@openscout/protocol 0.2.63 → 0.2.82

package/dist/common.d.ts

@@ -1,15 +1,16 @@
 export type ScoutId = string;
-export type ActorKind = "person" | "helper" | "agent" | "system" | "bridge" | "device";
-export type AgentState = "offline" | "idle" | "active" | "waiting";
+export type ActorKind = "person" | "helper" | "agent" | "session" | "system" | "bridge" | "device";
+export type AgentState = "registered" | "attaching" | "waking" | "offline" | "idle" | "active" | "waiting" | "working" | "unreachable" | "failed" | "superseded" | "stopped";
 export type VisibilityScope = "private" | "workspace" | "public" | "system";
 export type DeliveryStatus = "accepted" | "peer_acked" | "running" | "completed" | "deferred" | "failed" | "cancelled" | "pending" | "leased" | "sent" | "acknowledged";
 export type DeliveryFailureReason = "peer_unreachable" | "peer_rejected" | "agent_offline" | "timeout" | "harness_error" | "dispatch" | "cancelled";
 export type DeliveryPolicy = "best_effort" | "must_ack" | "durable" | "ephemeral";
 export type DeliveryTargetKind = "participant" | "agent" | "bridge" | "device" | "voice_session" | "webhook";
-export type DeliveryTransport = "local_socket" | "websocket" | "pairing_bridge" | "peer_broker" | "http" | "webhook" | "telegram" | "discord" | "sms" | "email" | "tts" | "native_voice" | "claude_stream_json" | "codex_app_server" | "codex_exec" | "claude_resume" | "tmux";
+export type DeliveryTransport = "local_socket" | "websocket" | "pairing_bridge" | "peer_broker" | "http" | "webhook" | "telegram" | "discord" | "sms" | "email" | "tts" | "native_voice" | "claude_channel" | "claude_stream_json" | "codex_app_server" | "codex_exec" | "claude_resume" | "pi_rpc" | "grok_acp" | "kimi_acp" | "cursor_acp" | "opencode_acp" | "tmux" | "cursor_exec" | "cursor_cli_text" | "cursor_cli_stream_json" | "cursor_sdk_local";
 export type DeliveryReason = "conversation_visibility" | "direct_message" | "mention" | "thread_reply" | "invocation" | "bridge_outbound" | "speech";
 export type AdvertiseScope = "local" | "mesh";
 export type ShareMode = "local" | "summary" | "shared";
 export interface MetadataMap {
     [key: string]: unknown;
 }
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,SAAS,GACT,MAAM,GACN,QAAQ,GACR,SAAS,GACT,SAAS,GACT,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5E,MAAM,MAAM,cAAc,GAEtB,UAAU,GACV,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,WAAW,GAEX,SAAS,GACT,QAAQ,GACR,MAAM,GACN,cAAc,CAAC;AAEnB,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,SAAS,GACT,eAAe,GACf,UAAU,GACV,WAAW,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAElF,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,SAAS,CAAC;AAEd,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,aAAa,GACb,MAAM,GACN,SAAS,GACT,UAAU,GACV,SAAS,GACT,KAAK,GACL,OAAO,GACP,KAAK,GACL,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,QAAQ,GACR,UAAU,GACV,UAAU,GACV,YAAY,GACZ,cAAc,GACd,MAAM,GACN,aAAa,GACb,iBAAiB,GACjB,wBAAwB,GACxB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,cAAc,GACtB,yBAAyB,GACzB,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/conversations.d.ts

@@ -22,3 +22,4 @@ export interface ConversationBinding {
     externalThreadId?: string;
     metadata?: MetadataMap;
 }
+//# sourceMappingURL=conversations.d.ts.map

package/dist/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,SAAS,EACT,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;IAC/C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB"}

