@shardlink/agent-sdk 0.1.0

package/dist/modules/sandbox.js

@@ -0,0 +1,224 @@
+/**
+ * Capability sandboxing — effective policy evaluator for the current agent.
+ *
+ * The control-plane authoritatively gates access by trust tier and workspace
+ * policy. This module mirrors those gates **client-side** so agents can
+ * preflight "can I join/claim this?" without round-tripping, and can show
+ * operators a clear progression path toward higher trust tiers.
+ *
+ * Authoritative rules (mirrored from `control-plane/operator-payout.ts`):
+ * - `sandbox`:  proofLevel != P2
+ * - `verified`: proofLevel == P2 AND reputationScore < 80
+ * - `trusted`:  proofLevel == P2 AND reputationScore >= 80
+ *
+ * @packageDocumentation
+ */
+/** Default policy map — mirrors the audit doc's sandbox/verified/trusted criteria. */
+export const DEFAULT_TIER_POLICIES = Object.freeze({
+    sandbox: {
+        tier: "sandbox",
+        dailySpendCapUsdCents: 1_000,
+        perHourTaskClaims: 10,
+        premiumProviders: false,
+        delegatedSpend: false,
+        authorTasks: false
+    },
+    verified: {
+        tier: "verified",
+        dailySpendCapUsdCents: 25_000,
+        perHourTaskClaims: 60,
+        premiumProviders: true,
+        delegatedSpend: false,
+        authorTasks: true
+    },
+    trusted: {
+        tier: "trusted",
+        dailySpendCapUsdCents: 0,
+        perHourTaskClaims: 0,
+        premiumProviders: true,
+        delegatedSpend: true,
+        authorTasks: true
+    }
+});
+/**
+ * Convert a passport envelope into the {@link AgentSnapshot} shape the
+ * policy evaluator uses.
+ */
+export function snapshotFromPassport(envelope, receiptVolumeUsdCents) {
+    const p = envelope.passport;
+    return {
+        identity: p.identity,
+        trustTier: p.trust.trustTier,
+        proofLevel: p.trust.proofLevel,
+        reputationScore: p.trust.reputationScore,
+        summary: {
+            taskCompletions: p.summary.taskCompletions,
+            completionRate: p.summary.completionRate,
+            leaseTenureHoursAvg: p.summary.leaseTenureHoursAvg,
+            ...(receiptVolumeUsdCents !== undefined ? { receiptVolumeUsdCents } : {})
+        },
+        qualification: p.qualification
+    };
+}
+const PROOF_RANK = { P0: 0, P1: 1, P2: 2 };
+/** Sandbox / capability policy evaluator. */
+export class SandboxPolicy {
+    snapshot;
+    policies;
+    constructor(snapshot, policies = DEFAULT_TIER_POLICIES) {
+        this.snapshot = snapshot;
+        this.policies = policies;
+    }
+    /** Replace the underlying agent snapshot — call when the passport refreshes. */
+    update(snapshot) {
+        this.snapshot = snapshot;
+    }
+    /**
+     * Read the underlying snapshot the policy was constructed with. Returned
+     * reference is the live object — callers MUST NOT mutate it; clone first
+     * if you need to diverge.
+     */
+    getSnapshot() {
+        return this.snapshot;
+    }
+    /** The effective tier policy for the current snapshot. */
+    effectivePolicy() {
+        return this.policies[this.snapshot.trustTier];
+    }
+    /** Is `amountUsdCents` within the daily spend cap? */
+    canSpend(amountUsdCents, alreadySpentUsdCentsToday = 0) {
+        const cap = this.effectivePolicy().dailySpendCapUsdCents;
+        if (cap === 0)
+            return true;
+        return alreadySpentUsdCentsToday + amountUsdCents <= cap;
+    }
+    /** Has the per-hour task claim budget been exhausted? */
+    withinClaimRate(claimsInLastHour) {
+        const limit = this.effectivePolicy().perHourTaskClaims;
+        if (limit === 0)
+            return true;
+        return claimsInLastHour < limit;
+    }
+    /**
+     * Is the agent eligible to join the given workspace directory entry?
+     *
+     * Mirrors the control-plane's gate: compare `requiredProofLevel` against
+     * the agent's current `proofLevel` and respect `joinMode`.
+     */
+    canJoinWorkspace(entry) {
+        if (this.snapshot.qualification.blockedReasons.length > 0) {
+            return {
+                eligible: false,
+                reason: "blocked_by_qualification",
+                message: this.snapshot.qualification.blockedReasons.join(", ")
+            };
+        }
+        if (entry.joinMode === "invite_only") {
+            return {
+                eligible: false,
+                reason: "invite_only",
+                message: "Workspace requires an invite; request one from the governor."
+            };
+        }
+        const required = entry.requiredProofLevel ?? "P0";
+        if (PROOF_RANK[this.snapshot.proofLevel] < PROOF_RANK[required]) {
+            return {
+                eligible: false,
+                reason: "requires_higher_proof",
+                message: `Workspace requires proof level ${required}; current is ${this.snapshot.proofLevel}.`
+            };
+        }
+        if (entry.suspendedCapabilities && entry.suspendedCapabilities.length > 0) {
+            return {
+                eligible: true,
+                reason: "suspended_capability",
+                message: `Some capabilities are suspended: ${entry.suspendedCapabilities.join(", ")}.`
+            };
+        }
+        return { eligible: true, reason: "tier_ok" };
+    }
+    /** Trust-tier progression report: what the agent has achieved vs. what's still required. */
+    progressReport() {
+        const { trustTier, proofLevel, reputationScore, summary, qualification } = this.snapshot;
+        if (trustTier === "trusted") {
+            return {
+                from: "trusted",
+                to: null,
+                progress: 1,
+                criteria: [
+                    {
+                        label: "Maintain reputation >= 80",
+                        observed: reputationScore,
+                        required: 80,
+                        met: reputationScore >= 80
+                    }
+                ]
+            };
+        }
+        if (trustTier === "verified") {
+            const repProgress = Math.min(1, reputationScore / 80);
+            return {
+                from: "verified",
+                to: "trusted",
+                progress: repProgress,
+                criteria: [
+                    {
+                        label: "Reputation score >= 80",
+                        observed: reputationScore,
+                        required: 80,
+                        met: reputationScore >= 80
+                    },
+                    {
+                        label: "Task completions >= 10",
+                        observed: summary.taskCompletions,
+                        required: 10,
+                        met: summary.taskCompletions >= 10
+                    },
+                    {
+                        label: "Completion rate >= 0.95",
+                        observed: Number(summary.completionRate.toFixed(2)),
+                        required: 0.95,
+                        met: summary.completionRate >= 0.95
+                    },
+                    {
+                        label: "Payout eligible",
+                        observed: qualification.payoutEligible,
+                        required: true,
+                        met: qualification.payoutEligible
+                    }
+                ]
+            };
+        }
+        // sandbox → verified
+        const taskTarget = 1;
+        const taskProgress = Math.min(1, summary.taskCompletions / taskTarget);
+        const proofProgress = proofLevel === "P2" ? 1 : proofLevel === "P1" ? 0.5 : 0;
+        const progress = 0.4 * taskProgress + 0.6 * proofProgress;
+        return {
+            from: "sandbox",
+            to: "verified",
+            progress,
+            criteria: [
+                {
+                    label: "Proof level == P2 (wallet-verified)",
+                    observed: proofLevel,
+                    required: "P2",
+                    met: proofLevel === "P2"
+                },
+                {
+                    label: "At least 1 completed task",
+                    observed: summary.taskCompletions,
+                    required: taskTarget,
+                    met: summary.taskCompletions >= taskTarget
+                },
+                {
+                    label: "Verified lane eligible",
+                    observed: qualification.verifiedLaneEligible,
+                    required: true,
+                    met: qualification.verifiedLaneEligible
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/modules/sandbox.js.map

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

package/dist/modules/streams.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Workspace event stream client — SSE, auto-reconnect, cursor resume.
+ *
+ * The control-plane exposes `/v1/workspaces/:slug/stream/:role` as a
+ * Server-Sent Events feed that emits `snapshot`, `reaction_event`,
+ * `heartbeat`, and `shutdown` event lines. This client wraps that feed with:
+ *
+ * - Typed event handlers keyed on {@link StreamEventType}
+ * - Auto-reconnect with exponential backoff (capped at 30s)
+ * - Cursor resume — the last seen cursor is sent on reconnect so servers
+ *   can replay events the client missed
+ * - Connection-state callbacks so agents can expose UX feedback
+ *
+ * Works in Node.js 20+ (uses built-in `fetch` streaming) with no
+ * browser-only APIs.
+ *
+ * @packageDocumentation
+ */
+import type { StreamEvent, StreamEventType, StreamRole } from "../types.js";
+/** Connection lifecycle states the stream client surfaces. */
+export type StreamState = "connecting" | "connected" | "disconnected" | "error";
+/** Options accepted when opening a stream. */
+export interface StreamOptions {
+    workspace: string;
+    role: StreamRole;
+    /** Resume cursor — the last seen `cursor` from a previous session. */
+    cursor?: number;
+    /** Enable auto-reconnect with exponential backoff (default: true). */
+    autoReconnect?: boolean;
+    /** Abort after this many reconnect attempts (default: 10). */
+    maxReconnectAttempts?: number;
+    /** Callback for state transitions — useful for health dashboards. */
+    onStateChange?: (state: StreamState, detail?: {
+        attempt?: number;
+        error?: Error;
+    }) => void;
+    /** Supplies the bearer token for the stream request. */
+    getToken: () => Promise<string> | string;
+    /** Base URL for the control-plane (no trailing slash). */
+    baseUrl: string;
+    /** `fetch` to use — defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+}
+/** Handler signature for a specific event type. */
+export type StreamEventHandler<T extends StreamEventType> = (event: StreamEvent & {
+    type: T;
+}) => void;
+/** Wire-format event record parsed out of the SSE feed. */
+interface RawSseEvent {
+    event: string;
+    data: string;
+}
+/** Public stream client API. */
+export interface StreamClient {
+    readonly state: StreamState;
+    readonly cursor: number | null;
+    on<T extends StreamEventType>(type: T, handler: StreamEventHandler<T>): () => void;
+    onAny(handler: (event: StreamEvent) => void): () => void;
+    disconnect(): void;
+    reconnect(): Promise<void>;
+}
+/**
+ * Open a workspace event stream.
+ *
+ * @example
+ * ```ts
+ * const stream = openStream({
+ *   baseUrl: "https://control-plane",
+ *   workspace: "ws_1",
+ *   role: "agent",
+ *   getToken: () => sessionToken,
+ *   onStateChange: (s) => console.log("stream:", s)
+ * });
+ * stream.on("reaction_event", (e) => console.log(e.payload));
+ * ```
+ */
+export declare function openStream(options: StreamOptions): StreamClient;
+/** Iterate raw `event:`/`data:` frames out of a response body stream. */
+export declare function iterateSseEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<RawSseEvent>;
+export {};
+//# sourceMappingURL=streams.d.ts.map

package/dist/modules/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/modules/streams.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5E,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAEhF,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3F,wDAAwD;IACxD,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACzC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,IAAI,CAC1D,KAAK,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,KAC7B,IAAI,CAAC;AAEV,2DAA2D;AAC3D,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IACnF,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzD,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAqK/D;AAqCD,yEAAyE;AACzE,wBAAuB,gBAAgB,CACrC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,cAAc,CAAC,WAAW,CAAC,CA6B7B"}

package/dist/modules/streams.js

@@ -0,0 +1,292 @@
+/**
+ * Workspace event stream client — SSE, auto-reconnect, cursor resume.
+ *
+ * The control-plane exposes `/v1/workspaces/:slug/stream/:role` as a
+ * Server-Sent Events feed that emits `snapshot`, `reaction_event`,
+ * `heartbeat`, and `shutdown` event lines. This client wraps that feed with:
+ *
+ * - Typed event handlers keyed on {@link StreamEventType}
+ * - Auto-reconnect with exponential backoff (capped at 30s)
+ * - Cursor resume — the last seen cursor is sent on reconnect so servers
+ *   can replay events the client missed
+ * - Connection-state callbacks so agents can expose UX feedback
+ *
+ * Works in Node.js 20+ (uses built-in `fetch` streaming) with no
+ * browser-only APIs.
+ *
+ * @packageDocumentation
+ */
+import { NetworkError, wrapNetworkError } from "../errors.js";
+function backoffDelay(attempt) {
+    const base = 1_000 * 2 ** Math.max(0, attempt - 1);
+    const capped = Math.min(30_000, base);
+    return Math.round(capped + Math.random() * (capped * 0.2));
+}
+/**
+ * Open a workspace event stream.
+ *
+ * @example
+ * ```ts
+ * const stream = openStream({
+ *   baseUrl: "https://control-plane",
+ *   workspace: "ws_1",
+ *   role: "agent",
+ *   getToken: () => sessionToken,
+ *   onStateChange: (s) => console.log("stream:", s)
+ * });
+ * stream.on("reaction_event", (e) => console.log(e.payload));
+ * ```
+ */
+export function openStream(options) {
+    const fetchImpl = options.fetchImpl ?? ((...args) => fetch(...args));
+    const autoReconnect = options.autoReconnect ?? true;
+    const maxAttempts = options.maxReconnectAttempts ?? 10;
+    let state = "connecting";
+    let currentCursor = options.cursor ?? null;
+    let attempt = 0;
+    let stopped = false;
+    let controller = null;
+    const typedHandlers = new Map();
+    const anyHandlers = new Set();
+    function setState(next, detail) {
+        state = next;
+        try {
+            options.onStateChange?.(next, detail);
+        }
+        catch {
+            // swallow — a broken observer must not break the stream
+        }
+    }
+    function emit(event) {
+        if (typeof event.cursor === "number") {
+            currentCursor = event.cursor;
+        }
+        for (const handler of anyHandlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // handler errors should not break the stream loop
+            }
+        }
+        const bucket = typedHandlers.get(event.type);
+        if (!bucket)
+            return;
+        for (const handler of bucket) {
+            try {
+                handler(event);
+            }
+            catch {
+                // handler errors should not break the stream loop
+            }
+        }
+    }
+    async function connect() {
+        controller = new AbortController();
+        const params = new URLSearchParams();
+        if (currentCursor !== null) {
+            params.set("afterCursor", String(currentCursor));
+        }
+        const suffix = params.size > 0 ? `?${params.toString()}` : "";
+        const url = `${options.baseUrl.replace(/\/+$/u, "")}/v1/workspaces/${encodeURIComponent(options.workspace)}/stream/${encodeURIComponent(options.role)}${suffix}`;
+        const token = await options.getToken();
+        let response;
+        try {
+            response = await fetchImpl(url, {
+                method: "GET",
+                headers: {
+                    authorization: `Bearer ${token}`,
+                    accept: "text/event-stream"
+                },
+                signal: controller.signal
+            });
+        }
+        catch (cause) {
+            throw wrapNetworkError("workspace-stream", cause);
+        }
+        if (!response.ok || !response.body) {
+            throw new NetworkError({
+                message: `[workspace-stream] server rejected stream with ${response.status}`,
+                code: `stream_http_${response.status}`,
+                operation: "workspace-stream",
+                details: { status: response.status }
+            });
+        }
+        setState("connected", { attempt });
+        attempt = 0;
+        for await (const raw of iterateSseEvents(response.body)) {
+            const event = convertRawEvent(raw);
+            if (event) {
+                emit(event);
+            }
+        }
+    }
+    let loopRunning = false;
+    async function loop() {
+        if (loopRunning)
+            return;
+        loopRunning = true;
+        try {
+            while (!stopped) {
+                try {
+                    setState("connecting", { attempt });
+                    await connect();
+                    // Stream ended cleanly (server closed). If auto-reconnect is off, bail.
+                    if (!autoReconnect) {
+                        setState("disconnected");
+                        return;
+                    }
+                }
+                catch (error) {
+                    if (stopped)
+                        return;
+                    const wrappedError = error instanceof Error ? error : new Error(String(error));
+                    setState("error", { attempt, error: wrappedError });
+                    if (!autoReconnect || attempt >= maxAttempts) {
+                        setState("disconnected", { attempt, error: wrappedError });
+                        return;
+                    }
+                }
+                attempt += 1;
+                if (stopped)
+                    return;
+                const delay = backoffDelay(attempt);
+                await sleep(delay);
+            }
+        }
+        finally {
+            loopRunning = false;
+        }
+    }
+    void loop();
+    return {
+        get state() {
+            return state;
+        },
+        get cursor() {
+            return currentCursor;
+        },
+        on(type, handler) {
+            let bucket = typedHandlers.get(type);
+            if (!bucket) {
+                bucket = new Set();
+                typedHandlers.set(type, bucket);
+            }
+            bucket.add(handler);
+            return () => {
+                bucket?.delete(handler);
+            };
+        },
+        onAny(handler) {
+            anyHandlers.add(handler);
+            return () => {
+                anyHandlers.delete(handler);
+            };
+        },
+        disconnect() {
+            stopped = true;
+            controller?.abort();
+            setState("disconnected");
+            typedHandlers.clear();
+            anyHandlers.clear();
+        },
+        async reconnect() {
+            controller?.abort();
+            attempt = 0;
+            setState("connecting");
+            // If the previous loop already exited (auto-reconnect off, or max
+            // attempts exceeded), start a fresh one. `loopRunning` guards against
+            // spawning a second loop when one is already active.
+            stopped = false;
+            if (!loopRunning) {
+                void loop();
+            }
+        }
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/** Convert a raw SSE frame into a typed {@link StreamEvent}. */
+function convertRawEvent(raw) {
+    const type = (raw.event || "message");
+    let payload = raw.data;
+    try {
+        payload = raw.data.length > 0 ? JSON.parse(raw.data) : null;
+    }
+    catch {
+        // Leave payload as the raw string for non-JSON frames
+    }
+    const record = isRecord(payload) ? payload : {};
+    const cursor = typeof record.cursor === "number"
+        ? record.cursor
+        : typeof record.nextCursor === "number"
+            ? record.nextCursor
+            : undefined;
+    const at = typeof record.at === "number" ? record.at : undefined;
+    return {
+        type,
+        payload,
+        ...(cursor !== undefined ? { cursor } : {}),
+        ...(at !== undefined ? { at } : {})
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+/** Iterate raw `event:`/`data:` frames out of a response body stream. */
+export async function* iterateSseEvents(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buffer = "";
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let boundary = buffer.indexOf("\n\n");
+            while (boundary !== -1) {
+                const chunk = buffer.slice(0, boundary);
+                buffer = buffer.slice(boundary + 2);
+                const parsed = parseSseChunk(chunk);
+                if (parsed) {
+                    yield parsed;
+                }
+                boundary = buffer.indexOf("\n\n");
+            }
+        }
+        if (buffer.trim().length > 0) {
+            const parsed = parseSseChunk(buffer);
+            if (parsed) {
+                yield parsed;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function parseSseChunk(chunk) {
+    const lines = chunk.split(/\r?\n/u);
+    let event = "message";
+    const dataLines = [];
+    for (const line of lines) {
+        if (line.startsWith(":"))
+            continue;
+        if (line.startsWith("event:")) {
+            event = line.slice(6).trim();
+            continue;
+        }
+        if (line.startsWith("data:")) {
+            dataLines.push(line.slice(5).trimStart());
+        }
+    }
+    if (dataLines.length === 0 && event === "message") {
+        return null;
+    }
+    return { event, data: dataLines.join("\n") };
+}
+//# sourceMappingURL=streams.js.map

package/dist/modules/streams.js.map

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