@nyte-ai/core 0.0.18 → 0.0.21

package/dist/src/compose.js

@@ -3,90 +3,95 @@ import {
   composeServer2,
   hostIdentity2,
   createKernel2
-} from "../chunks/compose-1z7q169s.js";
-import"../chunks/compose-k8aghhv2.js";
-import"../chunks/compose-r12cnkpc.js";
-import"../chunks/compose-djq2bt61.js";
-import"../chunks/compose-4b1zf3p0.js";
-import"../chunks/compose-7pc3p5ex.js";
-import"../chunks/compose-xm52jghq.js";
-import"../chunks/compose-j3tkz0tb.js";
-import"../chunks/compose-gg8b9b21.js";
-import"../chunks/compose-xtkavyrw.js";
-import"../chunks/compose-wgphshsn.js";
+} from "../chunks/compose-q2zxbg41.js";
+import"../chunks/compose-pkprmn5b.js";
+import"../chunks/compose-wvzzf8n2.js";
 import"../chunks/compose-e3635qmn.js";
-import"../chunks/compose-n93897b0.js";
-import"../chunks/compose-amr0k1m1.js";
+import"../chunks/compose-12jnd50a.js";
+import"../chunks/compose-jd4bsnqh.js";
+import"../chunks/compose-c4238qkb.js";
+import"../chunks/compose-sprfv38c.js";
+import"../chunks/compose-m91ffwss.js";
+import"../chunks/compose-b2bf1jvy.js";
 import"../chunks/compose-597de3tc.js";
 import"../chunks/compose-kevyezbv.js";
-import"../chunks/compose-rpq9n0nz.js";
-import"../chunks/compose-aa73dbe8.js";
-import"../chunks/compose-madtxnp1.js";
-import"../chunks/compose-5tkyrzr0.js";
-import"../chunks/compose-vmhv4e00.js";
-import"../chunks/compose-dc2ns6gd.js";
-import"../chunks/compose-yk3y0jap.js";
-import"../chunks/compose-s2aew2c9.js";
-import"../chunks/compose-r7dx7rpz.js";
-import"../chunks/compose-gaps3heh.js";
-import"../chunks/compose-0rx7ygxq.js";
-import"../chunks/compose-2g3enfv5.js";
-import"../chunks/compose-xd0kdp3t.js";
-import"../chunks/compose-064y3n82.js";
-import"../chunks/compose-q1b0tppc.js";
-import"../chunks/compose-b5xz0dj7.js";
-import"../chunks/compose-kmzr06mw.js";
-import"../chunks/compose-d2s80zg2.js";
-import"../chunks/compose-q1n2dgrs.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";
+import"../chunks/compose-zjj072km.js";
+import"../chunks/compose-e9f6nrwp.js";
+import"../chunks/compose-r8tz1xfj.js";
+import"../chunks/compose-1r0wr5dc.js";
+import"../chunks/compose-xm52jghq.js";
+import"../chunks/compose-8mkfr84d.js";
+import"../chunks/compose-mcz93154.js";
+import"../chunks/compose-a8ddt55n.js";
+import"../chunks/compose-bd8c5n7k.js";
+import"../chunks/compose-5rg7askh.js";
+import"../chunks/compose-matk94se.js";
+import"../chunks/compose-gvm49f4b.js";
+import"../chunks/compose-jwy1gba9.js";
+import"../chunks/compose-qxfq6dn9.js";
+import"../chunks/compose-0m65m83c.js";
+import"../chunks/compose-e2fyz3xc.js";
+import"../chunks/compose-mdwr0er9.js";
+import"../chunks/compose-9hy3p236.js";
+import"../chunks/compose-zaanjpb7.js";
+import"../chunks/compose-jeemzja1.js";
+import"../chunks/compose-753gc057.js";
+import"../chunks/compose-ae5t6v5b.js";
+import"../chunks/compose-c9wxgbjp.js";
+import"../chunks/compose-qwbe95qs.js";
+import"../chunks/compose-hfsn6pnt.js";
+import"../chunks/compose-hfrjm4a1.js";
+import"../chunks/compose-1knxqqm1.js";
+import"../chunks/compose-d1m94kzq.js";
+import"../chunks/compose-gj2ypr7q.js";
+import"../chunks/compose-yfcb6w2h.js";
+import"../chunks/compose-jmmyw9hd.js";
+import"../chunks/compose-8pp3vtv0.js";
+import"../chunks/compose-4ppmas7g.js";
+import"../chunks/compose-2rha31fc.js";
+import"../chunks/compose-m01wspwf.js";
+import"../chunks/compose-nkxwrphm.js";
+import"../chunks/compose-byse0eqj.js";
 import"../chunks/compose-vzvm76dn.js";
-import"../chunks/compose-cdy4q5mv.js";
+import"../chunks/compose-t9fcqtby.js";
+import"../chunks/compose-ac5efwd1.js";
 import"../chunks/compose-rb9gqgp9.js";
