@claxedo/agent-runtime-contract 0.8.0 → 0.10.1

package/dist/harnesses.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Where a harness's session runs on a cloud workspace. A `session-host`
+ * harness runs in the session's own Durable Object, which holds the owner's
+ * credential itself; a `workspace-runtime` harness runs inside the sandbox,
+ * which never holds a secret and reaches the vendor through a placeholder.
+ * The control plane places a session by this when it reserves it, and the
+ * sandbox runtime refuses to host a `session-host` harness, so neither side
+ * can run a harness where its credential cannot follow.
+ */
+export type CloudHarnessHost = "session-host" | "workspace-runtime";
 export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
     readonly key: "claude";
     readonly id: "claude";
@@ -5,6 +15,7 @@ export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
     readonly label: "Claude";
     readonly authEnv: "ANTHROPIC_API_KEY";
     readonly authSlot: "anthropic";
+    readonly cloudHost: "workspace-runtime";
 }, {
     readonly key: "codex";
     readonly id: "codex";
@@ -12,6 +23,7 @@ export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
     readonly label: "Codex";
     readonly authEnv: "OPENAI_API_KEY";
     readonly authSlot: "openai";
+    readonly cloudHost: "workspace-runtime";
 }, {
     readonly key: "cursor";
     readonly id: "cursor";
@@ -19,6 +31,7 @@ export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
     readonly label: "Cursor";
     readonly authEnv: "CURSOR_API_KEY";
     readonly authSlot: "cursor";
+    readonly cloudHost: "workspace-runtime";
 }, {
     readonly key: "pi";
     readonly id: "pi";
@@ -26,6 +39,7 @@ export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
     readonly label: "Pi";
     readonly authEnv: null;
     readonly authSlot: null;
+    readonly cloudHost: "session-host";
 }, {
     readonly key: "opencode";
     readonly id: "opencode";
@@ -33,7 +47,10 @@ export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
     readonly label: "OpenCode";
     readonly authEnv: null;
     readonly authSlot: null;
+    readonly cloudHost: "workspace-runtime";
 }];
+/** A connection's agent runs inside the sandbox, as does any harness the table does not name. */
+export declare function cloudHarnessHost(harnessId: string): CloudHarnessHost;
 export declare const AGENT_HARNESS_IDS: readonly ["claude", "codex", "cursor", "pi", "opencode"];
 export declare const AGENT_HARNESS_ACCESSES: readonly ["connection", "native"];
 export declare const AGENT_HARNESS_KEYS: ("claude" | "codex" | "cursor" | "opencode" | "pi")[];
@@ -41,7 +58,7 @@ export type AgentHarnessId = (typeof AGENT_HARNESS_IDS)[number];
 export type AgentHarnessAccess = (typeof AGENT_HARNESS_ACCESSES)[number];
 export type AgentHarnessKey = (typeof AGENT_HARNESS_KEYS)[number];
 export type NativeHarnessId = AgentHarnessId;
