@assemblyline-agents/runtime 2.0.0 → 3.1.0

package/dist/workspace-manifest.js

@@ -0,0 +1,111 @@
+import { createHash } from "node:crypto";
+export const DEFAULT_WORKSPACE_LIMITS = {
+    maxFiles: 10_000,
+    maxFileBytes: 100 * 1024 * 1024,
+    maxTotalBytes: 1024 * 1024 * 1024
+};
+const RESERVED_TOP_LEVEL = new Set(["memory", "skills", "history", "files", ".agents", ".assembly-line"]);
+export function scanWorkspaceEntries(entries, limits = DEFAULT_WORKSPACE_LIMITS) {
+    if (entries.length > limits.maxFiles)
+        throw new Error(`Workspace has ${entries.length} files; limit is ${limits.maxFiles}.`);
+    let totalBytes = 0;
+    const seen = new Set();
+    const files = entries.map((entry) => {
+        if (entry.kind && entry.kind !== "file")
+            throw new Error(`Workspace entry is not a regular file: ${entry.path}`);
+        const path = normalizeWorkspaceRelativePath(entry.path);
+        if (seen.has(path))
+            throw new Error(`Workspace contains a duplicate path: ${path}`);
+        seen.add(path);
+        const bytes = typeof entry.contents === "string" ? Buffer.from(entry.contents) : Buffer.from(entry.contents);
+        if (bytes.byteLength > limits.maxFileBytes) {
+            throw new Error(`Workspace file exceeds ${limits.maxFileBytes} bytes: ${path}`);
+        }
+        totalBytes += bytes.byteLength;
+        if (totalBytes > limits.maxTotalBytes)
+            throw new Error(`Workspace exceeds ${limits.maxTotalBytes} total bytes.`);
+        return {
+            path,
+            contents: entry.contents,
+            sha256: createHash("sha256").update(bytes).digest("hex"),
+            sizeBytes: bytes.byteLength,
+            contentType: workspaceContentType(path, bytes),
+            mode: normalizeWorkspaceMode(entry.mode)
+        };
+    });
+    return files.sort((a, b) => a.path.localeCompare(b.path));
+}
+export function createWorkspaceManifest(workspaceId, entries, createdAt) {
+    const sorted = entries.map(normalizeManifestEntry).sort((a, b) => a.path.localeCompare(b.path));
+    const paths = new Set();
+    let totalBytes = 0;
+    for (const entry of sorted) {
+        if (paths.has(entry.path))
+            throw new Error(`Workspace manifest contains a duplicate path: ${entry.path}`);
+        paths.add(entry.path);
+        totalBytes += entry.sizeBytes;
+    }
+    return { format: 1, workspaceId, entries: sorted, fileCount: sorted.length, totalBytes, createdAt };
+}
+export function encodeWorkspaceManifest(manifest) {
+    return Buffer.from(JSON.stringify(manifest));
+}
+export function workspaceManifestSha256(value) {
+    return createHash("sha256").update(typeof value === "string" ? Buffer.from(value) : value).digest("hex");
+}
+export function parseWorkspaceManifest(value) {
+    const raw = typeof value === "string" ? value : Buffer.from(value).toString("utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.format !== 1 || typeof parsed.workspaceId !== "string" || !Array.isArray(parsed.entries) || typeof parsed.createdAt !== "string") {
+        throw new Error("Workspace manifest is invalid.");
+    }
+    const manifest = createWorkspaceManifest(parsed.workspaceId, parsed.entries, parsed.createdAt);
+    if (parsed.fileCount !== manifest.fileCount || parsed.totalBytes !== manifest.totalBytes) {
+        throw new Error("Workspace manifest totals do not match its entries.");
+    }
+    return manifest;
+}
+export function normalizeWorkspaceRelativePath(value) {
+    const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+/g, "/");
+    const parts = normalized.split("/");
+    if (!normalized || parts.some((part) => !part || part === "." || part === "..")) {
+        throw new Error(`Invalid workspace path: ${value}`);
+    }
+    if (/[\u0000-\u001f\u007f]/u.test(normalized))
+        throw new Error(`Invalid workspace path: ${value}`);
+    if (RESERVED_TOP_LEVEL.has(parts[0] ?? ""))
+        throw new Error(`Reserved workspace path: ${value}`);
+    return normalized;
+}
+export function normalizeWorkspaceMode(mode) {
+    return typeof mode === "number" && (mode & 0o111) !== 0 ? 0o755 : 0o644;
+}
+function normalizeManifestEntry(entry) {
+    if (!/^[a-f0-9]{64}$/u.test(entry.sha256))
+        throw new Error(`Invalid workspace content hash for ${entry.path}.`);
+    if (!entry.blobKey || typeof entry.blobKey !== "string")
+        throw new Error(`Missing workspace blob key for ${entry.path}.`);
+    if (!Number.isSafeInteger(entry.sizeBytes) || entry.sizeBytes < 0)
+        throw new Error(`Invalid workspace size for ${entry.path}.`);
+    return {
+        path: normalizeWorkspaceRelativePath(entry.path),
+        blobKey: entry.blobKey,
+        sha256: entry.sha256,
+        sizeBytes: entry.sizeBytes,
+        contentType: entry.contentType || "application/octet-stream",
+        mode: normalizeWorkspaceMode(entry.mode)
+    };
+}
+function workspaceContentType(path, bytes) {
+    if (bytes.includes(0))
+        return "application/octet-stream";
+    if (path.endsWith(".json"))
+        return "application/json";
+    if (path.endsWith(".md") || path.endsWith(".mdx"))
+        return "text/markdown";
+    if (/\.(?:txt|log|csv|tsv|ts|tsx|js|jsx|mjs|cjs|css|html|xml|yaml|yml|toml|ini|sh|py|rb|go|rs|java|kt|swift|sql)$/u.test(path)) {
+        return "text/plain";
+    }
+    return "application/octet-stream";
+}
+//# sourceMappingURL=workspace-manifest.js.map

