@bastani/atomic 0.9.19-alpha.1 → 0.9.19-alpha.11

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

@@ -0,0 +1,404 @@
+/** Owner-bound task wire contracts. Capabilities are deliberately not wire DTOs. */
+declare const brand: unique symbol;
+type Brand<Name extends string> = {
+    readonly [brand]: Name;
+};
+export type OwnerId = string & Brand<"OwnerId">;
+export type TaskId = string & Brand<"TaskId">;
+export type AttemptId = string & Brand<"AttemptId">;
+export type WaitId = string & Brand<"WaitId">;
+export type OperationId = string & Brand<"OperationId">;
+export type Generation = string & Brand<"Generation">;
+/** Decimal u64, never a JavaScript number. */
+export type Sequence = string & Brand<"Sequence">;
+export type Result<T, E> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+export type Failure<Code extends string> = {
+    code: Code;
+    message: string;
+};
+export type OwnerError = Failure<"ScopeMismatch" | "EnvironmentClosing">;
+export type StartError = "OwnerClosing" | "UnknownAgent" | "InvalidCwd" | "DepthExceeded" | "CapacityExhausted" | "DispatchGuardBusy" | "OperationConflict" | "RunnerUnavailable" | "SpawnFailed" | "ContainmentUnavailable";
+export type StartFailure = Failure<StartError>;
+export type WaitError = Failure<"UnknownTask" | "OwnerClosed" | "EnvironmentClosing" | "ScopeMismatch" | "ObserverCancelled">;
+export type YieldError = Failure<"UnknownWait" | "StaleGeneration" | "ObserverCancelled">;
+export type ForegroundError = Failure<"TaskTerminal" | "OwnerClosing" | "UnknownTask" | "ObserverCancelled">;
+export type CancelError = Failure<"UnknownTask" | "CleanupFailed">;
+export type CloseError = Failure<"CleanupFailed" | "EnvironmentClosing">;
+export type WatchError = Failure<"OwnerClosed" | "StaleGeneration" | "EnvironmentClosing">;
+export type ReportError = Failure<"StaleAttempt" | "OwnerClosing" | "TaskTerminal" | "ReportConflict">;
+export type InputData = {
+    kind: "bytes";
+    bytes: Uint8Array;
+} | {
+    kind: "eof";
+};
+export type InputReceipt = {
+    operationId: OperationId;
+    acceptedBytes: number;
+    kind: "bytes" | "eof";
+};
+export type InputError = Failure<"TaskTerminal" | "StdinClosed" | "InputBackpressure" | "OperationConflict" | "InputDeliveryUnknown" | "UnknownTask" | "OutputUnavailable">;
+export type OutputError = Failure<"UnknownTask" | "OutputUnavailable">;
+export type OutputRange = {
+    start: string;
+    maximumBytes: number;
+};
+export type OutputPage = {
+    requested: {
+        start: string;
+        end: string;
+    };
+    chunks: Array<{
+        offsets: {
+            start: string;
+            end: string;
+        };
+        bytes: Uint8Array;
+    }>;
+    omittedRanges: Array<{
+        start: string;
+        end: string;
+    }>;
+    nextOffset?: string;
+};
+export type OwnerScope = {
+    kind: "session";
+    sessionId: string;
+} | {
+    kind: "workflow-stage";
+    sessionId: string;
+    runId: string;
+    stageId: string;
+    stageAttemptId: string;
+};
+export type WaitPolicy = {
+    kind: "background";
+} | {
+    kind: "foreground";
+    budgetMs?: number;
+};
+export type YieldReason = "explicit" | "default-background" | "elapsed" | "intercom-coordination" | "input-needed";
+export type WaitOutcome = {
+    kind: "settled";
+    taskId: TaskId;
+    result: TaskResult;
+} | {
+    kind: "yielded";
+    taskId: TaskId;
+    waitId: WaitId;
+    reason: YieldReason;
+};
+export type AgentIntent = {
+    kind: "agent";
+    agent: string;
+    task: string;
+    description?: string;
+    cwd?: string;
+    parentTaskId?: TaskId;
+};
+export type CommandIntent = {
+    kind: "command";
+    command: string;
+    description?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    /** Explicit executable and prefix arguments; command is appended as one argument. */
+    shell?: {
+        program: string;
+        args: string[];
+    };
+    /** False replaces the inherited environment with env; omission preserves inheritance. */
+    inheritEnv?: boolean;
+    terminal: {
+        kind: "pipe";
+    } | {
+        kind: "pty";
+        columns: number;
+        rows: number;
+    };
+    executionTimeoutMs?: number;
+    parentTaskId?: TaskId;
+};
+export type TaskIntent = AgentIntent | CommandIntent;
+export type TaskWaitConfiguration = {
+    kind: "automatic";
+    commandBudgetMs?: number;
+    agentBudgetMs?: number;
+} | {
+    kind: "until-settled";
+};
+export type CancelCause = "user" | "owner-close" | "execution-timeout" | "output-limit" | "parent-handoff" | "shutdown";
+export type OwnerCloseCause = "session-close" | "stage-close" | "app-shutdown";
+export type Cursor = {
+    generation: Generation;
+    sequence: Sequence;
+};
+export type NativeTaskRef = {
+    ownerId: OwnerId;
+    taskId: TaskId;
+    attemptId: AttemptId;
+    generation: Generation;
+};
+export type OutputRef = {
+    ownerId: OwnerId;
+    taskId: TaskId;
+    artifactId: string;
+    byteCount: string;
+    omittedRanges: Array<{
+        start: string;
+        end: string;
+    }>;
+};
+export type TaskResult = {
+    kind: "completed";
+    output: OutputRef;
+    exitCode?: number;
+} | {
+    kind: "failed";
+    code: string;
+    message: string;
+    output?: OutputRef;
+    exitCode?: number;
+} | {
+    kind: "cancelled";
+    cause: CancelCause;
+    output?: OutputRef;
+};
+export type Execution = {
+    kind: "queued";
+} | {
+    kind: "running";
+} | {
+    kind: "cancelling";
+    cause: CancelCause;
+} | {
+    kind: "settled";
+    result: TaskResult;
+};
+export type ResourceFailure = {
+    resource: string;
+    code: string;
+    message: string;
+};
+export type Cleanup = {
+    kind: "active";
+} | {
+    kind: "draining";
+} | {
+    kind: "reaped";
+} | {
+    kind: "failed";
+    resources: Array<ResourceFailure>;
+};
+export type PromptRoute = {
+    sessionId: string;
+    promptId: string;
+    stageAttemptId?: string;
+};
+export type Attention = {
+    kind: "none";
+} | {
+    kind: "input-needed";
+    requestId: string;
+    prompt: string;
+    route: PromptRoute;
+} | {
+    kind: "no-recent-activity";
+    lastActivityAt?: string;
+};
+export type HostObservation = {
+    kind: "foreground";
+    waitId: WaitId;
+} | {
+    kind: "background";
+    reason: YieldReason | "not-observed" | "observer-cancelled";
+} | {
+    kind: "none";
+    reason: "task-settled" | "owner-closing";
+};
+export type TaskRecord = {
+    ref: NativeTaskRef;
+    launchOperationId: OperationId;
+    parentTaskId?: TaskId;
+    launchGroupId?: string;
+    launchOrdinal: number;
+    kind: "agent" | "command";
+    title: string;
+    agentName?: string;
+    /** Resolved execution settings, retained after completion. */
+    model?: string;
+    thinking?: string;
+    execution: Execution;
+    observation: HostObservation;
+    /** Retained native background membership, independent of the current wait. */
+    wasBackground?: boolean;
+    attention: Attention;
+    cleanup: Cleanup;
+    currentAction?: {
+        tool: string;
+        text: string;
+    };
+    metrics?: {
+        elapsedMs?: number;
+        toolCount?: number;
+        tokenCount?: number;
+    };
+    output: OutputRef;
+};
+/**
+ * The latest 256 accepted activity IDs per task retain SHA-256 payload hashes and receipts.
+ * Identical replay is duplicate; changed payload conflicts, without events or retention refresh.
+ * Evicted IDs are fresh reports, subject to existing terminal/owner guards, not task revival.
+ */
+export type ActivityReport = {
+    reportId: string;
+    change: {
+        kind: "action";
+        tool: string;
+        text: string;
+    } | {
+        kind: "model";
+        model?: string;
+        thinking?: string;
+    } | {
+        kind: "metrics";
+        elapsedMs?: number;
+        toolCount?: number;
+        tokenCount?: number;
+    } | {
+        kind: "output";
+        offset: string;
+        bytesBase64: string;
+    } | {
+        kind: "attention-set";
+        attention: Exclude<Attention, {
+            kind: "none";
+        }>;
+    } | {
+        kind: "attention-clear";
+        requestId: string;
+    };
+};
+/** Terminal reports and their receipts never expire while the task record exists. */
+export type OutcomeReport = {
+    reportId: string;
+    result: TaskResult;
+};
+export type TaskEvent = {
+    kind: "task-admitted";
+    task: TaskRecord;
+} | {
+    kind: "task-started";
+    ref: NativeTaskRef;
+} | {
+    kind: "wait-yielded";
+    ref: NativeTaskRef;
+    waitId: WaitId;
+    reason: YieldReason;
+} | {
+    kind: "wait-started";
+    ref: NativeTaskRef;
+    waitId: WaitId;
+    observer: "sdk" | "host";
+} | {
+    kind: "host-observation-changed";
+    ref: NativeTaskRef;
+    observation: HostObservation;
+} | {
+    kind: "task-activity";
+    ref: NativeTaskRef;
+    activity: ActivityReport;
+} | {
+    kind: "task-cancelling";
+    ref: NativeTaskRef;
+    cause: CancelCause;
+} | {
+    kind: "task-settled";
+    ref: NativeTaskRef;
+    result: TaskResult;
+    completionId: string;
+} | {
+    kind: "cleanup-changed";
+    ref: NativeTaskRef;
+    cleanup: Cleanup;
+} | {
+    kind: "owner-closing";
+} | {
+    kind: "owner-closed";
+};
+export type NativeEvent = {
+    schemaVersion: 1;
+    cursor: Cursor;
+    ownerId: OwnerId;
+    taskId?: TaskId;
+    payload: TaskEvent;
+};
+export type OwnerSnapshot = {
+    ownerId: OwnerId;
+    scope: OwnerScope;
+    generation: Generation;
+    state: "open" | "closing" | "closed";
+    tasks: Array<TaskRecord>;
+    cursor: Cursor;
+};
+export type ReportReceipt = {
+    reportId: string;
+    cursor: Cursor;
+    disposition: "accepted" | "duplicate";
+};
+export type SettlementReceipt = {
+    taskId: TaskId;
+    cursor: Cursor;
+    result: TaskResult;
+    completionId: string;
+};
+export type CancelReceipt = {
+    taskId: TaskId;
+    decision: "already-settled" | "cancellation-requested";
+    execution: Execution;
+    cleanup: Cleanup;
+};
+export type OwnerCloseReceipt = {
+    ownerId: OwnerId;
+    state: "closed";
+    tasks: Array<CancelReceipt>;
+};
+export type ArtifactRef = {
+    kind: "transcript" | "result";
+    uri: string;
+};
+export type ModelAdmitted = {
+    kind: "admitted";
+    observation: WaitOutcome;
+    artifacts?: Array<ArtifactRef>;
+};
+export type ModelRejected = {
+    kind: "unstarted";
+    reason: {
+        kind: "rejected";
+        error: StartFailure;
+    };
+};
+export type ModelUnstarted = ModelRejected | {
+    kind: "unstarted";
+    reason: {
+        kind: "skipped";
+        cause: "parallel-group-detach";
+    };
+};
+export type ModelSingleResponse = ModelAdmitted | ModelRejected;
+export type ModelParallelResponse = {
+    kind: "parallel";
+    slots: Array<{
+        ordinal: number;
+        outcome: ModelAdmitted | ModelUnstarted;
+    }>;
+};
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/core/tasks/contracts.d.ts.map

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

