@nyte-ai/core 0.0.18 → 0.0.19

package/dist/src/contract/host.d.ts

@@ -1,4 +1,4 @@
-import type { AdvanceReport, Authority, Awaitable, BlobId, ByteReader, CallId, CredentialSource, Cursor, DecodedObjectView, Disposer, ExecutionCoverage, HeadName, HostDescription, HostId, HostView, IdentityChallenge, IntegrityReport, JournalEntry, Json, LoginMethod, ModelAccount, ModelCatalogView, ModelRef, Owned, Paged, PluginCheckReport, PluginReplacementReport, PrincipalId, PrincipalView, ProviderUsage, ReceiptId, Ref, RepairPage, RunId, Seq, SessionEvent, SessionId, SettingOutcome, WorkspaceId, WorkspaceTarget } from "@nyte-ai/schema";
+import type { AdvanceReport, Authority, Awaitable, BlobId, ByteReader, CallId, CredentialSource, Cursor, DecodedObjectView, Disposer, ExecutionCoverage, HeadName, HostDescription, HostId, HostView, IdentityChallenge, IntegrityReport, JournalEntry, Json, LoginMethod, ModelAccount, ModelCatalogView, ModelListing, ModelRef, Owned, Paged, PluginCheckReport, PluginReplacementReport, PrincipalId, PrincipalView, ProviderUsage, ReceiptId, Ref, RepairPage, RunId, Seq, SessionEvent, SessionId, SettingOutcome, WorkspaceId, WorkspaceTarget } from "@nyte-ai/schema";
 import type { Models, Provider } from "@nyte-ai/ai";
 import type { Plugin } from "./plugin.ts";
 import type { Session, Sessions } from "./session.ts";
