Shared utilities for AWP packages — validation, reputation calculations, and frontmatter parsing
npm install @agent-workspace/utilsShared utilities for the Agent Workspace Protocol packages.
``bash`
npm install @agent-workspace/utils
`typescript
import { validateSlug, sanitizeSlug, validatePath } from "@agent-workspace/utils";
// Validate a slug
validateSlug("my-artifact"); // true
validateSlug("Invalid_Slug"); // false
// Sanitize and validate (throws on invalid)
const slug = sanitizeSlug("My-Artifact"); // "my-artifact"
// Validate path is within root (prevents traversal)
const safePath = validatePath("/workspace", "artifacts/doc.md");
`
`typescript
import {
computeDecayedScore,
updateDimension,
computeConfidence,
} from "@agent-workspace/utils";
// Compute decayed score (decays toward 0.5 over time)
const decayed = computeDecayedScore(dimension, new Date());
// Update dimension with new signal using EWMA
const updated = updateDimension(existingDimension, 0.9);
// Compute confidence from sample size
const confidence = computeConfidence(10); // ~0.5
`
`typescript
import {
parseWorkspaceFile,
writeWorkspaceFile,
serializeWorkspaceFile,
} from "@agent-workspace/utils";
import type { IdentityFrontmatter } from "@agent-workspace/core";
// Parse a workspace file
const identity = await parseWorkspaceFile
console.log(identity.frontmatter.name);
// Modify and write back
identity.frontmatter.lastModified = new Date().toISOString();
await writeWorkspaceFile(identity);
``
This package is part of the Agent Workspace Protocol monorepo:
| Package | Description |
|---------|-------------|
| @agent-workspace/core | Types, constants, JSON schemas |
| @agent-workspace/cli | CLI tool |
| @agent-workspace/mcp-server | MCP server |
| @agent-workspace/utils | Shared utilities |
Apache-2.0