-/** The native harnesses driven through `SdkRuntimeDriver`; `opencode` is composed by `@claxedo/workspace-runtime/opencode` instead. */
+/** The native harnesses driven through `SdkRuntimeDriver`; `opencode` is composed by `@claxedo/harness/opencode-sdk` instead. */
 export type NativeSdkHarnessId = Extract<AgentHarnessId, "claude" | "codex" | "cursor" | "pi">;
 /**
  * A harness identity's id field: one of the finite built-in ids, or a
@@ -72,6 +89,7 @@ export declare function harnessKey(input: {
     id: SessionHarnessId;
     access: AgentHarnessAccess;
 }): string | undefined;
+export declare function sameSessionHarness(a: SessionHarness, b: SessionHarness): boolean;
 export declare function normalizeHarnessIdentity(input: unknown): {
     id: SessionHarnessId;
     access: AgentHarnessAccess;

package/dist/ids.d.ts

@@ -0,0 +1,4 @@
+export type Clock = () => number;
+export type CreateId = (prefix?: string) => string;
+export declare const systemClock: Clock;
+export declare function createSequentialIdFactory(seed?: number): CreateId;

package/dist/index.d.ts

@@ -1,19 +1,64 @@
-export declare const AGENT_RUNTIME_CONTRACT_VERSION = 1;
+export declare const AGENT_RUNTIME_CONTRACT_VERSION = 2;
 export * from "./availability";
 export * from "./capabilities";
 export * from "./claims";
 export * from "./connections";
 export * from "./content";
+export * from "./transcript-notice";
 export * from "./credential-broker-errors";
+export * from "./elicitation";
+export * from "./elicitation-validation";
 export * from "./errors";
 export * from "./events";
 export * from "./files";
+export * from "./goals";
 export * from "./harness-effort";
+export * from "./harness-permission-modes";
 export * from "./harness-table";
 export * from "./harnesses";
+export * from "./permissions";
+export * from "./custom-provider-headers";
+export * from "./pi-providers";
+export * from "./vendor-providers";
+export * from "./prompt-title";
+export * from "./provider-projection";
 export * from "./question-answers";
+export { type RecoveryGeneration, EXECUTION_FACTS, CLEANUP_FACTS, PERSISTENCE_FACTS, type ExecutionFact, type CleanupFact, type PersistenceFact, type RecoveryFactEvidence, type RecoveryFacts, parseRecoveryFacts, } from "./recovery/facts";
+export { DAEMON_OWNERSHIP_SNAPSHOT_FILE, daemonOwnershipSnapshotPath, type DaemonOwnershipRow, isDaemonOwnershipSnapshot, } from "./daemon-ownership-snapshot";
+export { RECOVERY_TARGET_SCOPES, type RecoveryTargetScope, type RecoveryTurnTarget, type RecoverySessionTarget, type RecoveryHarnessTarget, type RecoveryMachineTarget, type RecoveryTarget, normalizeRecoveryTarget, recoveryTargetsMatch, parseRecoveryTarget, recoveryScopeKey, recoveryTargetSessionId, } from "./recovery/targets";
+export { RECOVERY_ACTIONS, type RecoveryAction, RECOVERY_MUTATING_ACTIONS, type RecoveryMutatingAction, RECOVERY_READ_ACTIONS, type RecoveryReadAction, isMutatingRecoveryAction, RECOVERY_ACTION_SCOPES, } from "./recovery/actions";
+export { releasedDrainOperationId, type RecoveryRequest, type RecoveryIntent, normalizeRecoveryIntent, recoveryIntentEquals, parseRecoveryRequest, } from "./recovery/requests";
+export { RECOVERY_OPERATION_STATES, type RecoveryOperationState, RECOVERY_PHASES, type RecoveryPhase, type RecoveryReceipt, type RecoveryNextAction, RECOVERY_ERROR_CODES, type RecoveryErrorCode, type RecoveryError, type RecoveryOperation, RECOVERY_OPERATION_RETENTION_MS, finalizeRecoveryOperation, parseRecoveryError, parseRecoveryOperation, } from "./recovery/operations";
+export { type RecoveryScopePreview, type RecoveryRefusal, type RecoveryOutcome, parseRecoveryRefusal, serializeRecoveryOutcome, parseRecoveryOutcome, isRecoveryOutcome, } from "./recovery/outcomes";
+export { type RecoveryBudgets, DEFAULT_RECOVERY_BUDGETS, capChildBudget, } from "./recovery/budgets";
+export { recoveryPostconditionHolds, turnStopped, } from "./recovery/postconditions";
+export { RECOVERY_PAYLOAD_PREFIX, readRecoveryPayloadLine, } from "./recovery/payload-line";
+export { RECOVERY_CONTRACT_ERROR_CODES, type RecoveryContractErrorCode, RecoveryContractError, } from "./recovery/validation";
 export * from "./session-group";
+export * from "./session-handoff";
+export * from "./session-titles";
 export * from "./sessions";
+export * from "./subagents";
+export * from "./background-work";
+export * from "./tool-header";
+export * from "./mcp-app";
+export * from "./turn-outline";
+export * from "./turn-page";
 export * from "./tool-names";
+export * from "./turn-account";
+export * from "./turn-error-classes";
+export * from "./first-turn-error";
+export * from "./vendor-body";
+export * from "./message-page";
 export * from "./usage-windows";
 export * from "./values";
+export * from "./agent-runtime-event";
+export * from "./diagnostics";
+export * from "./event-cursor";
+export * from "./d1-bookmarks";
+export * from "./ids";
+export * from "./raw-harness-event";
+export * from "./runtime-content";
+export * from "./stream-heartbeat";
+export * from "./turn-message-ids";
+export * from "./usage-streams";