@@ -66,6 +66,30 @@ export interface OpenOptions {
     readonly mcp?: McpHubFactory;
     /** The serving machine's GitHub CLI login, served as `Connection.github`; absent, its calls throw `SdkError("unavailable")`. */
     readonly github?: GitHubAccountApi;
+    readonly images?: ImageProcessor;
+}
+export interface ImageLimits {
+    readonly maxWidth: number;
+    readonly maxHeight: number;
+    readonly maxBase64Bytes: number;
+}
+export declare const IMAGE_LIMITS: ImageLimits;
+export interface PreparedImage {
+    readonly data: string;
+    readonly mimeType: string;
+    readonly resized?: {
+        readonly from: {
+            readonly width: number;
+            readonly height: number;
+        };
+        readonly to: {
+            readonly width: number;
+            readonly height: number;
+        };
+    };
+}
+export interface ImageProcessor {
+    prepare(bytes: Uint8Array, mimeType: string, limits: ImageLimits): Promise<PreparedImage | undefined>;
 }
 export interface ConnectOptions {
     readonly url: string;
@@ -127,6 +151,11 @@ export interface ModelsApi {
     } | {
         readonly kind: "unknown-model";
     }>;
+    setListing(refs: readonly ModelRef[], listing: ModelListing): Promise<{
+        readonly kind: "set";
+    } | {
+        readonly kind: "unknown-model";
+    }>;
     verify(provider: string): Promise<{
         readonly kind: "verified";
     } | {

package/dist/src/contract/host.js

@@ -4,11 +4,13 @@ import {
   ALL_AUTHORITY2,
   TOKEN_AUTHORITY2,
   CORE_CONTEXT2,
-  PARTICIPANT_AUTHORITY2
-} from "../../chunks/compose-mryw0674.js";
+  PARTICIPANT_AUTHORITY2,
+  IMAGE_LIMITS2
+} from "../../chunks/compose-5z835ej2.js";
 export {
   ALL_AUTHORITY2 as ALL_AUTHORITY,
   CORE_CONTEXT2 as CORE_CONTEXT,
+  IMAGE_LIMITS2 as IMAGE_LIMITS,
   LOCAL2 as LOCAL,
   PARTICIPANT_AUTHORITY2 as PARTICIPANT_AUTHORITY,
   TOKEN2 as TOKEN,

package/dist/src/contract/kernel.d.ts

@@ -1,9 +1,10 @@
 import type { Activation, CallId, CommitId, Configuration, ConfigurationPatch, ConfigureOutcome, Decision, Delivery, Disposer, ExecutionCoverage, HeadName, HostDescription, HostId, HostView, JobEnd, JobId, Json, MessageId, MessageSource, ModelRef, ModelRequestInput, ModelRequestOutcome, PartId, PluginLoadOutcome, PrincipalId, Revision, RunEnd, RunId, RunView, SessionCatalogView, SessionId, ToolInfo, Usage, ValidationIssue } from "@nyte-ai/schema";
 import type { KeyedSerial } from "@nyte-ai/schema/serial";
 import type { FoldCache, LogPublisher, SessionBus } from "./fold.ts";
-import type { Connection, ConnectionContext, ConnectionRegistry, Host, HostState, ModelState, OpenOptions } from "./host.ts";
+import type { Connection, ConnectionContext, ConnectionRegistry, Host, HostState, ImageProcessor, ModelState, OpenOptions } from "./host.ts";
 import type { PartDefinition, PartDefinitions, PartTable } from "./parts.ts";
 import type { Agent, ContributionTable, HookEntry, HookName, HookTable, Plugin, PluginApi, Registries, Registry, SettingDefinition, SettingsRegistry } from "./plugin.ts";
+import type { Presence } from "../engine/presence.ts";
 import type { CallRecord } from "./records.ts";
 import type { Session } from "./session.ts";
 import type { StoreConnection } from "./store.ts";
@@ -12,13 +13,12 @@ import type { EnvironmentRegistry, ExecutionEnv, GitHubAccountApi, JobTable, Mcp
 export interface Kernel {
     readonly hostId: HostId;
     readonly instance: string;
+    readonly presence: Presence | null;
     readonly poll: number | null;
-    /** Listeners the store poll calls when another process has committed, for readers of what the bus does not carry, such as the session directory. */
     readonly externalCommits: Set<() => void>;
     readonly store: StoreConnection;
     readonly description: HostDescription;
     readonly bus: SessionBus;
-    /** The one way logged events reach the bus: once each, in seq order per session. */
     readonly publisher: LogPublisher;
     readonly host: HostState;
     readonly folds: FoldCache;
@@ -32,7 +32,7 @@ export interface Kernel {
     readonly summarize: Summarizer;
     readonly compact: Compactor;
     readonly resolveConfiguration: ConfigurationResolver;
-    /** Whether `model`'s runtime takes a message sent mid-turn (`ModelCapabilities.steer`); true for a model of no known provider. */
+    readonly rememberChoice: (choice: Configuration, scope: "model" | "thinking") => Promise<void>;
     readonly modelSteers: (model: ModelRef) => boolean;
     readonly waits: WaitRegistry;
     readonly modelState: ModelState;
@@ -46,63 +46,47 @@ export interface Kernel {
     request<T>(session: SessionId, input: ModelRequestInput<T>): Promise<ModelRequestOutcome<T>>;
     readonly secrets: NonNullable<OpenOptions["secrets"]> | null;
     readonly mcp: McpHub | null;
-    /** The serving machine's GitHub CLI login, null on a host without one. */
     readonly github: GitHubAccountApi | null;
+    readonly images: ImageProcessor | null;
     readonly plugins: PluginHost;
-    /** Builds the public connection and session handles, so engine and plugin code never import the api layer. */
     readonly handles: Handles;
-    /** Removes a chat whose first message is still deciding, the way a refusal does; returns that message, or null when nothing on the chat is deciding. On the kernel so receipts reach it without importing start.ts. */
     stopStart(session: SessionId): Promise<MessageId | null>;
 }
-/** The host's plugins and the per-session runtimes that load them. */
 export interface PluginHost {
-    /** The first-party plugins every session loads first. */
     readonly builtins: readonly Plugin<"core">[];
-    /** The host's own plugins, after the built-ins; `replace` swaps them. */
     host: readonly Plugin<"core">[];
-    /** Where each plugin loaded from a file came from. */
     readonly sources: ReadonlyMap<Plugin<"core">, {
         readonly source: "user" | "project";
         readonly path: string;
     }>;
     readonly state: PluginState;
-    /** The session's runtime, installed on first use. */
     runtime(session: SessionId): PluginRuntime;
-    /** Installs a fresh runtime for the session over the one it has, and waits for it. */
     reload(session: SessionId): Promise<void>;
     runtimes(): ReadonlyMap<SessionId, PluginRuntime>;
     close(session: SessionId): Promise<void>;
-    /** The api a plugin owns in a session's runtime. */
     api(owner: string, session: SessionId): PluginApi<"core">;
     replace(plugins: readonly Plugin<"core">[], scope?: {
         readonly session: SessionId;
     }): ReturnType<Host["plugins"]["replace"]>;
     check(plugins: readonly Plugin<"core">[]): ReturnType<Host["plugins"]["check"]>;
-    /** Imports the plugins in `paths`, through the host's plugin loader. */
     load(paths: readonly string[]): Promise<readonly Plugin<"core">[]>;
 }
-/** This process's activation and catalog of each session, each change published on the session's bus. */
 export interface SessionDirectory {
     activation(session: SessionId): Activation;
     setActivation(session: SessionId, activation: Activation): void;
     catalog(session: SessionId): SessionCatalogView;
     setCatalog(session: SessionId, catalog: SessionCatalogView): void;
-    /** Drops a removed session's activation and catalog. */
     forget(session: SessionId): void;
 }
 interface Handles {
     connection(context: ConnectionContext): Connection;
     session(context: ConnectionContext, session: SessionId): Session;
-    /** The session handle a plugin's `activate` receives: its main head sends without waiting on the activation. */
     activationSession(context: ConnectionContext, session: SessionId): Session;
 }
-/** This process's abort controllers for the runs it works on. Whether a run is stopping is its record's `stopping`; this table only follows that record's logged stop fence. */
 export interface RunTable {
-    /** The controller of a run this process works on, created on first use, following the session's bus for the run's stop fence. */
     start(session: SessionId, run: RunId): AbortController;
     abort(run: RunId): void;
     signal(run: RunId): AbortSignal | null;
-    /** Whether the run's stop fence reached this process's bus, or its work here was aborted. */
     fenced(run: RunId): boolean;
     end(run: RunId): void;
 }
@@ -189,35 +173,23 @@ export interface ParkedWait {
     readonly partial: CallRecord["partial"];
     readonly index: number;
 }
-/** Wakes parked calls: each target event offers its outcome to the waits the store-side index lists under it, and `tick` to the timers and deadlines that are due. */
 export interface WaitRegistry {
-    /** Checks a just-parked wait against what it waits on, completing it at once when that already happened. */
     park(entry: ParkedWait): Promise<void>;
-    /** Offers a run's end to its waiters; whether any took it. */
     runEnded(session: SessionId, run: RunId, end: RunEnd): Promise<boolean>;
-    /** Offers a job's end to its waiters; whether any took it. */
     jobEnded(job: JobId, end: JobEnd): Promise<boolean>;
     partAnswered(session: SessionId, part: PartId, answer: {
         readonly action: string;
         readonly input: Json;
     }): Promise<void>;
     partClosed(session: SessionId, part: PartId): Promise<void>;
-    /** Ends the waits on a head that stop at its next input. */
     inputAdmitted(session: SessionId, head: HeadName, message: MessageId): Promise<void>;
-    /** Ends the waits a run's parked calls hold, stopped. */
     runStopped(session: SessionId, run: RunId): Promise<void>;
-    /** Ends a call's wait, and those of the calls nested in it, stopped. */
     callStopped(session: SessionId, call: CallId): Promise<void>;
-    /** Offers the timers and deadlines due at `now`. */
     tick(now: number): Promise<void>;
     rerun(session: SessionId, call: CallId): void;
-    /** After another process committed: steps the calls its wakes indexed as woken (see `loadWaits`), and resumes this process's action loops whose call it settled or whose re-run claim lapsed. A parked call is left to its index, which every process offers through. */
     refresh(): Promise<void>;
-    /** Registers this process's live loop for an action call, resumed when its wait completes. */
     onWoken(session: SessionId, call: CallId, resume: () => void): Disposer;
-    /** Calls `listener` each time this process settles the receipt, until disposed. */
     onReceipt(session: SessionId, receipt: string, listener: () => void): Disposer;
-    /** Tells this process's listeners of the receipt that it settled. */
     receiptSettled(session: SessionId, receipt: string): void;
 }
 export interface PluginRuntime {
@@ -321,15 +293,14 @@ interface Held {
 }
 export interface ExecutionState {
     readonly held: Map<string, Held>;
-    /** The runs this process drives a turn of, with their sessions. */
     readonly driving: Map<RunId, SessionId>;
     readonly covers: Map<object, ExecutionCoverage>;
     readonly advancing: Set<string>;
+    readonly undrained: Set<string>;
     readonly leaseQueue: KeyedSerial<string>;
     readonly pending: Map<string, boolean>;
     readonly summaries: Set<string>;
     readonly callQueue: KeyedSerial<string>;
-    /** The chats whose first message this process is deciding, each with the abort a stop or remove fires. */
     readonly starting: Map<SessionId, {
         readonly done: Promise<void>;
         readonly abort: AbortController;

package/dist/src/contract/records.d.ts

@@ -333,6 +333,11 @@ declare const RunRecordType: Type.TObject<{
         };
     }>>>;
     parked: Type.TReadonly<Type.TImmutable<Type.TArray<Type.TUnsafe<import("@nyte-ai/schema").Id<"call">>>>>;
+    interrupted: Type.TReadonly<Type.TOptional<Type.TObject<{
+        count: Type.TReadonly<Type.TNumber>;
+        mark: Type.TReadonly<Type.TString>;
+    }>>>;
+    requires: Type.TReadonly<Type.TOptional<Type.TImmutable<Type.TArray<Type.TString>>>>;
 }>;
 export type RunRecord = Static<typeof RunRecordType>;
 declare const PartRecordType: Type.TObject<{
@@ -991,7 +996,6 @@ declare const WorkspaceRecordType: Type.TObject<{
     }>, Type.TNull]>>;
 }>;
 export type WorkspaceRecord = Static<typeof WorkspaceRecordType>;
-/** The user's decision for one folder's project files, at `trust/<folder key>`; folders under it inherit it. */
 declare const TrustRecordType: Type.TObject<{
     target: Type.TReadonly<Type.TUnsafe<{
         readonly path: string;
@@ -1025,13 +1029,41 @@ declare const LeaseType: Type.TObject<{
     expiresAt: Type.TReadonly<Type.TNumber>;
 }>;
 type Lease = Static<typeof LeaseType>;
+declare const ProcessRecordType: Type.TObject<{
+    instance: Type.TReadonly<Type.TString>;
+    holder: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"host">>>;
+    label: Type.TReadonly<Type.TString>;
+    pid: Type.TReadonly<Type.TUnion<[Type.TNumber, Type.TNull]>>;
+    capabilities: Type.TReadonly<Type.TImmutable<Type.TArray<Type.TString>>>;
+    startedAt: Type.TReadonly<Type.TNumber>;
+}>;
+export type ProcessRecord = Static<typeof ProcessRecordType>;
+declare const JobRecordType: Type.TObject<{
+    id: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"job">>>;
+    instance: Type.TReadonly<Type.TString>;
+    workspace: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"workspace">>>;
+    session: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>>;
+    head: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"head">>>;
+    startedBy: Type.TReadonly<Type.TUnion<[Type.TUnsafe<import("@nyte-ai/schema").Id<"call">>, Type.TNull]>>;
+    title: Type.TReadonly<Type.TString>;
+    command: Type.TReadonly<Type.TString>;
+    startedAt: Type.TReadonly<Type.TNumber>;
+    end: Type.TReadonly<Type.TUnion<[Type.TUnsafe<{
+        readonly code: number | null;
+        readonly kind: "exited";
+        readonly reason: "exited" | "terminated" | "expired" | "host-lost";
+    } | {
+        readonly kind: "lost";
+    }>, Type.TNull]>>;
+    endedAt: Type.TReadonly<Type.TUnion<[Type.TNumber, Type.TNull]>>;
+}>;
+export type JobRecord = Static<typeof JobRecordType>;
 declare const HostIdentityType: Type.TObject<{
     id: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"host">>>;
     createdAt: Type.TReadonly<Type.TNumber>;
 }>;
 export type HostIdentity = Static<typeof HostIdentityType>;
-export type RecordKind = "session" | "commit" | "inbox" | "run" | "part" | "receipt" | "seen" | "workspace" | "trust" | "lease" | "call" | "kv" | "principals" | "identity";
-/** The schema of every stored record body by envelope kind, `kv` excepted since it holds any JSON. Old stores keep old bodies, so a change here must still decode them or come with a backfill. */
+export type RecordKind = "session" | "commit" | "inbox" | "run" | "part" | "receipt" | "seen" | "workspace" | "trust" | "lease" | "process" | "job" | "call" | "kv" | "principals" | "identity";
 export declare const STORED_RECORD_TYPES: {
     session: Type.TObject<{
         id: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>>;
@@ -1289,6 +1321,11 @@ export declare const STORED_RECORD_TYPES: {
             };
         }>>>;
         parked: Type.TReadonly<Type.TImmutable<Type.TArray<Type.TUnsafe<import("@nyte-ai/schema").Id<"call">>>>>;
+        interrupted: Type.TReadonly<Type.TOptional<Type.TObject<{
+            count: Type.TReadonly<Type.TNumber>;
+            mark: Type.TReadonly<Type.TString>;
+        }>>>;
+        requires: Type.TReadonly<Type.TOptional<Type.TImmutable<Type.TArray<Type.TString>>>>;
     }>;
     part: Type.TObject<{
         id: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"part">>>;
@@ -1536,6 +1573,33 @@ export declare const STORED_RECORD_TYPES: {
         instance: Type.TReadonly<Type.TString>;
         expiresAt: Type.TReadonly<Type.TNumber>;
     }>;
+    process: Type.TObject<{
+        instance: Type.TReadonly<Type.TString>;
+        holder: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"host">>>;
+        label: Type.TReadonly<Type.TString>;
+        pid: Type.TReadonly<Type.TUnion<[Type.TNumber, Type.TNull]>>;
+        capabilities: Type.TReadonly<Type.TImmutable<Type.TArray<Type.TString>>>;
+        startedAt: Type.TReadonly<Type.TNumber>;
+    }>;
+    job: Type.TObject<{
+        id: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"job">>>;
+        instance: Type.TReadonly<Type.TString>;
+        workspace: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"workspace">>>;
+        session: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>>;
+        head: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"head">>>;
+        startedBy: Type.TReadonly<Type.TUnion<[Type.TUnsafe<import("@nyte-ai/schema").Id<"call">>, Type.TNull]>>;
+        title: Type.TReadonly<Type.TString>;
+        command: Type.TReadonly<Type.TString>;
+        startedAt: Type.TReadonly<Type.TNumber>;
+        end: Type.TReadonly<Type.TUnion<[Type.TUnsafe<{
+            readonly code: number | null;
+            readonly kind: "exited";
+            readonly reason: "exited" | "terminated" | "expired" | "host-lost";
+        } | {
+            readonly kind: "lost";
+        }>, Type.TNull]>>;
+        endedAt: Type.TReadonly<Type.TUnion<[Type.TNumber, Type.TNull]>>;
+    }>;
     call: Type.TObject<{
         id: Type.TReadonly<Type.TUnsafe<import("@nyte-ai/schema").Id<"call">>>;
         kind: Type.TReadonly<Type.TEnum<["tool", "action", "hook", "intent"]>>;
@@ -1990,6 +2054,8 @@ export declare const decodeTrustRecord: Decode<TrustRecord>;
 export declare const decodeCallRecord: Decode<CallRecord>;
 export declare const decodePrincipalRecord: Decode<PrincipalRecord>;
 export declare const decodeLease: Decode<Lease>;
+export declare const decodeProcessRecord: Decode<ProcessRecord>;
+export declare const decodeJobRecord: Decode<JobRecord>;
 export declare const decodeHostIdentity: Decode<HostIdentity>;
 export declare function decodeKvValue(object: Json | null): Json | undefined;
 export {};

package/dist/src/contract/records.js

@@ -13,19 +13,23 @@ import {
   decodeCallRecord2,
   decodePrincipalRecord2,
   decodeLease2,
+  decodeProcessRecord2,
+  decodeJobRecord2,
   decodeHostIdentity2,
   decodeKvValue2
-} from "../../chunks/compose-1jz2j92f.js";
+} from "../../chunks/compose-gxjc6vz9.js";
 export {
   STORED_RECORD_TYPES2 as STORED_RECORD_TYPES,
   decodeCallRecord2 as decodeCallRecord,
   decodeCommitRecord2 as decodeCommitRecord,
   decodeHostIdentity2 as decodeHostIdentity,
   decodeInboxRecord2 as decodeInboxRecord,
+  decodeJobRecord2 as decodeJobRecord,
   decodeKvValue2 as decodeKvValue,
   decodeLease2 as decodeLease,
   decodePartRecord2 as decodePartRecord,
   decodePrincipalRecord2 as decodePrincipalRecord,
+  decodeProcessRecord2 as decodeProcessRecord,
   decodeReceiptRecord2 as decodeReceiptRecord,
   decodeRunRecord2 as decodeRunRecord,
   decodeSeenRecord2 as decodeSeenRecord,

package/dist/src/contract/session.d.ts

@@ -80,7 +80,7 @@ export interface Sessions {
         readonly parents?: ParentFilter;
         readonly limit?: number;
     }): AsyncIterable<readonly SessionInfo[]>;
-    /** Starts a chat with its first message. One commit creates the session and admits the message, so no session exists without one; until then a client holds a draft. `id` is minted when absent and names the chat, its first message and its receipt. Pass it to key a draft or to retry: the same id and input return the same start. Other input under that id, or an id naming an existing chat, is refused as invalid. Resolves once the session's before_send hooks decided the message. A refusal, a failing hook, or a stop before the decision removes the session and throws. */
+    /** Starts a chat with its first message. One commit creates the session and admits the message, so no session exists without one; until then a client holds a draft. A person's client's `configuration` is remembered as `Head.configure` remembers it. `id` is minted when absent and names the chat, its first message and its receipt. Pass it to key a draft or to retry: the same id and input return the same start. Other input under that id, or an id naming an existing chat, is refused as invalid. Resolves once the session's before_send hooks decided the message. A refusal, a failing hook, or a stop before the decision removes the session and throws. */
     start(input: {
         readonly id?: SessionId;
         readonly name?: string;
@@ -105,6 +105,7 @@ export interface Head {
     readonly sessionId: SessionId;
     readonly name: HeadName;
     send(content: UserContent, options?: SendOptions): Promise<SendReceipt>;
+    /** A model switch without a level lands on the new model's `defaultThinking`. From a person's client, not a tool call or plugin, an accepted model becomes the default and an accepted level its model's `defaultThinking`. */
     configure(patch: ConfigurationPatch): Promise<ConfigureOutcome>;
     view(options?: ViewOptions): Promise<SessionView>;
     watch(options?: ViewOptions): AsyncIterable<SessionView>;

package/dist/src/contract/workspace.d.ts

@@ -1,4 +1,4 @@
-import type { AddOutcome, Availability, BackgroundItem, BatchOutcome, BlameView, BlobId, ByteReader, CallId, Capability, ChangeSet, CommandCompletion, ConsoleEntry, Cursor, DiffOptions, Disposer, DocumentRevision, EnvironmentIdentity, FileDocument, FileEntryView, FileEvent, FileVersion, ForgetOutcome, FormatOutcome, GitCommitView, GitFileSides, GitOutcome, GitRefsView, GitScope, GitStatus, GitWrite, GitHubAccountState, GitHubPullRequestInput, GitHubPullRequestOutcome, GitHubState, HeadName, JobChange, JobEnd, JobId, JobKey, JobView, Json, McpChange, McpScope, McpServerConfig, McpView, OutputFrame, Paged, PageId, PageInfo, PageOutcome, PageSnapshot, PageView, PatchEntry, PatchSet, ReceiptId, RequestOptions, RunId, ScanFrame, SearchFrame, SearchInput, SessionId, SnapshotId, StopOutcome, WorkspaceCatalogView, WorkspaceCommandOutcome, WorkspaceId, WorkspaceInfo, WorkspaceInspection, WorkspaceTarget, WriteOutcome } from "@nyte-ai/schema";
+import type { AddOutcome, Availability, BackgroundItem, BatchOutcome, BlameView, BlobId, ByteReader, CallId, Capability, ChangeSet, ChangeSource, CommandCompletion, ConsoleEntry, Cursor, DiffOptions, Disposer, DocumentRevision, EnvironmentIdentity, FileDocument, FileEntryView, FileEvent, FileVersion, ForgetOutcome, FormatOutcome, GitCommitView, GitFileSides, GitOutcome, GitRefsView, GitScope, GitStatus, GitWrite, GitHubAccountState, GitHubPullRequestInput, GitHubPullRequestOutcome, GitHubState, HeadName, JobChange, JobEnd, JobId, JobKey, JobView, Json, McpChange, McpScope, McpServerConfig, McpView, OutputFrame, Paged, PageId, PageInfo, PageOutcome, PageSnapshot, PageView, PatchEntry, PatchSet, ReceiptId, RequestOptions, RunId, ScanFrame, SearchFrame, SearchInput, SessionId, SnapshotId, StopOutcome, WorkspaceCatalogView, WorkspaceCommandOutcome, WorkspaceId, WorkspaceInfo, WorkspaceInspection, WorkspaceTarget, WriteOutcome } from "@nyte-ai/schema";
 import type { Login, PluginStorage } from "./host.ts";
 import type { Receipt } from "./session.ts";
 import type { ToolDefinition } from "./tools.ts";
@@ -463,8 +463,10 @@ export interface Workspace {
     completeCommand(name: string, prefix: string): Promise<readonly CommandCompletion[]>;
     readonly jobs: Jobs;
     job(id: JobId): Job;
-    changes(run: RunId): Promise<ChangeSet>;
-    patches(run: RunId, paths: readonly string[], options?: DiffOptions): AsyncIterable<PatchSet>;
+    /** The files `source` changed: a run's from its first snapshot to its last (the workspace as it is now while it runs), a session's from its first run's first snapshot to its latest run's last (now while one runs). Throws `SdkError("unavailable")` for a session no run has snapshotted. */
+    changes(source: ChangeSource): Promise<ChangeSet>;
+    /** The patches of `paths` over the range {@link Workspace.changes} reads for `source`. */
+    patches(source: ChangeSource, paths: readonly string[], options?: DiffOptions): AsyncIterable<PatchSet>;
     files(): Promise<Capability<FilesApi>>;
     git(): Promise<Capability<GitApi>>;
     /** GitHub through the serving machine's `gh`; `unsupported` where the provider serves none. */

package/dist/src/drive/execution.js

@@ -5,58 +5,61 @@ import {
   repair2,
   driveInProcess2,
   dispatchHead2
-} from "../../chunks/compose-rpq9n0nz.js";
-import"../../chunks/compose-aa73dbe8.js";
-import"../../chunks/compose-madtxnp1.js";
-import"../../chunks/compose-vmhv4e00.js";
-import"../../chunks/compose-dc2ns6gd.js";
-import"../../chunks/compose-s2aew2c9.js";
-import"../../chunks/compose-064y3n82.js";
-import"../../chunks/compose-q1b0tppc.js";
-import"../../chunks/compose-b5xz0dj7.js";
-import"../../chunks/compose-eqr5qwp1.js";
-import"../../chunks/compose-1gd9vkye.js";
-import"../../chunks/compose-y478gv6x.js";
-import"../../chunks/compose-5w5bbakh.js";
-import"../../chunks/compose-0bpspysf.js";
-import"../../chunks/compose-9tqm6g18.js";
-import"../../chunks/compose-t53j8yxv.js";
-import"../../chunks/compose-yn2et568.js";
-import"../../chunks/compose-rehp8epe.js";
+} from "../../chunks/compose-xaegezm3.js";
+import"../../chunks/compose-hms4hf6p.js";
+import"../../chunks/compose-bd8c5n7k.js";
+import"../../chunks/compose-5rg7askh.js";
+import"../../chunks/compose-47f47sgy.js";
+import"../../chunks/compose-gvm49f4b.js";
+import"../../chunks/compose-jehg40ce.js";
+import"../../chunks/compose-seyhq3fb.js";
+import"../../chunks/compose-gxvetm0j.js";
+import"../../chunks/compose-r1pxdxbw.js";
+import"../../chunks/compose-0827b2k4.js";
+import"../../chunks/compose-qwbe95qs.js";
+import"../../chunks/compose-tb5ywdfk.js";
+import"../../chunks/compose-v9yf9mrh.js";
+import"../../chunks/compose-mamr4qwf.js";
+import"../../chunks/compose-h3pch7ch.js";
+import"../../chunks/compose-qknd62yj.js";
+import"../../chunks/compose-57j0pme0.js";
+import"../../chunks/compose-se7wwcq1.js";
+import"../../chunks/compose-y9c31w4e.js";
+import"../../chunks/compose-eemt6sea.js";
 import"../../chunks/compose-vzvm76dn.js";
-import"../../chunks/compose-cdy4q5mv.js";
+import"../../chunks/compose-pe0cgbv0.js";
 import"../../chunks/compose-rb9gqgp9.js";
-import"../../chunks/compose-52afaf3v.js";
-import"../../chunks/compose-p3q14yt1.js";
+import"../../chunks/compose-prchdrqk.js";
+import"../../chunks/compose-g2a1f1yx.js";
 import"../../chunks/compose-66009v9f.js";
-import"../../chunks/compose-9m19b27b.js";
+import"../../chunks/compose-gvrqkyn4.js";
 import"../../chunks/compose-ac5efwd1.js";
-import"../../chunks/compose-ef936rsa.js";
-import"../../chunks/compose-6vf6dkk2.js";
-import"../../chunks/compose-xpfr4wt3.js";
-import"../../chunks/compose-7b8ajk7a.js";
-import"../../chunks/compose-2eg8w67t.js";
-import"../../chunks/compose-pgeemk2b.js";
-import"../../chunks/compose-7k6nsmtq.js";
-import"../../chunks/compose-jc22rsz4.js";
+import"../../chunks/compose-ks2rdteq.js";
+import"../../chunks/compose-xhtgytrh.js";
+import"../../chunks/compose-pnsvwd3m.js";
+import"../../chunks/compose-rd5e5nxg.js";
+import"../../chunks/compose-6r5ymwyr.js";
+import"../../chunks/compose-a7k9h27z.js";
+import"../../chunks/compose-6gt28900.js";
+import"../../chunks/compose-dbsn3bsy.js";
 import"../../chunks/compose-1c6w12g1.js";
-import"../../chunks/compose-jjchxce6.js";
-import"../../chunks/compose-q1ts0v6k.js";
-import"../../chunks/compose-cq1zx4gp.js";
-import"../../chunks/compose-drdej9yt.js";
-import"../../chunks/compose-n10w4nkk.js";
+import"../../chunks/compose-j42p9wfs.js";
+import"../../chunks/compose-767bb340.js";
+import"../../chunks/compose-h14pmqv3.js";
+import"../../chunks/compose-c2rnebv0.js";
+import"../../chunks/compose-vn7b7fdj.js";
 import"../../chunks/compose-84272xbk.js";
-import"../../chunks/compose-mryw0674.js";
+import"../../chunks/compose-5z835ej2.js";
 import"../../chunks/compose-bjx8s01m.js";
 import"../../chunks/compose-n116fnmp.js";
 import"../../chunks/compose-zfjxkavf.js";
 import"../../chunks/compose-bj54tkph.js";
 import"../../chunks/compose-sd0stm97.js";
-import"../../chunks/compose-k35b75k9.js";
-import"../../chunks/compose-j12n448k.js";
+import"../../chunks/compose-kwkna3cg.js";
+import"../../chunks/compose-nj4nj5n9.js";
 import"../../chunks/compose-0wq555bd.js";
-import"../../chunks/compose-kb22bkpt.js";
-import"../../chunks/compose-1jz2j92f.js";
+import"../../chunks/compose-cqpjcx2t.js";
+import"../../chunks/compose-gxjc6vz9.js";
 import"../../chunks/compose-ry29956g.js";
 import"../../chunks/compose-q6c7wswc.js";
 export {

package/dist/src/drive/interruptions.d.ts

@@ -0,0 +1,7 @@
+import type { Failure, HeadName, RefUpdate, SessionId } from "@nyte-ai/schema";
+import type { Kernel } from "../contract/kernel.ts";
+import type { RunRecord } from "../contract/records.ts";
+export declare const RESTART_LIMIT = 5;
+export declare function crashLooping(record: RunRecord): boolean;
+export declare function parkedFailure(record: RunRecord): Failure;
+export declare function interruption(kernel: Kernel, session: SessionId, head: HeadName): Promise<readonly RefUpdate[]>;

package/dist/src/drive/interruptions.js

@@ -0,0 +1,17 @@
+import {
+  RESTART_LIMIT2,
+  crashLooping2,
+  parkedFailure2,
+  interruption2
+} from "../../chunks/compose-5rg7askh.js";
+import"../../chunks/compose-vn7b7fdj.js";
+import"../../chunks/compose-n116fnmp.js";
+import"../../chunks/compose-cqpjcx2t.js";
+import"../../chunks/compose-gxjc6vz9.js";
+import"../../chunks/compose-q6c7wswc.js";
+export {
+  RESTART_LIMIT2 as RESTART_LIMIT,
+  crashLooping2 as crashLooping,
+  interruption2 as interruption,
+  parkedFailure2 as parkedFailure
+};

package/dist/src/engine/admission.js

@@ -5,38 +5,38 @@ import {
   landing2,
   admitDeciding2,
   readmitDeciding2
-} from "../../chunks/compose-cdy4q5mv.js";
+} from "../../chunks/compose-pe0cgbv0.js";
 import"../../chunks/compose-rb9gqgp9.js";
-import"../../chunks/compose-52afaf3v.js";
-import"../../chunks/compose-p3q14yt1.js";
+import"../../chunks/compose-prchdrqk.js";
+import"../../chunks/compose-g2a1f1yx.js";
 import"../../chunks/compose-66009v9f.js";
-import"../../chunks/compose-9m19b27b.js";
+import"../../chunks/compose-gvrqkyn4.js";
 import"../../chunks/compose-ac5efwd1.js";
-import"../../chunks/compose-ef936rsa.js";
-import"../../chunks/compose-6vf6dkk2.js";
-import"../../chunks/compose-xpfr4wt3.js";
-import"../../chunks/compose-7b8ajk7a.js";
-import"../../chunks/compose-2eg8w67t.js";
-import"../../chunks/compose-pgeemk2b.js";
-import"../../chunks/compose-7k6nsmtq.js";
-import"../../chunks/compose-jc22rsz4.js";
+import"../../chunks/compose-ks2rdteq.js";
+import"../../chunks/compose-xhtgytrh.js";
+import"../../chunks/compose-pnsvwd3m.js";
+import"../../chunks/compose-rd5e5nxg.js";
+import"../../chunks/compose-6r5ymwyr.js";
+import"../../chunks/compose-a7k9h27z.js";
+import"../../chunks/compose-6gt28900.js";
+import"../../chunks/compose-dbsn3bsy.js";
 import"../../chunks/compose-1c6w12g1.js";
-import"../../chunks/compose-jjchxce6.js";
-import"../../chunks/compose-q1ts0v6k.js";
-import"../../chunks/compose-cq1zx4gp.js";
-import"../../chunks/compose-drdej9yt.js";
-import"../../chunks/compose-n10w4nkk.js";
+import"../../chunks/compose-j42p9wfs.js";
+import"../../chunks/compose-767bb340.js";
+import"../../chunks/compose-h14pmqv3.js";
+import"../../chunks/compose-c2rnebv0.js";
+import"../../chunks/compose-vn7b7fdj.js";
 import"../../chunks/compose-84272xbk.js";
-import"../../chunks/compose-mryw0674.js";
+import"../../chunks/compose-5z835ej2.js";
 import"../../chunks/compose-bjx8s01m.js";
 import"../../chunks/compose-n116fnmp.js";
 import"../../chunks/compose-bj54tkph.js";
 import"../../chunks/compose-sd0stm97.js";
-import"../../chunks/compose-k35b75k9.js";
-import"../../chunks/compose-j12n448k.js";
+import"../../chunks/compose-kwkna3cg.js";
+import"../../chunks/compose-nj4nj5n9.js";
 import"../../chunks/compose-0wq555bd.js";
-import"../../chunks/compose-kb22bkpt.js";
-import"../../chunks/compose-1jz2j92f.js";
+import"../../chunks/compose-cqpjcx2t.js";
+import"../../chunks/compose-gxjc6vz9.js";
 import"../../chunks/compose-q6c7wswc.js";
 export {
   admitDeciding2 as admitDeciding,