package/dist/core/tasks/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/core/tasks/contracts.ts"],"names":[],"mappings":"","sourcesContent":["/** Owner-bound task wire contracts. Capabilities are deliberately not wire DTOs. */\ndeclare const brand: unique symbol;\ntype Brand<Name extends string> = { readonly [brand]: Name };\nexport type OwnerId = string & Brand<\"OwnerId\">;\nexport type TaskId = string & Brand<\"TaskId\">;\nexport type AttemptId = string & Brand<\"AttemptId\">;\nexport type WaitId = string & Brand<\"WaitId\">;\nexport type OperationId = string & Brand<\"OperationId\">;\nexport type Generation = string & Brand<\"Generation\">;\n/** Decimal u64, never a JavaScript number. */\nexport type Sequence = string & Brand<\"Sequence\">;\nexport type Result<T, E> = { ok: true; value: T } | { ok: false; error: E };\nexport type Failure<Code extends string> = { code: Code; message: string };\nexport type OwnerError = Failure<\"ScopeMismatch\" | \"EnvironmentClosing\">;\nexport type StartError =\n\t| \"OwnerClosing\"\n\t| \"UnknownAgent\"\n\t| \"InvalidCwd\"\n\t| \"DepthExceeded\"\n\t| \"CapacityExhausted\"\n\t| \"DispatchGuardBusy\"\n\t| \"OperationConflict\"\n\t| \"RunnerUnavailable\"\n\t| \"SpawnFailed\"\n\t| \"ContainmentUnavailable\";\nexport type StartFailure = Failure<StartError>;\nexport type WaitError = Failure<\n\t\"UnknownTask\" | \"OwnerClosed\" | \"EnvironmentClosing\" | \"ScopeMismatch\" | \"ObserverCancelled\"\n>;\nexport type YieldError = Failure<\"UnknownWait\" | \"StaleGeneration\" | \"ObserverCancelled\">;\nexport type ForegroundError = Failure<\"TaskTerminal\" | \"OwnerClosing\" | \"UnknownTask\" | \"ObserverCancelled\">;\nexport type CancelError = Failure<\"UnknownTask\" | \"CleanupFailed\">;\nexport type CloseError = Failure<\"CleanupFailed\" | \"EnvironmentClosing\">;\nexport type WatchError = Failure<\"OwnerClosed\" | \"StaleGeneration\" | \"EnvironmentClosing\">;\nexport type ReportError = Failure<\"StaleAttempt\" | \"OwnerClosing\" | \"TaskTerminal\" | \"ReportConflict\">;\nexport type InputData = { kind: \"bytes\"; bytes: Uint8Array } | { kind: \"eof\" };\nexport type InputReceipt = { operationId: OperationId; acceptedBytes: number; kind: \"bytes\" | \"eof\" };\nexport type InputError = Failure<\n\t| \"TaskTerminal\"\n\t| \"StdinClosed\"\n\t| \"InputBackpressure\"\n\t| \"OperationConflict\"\n\t| \"InputDeliveryUnknown\"\n\t| \"UnknownTask\"\n\t| \"OutputUnavailable\"\n>;\nexport type OutputError = Failure<\"UnknownTask\" | \"OutputUnavailable\">;\nexport type OutputRange = { start: string; maximumBytes: number };\nexport type OutputPage = {\n\trequested: { start: string; end: string };\n\tchunks: Array<{ offsets: { start: string; end: string }; bytes: Uint8Array }>;\n\tomittedRanges: Array<{ start: string; end: string }>;\n\tnextOffset?: string;\n};\nexport type OwnerScope =\n\t| { kind: \"session\"; sessionId: string }\n\t| { kind: \"workflow-stage\"; sessionId: string; runId: string; stageId: string; stageAttemptId: string };\nexport type WaitPolicy = { kind: \"background\" } | { kind: \"foreground\"; budgetMs?: number };\nexport type YieldReason = \"explicit\" | \"default-background\" | \"elapsed\" | \"intercom-coordination\" | \"input-needed\";\nexport type WaitOutcome =\n\t| { kind: \"settled\"; taskId: TaskId; result: TaskResult }\n\t| { kind: \"yielded\"; taskId: TaskId; waitId: WaitId; reason: YieldReason };\nexport type AgentIntent = {\n\tkind: \"agent\";\n\tagent: string;\n\ttask: string;\n\tdescription?: string;\n\tcwd?: string;\n\tparentTaskId?: TaskId;\n};\nexport type CommandIntent = {\n\tkind: \"command\";\n\tcommand: string;\n\tdescription?: string;\n\tcwd?: string;\n\tenv?: Record<string, string>;\n\t/** Explicit executable and prefix arguments; command is appended as one argument. */\n\tshell?: { program: string; args: string[] };\n\t/** False replaces the inherited environment with env; omission preserves inheritance. */\n\tinheritEnv?: boolean;\n\tterminal: { kind: \"pipe\" } | { kind: \"pty\"; columns: number; rows: number };\n\texecutionTimeoutMs?: number;\n\tparentTaskId?: TaskId;\n};\nexport type TaskIntent = AgentIntent | CommandIntent;\nexport type TaskWaitConfiguration =\n\t| { kind: \"automatic\"; commandBudgetMs?: number; agentBudgetMs?: number }\n\t| { kind: \"until-settled\" };\nexport type CancelCause = \"user\" | \"owner-close\" | \"execution-timeout\" | \"output-limit\" | \"parent-handoff\" | \"shutdown\";\nexport type OwnerCloseCause = \"session-close\" | \"stage-close\" | \"app-shutdown\";\nexport type Cursor = { generation: Generation; sequence: Sequence };\nexport type NativeTaskRef = { ownerId: OwnerId; taskId: TaskId; attemptId: AttemptId; generation: Generation };\nexport type OutputRef = {\n\townerId: OwnerId;\n\ttaskId: TaskId;\n\tartifactId: string;\n\tbyteCount: string;\n\tomittedRanges: Array<{ start: string; end: string }>;\n};\nexport type TaskResult =\n\t| { kind: \"completed\"; output: OutputRef; exitCode?: number }\n\t| { kind: \"failed\"; code: string; message: string; output?: OutputRef; exitCode?: number }\n\t| { kind: \"cancelled\"; cause: CancelCause; output?: OutputRef };\nexport type Execution =\n\t| { kind: \"queued\" }\n\t| { kind: \"running\" }\n\t| { kind: \"cancelling\"; cause: CancelCause }\n\t| { kind: \"settled\"; result: TaskResult };\nexport type ResourceFailure = { resource: string; code: string; message: string };\nexport type Cleanup =\n\t| { kind: \"active\" }\n\t| { kind: \"draining\" }\n\t| { kind: \"reaped\" }\n\t| { kind: \"failed\"; resources: Array<ResourceFailure> };\nexport type PromptRoute = { sessionId: string; promptId: string; stageAttemptId?: string };\nexport type Attention =\n\t| { kind: \"none\" }\n\t| { kind: \"input-needed\"; requestId: string; prompt: string; route: PromptRoute }\n\t| { kind: \"no-recent-activity\"; lastActivityAt?: string };\nexport type HostObservation =\n\t| { kind: \"foreground\"; waitId: WaitId }\n\t| { kind: \"background\"; reason: YieldReason | \"not-observed\" | \"observer-cancelled\" }\n\t| { kind: \"none\"; reason: \"task-settled\" | \"owner-closing\" };\nexport type TaskRecord = {\n\tref: NativeTaskRef;\n\tlaunchOperationId: OperationId;\n\tparentTaskId?: TaskId;\n\tlaunchGroupId?: string;\n\tlaunchOrdinal: number;\n\tkind: \"agent\" | \"command\";\n\ttitle: string;\n\tagentName?: string;\n\t/** Resolved execution settings, retained after completion. */\n\tmodel?: string;\n\tthinking?: string;\n\texecution: Execution;\n\tobservation: HostObservation;\n\t/** Retained native background membership, independent of the current wait. */\n\twasBackground?: boolean;\n\tattention: Attention;\n\tcleanup: Cleanup;\n\tcurrentAction?: { tool: string; text: string };\n\tmetrics?: { elapsedMs?: number; toolCount?: number; tokenCount?: number };\n\toutput: OutputRef;\n};\n/**\n * The latest 256 accepted activity IDs per task retain SHA-256 payload hashes and receipts.\n * Identical replay is duplicate; changed payload conflicts, without events or retention refresh.\n * Evicted IDs are fresh reports, subject to existing terminal/owner guards, not task revival.\n */\nexport type ActivityReport = {\n\treportId: string;\n\tchange:\n\t\t| { kind: \"action\"; tool: string; text: string }\n\t\t| { kind: \"model\"; model?: string; thinking?: string }\n\t\t| { kind: \"metrics\"; elapsedMs?: number; toolCount?: number; tokenCount?: number }\n\t\t| { kind: \"output\"; offset: string; bytesBase64: string }\n\t\t| { kind: \"attention-set\"; attention: Exclude<Attention, { kind: \"none\" }> }\n\t\t| { kind: \"attention-clear\"; requestId: string };\n};\n/** Terminal reports and their receipts never expire while the task record exists. */\nexport type OutcomeReport = { reportId: string; result: TaskResult };\nexport type TaskEvent =\n\t| { kind: \"task-admitted\"; task: TaskRecord }\n\t| { kind: \"task-started\"; ref: NativeTaskRef }\n\t| { kind: \"wait-yielded\"; ref: NativeTaskRef; waitId: WaitId; reason: YieldReason }\n\t| { kind: \"wait-started\"; ref: NativeTaskRef; waitId: WaitId; observer: \"sdk\" | \"host\" }\n\t| { kind: \"host-observation-changed\"; ref: NativeTaskRef; observation: HostObservation }\n\t| { kind: \"task-activity\"; ref: NativeTaskRef; activity: ActivityReport }\n\t| { kind: \"task-cancelling\"; ref: NativeTaskRef; cause: CancelCause }\n\t| { kind: \"task-settled\"; ref: NativeTaskRef; result: TaskResult; completionId: string }\n\t| { kind: \"cleanup-changed\"; ref: NativeTaskRef; cleanup: Cleanup }\n\t| { kind: \"owner-closing\" }\n\t| { kind: \"owner-closed\" };\nexport type NativeEvent = {\n\tschemaVersion: 1;\n\tcursor: Cursor;\n\townerId: OwnerId;\n\ttaskId?: TaskId;\n\tpayload: TaskEvent;\n};\nexport type OwnerSnapshot = {\n\townerId: OwnerId;\n\tscope: OwnerScope;\n\tgeneration: Generation;\n\tstate: \"open\" | \"closing\" | \"closed\";\n\ttasks: Array<TaskRecord>;\n\tcursor: Cursor;\n};\nexport type ReportReceipt = { reportId: string; cursor: Cursor; disposition: \"accepted\" | \"duplicate\" };\nexport type SettlementReceipt = { taskId: TaskId; cursor: Cursor; result: TaskResult; completionId: string };\nexport type CancelReceipt = {\n\ttaskId: TaskId;\n\tdecision: \"already-settled\" | \"cancellation-requested\";\n\texecution: Execution;\n\tcleanup: Cleanup;\n};\nexport type OwnerCloseReceipt = { ownerId: OwnerId; state: \"closed\"; tasks: Array<CancelReceipt> };\nexport type ArtifactRef = { kind: \"transcript\" | \"result\"; uri: string };\nexport type ModelAdmitted = { kind: \"admitted\"; observation: WaitOutcome; artifacts?: Array<ArtifactRef> };\nexport type ModelRejected = { kind: \"unstarted\"; reason: { kind: \"rejected\"; error: StartFailure } };\nexport type ModelUnstarted =\n\t| ModelRejected\n\t| { kind: \"unstarted\"; reason: { kind: \"skipped\"; cause: \"parallel-group-detach\" } };\nexport type ModelSingleResponse = ModelAdmitted | ModelRejected;\nexport type ModelParallelResponse = {\n\tkind: \"parallel\";\n\tslots: Array<{ ordinal: number; outcome: ModelAdmitted | ModelUnstarted }>;\n};\n"]}

