@paperclipai/server 2026.830.0-canary.0 → 2026.830.0-canary.2

package/dist/build-info.json

@@ -1,3 +1,3 @@
 {
-  "commit": "d8dfa27a1"
+  "commit": "300b7f4b7"
 }

package/dist/services/productivity-review.d.ts

@@ -61,11 +61,11 @@ export declare function productivityReviewService(db: Db, deps?: {
         now?: Date;
         thresholds?: Partial<ProductivityReviewThresholds>;
     }) => Promise<{
+        reason?: undefined;
         held: false;
         reviewIssueId?: undefined;
         reviewIdentifier?: undefined;
         trigger?: undefined;
-        reason?: undefined;
     } | {
         held: true;
         reviewIssueId: string;

package/dist/vendor/paperclip-runner/backends/harness-driver-backend.d.ts

@@ -0,0 +1,164 @@
+import type { HarnessDriver, HarnessSession } from "../contracts/harness-driver.js";
+import type { NativeSession, NativeSessionBackend, NativeSessionBackendDescriptor, NativeSessionRecoveryOptions, OpenNativeSessionInput, PersistedNativeSession } from "../contracts/native-session-backend.js";
+import type { PrpEvent, PrpTerminalState } from "../protocol/replay-contract.js";
+/**
+ * Package-owned adapter from the concrete harness driver contract to the
+ * normalized session boundary consumed by Paperclip. Provider mechanics stay
+ * behind HarnessDriver; the control plane sees only PRP events and results.
+ */
+export declare class HarnessDriverBackend implements NativeSessionBackend {
+    #private;
+    constructor(driver: HarnessDriver);
+    descriptor(): Promise<NativeSessionBackendDescriptor>;
+    openSession(input: OpenNativeSessionInput): Promise<NativeSession>;
+    recoverSession(snapshot: PersistedNativeSession, options: NativeSessionRecoveryOptions): Promise<{
+        recovered: boolean;
+        reason: string | undefined;
+        session?: undefined;
+    } | {
+        reason?: undefined;
+        recovered: boolean;
+        session: HarnessNativeSession;
+    }>;
+}
+declare class HarnessNativeSession implements NativeSession {
+    #private;
+    constructor(input: OpenNativeSessionInput, session: HarnessSession, terminal?: PrpTerminalState | null);
+    identity(): import("../index.js").NativeRunIdentity;
+    capabilities(): Promise<{
+        resume: boolean;
+        typedEvents: boolean;
+        steering: boolean;
+        interruption: boolean;
+        structuredResult: boolean;
+        read: boolean;
+        reconciliation: boolean;
+        usage: boolean;
+        runtimeRequestResolution: boolean;
+        runtimeRequestHandoff: boolean;
+        goals: boolean;
+        threadLineage: boolean;
+    }>;
+    attachRun(input: {
+        identity: OpenNativeSessionInput["identity"];
+    }): Promise<void>;
+    events(): AsyncIterable<PrpEvent>;
+    startTurn(input: Parameters<HarnessSession["startTurn"]>[0]): Promise<{
+        turnId: string;
+        effectiveCollaborationMode?: "default" | "plan";
+    }>;
+    steer(input: {
+        turnId: string;
+        message: {
+            role: "user";
+            text: string;
+        };
+        correlationId?: string;
+    }): Promise<void>;
+    interrupt(input: {
+        turnId?: string;
+        reason?: string;
+    }): Promise<void>;
+    cancel(input: {
+        reason: string;
+        signal: AbortSignal;
+    }): {
+        cleanup: Promise<void>;
+    };
+    resolveRuntimeRequest(input: {
+        requestId: string;
+        turnId: string;
+        resolution: Parameters<NonNullable<HarnessSession["resolveRuntimeRequest"]>>[0]["resolution"];
+    }): Promise<void>;
+    handoffRuntimeRequest(input: {
+        requestId: string;
+        turnId: string;
+        reason: "durable_handoff";
+        signal: AbortSignal;
+    }): import("../contracts/harness-driver.js").HarnessRuntimeRequestHandoff;
+    result(): Promise<{
+        result: {
+            [x: string]: unknown;
+            artifacts: {
+                [x: string]: unknown;
+                kind: string;
+                ref: string;
+                title?: string | undefined;
+            }[];
+            attentionRequests: {
+                [x: string]: unknown;
+                kind?: string | undefined;
+                ownerClass?: "agent" | "external_system" | "human" | undefined;
+                summary?: string | undefined;
+                targetAgentId?: string | undefined;
+            }[];
+            blocker?: {
+                [x: string]: unknown;
+                owner: {
+                    [x: string]: unknown;
+                    kind: "agent" | "external" | "system" | "user";
+                    name: string;
+                };
+                reasonCode: string;
+                scope: "current_track" | "task_wide";
+                unblockAction: string;
+            } | undefined;
+            completionClaim: {
+                [x: string]: unknown;
+                contractRevision: string;
+                criteria: {
+                    [x: string]: unknown;
+                    criterionId: string;
+                    evidenceRefs: string[];
+                    explanation?: string | undefined;
+                    status: "not_satisfied" | "satisfied" | "unknown";
+                }[];
+                objectiveSatisfied: boolean;
+                remainingWork: {
+                    [x: string]: unknown;
+                    blocksCompletion: boolean;
+                    description: string;
+                }[];
+            };
+            continuation?: {
+                [x: string]: unknown;
+                idempotencyKey: string;
+                kind: "delegated_issue" | "monitor" | "response_wake" | "retry" | "same_agent";
+                summary: string;
+            } | undefined;
+            evidence: {
+                [x: string]: unknown;
+            }[];
+            reportedWorkDisposition: "blocked" | "done" | "needs_review" | "yielded";
+            schema: "paperclip.run_result.v1";
+            summary: string;
+            verification: {
+                [x: string]: unknown;
+                artifactRef?: string | undefined;
+                commandOrCheck: string;
+                detail?: string | undefined;
+                reasonCode?: "budget_exhausted" | "credential_missing" | "dependency_missing" | "environment_unavailable" | "external_service_unavailable" | "other" | "permission_denied" | "policy_restricted" | "tool_unavailable" | undefined;
+                status: "failed" | "not_run" | "passed";
+            }[];
+        };
+        terminal: {
+            [x: string]: unknown;
+            reportedWorkDisposition: "blocked" | "done" | "needs_review" | "yielded";
+            runTerminalState: "cancelled" | "failed" | "succeeded";
+            schema: "paperclip.prp.terminal.v1";
+            statusDecisionId?: string | undefined;
+            stopReason?: undefined;
+            turnTerminalState: "cancelled" | "completed" | "failed" | "interrupted";
+            workAssessmentId?: string | undefined;
+        };
+        turnId: string;
+    } | null>;
+    snapshot(): Promise<PersistedNativeSession>;
+    usage(): Promise<Record<string, unknown> | null>;
+    close(input: {
+        reason: string;
+    }): Promise<void>;
+}
+export declare function createHarnessDriverBackend(driver: HarnessDriver): NativeSessionBackend;
+export {};
+//# sourceMappingURL=harness-driver-backend.d.ts.map

package/dist/vendor/paperclip-runner/backends/harness-driver-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-driver-backend.d.ts","sourceRoot":"","sources":["../../src/backends/harness-driver-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAGf,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAExC;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,oBAAoB;;IAG/D,YAAY,MAAM,EAAE,aAAa,EAEhC;IAEK,UAAU,IAAI,OAAO,CAAC,8BAA8B,CAAC,CAS1D;IAEK,WAAW,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBvE;IAEK,cAAc,CAClB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,4BAA4B;;;;;;;;OAqEtC;CACF;AAoBD,cAAM,oBAAqB,YAAW,aAAa;;IAMjD,YACE,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,EAKnC;IAED,QAAQ,4CAEP;IAEK,YAAY;;;;;;;;;;;;;OAejB;IAEK,SAAS,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtF;IAEM,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,CAsHvC;IAED,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;;;OAE1D;IAED,KAAK,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,iBAG/F;IAED,SAAS,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,iBAGpD;IAED,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE;QAUjD,OAAO;MAOV;IAED,qBAAqB,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;KAC/F,iBAKA;IAED,qBAAqB,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,iBAAiB,CAAC;QAC1B,MAAM,EAAE,WAAW,CAAC;KACrB,yEAKA;IAEK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAaX;IAEK,QAAQ,IAAI,OAAO,CAAC,sBAAsB,CAAC,CA8BhD;IAEK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAErD;IAED,KAAK,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,iBAE9B;CACF;AAQD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB,CAEtF"}

package/dist/vendor/paperclip-runner/backends/harness-driver-backend.js

@@ -0,0 +1,395 @@
+/**
+ * Package-owned adapter from the concrete harness driver contract to the
+ * normalized session boundary consumed by Paperclip. Provider mechanics stay
+ * behind HarnessDriver; the control plane sees only PRP events and results.
+ */
+export class HarnessDriverBackend {
+    #driver;
+    constructor(driver) {
+        this.#driver = driver;
+    }
+    async descriptor() {
+        const descriptor = await this.#driver.descriptor();
+        return {
+            kind: "runner",
+            name: descriptor.kind,
+            version: descriptor.version,
+            capabilities: structuredClone(descriptor.capabilities),
+            runtimeContextCapabilities: descriptor.runtimeContextCapabilities === undefined ? undefined : structuredClone(descriptor.runtimeContextCapabilities),
+        };
+    }
+    async openSession(input) {
+        const session = await this.#driver.openSession({
+            runId: input.identity.runId,
+            normalizedSessionId: input.identity.sessionId,
+            workingDirectory: input.workingDirectory ?? process.cwd(),
+            ...(input.signal === undefined ? {} : { signal: input.signal }),
+        });
+        try {
+            assertProviderSessionIdentity(session, (await this.#driver.descriptor()).kind, "session.open");
+        }
+        catch (error) {
+            await session.close({
+                reason: "provider session bootstrap returned an incomplete identity",
+                force: true,
+            }).catch(() => undefined);
+            throw error;
+        }
+        return new HarnessNativeSession(input, session);
+    }
+    async recoverSession(snapshot, options) {
+        if (this.#driver.recoverSession === undefined) {
+            return { recovered: false, reason: "driver does not support recovery" };
+        }
+        // `null` is a durable "no active turn" checkpoint. Only an omitted legacy
+        // field may use the compatibility fallback; nullish coalescing here would
+        // otherwise turn the most recent terminal turn back into an active one.
+        const activeTurnId = snapshot.activeTurnId === undefined
+            ? snapshot.terminalTurns?.at(-1)?.turnId ?? null
+            : snapshot.activeTurnId;
+        const persisted = {
+            driverKind: snapshot.driverKind ?? snapshot.backendKind,
+            driverSessionId: snapshot.sessionId,
+            providerSessionId: snapshot.providerSessionId,
+            ...(snapshot.providerIdentity === undefined
+                ? {}
+                : { providerIdentity: structuredClone(snapshot.providerIdentity) }),
+            ...(snapshot.providerRecoveryPolicy === undefined
+                ? {}
+                : { providerRecoveryPolicy: snapshot.providerRecoveryPolicy }),
+            runId: snapshot.identity.runId,
+            normalizedSessionId: snapshot.identity.sessionId,
+            activeTurnId,
+            lastSourceSequence: parseCursor(snapshot.cursor),
+            ...(snapshot.semanticResult === undefined || snapshot.semanticResult === null
+                ? {}
+                : {
+                    semanticResult: {
+                        result: snapshot.semanticResult,
+                        fingerprint: canonicalJson(snapshot.semanticResult),
+                        turnId: activeTurnId ?? snapshot.terminalTurns?.at(-1)?.turnId ?? "recovered",
+                    },
+                }),
+            terminalTurns: snapshot.terminalTurns ?? [],
+            pendingRuntimeRequests: snapshot.pendingRuntimeRequests ?? [],
+            lineage: snapshot.lineage ?? [],
+        };
+        const recoveryOptions = {
+            signal: options.signal,
+        };
+        const recovered = await this.#driver.recoverSession(persisted, recoveryOptions);
+        if (!recovered.recovered || recovered.session === undefined) {
+            return { recovered: false, reason: recovered.reason };
+        }
+        try {
+            assertProviderSessionIdentity(recovered.session, (await this.#driver.descriptor()).kind, "session.recover");
+        }
+        catch (error) {
+            await recovered.session.close({
+                reason: "provider session recovery returned an incomplete identity",
+                force: true,
+            }).catch(() => undefined);
+            throw error;
+        }
+        return {
+            recovered: true,
+            session: new HarnessNativeSession({ identity: snapshot.identity }, recovered.session, snapshot.terminal),
+        };
+    }
+}
+function assertProviderSessionIdentity(session, provider, stage) {
+    const ids = session.ids();
+    if (typeof ids.driverSessionId !== "string"
+        || ids.driverSessionId.trim().length === 0
+        || typeof ids.providerSessionId !== "string"
+        || ids.providerSessionId.trim().length === 0) {
+        throw new Error(`provider_initialize_protocol_error: provider=${provider} stage=${stage} missing durable provider session identity`);
+    }
+}
+class HarnessNativeSession {
+    #input;
+    #session;
+    #terminal = null;
+    #explicitlyCancelled = false;
+    constructor(input, session, terminal) {
+        this.#input = structuredClone(input);
+        this.#session = session;
+        this.#terminal = terminal === undefined ? null : structuredClone(terminal);
+    }
+    identity() {
+        return structuredClone(this.#input.identity);
+    }
+    async capabilities() {
+        return {
+            resume: true,
+            typedEvents: true,
+            steering: this.#session.steer !== undefined,
+            interruption: this.#session.interrupt !== undefined,
+            structuredResult: true,
+            read: this.#session.read !== undefined,
+            reconciliation: this.#session.reconcile !== undefined,
+            usage: this.#session.usage !== undefined,
+            runtimeRequestResolution: this.#session.resolveRuntimeRequest !== undefined,
+            runtimeRequestHandoff: this.#session.handoffRuntimeRequest !== undefined,
+            goals: this.#session.goal !== undefined,
+            threadLineage: this.#session.lineage !== undefined,
+        };
+    }
+    async attachRun(input) {
+        const currentIdentity = this.#input.identity;
+        if (input.identity.sessionId !== currentIdentity.sessionId
+            || input.identity.companyId !== currentIdentity.companyId
+            || input.identity.issueId !== currentIdentity.issueId
+            || input.identity.agentId !== currentIdentity.agentId) {
+            throw new Error("native_session_attach_binding_mismatch");
+        }
+        if (this.#session.attachRun === undefined) {
+            throw new Error("native_session_multi_run_unavailable");
+        }
+        await this.#session.attachRun({ runId: input.identity.runId });
+        this.#input = { ...this.#input, identity: structuredClone(input.identity) };
+        this.#terminal = null;
+        this.#explicitlyCancelled = false;
+    }
+    async *events() {
+        let sourceInstanceId = null;
+        let lastSourceSequence = 0;
+        let sawTerminal = false;
+        let synthesizedDurableWait = false;
+        let streamFailure = null;
+        const observedPendingInputs = new Map();
+        try {
+            for await (const event of this.#session.events()) {
+                sourceInstanceId = event.sourceInstanceId;
+                lastSourceSequence = Math.max(lastSourceSequence, event.sourceSeq);
+                if (event.eventType === "runtime_request.created") {
+                    const request = plainRecord(event.payload.request);
+                    if (request?.schema === "paperclip.runtime_request.v2"
+                        && request.type === "input"
+                        && typeof request.requestId === "string")
+                        observedPendingInputs.set(request.requestId, structuredClone(request));
+                }
+                else if (["runtime_request.resolved", "runtime_request.cancelled", "runtime_request.expired"].includes(event.eventType)) {
+                    const requestId = typeof event.payload.requestId === "string" ? event.payload.requestId : null;
+                    if (requestId)
+                        observedPendingInputs.delete(requestId);
+                }
+                if (event.eventType === "run.terminal") {
+                    sawTerminal = true;
+                    this.#terminal = structuredClone(event.payload);
+                }
+                else if (["turn.completed", "turn.failed", "turn.interrupted", "turn.cancelled"].includes(event.eventType)) {
+                    sawTerminal = true;
+                    const snapshot = await this.#session.snapshot();
+                    const disposition = snapshot.semanticResult?.result.reportedWorkDisposition ?? "yielded";
+                    this.#terminal = {
+                        schema: "paperclip.prp.terminal.v1",
+                        turnTerminalState: event.eventType === "turn.completed" ? "completed"
+                            : event.eventType === "turn.failed" ? "failed"
+                                : event.eventType === "turn.interrupted" ? "interrupted"
+                                    : "cancelled",
+                        runTerminalState: event.eventType === "turn.completed" ? "succeeded" : event.eventType === "turn.failed" ? "failed" : "cancelled",
+                        reportedWorkDisposition: disposition,
+                    };
+                }
+                yield structuredClone(event);
+            }
+        }
+        catch (error) {
+            streamFailure = error;
+        }
+        // The provider can disappear while its native RPC is awaiting the user.
+        // Emit one canonical terminal fact and replace the stream failure with a
+        // governed wait; the control plane can materialize the continuation without
+        // ever trying to replay the dead provider request.
+        if (!sawTerminal && !this.#explicitlyCancelled && sourceInstanceId) {
+            const snapshot = await this.#session.snapshot().catch(() => null);
+            let governedWaitTurnId;
+            for (const request of observedPendingInputs.values()) {
+                const sourceSeq = Math.max(lastSourceSequence, snapshot?.lastSourceSequence ?? 0) + 1;
+                lastSourceSequence = sourceSeq;
+                const requestId = String(request.requestId);
+                const turnId = typeof request.turnId === "string" ? request.turnId : undefined;
+                governedWaitTurnId ??= turnId;
+                const itemId = typeof request.itemId === "string" ? request.itemId : requestId;
+                yield {
+                    schema: "paperclip.prp.event.v1",
+                    sourceEventId: `${sourceInstanceId}:${this.#input.identity.runId}:${sourceSeq}`,
+                    sourceSeq,
+                    sourceInstanceId,
+                    sourceKind: "runner",
+                    runId: this.#input.identity.runId,
+                    normalizedSessionId: this.#input.identity.sessionId,
+                    ...(turnId ? { turnId } : {}),
+                    itemId,
+                    eventType: "runtime_request.expired",
+                    schemaVersion: 1,
+                    priority: 0,
+                    emittedAt: new Date().toISOString(),
+                    payload: {
+                        requestId,
+                        ...(turnId ? { turnId } : {}),
+                        itemId,
+                        requestKind: "runtime",
+                        reason: "provider_process_lost",
+                        replayAllowed: false,
+                        requestType: "input",
+                        ...(plainRecord(request.origin)?.adapter
+                            ? { adapter: plainRecord(request.origin)?.adapter }
+                            : {}),
+                        request: structuredClone(request),
+                    },
+                };
+            }
+            if (governedWaitTurnId) {
+                const sourceSeq = Math.max(lastSourceSequence, snapshot?.lastSourceSequence ?? 0) + 1;
+                lastSourceSequence = sourceSeq;
+                synthesizedDurableWait = true;
+                sawTerminal = true;
+                this.#terminal = {
+                    schema: "paperclip.prp.terminal.v1",
+                    turnTerminalState: "interrupted",
+                    runTerminalState: "cancelled",
+                    reportedWorkDisposition: "yielded",
+                };
+                yield {
+                    schema: "paperclip.prp.event.v1",
+                    sourceEventId: `${sourceInstanceId}:${this.#input.identity.runId}:${sourceSeq}`,
+                    sourceSeq,
+                    sourceInstanceId,
+                    sourceKind: "runner",
+                    runId: this.#input.identity.runId,
+                    normalizedSessionId: this.#input.identity.sessionId,
+                    turnId: governedWaitTurnId,
+                    eventType: "turn.interrupted",
+                    schemaVersion: 1,
+                    priority: 0,
+                    emittedAt: new Date().toISOString(),
+                    payload: { status: "interrupted", reason: "provider_process_lost" },
+                };
+            }
+        }
+        if (streamFailure && !synthesizedDurableWait)
+            throw streamFailure;
+    }
+    startTurn(input) {
+        return this.#session.startTurn(input);
+    }
+    steer(input) {
+        if (this.#session.steer === undefined)
+            throw new Error("steering is unavailable");
+        return this.#session.steer(input);
+    }
+    interrupt(input) {
+        if (this.#session.interrupt === undefined)
+            throw new Error("interruption is unavailable");
+        return this.#session.interrupt(input);
+    }
+    cancel(input) {
+        if (input.signal.aborted) {
+            throw input.signal.reason ?? new Error("native session cancellation aborted");
+        }
+        // This flag is the adapter's synchronous publication boundary. Provider
+        // interruption happens afterward as passive cleanup, so a slow or broken
+        // transport cannot synthesize or publish new accepted output for the turn.
+        this.#explicitlyCancelled = true;
+        const interrupt = this.#session.interrupt;
+        return {
+            cleanup: interrupt === undefined
+                ? Promise.resolve()
+                : Promise.resolve().then(() => interrupt.call(this.#session, {
+                    reason: input.reason,
+                    signal: input.signal,
+                })),
+        };
+    }
+    resolveRuntimeRequest(input) {
+        if (this.#session.resolveRuntimeRequest === undefined) {
+            throw new Error("native_runtime_request_resolution_unavailable");
+        }
+        return this.#session.resolveRuntimeRequest(input);
+    }
+    handoffRuntimeRequest(input) {
+        if (this.#session.handoffRuntimeRequest === undefined) {
+            throw new Error("native_runtime_request_handoff_unavailable");
+        }
+        return this.#session.handoffRuntimeRequest(input);
+    }
+    async result() {
+        const snapshot = await this.#session.snapshot();
+        if (snapshot.semanticResult === undefined || snapshot.semanticResult === null) {
+            return null;
+        }
+        if (this.#terminal === null) {
+            return null;
+        }
+        return {
+            result: structuredClone(snapshot.semanticResult.result),
+            terminal: structuredClone(this.#terminal),
+            turnId: snapshot.semanticResult.turnId,
+        };
+    }
+    async snapshot() {
+        const snapshot = await this.#session.snapshot();
+        return {
+            backendKind: "runner",
+            driverKind: snapshot.driverKind,
+            sessionId: snapshot.driverSessionId,
+            identity: structuredClone(this.#input.identity),
+            providerSessionId: snapshot.providerSessionId,
+            ...(snapshot.providerIdentity === undefined
+                ? {}
+                : { providerIdentity: structuredClone(snapshot.providerIdentity) }),
+            ...(snapshot.providerRecoveryPolicy === undefined
+                ? {}
+                : { providerRecoveryPolicy: snapshot.providerRecoveryPolicy }),
+            cursor: snapshot.lastSourceSequence === undefined
+                ? null
+                : String(snapshot.lastSourceSequence),
+            semanticResult: snapshot.semanticResult?.result ?? null,
+            terminal: this.#terminal,
+            // Harness snapshots use an explicit null to record a settled turn. Keep
+            // the semantic-result fallback solely for legacy snapshots that omitted
+            // activeTurnId, or a later recovery can replay the terminal turn.
+            activeTurnId: snapshot.activeTurnId === undefined
+                ? snapshot.semanticResult?.turnId ?? null
+                : snapshot.activeTurnId,
+            terminalTurns: snapshot.terminalTurns ?? [],
+            pendingRuntimeRequests: snapshot.pendingRuntimeRequests ?? [],
+            lineage: snapshot.lineage ?? [],
+        };
+    }
+    async usage() {
+        return this.#session.usage?.() ?? null;
+    }
+    close(input) {
+        return this.#session.close(input);
+    }
+}
+function plainRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+export function createHarnessDriverBackend(driver) {
+    return new HarnessDriverBackend(driver);
+}
+function parseCursor(cursor) {
+    if (cursor === undefined || cursor === null || cursor === "")
+        return undefined;
+    const parsed = Number(cursor);
+    return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : undefined;
+}
+function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    if (typeof value === "object" && value !== null) {
+        const record = value;
+        return `{${Object.keys(record)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "undefined";
+}
+//# sourceMappingURL=harness-driver-backend.js.map

package/dist/vendor/paperclip-runner/backends/harness-driver-backend.js.map

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

package/dist/vendor/paperclip-runner/backends/runtime-context.d.ts

@@ -0,0 +1,4 @@
+import type { NativeExecutionInput } from "../contracts/native-execution.js";
+export declare function nativeSystemInstructions(input: NativeExecutionInput): string;
+export declare function nativeTaskConstraints(input: NativeExecutionInput): string[];
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/vendor/paperclip-runner/backends/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/backends/runtime-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAkB5E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAe3E"}

package/dist/vendor/paperclip-runner/backends/runtime-context.js

@@ -0,0 +1,35 @@
+import { readFileSync, realpathSync } from "node:fs";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { CODEX_SKILLLESS_BASE_INSTRUCTIONS } from "../contracts/codex.js";
+import { composeNativeSystemInstructions } from "../contracts/runtime-context.js";
+export function nativeSystemInstructions(input) {
+    if (!("runtimeContext" in input))
+        return CODEX_SKILLLESS_BASE_INSTRUCTIONS;
+    const configuredRoot = resolve(input.runtimeContext.instructions.bundle.rootPath);
+    const bundleRoot = realpathSync(configuredRoot);
+    const entryPath = realpathSync(resolve(configuredRoot, input.runtimeContext.instructions.entryPath));
+    const pathFromRoot = relative(bundleRoot, entryPath);
+    if (pathFromRoot === ".."
+        || pathFromRoot.startsWith(`..${sep}`)
+        || isAbsolute(pathFromRoot)) {
+        throw new Error("native_runtime_context_entry_outside_bundle");
+    }
+    const entry = readFileSync(entryPath, "utf8");
+    return composeNativeSystemInstructions(input.runtimeContext, entry);
+}
+export function nativeTaskConstraints(input) {
+    const finalResponseConstraint = "Write the complete user-facing final response exactly once before invoking paperclip_finish or paperclip_block. Treat that semantic completion tool as the last action and do not emit a trailing acknowledgement.";
+    if (!("runtimeContext" in input)) {
+        return [
+            "Do not discover or invoke skills.",
+            "Do not call a control-plane API.",
+            finalResponseConstraint,
+        ];
+    }
+    return [
+        "Use only the assigned skills and provider-native tools.",
+        "Use Paperclip semantic tools for coordination and finalization.",
+        finalResponseConstraint,
+    ];
+}
+//# sourceMappingURL=runtime-context.js.map

package/dist/vendor/paperclip-runner/backends/runtime-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.js","sourceRoot":"","sources":["../../src/backends/runtime-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAElF,MAAM,UAAU,wBAAwB,CAAC,KAA2B;IAClE,IAAI,CAAC,CAAC,gBAAgB,IAAI,KAAK,CAAC;QAAE,OAAO,iCAAiC,CAAC;IAC3E,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CACpC,cAAc,EACd,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,CAC5C,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACrD,IACE,YAAY,KAAK,IAAI;WAClB,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;WACnC,UAAU,CAAC,YAAY,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,+BAA+B,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,MAAM,uBAAuB,GAC3B,oNAAoN,CAAC;IACvN,IAAI,CAAC,CAAC,gBAAgB,IAAI,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,mCAAmC;YACnC,kCAAkC;YAClC,uBAAuB;SACxB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,yDAAyD;QACzD,iEAAiE;QACjE,uBAAuB;KACxB,CAAC;AACJ,CAAC"}