package/dist/cursor-transport.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Local Cursor harness transport modes under evaluation.
+ * See docs/eng/sco-047-cursor-transport-spike.md.
+ */
+export declare const CURSOR_LOCAL_TRANSPORT_MODES: readonly ["cursor_cli_text", "cursor_cli_stream_json", "cursor_sdk_local", "cursor_sdk_local_no_key"];
+export type CursorLocalTransportMode = typeof CURSOR_LOCAL_TRANSPORT_MODES[number];
+export type CursorTransportAuthSource = "none" | "env" | "cursor_api_key_file" | "cli_flag" | "sdk_option";
+export type CursorTransportSpikeResult = {
+    mode: CursorLocalTransportMode;
+    ok: boolean;
+    durationMs: number;
+    authSource: CursorTransportAuthSource;
+    sessionId?: string;
+    agentId?: string;
+    runId?: string;
+    outputText?: string;
+    eventCount?: number;
+    errorCode?: string;
+    errorMessage?: string;
+    notes?: string[];
+};
+//# sourceMappingURL=cursor-transport.d.ts.map

package/dist/cursor-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-transport.d.ts","sourceRoot":"","sources":["../src/cursor-transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,uGAK/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAEnF,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,KAAK,GACL,qBAAqB,GACrB,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC"}

package/dist/cursor-transport.js

@@ -0,0 +1,10 @@
+/**
+ * Local Cursor harness transport modes under evaluation.
+ * See docs/eng/sco-047-cursor-transport-spike.md.
+ */
+export const CURSOR_LOCAL_TRANSPORT_MODES = [
+    "cursor_cli_text",
+    "cursor_cli_stream_json",
+    "cursor_sdk_local",
+    "cursor_sdk_local_no_key",
+];

package/dist/debug-attach.d.ts

@@ -0,0 +1,29 @@
+import type { ScoutId } from "./common.js";
+export interface AgentEndpointDebugTransport {
+    kind: "tmux";
+    state: "ready" | "starting" | "missing" | "stale" | "error";
+    sessionName: string;
+    paneTarget?: string;
+    cwd?: string;
+    attachable: boolean;
+    multiAttach: boolean;
+    lastProbeAt: number;
+    lastAttachAt?: number;
+    lastDetachAt?: number;
+    activeClients?: number;
+    detail?: string;
+}
+export interface DebugTmuxAttachPlan {
+    endpointId: ScoutId;
+    transport: "tmux";
+    sessionName: string;
+    paneTarget?: string;
+    command?: ["tmux", "attach-session", "-t", string];
+    terminalRelay?: {
+        backend: "tmux";
+        tmuxSession: string;
+    };
+}
+export declare function isDebugTransportAttachable(transport: Pick<AgentEndpointDebugTransport, "state" | "attachable"> | null | undefined): boolean;
+export declare function buildTmuxAttachCommand(sessionName: string): ["tmux", "attach-session", "-t", string];
+//# sourceMappingURL=debug-attach.d.ts.map

package/dist/debug-attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-attach.d.ts","sourceRoot":"","sources":["../src/debug-attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,IAAI,CAAC,2BAA2B,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,GACtF,OAAO,CAET;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,CAEpG"}

package/dist/debug-attach.js

@@ -0,0 +1,6 @@
+export function isDebugTransportAttachable(transport) {
+    return Boolean(transport?.attachable && transport.state === "ready");
+}
+export function buildTmuxAttachCommand(sessionName) {
+    return ["tmux", "attach-session", "-t", sessionName];
+}

package/dist/deliveries.d.ts

