@loompad/cli 0.1.0 → 1.1.1

package/dist/core/continuity/contracts.d.ts

@@ -0,0 +1,352 @@
+import { z } from "zod";
+export declare const Id: z.ZodString;
+export declare const Hash: z.ZodString;
+export declare const Text: z.ZodString;
+export declare const SourceRefV1: z.ZodObject<{
+    projectId: z.ZodString;
+    eventId: z.ZodNumber;
+    hash: z.ZodString;
+    span: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const WorkspaceRefV1: z.ZodObject<{
+    id: z.ZodString;
+    checkout: z.ZodString;
+    head: z.ZodNullable<z.ZodString>;
+    dirty: z.ZodNullable<z.ZodBoolean>;
+    revision: z.ZodString;
+}, z.core.$strict>;
+export declare const ContextItemV1: z.ZodObject<{
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    conversationId: z.ZodString;
+    kind: z.ZodEnum<{
+        instruction: "instruction";
+        decision: "decision";
+        correction: "correction";
+        topic: "topic";
+        pending: "pending";
+    }>;
+    text: z.ZodString;
+    origin: z.ZodEnum<{
+        user: "user";
+        agent: "agent";
+        derived: "derived";
+        external: "external";
+    }>;
+    status: z.ZodEnum<{
+        exploratory: "exploratory";
+        tentative: "tentative";
+        accepted: "accepted";
+        rejected: "rejected";
+        deferred: "deferred";
+        superseded: "superseded";
+    }>;
+    sources: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        eventId: z.ZodNumber;
+        hash: z.ZodString;
+        span: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    supersedes: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const CoverageV1: z.ZodObject<{
+    source: z.ZodObject<{
+        projectId: z.ZodString;
+        eventId: z.ZodNumber;
+        hash: z.ZodString;
+        span: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    disposition: z.ZodEnum<{
+        exact: "exact";
+        summarized: "summarized";
+        referenced: "referenced";
+        omitted: "omitted";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export declare const BindingV1: z.ZodObject<{
+    id: z.ZodString;
+    conversationId: z.ZodString;
+    agentInstanceId: z.ZodString;
+    harnessKind: z.ZodEnum<{
+        codex: "codex";
+        "claude-code": "claude-code";
+        opencode: "opencode";
+    }>;
+    workspaceId: z.ZodString;
+    compatibilityFingerprint: z.ZodString;
+    nativeSessionId: z.ZodNullable<z.ZodString>;
+    sessionEpoch: z.ZodNumber;
+    retention: z.ZodEnum<{
+        unknown: "unknown";
+        observed: "observed";
+        compacted: "compacted";
+    }>;
+}, z.core.$strict>;
+export declare const ContextPacketV1: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+    target: z.ZodObject<{
+        id: z.ZodString;
+        conversationId: z.ZodString;
+        agentInstanceId: z.ZodString;
+        harnessKind: z.ZodEnum<{
+            codex: "codex";
+            "claude-code": "claude-code";
+            opencode: "opencode";
+        }>;
+        workspaceId: z.ZodString;
+        compatibilityFingerprint: z.ZodString;
+        nativeSessionId: z.ZodNullable<z.ZodString>;
+        sessionEpoch: z.ZodNumber;
+        retention: z.ZodEnum<{
+            unknown: "unknown";
+            observed: "observed";
+            compacted: "compacted";
+        }>;
+    }, z.core.$strict>;
+    snapshot: z.ZodObject<{
+        throughEventId: z.ZodNumber;
+        conversationRevision: z.ZodNumber;
+        protectedStateRevision: z.ZodNumber;
+        workspace: z.ZodObject<{
+            id: z.ZodString;
+            checkout: z.ZodString;
+            head: z.ZodNullable<z.ZodString>;
+            dirty: z.ZodNullable<z.ZodBoolean>;
+            revision: z.ZodString;
+        }, z.core.$strict>;
+        instructionFilesFingerprint: z.ZodString;
+    }, z.core.$strict>;
+    mode: z.ZodEnum<{
+        reconstruction: "reconstruction";
+        delta: "delta";
+    }>;
+    currentRequest: z.ZodObject<{
+        projectId: z.ZodString;
+        eventId: z.ZodNumber;
+        hash: z.ZodString;
+        span: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    basis: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        packetId: z.ZodString;
+        protectedStateRevision: z.ZodNumber;
+    }, z.core.$strict>>>;
+    supplement: z.ZodString;
+    retrieval: z.ZodNullable<z.ZodObject<{
+        hash: z.ZodString;
+        relativePath: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strict>>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        conversationId: z.ZodString;
+        kind: z.ZodEnum<{
+            instruction: "instruction";
+            decision: "decision";
+            correction: "correction";
+            topic: "topic";
+            pending: "pending";
+        }>;
+        text: z.ZodString;
+        origin: z.ZodEnum<{
+            user: "user";
+            agent: "agent";
+            derived: "derived";
+            external: "external";
+        }>;
+        status: z.ZodEnum<{
+            exploratory: "exploratory";
+            tentative: "tentative";
+            accepted: "accepted";
+            rejected: "rejected";
+            deferred: "deferred";
+            superseded: "superseded";
+        }>;
+        sources: z.ZodArray<z.ZodObject<{
+            projectId: z.ZodString;
+            eventId: z.ZodNumber;
+            hash: z.ZodString;
+            span: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        supersedes: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    messages: z.ZodArray<z.ZodObject<{
+        source: z.ZodObject<{
+            projectId: z.ZodString;
+            eventId: z.ZodNumber;
+            hash: z.ZodString;
+            span: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        origin: z.ZodEnum<{
+            user: "user";
+            agent: "agent";
+            external: "external";
+        }>;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodObject<{
+            projectId: z.ZodString;
+            eventId: z.ZodNumber;
+            hash: z.ZodString;
+            span: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        headline: z.ZodString;
+    }, z.core.$strict>>>;
+    unlisted: z.ZodOptional<z.ZodObject<{
+        references: z.ZodNumber;
+        observations: z.ZodNumber;
+    }, z.core.$strict>>;
+    evidence: z.ZodArray<z.ZodObject<{
+        source: z.ZodObject<{
+            projectId: z.ZodString;
+            eventId: z.ZodNumber;
+            hash: z.ZodString;
+            span: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        text: z.ZodString;
+        outcome: z.ZodEnum<{
+            pending: "pending";
+            unknown: "unknown";
+            success: "success";
+            reported: "reported";
+            failure: "failure";
+            cancelled: "cancelled";
+        }>;
+    }, z.core.$strict>>;
+    coverage: z.ZodArray<z.ZodObject<{
+        source: z.ZodObject<{
+            projectId: z.ZodString;
+            eventId: z.ZodNumber;
+            hash: z.ZodString;
+            span: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        disposition: z.ZodEnum<{
+            exact: "exact";
+            summarized: "summarized";
+            referenced: "referenced";
+            omitted: "omitted";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    budget: z.ZodObject<{
+        estimatedAddedTokens: z.ZodNumber;
+        estimation: z.ZodLiteral<"heuristic">;
+        targetAddedTokens: z.ZodNumber;
+        overflow: z.ZodEnum<{
+            none: "none";
+            soft: "soft";
+            mandatory: "mandatory";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const RenderedBriefingV1: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    packetId: z.ZodString;
+    text: z.ZodString;
+    hash: z.ZodString;
+    channel: z.ZodLiteral<"turn-input">;
+    renderer: z.ZodLiteral<"loom-context/1">;
+}, z.core.$strict>;
+export declare const DeliveryReceiptV1: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    packetId: z.ZodString;
+    requestId: z.ZodString;
+    bindingId: z.ZodString;
+    runId: z.ZodString;
+    status: z.ZodEnum<{
+        accepted: "accepted";
+        prepared: "prepared";
+        submitting: "submitting";
+        failed: "failed";
+        outcome_unknown: "outcome_unknown";
+    }>;
+    execution: z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+        idle: "idle";
+        running: "running";
+        complete: "complete";
+        interrupted: "interrupted";
+    }>;
+    evidence: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNumber;
+}, z.core.$strict>;
+export declare const RequestV1: z.ZodObject<{
+    id: z.ZodString;
+    conversationId: z.ZodString;
+    agentInstanceId: z.ZodString;
+    text: z.ZodString;
+    source: z.ZodEnum<{
+        user: "user";
+        route: "route";
+    }>;
+    model: z.ZodNullable<z.ZodString>;
+    plan: z.ZodBoolean;
+    targetAddedTokens: z.ZodNumber;
+}, z.core.$strict>;
+export type SourceRef = z.infer<typeof SourceRefV1>;
+export type ContextItem = z.infer<typeof ContextItemV1>;
+export type Binding = z.infer<typeof BindingV1>;
+export type ContextPacket = z.infer<typeof ContextPacketV1>;
+export type RenderedBriefing = z.infer<typeof RenderedBriefingV1>;
+export type Receipt = z.infer<typeof DeliveryReceiptV1>;
+export type ContinuityRequest = z.infer<typeof RequestV1>;
+export type WorkspaceRef = z.infer<typeof WorkspaceRefV1>;
+export declare const digest: (text: string) => string;
+export declare class ContinuityError extends Error {
+    readonly code: "unsupported" | "conflict" | "overflow" | "recovery_required" | "stale" | "invalid";
+    constructor(code: "unsupported" | "conflict" | "overflow" | "recovery_required" | "stale" | "invalid", message: string);
+}
+/** Only adapters with evidence that no process was launched may use this. */
+export declare class NativeDispatchRejected extends Error {
+    constructor(message: string);
+}
+/** The bound native session could not be resumed and no turn was started.
+ * Safe to rebuild: the binding moves to a new epoch and reconstructs. */
+export declare class NativeSessionMissing extends NativeDispatchRejected {
+    constructor(message: string);
+}
+/** The native parent may have exited while a tool descendant still owns files. */
+export declare class NativeQuiescenceUnknown extends Error {
+    constructor(message: string);
+}
+export declare function parseBounded<T>(schema: z.ZodType<T>, value: unknown): T;

package/dist/core/continuity/contracts.js

@@ -0,0 +1,117 @@
+import { createHash } from "node:crypto";
+import { z } from "zod";
+// Wire contracts contain only bounded JSON values. Refinements belong in the
+// semantic validator, so the same shapes can be exported as JSON Schema.
+export const Id = z.string().min(1).max(256);
+export const Hash = z.string().regex(/^[a-f0-9]{64}$/);
+const Counter = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+export const Text = z.string().max(1_000_000);
+export const SourceRefV1 = z.strictObject({ projectId: Id, eventId: Counter,
+    hash: Hash, span: z.strictObject({ start: Counter, end: Counter }).optional() });
+export const WorkspaceRefV1 = z.strictObject({ id: Hash, checkout: Text,
+    head: z.string().max(256).nullable(), dirty: z.boolean().nullable(), revision: Hash });
+export const ContextItemV1 = z.strictObject({ id: Id, revision: Counter,
+    conversationId: Id, kind: z.enum(["instruction", "decision", "correction", "topic", "pending"]),
+    text: Text, origin: z.enum(["user", "agent", "derived", "external"]),
+    status: z.enum(["exploratory", "tentative", "accepted", "rejected", "deferred", "superseded"]),
+    sources: z.array(SourceRefV1).min(1).max(1000),
+    supersedes: z.strictObject({ id: Id, revision: Counter }).nullable() });
+export const CoverageV1 = z.strictObject({ source: SourceRefV1,
+    disposition: z.enum(["exact", "summarized", "referenced", "omitted"]), reason: z.string().min(1).max(1000) });
+export const BindingV1 = z.strictObject({ id: Id, conversationId: Id,
+    agentInstanceId: Id, harnessKind: z.enum(["codex", "claude-code", "opencode"]),
+    workspaceId: Hash, compatibilityFingerprint: Hash, nativeSessionId: Id.nullable(),
+    // "compacted": the harness reported native compaction; the next packet rebuilds state.
+    sessionEpoch: Counter, retention: z.enum(["unknown", "observed", "compacted"]) });
+export const ContextPacketV1 = z.strictObject({ version: z.literal(1), id: Id,
+    conversationId: Id, requestId: Id, target: BindingV1,
+    snapshot: z.strictObject({ throughEventId: Counter, conversationRevision: Counter,
+        protectedStateRevision: Counter, workspace: WorkspaceRefV1, instructionFilesFingerprint: Hash }),
+    mode: z.enum(["reconstruction", "delta"]), currentRequest: SourceRefV1,
+    // The accepted packet a delta builds on; its native session already holds
+    // everything that packet delivered.
+    basis: z.strictObject({ packetId: Id, protectedStateRevision: Counter }).nullable().optional(),
+    supplement: Text,
+    retrieval: z.strictObject({ hash: Hash, relativePath: z.string().regex(/^\.loom\/brain\/artifacts\/[a-f0-9]{64}\.json$/),
+        bytes: Counter }).nullable(),
+    items: z.array(ContextItemV1).max(10_000),
+    messages: z.array(z.strictObject({ source: SourceRefV1,
+        origin: z.enum(["user", "agent", "external"]), text: Text })).max(10_000),
+    // Older user messages sent as a one-line headline; full text is in the retrieval file.
+    references: z.array(z.strictObject({ source: SourceRefV1, headline: z.string().max(1000) })).max(10_000).optional(),
+    // Counts of sources that are covered but not listed individually in the rendered text.
+    unlisted: z.strictObject({ references: Counter, observations: Counter }).optional(),
+    evidence: z.array(z.strictObject({ source: SourceRefV1, text: Text,
+        outcome: z.enum(["reported", "pending", "success", "failure", "cancelled", "unknown"]) })).max(1000),
+    coverage: z.array(CoverageV1).max(20_000),
+    budget: z.strictObject({ estimatedAddedTokens: Counter, estimation: z.literal("heuristic"),
+        targetAddedTokens: Counter, overflow: z.enum(["none", "soft", "mandatory"]) }) });
+export const RenderedBriefingV1 = z.strictObject({ version: z.literal(1), packetId: Id,
+    text: Text, hash: Hash, channel: z.literal("turn-input"), renderer: z.literal("loom-context/1") });
+export const DeliveryReceiptV1 = z.strictObject({ version: z.literal(1), id: Id,
+    packetId: Id, requestId: Id, bindingId: Id, runId: Id,
+    status: z.enum(["prepared", "submitting", "accepted", "failed", "outcome_unknown"]),
+    execution: z.enum(["idle", "running", "complete", "failed", "interrupted", "unknown"]),
+    evidence: z.string().max(2000).nullable(), updatedAt: Counter });
+export const RequestV1 = z.strictObject({ id: Id, conversationId: Id, agentInstanceId: Id,
+    text: Text.min(1), source: z.enum(["user", "route"]), model: Id.nullable(),
+    plan: z.boolean(), targetAddedTokens: z.number().int().min(128).max(100_000) });
+export const digest = (text) => createHash("sha256").update(text, "utf8").digest("hex");
+export class ContinuityError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ContinuityError";
+    }
+}
+/** Only adapters with evidence that no process was launched may use this. */
+export class NativeDispatchRejected extends Error {
+    constructor(message) { super(message); this.name = "NativeDispatchRejected"; }
+}
+/** The bound native session could not be resumed and no turn was started.
+ * Safe to rebuild: the binding moves to a new epoch and reconstructs. */
+export class NativeSessionMissing extends NativeDispatchRejected {
+    constructor(message) { super(message); this.name = "NativeSessionMissing"; }
+}
+/** The native parent may have exited while a tool descendant still owns files. */
+export class NativeQuiescenceUnknown extends Error {
+    constructor(message) { super(message); this.name = "NativeQuiescenceUnknown"; }
+}
+export function parseBounded(schema, value) {
+    // Reject oversize/deep/unserializable inputs before handing them to Zod.
+    let encoded;
+    try {
+        encoded = JSON.stringify(value);
+    }
+    catch {
+        throw new ContinuityError("invalid", "invalid JSON");
+    }
+    if (!encoded || Buffer.byteLength(encoded) > 4_000_000)
+        throw new ContinuityError("invalid", "continuity input exceeds 4 MB");
+    let depth = 0, inString = false, escaped = false;
+    for (const c of encoded) {
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (c === "\\")
+                escaped = true;
+            else if (c === '"')
+                inString = false;
+        }
+        else if (c === '"')
+            inString = true;
+        else if (c === "{" || c === "[") {
+            if (++depth > 32)
+                throw new ContinuityError("invalid", "continuity input is too deep");
+        }
+        else if (c === "}" || c === "]")
+            depth--;
+    }
+    const parsed = schema.safeParse(value);
+    if (!parsed.success)
+        throw new ContinuityError("invalid", `invalid continuity contract: ${parsed.error.issues.slice(0, 8)
+            .map(issue => `${issue.code} at ${issue.path.join(".").slice(0, 200) || "root"}`).join("; ")}`);
+    return parsed.data;
+}
+//# sourceMappingURL=contracts.js.map

package/dist/core/continuity/contracts.js.map

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

package/dist/core/continuity/engine.d.ts

@@ -0,0 +1,55 @@
+import type { EventLog } from "../eventlog.js";
+import type { LoomEvent, SendInput } from "../../types.js";
+import { type ContinuityStore } from "./store.js";
+import { type ContextItem, type ContextPacket, type ContinuityRequest, type Receipt, type RenderedBriefing, type SourceRef, type WorkspaceRef } from "./contracts.js";
+export declare const estimateTokens: (text: string) => number;
+export declare function observeWorkspace(dir: string): Promise<{
+    workspace: WorkspaceRef;
+    instructions: string;
+}>;
+export declare const headline: (text: string) => string;
+export declare function renderPacket(packet: ContextPacket): RenderedBriefing;
+/** Brain owns durable evidence and packet assembly; native harnesses own tools,
+ * authentication, execution and private context. No model or embedding runtime. */
+export declare class ContinuityEngine {
+    private readonly log;
+    readonly projectId: string;
+    readonly store: ContinuityStore;
+    /** `compacted`: the harness reported native compaction during this run. */
+    private readonly runs;
+    constructor(log: EventLog, projectId: string);
+    capture(value: unknown): {
+        request: ContinuityRequest;
+        event: LoomEvent;
+        created: boolean;
+    };
+    readSource(source: SourceRef, chat: string): string;
+    putItem(value: unknown): ContextItem;
+    /**
+     * Assemble what the target native session is missing, within budget.
+     *
+     * A resumed session (delta) already holds everything earlier packets gave it
+     * plus its own turns, so only new user messages, other agents' work and
+     * changed reviewed state are sent. A new or compacted session
+     * (reconstruction) gets reviewed state, the most recent user messages
+     * exactly, one-line headlines for older ones (full text in a local evidence
+     * file) and recent observations. Nothing is dropped silently: every source is
+     * covered as exact, summarized, referenced or omitted.
+     */
+    prepare(request: ContinuityRequest, kind: string, dir: string, options: Record<string, unknown>, supplement?: string): Promise<{
+        packet: ContextPacket;
+        rendered: RenderedBriefing;
+        receipt: Receipt;
+    }>;
+    validate(packet: ContextPacket, rendered: RenderedBriefing): void;
+    submit(prepared: {
+        packet: ContextPacket;
+        rendered: RenderedBriefing;
+        receipt: Receipt;
+    }, signal?: AbortSignal): Promise<NonNullable<SendInput["continuity"]>>;
+    ingest(event: LoomEvent): void;
+    settled(runId: string, error?: unknown): void;
+    diagnostics(requestId?: string): object;
+    eventChat(runId: string): string | undefined;
+    isLiveRun(runId: string): boolean;
+}