package/dist/core/tasks/execution-scope.d.ts

@@ -0,0 +1,10 @@
+import type { AgentTaskHost } from "./agent-adapter.js";
+import type { TaskId } from "./contracts.js";
+export type AdmittedAgentTask = {
+    host: AgentTaskHost;
+    taskId: TaskId;
+};
+/** Internal durable callback boundary; admission still belongs to the actual host. */
+export declare function collectAgentTasks<T>(signal: AbortSignal, callback: () => Promise<T>, settle: (value: T, tasks: AdmittedAgentTask[]) => Promise<T>): Promise<T>;
+export declare function trackAdmittedAgentTask(task: AdmittedAgentTask): void;
+//# sourceMappingURL=execution-scope.d.ts.map

package/dist/core/tasks/execution-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-scope.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/execution-scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIxE,sFAAsF;AACtF,wBAAsB,iBAAiB,CAAC,CAAC,EACxC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1D,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAKpE"}

package/dist/core/tasks/execution-scope.js

@@ -0,0 +1,27 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const executionScope = new AsyncLocalStorage();
+/** Internal durable callback boundary; admission still belongs to the actual host. */
+export async function collectAgentTasks(signal, callback, settle) {
+    const scope = { signal, tasks: [] };
+    const cancel = () => {
+        for (const task of scope.tasks)
+            void task.host.cancelTask(task.taskId, "owner-close");
+    };
+    signal.addEventListener("abort", cancel, { once: true });
+    try {
+        return await executionScope.run(scope, async () => settle(await callback(), scope.tasks));
+    }
+    finally {
+        signal.removeEventListener("abort", cancel);
+    }
+}
+export function trackAdmittedAgentTask(task) {
+    const scope = executionScope.getStore();
+    if (!scope)
+        return;
+    if (!scope.tasks.some((entry) => entry.host === task.host && entry.taskId === task.taskId))
+        scope.tasks.push(task);
+    if (scope.signal.aborted)
+        void task.host.cancelTask(task.taskId, "owner-close");
+}
+//# sourceMappingURL=execution-scope.js.map