-import"../chunks/compose-52afaf3v.js";
-import"../chunks/compose-p3q14yt1.js";
+import"../chunks/compose-fnncnk81.js";
+import"../chunks/compose-tppkp915.js";
 import"../chunks/compose-66009v9f.js";
-import"../chunks/compose-9m19b27b.js";
-import"../chunks/compose-ac5efwd1.js";
-import"../chunks/compose-ef936rsa.js";
-import"../chunks/compose-6vf6dkk2.js";
+import"../chunks/compose-w6zb11k1.js";
+import"../chunks/compose-bz70g01d.js";
+import"../chunks/compose-xhtgytrh.js";
 import"../chunks/compose-7tf625s3.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-bbhk8vnr.js";
+import"../chunks/compose-ad80nkkn.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-ffk8dnbh.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-smsafpqe.js";
+import"../chunks/compose-d95fwwvw.js";
+import"../chunks/compose-vn7b7fdj.js";
 import"../chunks/compose-rxsqmcgq.js";
 import"../chunks/compose-84272xbk.js";
 import"../chunks/compose-7w4ebjp1.js";
-import"../chunks/compose-mryw0674.js";
-import"../chunks/compose-bjx8s01m.js";
+import"../chunks/compose-5z835ej2.js";
+import"../chunks/compose-fqsqjbrf.js";
 import"../chunks/compose-n116fnmp.js";
 import"../chunks/compose-zfjxkavf.js";
 import"../chunks/compose-bj54tkph.js";
 import"../chunks/compose-j50h13pg.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-dbx6ftbm.js";
-import"../chunks/compose-kb22bkpt.js";
-import"../chunks/compose-1jz2j92f.js";
+import"../chunks/compose-csh5vv2t.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/contract/fold.d.ts

@@ -46,6 +46,7 @@ export interface FoldInput {
         readonly previous: MessageId;
         readonly stopped: RunId | null;
     } | null;
+    readonly requires: readonly string[] | null;
     readonly landed: {
         readonly commit: CommitId;
         readonly run: RunId | null;
@@ -66,9 +67,6 @@ export interface FoldTurn {
     readonly head: HeadName;
     readonly live: readonly CallId[];
 }
-export type UserMessage = Extract<Message, {
-    readonly kind: "user";
-}>;
 export type Logged<Kind extends SessionEvent["kind"]> = Extract<SessionEvent, {
     readonly kind: Kind;
 }>;

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/parts.d.ts

@@ -137,6 +137,7 @@ export declare const tool: PartDefinition<{
     readonly name: string;
     readonly call: import("@nyte-ai/schema").Id<"call">;
     readonly changes: {
+        readonly unattributed?: true | undefined;
         readonly removed: number;
         readonly added: number;
         readonly paths: readonly string[];
@@ -193,6 +194,9 @@ export declare const tool: PartDefinition<{
     readonly stop: {
         readonly input: Schema<Record<string, never>>;
     };
+    readonly background: {
+        readonly input: Schema<Record<string, never>>;
+    };
 }>;
 export declare const compaction: PartDefinition<{
     usage: {

package/dist/src/contract/parts.js

@@ -6,7 +6,7 @@ import {
   tool2,
   compaction2,
   branchSummary2
-} from "../../chunks/compose-bjx8s01m.js";
+} from "../../chunks/compose-fqsqjbrf.js";
 import"../../chunks/compose-bj54tkph.js";
 export {
   branchSummary2 as branchSummary,

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/tools.d.ts

@@ -1,7 +1,7 @@
 import type { Awaitable, CallId, HeadName, Json, RunId, Schema, ToolClass, ToolInfo, ToolOutcome, ToolProgress, ToolResult, WaitOutcome, WaitTarget } from "@nyte-ai/schema";
 import type { Connection } from "./host.ts";
 import type { Session } from "./session.ts";
-import type { ExecutionEnv, Workspace } from "./workspace.ts";
+import type { ExecutionEnv, Job, Workspace } from "./workspace.ts";
 export interface ToolInvocation extends Durable {
     readonly run: RunId;
     readonly call: CallId;
@@ -12,6 +12,7 @@ export interface ToolInvocation extends Durable {
     readonly workspace: Workspace;
     readonly env: ExecutionEnv;
     progress(update: ToolProgress): void;
+    readonly foreground: ForegroundJobs;
     readonly tools: {
         execute(name: string, args: Json, options?: {
             readonly key?: string;
@@ -20,6 +21,14 @@ export interface ToolInvocation extends Durable {
         list(): readonly ToolInfo[];
     };
 }
+export interface ForegroundJobs {
+    start(input: {
+        readonly command: string;
+        readonly title?: string;
+    }): Promise<Job>;
+    release(): boolean;
+    readonly released: AbortSignal;
+}
 export interface Durable {
     wait(target: WaitTarget | {
         readonly kind: "any" | "all";