package/dist/workspace-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manifest.js","sourceRoot":"","sources":["../src/workspace-manifest.ts"],"names":[],"mappings":"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"}

package/dist/workspace-operation-limiter.d.ts

@@ -0,0 +1,16 @@
+export type WorkspaceRateLimitedOperation = "checkpoint" | "restore" | "fork" | "hydrate" | "sync";
+export interface WorkspaceOperationRateLimits {
+    windowMs: number;
+    limits: Record<WorkspaceRateLimitedOperation, number>;
+}
+export declare const DEFAULT_WORKSPACE_OPERATION_RATE_LIMITS: WorkspaceOperationRateLimits;
+export interface WorkspaceOperationLimiter {
+    assertAllowed(operation: WorkspaceRateLimitedOperation, scopeKey: string, now: Date): void;
+}
+export declare class SlidingWindowWorkspaceOperationLimiter implements WorkspaceOperationLimiter {
+    private readonly options;
+    private readonly attempts;
+    constructor(options?: WorkspaceOperationRateLimits);
+    assertAllowed(operation: WorkspaceRateLimitedOperation, scopeKey: string, now: Date): void;
+}
+//# sourceMappingURL=workspace-operation-limiter.d.ts.map

package/dist/workspace-operation-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation-limiter.d.ts","sourceRoot":"","sources":["../src/workspace-operation-limiter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,uCAAuC,EAAE,4BASrD,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,SAAS,EAAE,6BAA6B,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;CAC5F;AAED,qBAAa,sCAAuC,YAAW,yBAAyB;IAG1E,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;gBAE3B,OAAO,GAAE,4BAAsE;IAE5G,aAAa,CAAC,SAAS,EAAE,6BAA6B,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI;CAa3F"}