package/dist/core/tasks/execution-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-scope.js","sourceRoot":"","sources":["../../../src/core/tasks/execution-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAa,CAAC;AAE1D,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,MAAmB,EACnB,QAA0B,EAC1B,MAA4D;IAE5D,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,EAAE;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvF,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACJ,OAAO,MAAM,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,QAAQ,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3F,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnH,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO;QAAE,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACjF,CAAC","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { AgentTaskHost } from \"./agent-adapter.js\";\nimport type { TaskId } from \"./contracts.js\";\n\nexport type AdmittedAgentTask = { host: AgentTaskHost; taskId: TaskId };\ntype TaskScope = { signal: AbortSignal; tasks: AdmittedAgentTask[] };\nconst executionScope = new AsyncLocalStorage<TaskScope>();\n\n/** Internal durable callback boundary; admission still belongs to the actual host. */\nexport async function collectAgentTasks<T>(\n\tsignal: AbortSignal,\n\tcallback: () => Promise<T>,\n\tsettle: (value: T, tasks: AdmittedAgentTask[]) => Promise<T>,\n): Promise<T> {\n\tconst scope: TaskScope = { signal, tasks: [] };\n\tconst cancel = () => {\n\t\tfor (const task of scope.tasks) void task.host.cancelTask(task.taskId, \"owner-close\");\n\t};\n\tsignal.addEventListener(\"abort\", cancel, { once: true });\n\ttry {\n\t\treturn await executionScope.run(scope, async () => settle(await callback(), scope.tasks));\n\t} finally {\n\t\tsignal.removeEventListener(\"abort\", cancel);\n\t}\n}\n\nexport function trackAdmittedAgentTask(task: AdmittedAgentTask): void {\n\tconst scope = executionScope.getStore();\n\tif (!scope) return;\n\tif (!scope.tasks.some((entry) => entry.host === task.host && entry.taskId === task.taskId)) scope.tasks.push(task);\n\tif (scope.signal.aborted) void task.host.cancelTask(task.taskId, \"owner-close\");\n}\n"]}