@@ -1,4 +1,17 @@
-import type { DeliveryPolicy, DeliveryReason, DeliveryStatus, DeliveryTargetKind, DeliveryTransport, MetadataMap, ScoutId } from "./common.js";
+import type { DeliveryFailureReason, DeliveryPolicy, DeliveryReason, DeliveryStatus, DeliveryTargetKind, DeliveryTransport, MetadataMap, ScoutId } from "./common.js";
+/**
+ * Delivery metadata carries a small set of well-known keys alongside arbitrary
+ * extension data. The typed fields document the keys the runtime reads on the
+ * retry path; the {@link MetadataMap} index signature keeps the bag open for
+ * transport-specific extras. The wire/persistence shape is unchanged — these
+ * were always plain metadata keys, now they are typed.
+ */
+export interface DeliveryMetadata extends MetadataMap {
+    /** Epoch ms of the next retry attempt. Set while `status` is `"deferred"`. */
+    nextAttemptAt?: number;
+    /** Classified failure reason. Set when `status` is `"failed"`. */
+    failureReason?: DeliveryFailureReason;
+}
 export interface DeliveryTarget {
     id: ScoutId;
     kind: DeliveryTargetKind;
@@ -21,7 +34,7 @@ export interface DeliveryIntent {
     bindingId?: ScoutId;
     leaseOwner?: string;
     leaseExpiresAt?: number;
-    metadata?: MetadataMap;
+    metadata?: DeliveryMetadata;
 }
 export interface DeliveryAttempt {
     id: ScoutId;
@@ -33,3 +46,4 @@ export interface DeliveryAttempt {
     createdAt: number;
     metadata?: MetadataMap;
 }
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../src/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,OAAO,EACR,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB"}

package/dist/durable-actions.d.ts

@@ -0,0 +1,94 @@
+import type { MetadataMap, ScoutId } from "./common.js";
+export type DurableActionKind = "ask" | "message_delivery" | "checkback";
+export type DurableCheckbackMode = "notify" | "scoutbot" | "agent" | "routine";
+export interface DurableCheckbackMetadata extends MetadataMap {
+    dueAt: number;
+    mode?: DurableCheckbackMode;
+    title?: string;
+    body?: string;
+    prompt?: string;
+    ownerId?: ScoutId;
+    conversationId?: ScoutId;
+    recordId?: ScoutId;
+    route?: unknown;
+    recurrence?: unknown;
+}
+export type DurableActionState = "pending" | "leased" | "running" | "waiting" | "completed" | "failed" | "cancelled";
+export type DurableAttemptState = "pending" | "running" | "completed" | "failed" | "cancelled";
+export interface DurableAction {
+    id: ScoutId;
+    kind: DurableActionKind;
+    subjectId: ScoutId;
+    authorityCellId: ScoutId;
+    state: DurableActionState;
+    idempotencyKey?: string;
+    leaseOwner?: string;
+    leaseGeneration: number;
+    leaseExpiresAt?: number;
+    createdAt: number;
+    updatedAt: number;
+    metadata?: MetadataMap;
+}
+export interface DurableAttempt {
+    id: ScoutId;
+    actionId: ScoutId;
+    attempt: number;
+    state: DurableAttemptState;
+    leaseGeneration: number;
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+    metadata?: MetadataMap;
+}
+export interface DurableCheckpoint {
+    actionId: ScoutId;
+    name: string;
+    payload?: unknown;
+    ownerAttemptId?: ScoutId;
+    leaseOwner?: string;
+    leaseGeneration?: number;
+    createdAt: number;
+}
+export interface DurableSignal {
+    actionId: ScoutId;
+    name: string;
+    payload?: unknown;
+    leaseOwner?: string;
+    leaseGeneration?: number;
+    emittedAt: number;
+}
+export interface DurableActionCreateInput {
+    id: ScoutId;
+    kind: DurableActionKind;
+    subjectId: ScoutId;
+    authorityCellId: ScoutId;
+    idempotencyKey?: string;
+    createdAt: number;
+    metadata?: MetadataMap;
+}
+export interface DurableActionClaimInput {
+    actionId: ScoutId;
+    owner: string;
+    leaseMs: number;
+    claimedAt: number;
+}
+export interface DurableActionHeartbeatInput {
+    actionId: ScoutId;
+    owner: string;
+    generation: number;
+    leaseMs: number;
+    heartbeatAt: number;
+}
+export interface DurableActionLease {
+    owner: string;
+    generation: number;
+    expiresAt: number;
+}
+export interface DurableActionCommandReceipt {
+    accepted: boolean;
+    duplicate?: boolean;
+    action: DurableAction;
+    lease?: DurableActionLease;
+    events: string[];
+}
+//# sourceMappingURL=durable-actions.d.ts.map

package/dist/durable-actions.d.ts.map

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

package/dist/durable-actions.js

@@ -0,0 +1 @@
+export {};

package/dist/events.d.ts

@@ -4,15 +4,24 @@ import type { ConversationBinding, ConversationDefinition } from "./conversation
 import type { DeliveryAttempt, DeliveryIntent } from "./deliveries.js";
 import type { FlightRecord, InvocationRequest } from "./invocations.js";
 import type { MessageRecord } from "./messages.js";
+import type { ConversationReadCursor } from "./read-receipts.js";
 import type { AgentDefinition, AgentEndpoint, ActorIdentity } from "./actors.js";
 import type { CollaborationEvent, CollaborationRecord } from "./collaboration.js";
 import type { ScoutDispatchRecord } from "./scout-dispatch.js";
+export declare const OPENSCOUT_CONTROL_EVENT_VERSION: 1;
 export interface ControlEventBase<K extends string, P> {
     id: ScoutId;
     kind: K;
     ts: number;
     actorId: ScoutId;
     nodeId?: ScoutId;
+    /**
+     * Schema version of the control-event envelope. Optional by design: legacy
+     * persisted events pre-date the version field and carry no `v`, yet must
+     * still satisfy this type so they can be replayed. After
+     * {@link normalizeControlEvent}, `v` is always present.
+     */
+    readonly v?: typeof OPENSCOUT_CONTROL_EVENT_VERSION;
     payload: P;
 }
 export type NodeUpsertedEvent = ControlEventBase<"node.upserted", {
@@ -39,6 +48,9 @@ export type BindingUpsertedEvent = ControlEventBase<"binding.upserted", {
 export type MessagePostedEvent = ControlEventBase<"message.posted", {
     message: MessageRecord;
 }>;
+export type ConversationReadCursorUpdatedEvent = ControlEventBase<"conversation.read_cursor.updated", {
+    cursor: ConversationReadCursor;
+}>;
 export type InvocationRequestedEvent = ControlEventBase<"invocation.requested", {
     invocation: InvocationRequest;
 }>;
@@ -64,4 +76,18 @@ export type CollaborationEventAppendedEvent = ControlEventBase<"collaboration.ev
 export type ScoutDispatchedEvent = ControlEventBase<"scout.dispatched", {
     dispatch: ScoutDispatchRecord;
 }>;
-export type ControlEvent = NodeUpsertedEvent | ActorRegisteredEvent | AgentRegisteredEvent | AgentEndpointUpsertedEvent | AgentEndpointDeletedEvent | ConversationUpsertedEvent | BindingUpsertedEvent | MessagePostedEvent | InvocationRequestedEvent | FlightUpdatedEvent | DeliveryPlannedEvent | DeliveryAttemptedEvent | DeliveryStateChangedEvent | CollaborationUpsertedEvent | CollaborationEventAppendedEvent | ScoutDispatchedEvent;
+export type ControlEvent = NodeUpsertedEvent | ActorRegisteredEvent | AgentRegisteredEvent | AgentEndpointUpsertedEvent | AgentEndpointDeletedEvent | ConversationUpsertedEvent | BindingUpsertedEvent | MessagePostedEvent | ConversationReadCursorUpdatedEvent | InvocationRequestedEvent | FlightUpdatedEvent | DeliveryPlannedEvent | DeliveryAttemptedEvent | DeliveryStateChangedEvent | CollaborationUpsertedEvent | CollaborationEventAppendedEvent | ScoutDispatchedEvent;
+/**
+ * Stamp the current envelope version onto a control event when it is missing.
+ *
+ * The `v` field is optional on {@link ControlEventBase} so that legacy events
+ * persisted before versioning existed still satisfy the type (the package
+ * deliberately preserves legacy shapes for replay). This helper is the bridge:
+ * use it on the stamp-on-write path so newly produced events carry `v`, and on
+ * the normalize-on-read path so replayed legacy events are upgraded to the
+ * current version. It is a pure function — the input is never mutated.
+ */
+export declare function normalizeControlEvent<E extends ControlEvent>(event: E): E & {
+    v: typeof OPENSCOUT_CONTROL_EVENT_VERSION;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -1 +1,14 @@
-export {};
+export const OPENSCOUT_CONTROL_EVENT_VERSION = 1;
+/**
+ * Stamp the current envelope version onto a control event when it is missing.
+ *
+ * The `v` field is optional on {@link ControlEventBase} so that legacy events
+ * persisted before versioning existed still satisfy the type (the package
+ * deliberately preserves legacy shapes for replay). This helper is the bridge:
+ * use it on the stamp-on-write path so newly produced events carry `v`, and on
+ * the normalize-on-read path so replayed legacy events are upgraded to the
+ * current version. It is a pure function — the input is never mutated.
+ */
+export function normalizeControlEvent(event) {
+    return { ...event, v: event.v ?? OPENSCOUT_CONTROL_EVENT_VERSION };
+}

package/dist/harness-feature-support.d.ts

@@ -0,0 +1,76 @@
+export type HarnessSupportLevel = "yes" | "partial" | "no" | "unknown";
+export type HarnessFeatureDowngrade = "native" | "embedded" | "reference_text" | "prompt_only" | "debug_only" | "unsupported";
+export interface HarnessFeatureEvidence {
+    kind: "adapter_spec" | "catalog" | "runtime_check" | "manual" | "upstream";
+    ref: string;
+}
+export interface HarnessFeatureSupport {
+    level: HarnessSupportLevel;
+    reason?: string;
+    evidence?: HarnessFeatureEvidence[];
+    downgrade?: HarnessFeatureDowngrade;
+}
+export interface HarnessFeatureSupportMap {
+    prompts?: {
+        systemPrompt?: HarnessFeatureSupport;
+        agentInstructions?: HarnessFeatureSupport;
+        promptFiles?: HarnessFeatureSupport;
+        images?: HarnessFeatureSupport;
+    };
+    session?: {
+        start?: HarnessFeatureSupport;
+        resume?: HarnessFeatureSupport;
+        interrupt?: HarnessFeatureSupport;
+        shutdown?: HarnessFeatureSupport;
+        concurrentTurns?: HarnessFeatureSupport;
+        traceObserve?: HarnessFeatureSupport;
+        fork?: HarnessFeatureSupport;
+        nativeThreadClone?: HarnessFeatureSupport;
+        steer?: HarnessFeatureSupport;
+        followUps?: HarnessFeatureSupport;
+    };
+    interaction?: {
+        questions?: HarnessFeatureSupport;
+        approvals?: HarnessFeatureSupport;
+        serverRequests?: HarnessFeatureSupport;
+        toolSuspensions?: HarnessFeatureSupport;
+        planApproval?: HarnessFeatureSupport;
+    };
+    tools?: {
+        command?: HarnessFeatureSupport;
+        fileChange?: HarnessFeatureSupport;
+        subagent?: HarnessFeatureSupport;
+        taskProjection?: HarnessFeatureSupport;
+        mcpStdio?: HarnessFeatureSupport;
+        mcpSse?: HarnessFeatureSupport;
+        mcpStreamableHttp?: HarnessFeatureSupport;
+    };
+    events?: {
+        rawStream?: HarnessFeatureSupport;
+        normalizedStream?: HarnessFeatureSupport;
+        displayState?: HarnessFeatureSupport;
+        subagentEvents?: HarnessFeatureSupport;
+        taskEvents?: HarnessFeatureSupport;
+        usageEvents?: HarnessFeatureSupport;
+    };
+    limits?: {
+        maxTurns?: HarnessFeatureSupport;
+        maxModelCalls?: HarnessFeatureSupport;
+        maxDuration?: HarnessFeatureSupport;
+    };
+    auth?: {
+        apiKey?: HarnessFeatureSupport;
+        authFile?: HarnessFeatureSupport;
+        oauthToken?: HarnessFeatureSupport;
+        localLogin?: HarnessFeatureSupport;
+    };
+    debug?: {
+        tmuxAttach?: HarnessFeatureSupport;
+        logs?: HarnessFeatureSupport;
+        rawTranscript?: HarnessFeatureSupport;
+    };
+}
+export declare function normalizeHarnessSupportLevel(value: string | null | undefined): HarnessSupportLevel;
+export declare function isHarnessFeatureUsable(feature: Pick<HarnessFeatureSupport, "level"> | null | undefined): boolean;
+export declare function unsupportedHarnessFeature(reason: string, evidence?: HarnessFeatureEvidence[]): HarnessFeatureSupport;
+//# sourceMappingURL=harness-feature-support.d.ts.map

package/dist/harness-feature-support.d.ts.map

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

package/dist/harness-feature-support.js

@@ -0,0 +1,29 @@
+export function normalizeHarnessSupportLevel(value) {
+    switch (value?.trim().toLowerCase()) {
+        case "yes":
+        case "supported":
+        case "true":
+            return "yes";
+        case "partial":
+        case "degraded":
+            return "partial";
+        case "no":
+        case "unsupported":
+        case "false":
+            return "no";
+        case "unknown":
+        default:
+            return "unknown";
+    }
+}
+export function isHarnessFeatureUsable(feature) {
+    return feature?.level === "yes" || feature?.level === "partial";
+}
+export function unsupportedHarnessFeature(reason, evidence = []) {
+    return {
+        level: "no",
+        reason,
+        evidence,
+        downgrade: "unsupported",
+    };
+}

package/dist/host-integrations.d.ts

@@ -0,0 +1,22 @@
+import type { AgentHarness } from "./actors.js";
+export type ScoutHostIntegrationRole = "execution_harness" | "agent_host" | "mcp_host" | "terminal_host" | "agent_state_surface";
+export type ScoutHostIntegrationId = "claude-code" | "codex" | "cursor" | "pi" | "hermes" | "herdr";
+export interface ScoutHostIntegration {
+    id: ScoutHostIntegrationId;
+    label: string;
+    roles: readonly ScoutHostIntegrationRole[];
+    /**
+     * Present only when this host is also a Scout execution harness. Hosts such
+     * as Hermes and Herdr are first-class integrations without being valid
+     * values for `execution.harness` or `--harness`.
+     */
+    harness?: AgentHarness;
+    homepage?: string;
+    repositoryUrl?: string;
+    installHint?: string;
+    summary: string;
+}
+export declare const SCOUT_HOST_INTEGRATIONS: readonly ScoutHostIntegration[];
+export declare function scoutHostIntegrationById(id: string): ScoutHostIntegration | undefined;
+export declare function scoutHostIntegrationHasRole(host: ScoutHostIntegration, role: ScoutHostIntegrationRole): boolean;
+//# sourceMappingURL=host-integrations.d.ts.map

package/dist/host-integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-integrations.d.ts","sourceRoot":"","sources":["../src/host-integrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,wBAAwB,GAChC,mBAAmB,GACnB,YAAY,GACZ,UAAU,GACV,eAAe,GACf,qBAAqB,CAAC;AAE1B,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,OAAO,GACP,QAAQ,GACR,IAAI,GACJ,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAyDzD,CAAC;AAEX,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,GACT,oBAAoB,GAAG,SAAS,CAElC;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAET"}

package/dist/host-integrations.js

@@ -0,0 +1,64 @@
+export const SCOUT_HOST_INTEGRATIONS = [
+    {
+        id: "claude-code",
+        label: "Claude Code",
+        roles: ["execution_harness", "agent_host", "mcp_host"],
+        harness: "claude",
+        homepage: "https://claude.ai/claude-code",
+        repositoryUrl: "https://github.com/arach/claude-scout",
+        installHint: "/plugin marketplace add arach/claude-scout",
+        summary: "Claude Code can run Scout-routed work as a harness and expose Scout through a host plugin.",
+    },
+    {
+        id: "codex",
+        label: "Codex",
+        roles: ["execution_harness", "agent_host", "mcp_host"],
+        harness: "codex",
+        homepage: "https://github.com/openai/codex",
+        repositoryUrl: "https://github.com/arach/codex-scout",
+        installHint: "/plugin marketplace add arach/codex-scout",
+        summary: "Codex can run Scout-routed work as a harness and expose Scout through MCP/plugin surfaces.",
+    },
+    {
+        id: "cursor",
+        label: "Cursor",
+        roles: ["execution_harness", "agent_host", "mcp_host"],
+        harness: "cursor",
+        repositoryUrl: "https://github.com/arach/cursor-scout",
+        installHint: "See https://github.com/arach/cursor-scout for the host-specific installer.",
+        summary: "Cursor is an agent host and execution target when routed through its supported CLI or MCP surfaces.",
+    },
+    {
+        id: "pi",
+        label: "pi",
+        roles: ["execution_harness", "agent_host"],
+        harness: "pi",
+        repositoryUrl: "https://github.com/arach/pi-scout",
+        installHint: "pi install git:github.com/arach/pi-scout",
+        summary: "pi can run Scout-routed work through its native extension model.",
+    },
+    {
+        id: "hermes",
+        label: "Hermes Agent",
+        roles: ["agent_host", "mcp_host"],
+        homepage: "https://hermes-agent.nousresearch.com/docs/",
+        repositoryUrl: "https://github.com/arach/hermes-scout",
+        installHint: "Install Hermes Scout as a Hermes plugin after Scout is healthy.",
+        summary: "Hermes hosts Scout tools through its plugin and MCP system; it is not a Scout harness.",
+    },
+    {
+        id: "herdr",
+        label: "Herdr",
+        roles: ["terminal_host", "agent_state_surface"],
+        homepage: "https://herdr.dev/docs/",
+        repositoryUrl: "https://github.com/ogulcancelik/herdr",
+        installHint: "Install the Herdr integrations for the agent hosts you use, such as Claude, Codex, Hermes, or Cursor.",
+        summary: "Herdr is a terminal host and agent-state surface for sessions Scout can observe or drive; it is not a Scout harness.",
+    },
+];
+export function scoutHostIntegrationById(id) {
+    return SCOUT_HOST_INTEGRATIONS.find((host) => host.id === id);
+}
+export function scoutHostIntegrationHasRole(host, role) {
+    return host.roles.includes(role);
+}

package/dist/inbox.d.ts

@@ -0,0 +1,50 @@
+import type { DeliveryIntent } from "./deliveries.js";
+import type { InvocationRequest } from "./invocations.js";
+import type { MessageRecord } from "./messages.js";
+import type { DeliveryReason, DeliveryStatus, MetadataMap, ScoutId } from "./common.js";
+export type InboxItemKind = "message" | "invocation";
+export declare const INBOX_CLAIMABLE_DELIVERY_STATUSES: readonly ["pending", "accepted", "deferred"];
+export type InboxClaimableDeliveryStatus = (typeof INBOX_CLAIMABLE_DELIVERY_STATUSES)[number];
+export declare function isInboxClaimableDeliveryStatus(status: DeliveryStatus): status is InboxClaimableDeliveryStatus;
+export interface InboxItem {
+    id: ScoutId;
+    kind: InboxItemKind;
+    targetId: ScoutId;
+    targetNodeId?: ScoutId;
+    conversationId?: ScoutId;
+    messageId?: ScoutId;
+    invocationId?: ScoutId;
+    reason: DeliveryReason;
+    status: DeliveryStatus;
+    leaseOwner?: string;
+    leaseExpiresAt?: number;
+    delivery: DeliveryIntent;
+    message?: MessageRecord;
+    invocation?: InvocationRequest;
+    metadata?: MetadataMap;
+}
+export interface InboxClaimRequest {
+    targetId: ScoutId;
+    itemId?: ScoutId;
+    messageId?: ScoutId;
+    reasons?: DeliveryReason[];
+    leaseOwner?: string;
+    leaseMs?: number;
+}
+export interface InboxClaimResponse {
+    ok: true;
+    claimed: InboxItem | null;
+}
+export interface InboxAckRequest {
+    itemId: ScoutId;
+    leaseOwner?: string | null;
+    metadata?: MetadataMap;
+}
+export interface InboxNackRequest {
+    itemId: ScoutId;
+    leaseOwner?: string | null;
+    retryAfterMs?: number;
+    reason?: string;
+    metadata?: MetadataMap;
+}
+//# sourceMappingURL=inbox.d.ts.map

package/dist/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAErD,eAAO,MAAM,iCAAiC,8CAIA,CAAC;AAE/C,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,cAAc,GACrB,MAAM,IAAI,4BAA4B,CAGxC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB"}

package/dist/inbox.js

@@ -0,0 +1,9 @@
+export const INBOX_CLAIMABLE_DELIVERY_STATUSES = [
+    "pending",
+    "accepted",
+    "deferred",
+];
+export function isInboxClaimableDeliveryStatus(status) {
+    return INBOX_CLAIMABLE_DELIVERY_STATUSES
+        .includes(status);
+}