package/dist/workspace-operation-limiter.js

@@ -0,0 +1,31 @@
+export const DEFAULT_WORKSPACE_OPERATION_RATE_LIMITS = {
+    windowMs: 60_000,
+    limits: {
+        checkpoint: 60,
+        restore: 20,
+        fork: 20,
+        hydrate: 120,
+        sync: 120
+    }
+};
+export class SlidingWindowWorkspaceOperationLimiter {
+    options;
+    attempts = new Map();
+    constructor(options = DEFAULT_WORKSPACE_OPERATION_RATE_LIMITS) {
+        this.options = options;
+    }
+    assertAllowed(operation, scopeKey, now) {
+        const limit = Math.max(1, Math.floor(this.options.limits[operation]));
+        const windowMs = Math.max(1_000, Math.floor(this.options.windowMs));
+        const cutoff = now.getTime() - windowMs;
+        const key = `${operation}\u0000${scopeKey}`;
+        const attempts = (this.attempts.get(key) ?? []).filter((timestamp) => timestamp > cutoff);
+        if (attempts.length >= limit) {
+            const retryAfterMs = Math.max(1, (attempts[0] ?? now.getTime()) + windowMs - now.getTime());
+            throw new Error(`Workspace ${operation} rate limit exceeded. Retry after ${retryAfterMs} ms.`);
+        }
+        attempts.push(now.getTime());
+        this.attempts.set(key, attempts);
+    }
+}
+//# sourceMappingURL=workspace-operation-limiter.js.map

package/dist/workspace-operation-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation-limiter.js","sourceRoot":"","sources":["../src/workspace-operation-limiter.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,uCAAuC,GAAiC;IACnF,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE;QACN,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,GAAG;KACV;CACF,CAAC;AAMF,MAAM,OAAO,sCAAsC;IAGpB;IAFZ,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAExD,YAA6B,UAAwC,uCAAuC;QAA/E,YAAO,GAAP,OAAO,CAAwE;IAAG,CAAC;IAEhH,aAAa,CAAC,SAAwC,EAAE,QAAgB,EAAE,GAAS;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC;QACxC,MAAM,GAAG,GAAG,GAAG,SAAS,SAAS,QAAQ,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;QAC1F,IAAI,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5F,MAAM,IAAI,KAAK,CAAC,aAAa,SAAS,qCAAqC,YAAY,MAAM,CAAC,CAAC;QACjG,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/workspace-operations.d.ts