package/dist/core/tasks/owner-store.d.ts

@@ -0,0 +1,53 @@
+import type { ActivityReport, Cursor, OwnerSnapshot, Result, TaskId, TaskRecord, WaitError, WatchError } from "./contracts.js";
+import type { OwnerLease, TaskLease, TaskSupervisor } from "./supervisor.js";
+/** Activity previews are bounded independently of authoritative session history. */
+export declare const TASK_ACTIVITY_LIMIT = 64;
+export declare const TASK_ACTIVITY_BYTES = 8192;
+export type TaskAnchor = {
+    taskId: TaskId;
+    activitySequence: Cursor["sequence"];
+    cellOffset: number;
+    followBottom: boolean;
+};
+export type TaskActivity = {
+    cursor: Cursor;
+    report: ActivityReport;
+};
+/** A view subscription owns neither the owner nor its executions. */
+export declare class OwnerTaskStore {
+    private subscription?;
+    private listeners;
+    private records;
+    private activity;
+    private activityCursors;
+    private omittedActivity;
+    private backgroundIds;
+    readonly anchors: Map<TaskId, TaskAnchor>;
+    private current?;
+    readonly supervisor: TaskSupervisor;
+    private readonly owner;
+    constructor(supervisor: TaskSupervisor, owner: OwnerLease);
+    get snapshot(): OwnerSnapshot | undefined;
+    get cursor(): Cursor | undefined;
+    get tasks(): TaskRecord[];
+    /** Background membership survives foreground waits and terminal observation cleanup. */
+    get backgroundTasks(): TaskRecord[];
+    /** Resolve only within the owner that authorized this store. */
+    resolveTask(id: TaskId): Result<TaskLease, WaitError>;
+    recentActivity(id: TaskId): TaskActivity[];
+    activityOmitted(id: TaskId): boolean;
+    subscribe(listener: () => void): () => void;
+    connect(): Result<void, WatchError>;
+    /** Useful at explicit host barriers; no transcript repaint timer is installed. */
+    drain(): void;
+    dispose(): void;
+    private reconcile;
+    private observe;
+    private retainActivity;
+    private notify;
+}
+export declare function bindOwnerTaskStore(session: object, store: OwnerTaskStore): void;
+export declare function getOwnerTaskStore(session: object): OwnerTaskStore | undefined;
+/** Observe lazy producer binding without waiting for another tool/session event. */
+export declare function watchOwnerTaskStoreBinding(session: object, listener: () => void): () => void;
+//# sourceMappingURL=owner-store.d.ts.map

package/dist/core/tasks/owner-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-store.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/owner-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,MAAM,EAEN,aAAa,EACb,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAoB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/F,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,MAAM,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAOtE,qEAAqE;AACrE,qBAAa,cAAc;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,aAAa,CAAqB;IAC1C,QAAQ,CAAC,OAAO,0BAAiC;IACjD,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,YAAY,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAGxD;IAED,IAAI,QAAQ,IAAI,aAAa,GAAG,SAAS,CAExC;IACD,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IACD,IAAI,KAAK,IAAI,UAAU,EAAE,CAExB;IACD,wFAAwF;IACxF,IAAI,eAAe,IAAI,UAAU,EAAE,CAIlC;IACD,gEAAgE;IAChE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAEpD;IACD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE,CAEzC;IACD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEnC;IACD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK1C;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAUlC;IACD,kFAAkF;IAClF,KAAK,IAAI,IAAI,CAEZ;IACD,OAAO,IAAI,IAAI,CAGd;IACD,OAAO,CAAC,SAAS;YA2BH,OAAO;IAWrB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,MAAM;CAGd;AAKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAG/E;AACD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE7E;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAU5F"}