@@ -0,0 +1,145 @@
+import type { BlobAdapter, BlobObjectRecord } from "./runtime-types.js";
+import type { ResolvedStateAdapter, Workspace, WorkspaceManifest, WorkspaceVersion } from "./state.js";
+export interface WorkspaceRetentionReport {
+    workspaceId: string;
+    tailCount: number;
+    protected: {
+        headVersionId?: string;
+        checkpointVersionIds: string[];
+        forkSourceVersionIds: string[];
+        tailVersionIds: string[];
+    };
+    retainedVersionIds: string[];
+    prunableVersionIds: string[];
+    deletedVersionIds: string[];
+    dryRun: boolean;
+}
+export interface WorkspaceReachabilityIssue {
+    workspaceId: string;
+    versionId: string;
+    error: string;
+}
+export interface WorkspaceReachabilityReport {
+    safeToDelete: boolean;
+    workspaceCount: number;
+    versionCount: number;
+    reachableKeys: string[];
+    objects: BlobObjectRecord[];
+    orphanObjects: BlobObjectRecord[];
+    issues: WorkspaceReachabilityIssue[];
+    reachableBytes: number;
+    orphanBytes: number;
+    totalBytes: number;
+}
+export interface WorkspaceGarbageCollectionReport extends WorkspaceReachabilityReport {
+    dryRun: boolean;
+    minAgeMs: number;
+    eligibleObjects: BlobObjectRecord[];
+    skippedYoungOrUnknownAge: BlobObjectRecord[];
+    deletedKeys: string[];
+}
+export interface WorkspaceUsageReport {
+    complete: boolean;
+    workspaces: Array<{
+        workspaceId: string;
+        tenantId?: string;
+        versionCount: number;
+        logicalVersionBytes: number;
+        uniqueContentBytes: number;
+    }>;
+    tenants: Array<{
+        tenantId: string;
+        workspaceCount: number;
+        logicalVersionBytes: number;
+        uniqueContentBytes: number;
+    }>;
+    blobs: Array<{
+        sha256: string;
+        sizeBytes: number;
+        referenceCount: number;
+        workspaceIds: string[];
+    }>;
+    issues: WorkspaceReachabilityIssue[];
+}
+export interface WorkspaceDiagnostics {
+    generatedAt: string;
+    workspaceCount: number;
+    versionCount: number;
+    storageBytes: number;
+    orphanBlobCount: number;
+    orphanBytes: number;
+    dirtySessions: Array<{
+        sessionKey: string;
+        workspaceId?: string;
+        dirtyAgeMs: number;
+        state: string;
+    }>;
+    syncLagMs: number;
+    pendingSyncJobs: number;
+    conflictCount: number;
+    reachabilitySafe: boolean;
+    issues: WorkspaceReachabilityIssue[];
+}
+export type WorkspaceVerificationIssueKind = "stuck_head" | "missing_manifest" | "corrupt_manifest" | "missing_blob" | "corrupt_blob";
+export interface WorkspaceVerificationIssue {
+    kind: WorkspaceVerificationIssueKind;
+    workspaceId: string;
+    versionId?: string;
+    path?: string;
+    blobKey?: string;
+    detail: string;
+}
+export interface WorkspaceVerificationReport {
+    healthy: boolean;
+    workspaceCount: number;
+    versionCount: number;
+    checkedBlobCount: number;
+    issues: WorkspaceVerificationIssue[];
+}
+export interface WorkspaceOperationsHost {
+    state: ResolvedStateAdapter;
+    blob: BlobAdapter;
+    agentScope: string;
+    now(): Date;
+    requireWorkspace(workspaceId: string): Promise<Workspace>;
+    loadManifest(workspace: Workspace, versionId: string): Promise<{
+        version?: WorkspaceVersion;
+        manifest: WorkspaceManifest;
+    }>;
+}
+export declare class WorkspaceOperations {
+    private readonly host;
+    constructor(host: WorkspaceOperationsHost);
+    retention(workspaceId: string, input?: {
+        tailCount?: number;
+        dryRun?: boolean;
+    }): Promise<WorkspaceRetentionReport>;
+    reachability(): Promise<WorkspaceReachabilityReport>;
+    garbageCollect(input?: {
+        dryRun?: boolean;
+        minAgeMs?: number;
+    }): Promise<WorkspaceGarbageCollectionReport>;
+    usage(): Promise<WorkspaceUsageReport>;
+    diagnostics(): Promise<WorkspaceDiagnostics>;
+    verify(workspaceId?: string): Promise<WorkspaceVerificationReport>;
+    repairBlob(input: {
+        workspaceId: string;
+        versionId: string;
+        path?: string;
+        replacement: Uint8Array;
+    }): Promise<{
+        workspaceId: string;
+        versionId: string;
+        path?: string;
+        blobKey: string;
+        sha256: string;
+        sizeBytes: number;
+    }>;
+    repairHead(input: {
+        workspaceId: string;
+        targetVersionId: string;
+        expectedHeadVersionId?: string | null;
+    }): Promise<Workspace>;
+    private isInheritedForkManifest;
+}
+//# sourceMappingURL=workspace-operations.d.ts.map

package/dist/workspace-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operations.d.ts","sourceRoot":"","sources":["../src/workspace-operations.ts"],"names":[],"mappings":"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"}