@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-modules/lib/types/index.js

@@ -2,10 +2,11 @@
  * Node half of the client module system (`nomix.client` dual-face package): scans
  * the host Loader's entries for packages declaring `nomix.client`, composes the
  * `window.__NOMIX_BOOT__` entry graph (wire single source: {@link WebBootEntry}
- * in `./client/manifest.ts`), serves `/plugins/<id>/client.js` and its source
- * map, taps the index render to inject the boot manifest, and provides the
- * `clientModuleHost` service (the HMR node half's registration/notification
- * face).
+ * in `./client/manifest.ts`) in module-graph order, serves
+ * `/plugins/<id>/client.js` and its source map, contributes the boot manifest
+ * plus the parser-blocking bootstrap preloads to the webserver's index
+ * injection table, and provides the `clientModuleHost` service (the HMR node
+ * half's registration/notification face).
  *
  * Scanning is incremental per package — there is no full-rescan code path.
  * Every cordis `internal/plugin` emission (fiber construction/disposal) marks
@@ -25,6 +26,8 @@ import { readFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
 import { Service } from '../../../cordis/lib/index.js';
+import { optionalStringArray, stripClientSuffix } from "./client/manifest.js";
+export { stripClientSuffix } from "./client/manifest.js";
 /** Recovery instruction shared by grouped startup and steady-state bundle diagnostics. */
 const CLIENT_BUNDLE_BUILD_INSTRUCTION = 'run `pnpm run build` before launch';
 /** Missing built client export, retained as structured data for activation-error grouping. */
@@ -71,15 +74,15 @@ function parseNomixClient(pkgName, value) {
     if (typeof decl.platform !== 'string') {
         throw new Error(`client-modules: ${pkgName} nomix.client.platform must be a string`);
     }
-    if (decl.inject !== undefined && (!Array.isArray(decl.inject) || decl.inject.some(i => typeof i !== 'string'))) {
-        throw new Error(`client-modules: ${pkgName} nomix.client.inject must be a string array`);
-    }
+    const inject = optionalStringArray(pkgName, 'nomix.client.inject', decl.inject);
+    const external = optionalStringArray(pkgName, 'nomix.client.external', decl.external);
     if (decl.immediately !== undefined && typeof decl.immediately !== 'boolean') {
         throw new Error(`client-modules: ${pkgName} nomix.client.immediately must be a boolean`);
     }
     return {
         platform: decl.platform,
-        ...(decl.inject !== undefined ? { inject: decl.inject } : {}),
+        ...(inject !== undefined ? { inject } : {}),
+        ...(external !== undefined ? { external } : {}),
         ...(decl.immediately !== undefined ? { immediately: decl.immediately } : {}),
     };
 }
@@ -104,35 +107,111 @@ function shortHash(input) {
     return createHash('sha1').update(input).digest('hex').slice(0, 12);
 }
 /** Graph row for one bundle rev (url carries the rev as its cache-busting query). */
-function graphRow(id, rev, injectEdges, immediately) {
+function graphRow(id, rev, fields) {
     return {
         id,
         url: `/plugins/${id}/client.js?rev=${rev}`,
         rev,
-        ...(injectEdges !== undefined ? { inject: injectEdges } : {}),
-        ...(immediately ? { immediately: true } : {}),
+        ...(fields.inject !== undefined ? { inject: fields.inject } : {}),
+        ...(fields.immediately ? { immediately: true } : {}),
+        ...(fields.external.length > 0 ? { external: fields.external } : {}),
+    };
+}
+/**
+ * Order composed rows so every requested dynamic package precedes its
+ * consumers. An `external` specifier is either the package row it names
+ * (`<pkg>/client` aliases the bare package) or a static-table name that adds no
+ * graph edge.
+ * @param entries - composed rows in scan order.
+ * @returns the same rows reordered; scan order breaks every tie.
+ * @throws {Error} when a row requests itself or when the module graph has a
+ * cycle; the message lists the packages on it.
+ */
+export function orderByModuleGraph(entries) {
+    const rowsById = new Map();
+    for (const entry of entries)
+        rowsById.set(entry.id, entry);
+    const ordered = [];
+    const placed = new Set();
+    const open = [];
+    const visit = (entry) => {
+        if (placed.has(entry.id))
+            return;
+        const cycleStart = open.indexOf(entry.id);
+        if (cycleStart !== -1) {
+            throw new Error(`client-modules: module graph cycle ${[...open.slice(cycleStart), entry.id].join(' -> ')} `
+                + '— a requested package row must precede its consumers, and factory-form CJS cannot deliver partial exports');
+        }
+        open.push(entry.id);
+        for (const name of entry.external ?? []) {
+            const dependency = rowsById.get(name) ?? rowsById.get(stripClientSuffix(name));
+            if (dependency === entry) {
+                throw new Error(`client-modules: "${entry.id}" requests module "${name}" that it answers itself `
+                    + '— a row must not declare its own package in nomix.client.external');
+            }
+            if (dependency !== undefined)
+                visit(dependency);
+        }
+        open.pop();
+        placed.add(entry.id);
+        ordered.push(entry);
     };
+    for (const entry of entries)
+        visit(entry);
+    return ordered;
 }
+/** Bootstrap package whose ordinary client bundle supplies the module-system implementation. */
+const CLIENT_MODULES_ID = '@nomix-ai/nomix-client-modules';
+/** Dynamic package whose ordinary client bundle must be registered before plugin boot starts. */
+const CLIENT_RUNTIME_ID = '@nomix-ai/nomix-client-runtime';
+/** Ordinary dynamic bundles the HTML parser executes before the Vite shell. */
+const PARSER_PRELOAD_IDS = [CLIENT_MODULES_ID, CLIENT_RUNTIME_ID];
 /**
- * Inject the boot entry graph into index.html: `window.__NOMIX_BOOT__` as the
- * first script in <head> (before the shell bundle reads it). `<` is escaped in
- * the JSON so plugin-controlled strings cannot break out of the script element.
- * @param html - the index.html source.
+ * The boot protocol as index injection rows. The inline registration queue
+ * precedes blocking classic scripts for modules' and runtime's ordinary
+ * `lib/client.js` artifacts. Its `create()` method materializes the modules
+ * bundle, delegates construction to that bundle, and leaves the same facade
+ * in live-registration mode. The graph global follows before the shell reads
+ * it.
  * @param graph - the composed entry graph.
- * @returns the html with the graph script injected.
+ * @returns head rows in execution order: queue script, preload scripts, graph global.
  */
-export function injectBootManifest(html, graph) {
-    const json = JSON.stringify(graph).replaceAll('<', '\\u003c');
-    const script = `<script>window.__NOMIX_BOOT__ = ${json}</script>`;
-    const head = html.indexOf('<head>');
-    if (head !== -1)
-        return `${html.slice(0, head + 6)}${script}${html.slice(head + 6)}`;
-    // Headless fixture pages may lack <head>; prepending keeps the read-before-shell ordering.
-    return `${script}${html}`;
+export function bootInjections(graph) {
+    const bootstrapId = JSON.stringify(CLIENT_MODULES_ID);
+    const queue = `(()=>{
+const pendingQueue=[]
+window.__ModuleLoader__={
+  mode:"queue",
+  pendingQueue,
+  load(registration){pendingQueue.push(registration)},
+  create(options){
+    if(this.mode!=="queue")throw new Error("client-modules: window.__ModuleLoader__.create called after module-system boot")
+    const index=pendingQueue.findIndex(registration=>registration.id===${bootstrapId})
+    const registration=pendingQueue[index]
+    if(registration===undefined)throw new Error("client-modules: HTML did not preload ${CLIENT_MODULES_ID}/client.js")
+    pendingQueue.splice(index,1)
+    const exports=registration.factory(specifier=>{
+      throw new Error('client-modules: ${CLIENT_MODULES_ID}/client.js requested external "'+specifier+'" before the module system existed')
+    })
+    if(typeof exports!=="object"||exports===null||typeof exports.createClientModuleSystem!=="function"||typeof exports.apply!=="function"){
+      throw new Error("client-modules: ${CLIENT_MODULES_ID}/client.js did not export the bootstrap module face")
+    }
+    return exports.createClientModuleSystem(this,{id:registration.id,exports},options)
+  }
+}
+})()`;
+    const preload = PARSER_PRELOAD_IDS.map(id => graph.entries.find(entry => entry.id === id))
+        .filter((entry) => entry !== undefined)
+        .map((entry) => ({ kind: 'script-src', placement: 'head', src: entry.url }));
+    return [
+        { kind: 'script', placement: 'head', text: queue },
+        ...preload,
+        { kind: 'global', name: '__NOMIX_BOOT__', value: graph },
+    ];
 }
 /**
  * The web plugin table service: incremental `nomix.client` scan + wire composition
- * + bundle route + index tap. Construction runs the activation scan
+ * + bundle route + index injection rows. Construction runs the activation scan
  * synchronously — a malformed declaration or missing bundle among the
  * already-loaded entries aggregates into one loud throw (FAILED fiber; the
  * boot activation audit reports it).
@@ -193,7 +272,9 @@ export class ClientModuleRegistry extends Service {
             throw new ClientPackageCompositionError(failures);
         }
         ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: '/plugins', handler: this.serveBundle }), 'client-modules: bundle route');
-        ctx.effect(() => ctx.webServer.tapIndex(html => injectBootManifest(html, this.composed)), 'client-modules: boot manifest injection');
+        ctx.on('webserver/index-inject', (table) => {
+            table.push(...bootInjections(this.composed));
+        });
     }
     /**
      * Current composed entry graph (stable object between changes).
@@ -208,7 +289,7 @@ export class ClientModuleRegistry extends Service {
      * @returns the path, or undefined for an unknown id.
      */
     clientPath(id) {
-        return this.table.get(id)?.clientPath;
+        return this.table.get(id)?.meta.clientPath;
     }
     /**
      * Re-hash one bundle (the HMR watch's registration hook — the only entry
@@ -220,10 +301,10 @@ export class ClientModuleRegistry extends Service {
         const record = this.table.get(id);
         if (record === undefined)
             return undefined;
-        const rev = shortHash(readFileSync(record.clientPath));
+        const rev = shortHash(readFileSync(record.meta.clientPath));
         if (rev === record.entry.rev)
             return rev;
-        record.entry = graphRow(id, rev, record.entry.inject, record.entry.immediately === true);
+        record.entry = graphRow(id, rev, record.meta);
         this.composed = this.compose();
         for (const notify of this.rebuildListeners) {
             // Containment: rebuilt() runs inside the HMR watch callback — a
@@ -258,7 +339,7 @@ export class ClientModuleRegistry extends Service {
         return () => { this.graphListeners.delete(listener); };
     }
     compose() {
-        const entries = [...this.table.values()].map(record => record.entry);
+        const entries = orderByModuleGraph([...this.table.values()].map(record => record.entry));
         return { rev: shortHash(JSON.stringify(entries)), entries };
     }
     notifyGraphChanged() {
@@ -301,6 +382,7 @@ export class ClientModuleRegistry extends Service {
         const meta = {
             clientPath: join(dirname(pkgPath), clientRel),
             ...(decl.inject !== undefined ? { inject: decl.inject } : {}),
+            external: decl.external ?? [],
             immediately: decl.immediately === true,
         };
         this.pkgMeta.set(pkgName, meta);
@@ -342,7 +424,7 @@ export class ClientModuleRegistry extends Service {
         // The rev rides the row from here on: a fiber restart reuses the row (and
         // its rev) untouched; only rebuilt() re-reads the bundle.
         const rev = this.initialBundleRevision(entryName, meta.clientPath);
-        this.table.set(entryName, { entry: graphRow(entryName, rev, meta.inject, meta.immediately), clientPath: meta.clientPath });
+        this.table.set(entryName, { entry: graphRow(entryName, rev, meta), meta });
         return true;
     }
     flush(onError) {
@@ -359,10 +441,22 @@ export class ClientModuleRegistry extends Service {
                 onError(error instanceof Error ? error : new Error(String(error)));
             }
         }
-        if (changed) {
-            this.composed = this.compose();
-            this.notifyGraphChanged();
+        if (!changed)
+            return;
+        let composed;
+        try {
+            composed = this.compose();
         }
+        catch (error) {
+            // An unorderable module graph is a property of the whole table, not of
+            // the arriving package, so it surfaces here: aggregated into the
+            // activation throw, or warned in steady state while the last orderable
+            // graph stays served.
+            onError(error);
+            return;
+        }
+        this.composed = composed;
+        this.notifyGraphChanged();
     }
     serveBundle = async (req, res) => {
         if (req.method !== 'GET' && req.method !== 'HEAD') {

package/dist/kernel/client-modules/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-modules",
   "description": "Client module system, dual-face: node half composes the __NOMIX_BOOT__ entry graph (incremental nomix.client scan, bundle route, index tap, webPlugins service); browser half is the lazy-CJS module table the vendored cordis Loader consumes as its internal seam",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -55,6 +55,8 @@
   ],
   "peerDependencies": {
     "@nomix-ai/nomix-invariants": "workspace:^",
-    "@nomix-ai/cordis": "workspace:^"
+    "@nomix-ai/cordis": "workspace:^",
+    "@nomix-ai/cordis-plugin-loader": "workspace:^",
+    "@nomix-ai/nomix-host-webserver": "workspace:^"
   }
 }

package/dist/kernel/client-runtime/lib/client.js

@@ -113,7 +113,7 @@ window.__ModuleLoader__.load({
 				};
 			}
 			/**
-			* Install the shell's renderer (web-react's createSlotRenderer product).
+			* Install the shell's renderer (ui-renderer's createSlotRenderer product).
 			* Boot-once: a second install throws. Runs through the caller's ctx.effect,
 			* so shell fiber unload uninstalls the renderer.
 			* @param renderer - the outlet machinery implementing SlotRenderer.
@@ -5347,9 +5347,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* shell over it: {@link defineStore} bakes an init/persist/actions literal
 		* into a {@link StoreHandle}, the registration-side store seat of slot
 		* terminals. Lives in the React-free runtime (the data layer owns its
-		* engine; web-react is shell-only React
+		* engine; ui-renderer is shell-only React
 		* glue): engine products are bare observables — subscribe/getSnapshot/
-		* update/set, NO selector hook. Hook synthesis is web-react's (the one
+		* update/set, NO selector hook. Hook synthesis is ui-renderer's (the one
 		* uSES bridge, cached per source at the binding site).
 		*/
 		/**
@@ -7193,7 +7193,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			* @param mode - queue appends after the current turn; steer interrupts it.
 			* @returns the prompt result (also mirrored into promptError on failure).
 			*/
-			async prompt(content, mode) {
+			async prompt(content, mode, signal) {
 				this.promptError = null;
 				this.lastAgentError = null;
 				this.promptAttempted = true;
@@ -7206,7 +7206,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						mode,
 						content,
 						clientTimeZone: resolvedClientTimeZone()
-					})).result;
+					}, signal)).result;
 					else if (this.address.mode === "one-shot") result = {
 						ok: false,
 						error: {
@@ -7231,7 +7231,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 								text: part.text
 							}] : []),
 							clientTimeZone: resolvedClientTimeZone()
-						})).result;
+						}, signal)).result;
 						result = routed.ok ? {
 							ok: true,
 							value: { accepted: true }
@@ -7363,7 +7363,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			* @returns the admission result, or the error branch on transport failure.
 			*/
 			async command(line) {
-				const result = await this.remote.commands.execute(this.sessionId, line);
+				const result = await this.remote.commands.execute(this.sessionId, line, []);
 				if (!result.ok) return result;
 				return {
 					ok: true,
@@ -10295,10 +10295,31 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* @returns an absolute path when a workspace root is available, otherwise the original path.
 		*/
 		function resolveWorkspacePath(cwd, path) {
-			if (path.startsWith("/") || /^[A-Za-z]:[/\\]/.test(path) || path.startsWith("\\\\")) return path;
+			if (path.startsWith("/") || isWindowsStylePath(path)) return path;
 			if (cwd === void 0 || cwd === "") return path;
 			return `${cwd.replace(/[/\\]+$/, "")}/${path.replace(/^[/\\]+/, "")}`;
 		}
+		/** Drive-letter or UNC path; Web display must not rewrite these as `~`. */
+		function isWindowsStylePath(value) {
+			return /^[A-Za-z]:[/\\]/.test(value) || value.startsWith("\\\\");
+		}
+		/**
+		* Display-only POSIX home abbreviation. Windows drive and UNC paths stay
+		* verbatim, including when `home` itself is a Windows path. A missing, empty,
+		* or filesystem-root `home` leaves `path` unchanged so `/` cannot become `~`.
+		* @param path - absolute or already-short display path.
+		* @param home - host account home from `host.describe`; absent skips abbreviation.
+		* @returns `~` or `~/…` for the POSIX home and its descendants, otherwise `path`.
+		*/
+		function abbreviateHomePath(path, home) {
+			if (home === void 0 || home === "") return path;
+			if (isWindowsStylePath(path) || isWindowsStylePath(home)) return path;
+			const root = home.replace(/\/+$/, "");
+			if (root === "" || root === "/") return path;
+			if (path.replace(/\/+$/, "") === root) return "~";
+			if (path.startsWith(`${root}/`)) return `~${path.slice(root.length)}`;
+			return path;
+		}
 		//#endregion
 		//#region lib/types/client/sessions/partial.js
 		/**
@@ -10374,6 +10395,18 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return names.length > 0 ? names.join(", ") : null;
 		}
 		/**
+		* The referenced-session labels of one durable `session-reference` recall
+		* source, in first-seen order; empty for every other source shape, including
+		* a foreign or older log whose reference entries carry no readable label.
+		* @param source - the logged `user/message` source, exactly as recorded.
+		* @returns distinct non-empty reference labels.
+		*/
+		function sessionRecallLabels(source) {
+			const record = asRecord(source);
+			if (record === null || readString(record, "kind") !== "session-reference") return [];
+			return collect(record, "references", "label");
+		}
+		/**
 		* Project one durable message source onto its transcript role and producer name.
 		*
 		* The source arrives over the wire as opaque JSON (`MessageSource` is
@@ -10512,6 +10545,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		exports.SlotRegistry = SlotRegistry;
 		exports.WorkspaceCreateError = WorkspaceCreateError;
 		exports.WorkspaceRuntime = WorkspaceRuntime;
+		exports.abbreviateHomePath = abbreviateHomePath;
 		exports.apply = apply;
 		exports.contextForm = contextForm;
 		exports.contextProvenance = contextProvenance;
@@ -10528,6 +10562,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		exports.isTokenDelta = isTokenDelta;
 		exports.resolveWorkspacePath = resolveWorkspacePath;
 		exports.scopeOf = scopeOf;
+		exports.sessionRecallLabels = sessionRecallLabels;
 		exports.shallowEqual = shallowEqual;
 		exports.toAssistantBlock = toAssistantBlock;
 		exports.toAssistantBlocks = toAssistantBlocks;

package/dist/kernel/client-runtime/lib/types/client/contract/session.d.ts

@@ -34,7 +34,7 @@ export interface ISession {
      * @param mode - 'queue' appends a turn; 'steer' interrupts the running one.
      * @returns acceptance, or the business error (also mirrored into snapshot.promptError).
      */
-    prompt(content: PromptContentPart[], mode: 'queue' | 'steer'): Promise<RpcResult<{
+    prompt(content: PromptContentPart[], mode: 'queue' | 'steer', signal?: AbortSignal): Promise<RpcResult<{
         accepted: true;
     }>>;
     /**

package/dist/kernel/client-runtime/lib/types/client/contract/store.d.ts

@@ -5,7 +5,7 @@ export interface ObservableSnapshot<T> {
     getSnapshot(): T;
     subscribe(fn: () => void): () => void;
 }
-/** Writable snapshot store (bare data face; React selector hooks are synthesized in web-react). */
+/** Writable snapshot store (bare data face; React selector hooks are synthesized in ui-renderer). */
 export interface SnapshotStore<T> extends ObservableSnapshot<T> {
     /**
      * Mutate the state through an immer draft.

package/dist/kernel/client-runtime/lib/types/client/contract/store.js

@@ -4,9 +4,9 @@
  * shell over it: {@link defineStore} bakes an init/persist/actions literal
  * into a {@link StoreHandle}, the registration-side store seat of slot
  * terminals. Lives in the React-free runtime (the data layer owns its
- * engine; web-react is shell-only React
+ * engine; ui-renderer is shell-only React
  * glue): engine products are bare observables — subscribe/getSnapshot/
- * update/set, NO selector hook. Hook synthesis is web-react's (the one
+ * update/set, NO selector hook. Hook synthesis is ui-renderer's (the one
  * uSES bridge, cached per source at the binding site).
  */
 import { createStore } from 'zustand/vanilla';

package/dist/kernel/client-runtime/lib/types/client/index.d.ts

@@ -24,7 +24,7 @@ export type { SessionProvideChannelHost } from './sessions/provide.ts';
 export { createScope } from './agents/scope.ts';
 export type { AgentScopeHandle } from './agents/scope.ts';
 export { DirectoryBrowseError, WorkspaceCreateError, WorkspaceRuntime } from './workspaces/service.ts';
-export { resolveWorkspacePath } from './workspaces/path.ts';
+export { abbreviateHomePath, resolveWorkspacePath } from './workspaces/path.ts';
 export type { SettingsScope, SettingsScopeSnapshot, SettingsScopeSpec, } from './contract/settings-scope.ts';
 export type { Session } from './sessions/session.ts';
 export type { ISession, ProjectionsFace, SessionFace } from './contract/session.ts';
@@ -42,7 +42,7 @@ export type { AssistantBlock, AssistantMessageNode, AssistantProvenanceView, Ass
 export { EMPTY_CHAT_SNAPSHOT, EMPTY_CONVERSATION_VIEWS, toAssistantBlock, toAssistantBlocks, } from './sessions/conversation.ts';
 export { emptyAssistantBlock } from './sessions/partial.ts';
 export { isTokenDelta } from './sessions/assistant-timing.ts';
-export { contextForm, contextProvenance } from './sessions/context-provenance.ts';
+export { contextForm, contextProvenance, sessionRecallLabels } from './sessions/context-provenance.ts';
 export { displayFailureMessage } from './sessions/failure-display.ts';
 export type { ConversationContext, ConversationContextOriginKind, } from './sessions/conversation-context.ts';
 export type { ContextProvenanceView, ContextRole, KnownContextForm, } from './sessions/context-provenance.ts';

package/dist/kernel/client-runtime/lib/types/client/index.js

@@ -17,13 +17,13 @@ export { indexSubagentDescendants } from "./sessions/subagent-lineage.js";
 export { SessionProvideChannel } from "./sessions/provide.js";
 export { createScope } from "./agents/scope.js";
 export { DirectoryBrowseError, WorkspaceCreateError, WorkspaceRuntime } from "./workspaces/service.js";
-export { resolveWorkspacePath } from "./workspaces/path.js";
-// Runtime owns the snapshot store; web-react only binds it to React.
+export { abbreviateHomePath, resolveWorkspacePath } from "./workspaces/path.js";
+// Runtime owns the snapshot store; ui-renderer only binds it to React.
 export { createSnapshotStore, defineStore, shallowEqual } from "./contract/store.js";
 export { EMPTY_CHAT_SNAPSHOT, EMPTY_CONVERSATION_VIEWS, toAssistantBlock, toAssistantBlocks, } from "./sessions/conversation.js";
 export { emptyAssistantBlock } from "./sessions/partial.js";
 export { isTokenDelta } from "./sessions/assistant-timing.js";
-export { contextForm, contextProvenance } from "./sessions/context-provenance.js";
+export { contextForm, contextProvenance, sessionRecallLabels } from "./sessions/context-provenance.js";
 export { displayFailureMessage } from "./sessions/failure-display.js";
 export { PendingWait } from "./sessions/pending.js";
 /** Required services: the wire handle and Client Typert registry. */

package/dist/kernel/client-runtime/lib/types/client/sessions/context-provenance.d.ts

@@ -19,6 +19,14 @@ export interface ContextProvenanceView {
      */
     label: string | null;
 }
+/**
+ * The referenced-session labels of one durable `session-reference` recall
+ * source, in first-seen order; empty for every other source shape, including
+ * a foreign or older log whose reference entries carry no readable label.
+ * @param source - the logged `user/message` source, exactly as recorded.
+ * @returns distinct non-empty reference labels.
+ */
+export declare function sessionRecallLabels(source: unknown): string[];
 /**
  * Project one durable message source onto its transcript role and producer name.
  *

package/dist/kernel/client-runtime/lib/types/client/sessions/context-provenance.js

@@ -32,6 +32,19 @@ function collect(source, member, field) {
 function joined(names) {
     return names.length > 0 ? names.join(', ') : null;
 }
+/**
+ * The referenced-session labels of one durable `session-reference` recall
+ * source, in first-seen order; empty for every other source shape, including
+ * a foreign or older log whose reference entries carry no readable label.
+ * @param source - the logged `user/message` source, exactly as recorded.
+ * @returns distinct non-empty reference labels.
+ */
+export function sessionRecallLabels(source) {
+    const record = asRecord(source);
+    if (record === null || readString(record, 'kind') !== 'session-reference')
+        return [];
+    return collect(record, 'references', 'label');
+}
 /**
  * Project one durable message source onto its transcript role and producer name.
  *

package/dist/kernel/client-runtime/lib/types/client/sessions/conversation.d.ts

@@ -75,14 +75,14 @@ export interface AssistantTiming {
     /** Final assistant/message timestamp. */
     completedTime: number;
 }
-/** A finalized (or interruption-frozen) assistant message. */
+/** A finalized assistant message or an interruption-frozen streaming prefix. */
 export interface AssistantMessageNode {
     kind: 'assistant';
     seq: number;
     /**
-     * Stable identity of the finalized model output, carried from the
-     * `assistant/message` event. Absent on interruption-frozen partials: those
-     * were never finalized, so they address no durable message.
+     * Stable identity carried from the `assistant/message` event. Absent only on
+     * synthetic interruption fallbacks assembled from chunks without a durable
+     * assistant message.
      */
     messageId?: MessageId;
     /** Unix epoch ms from the source session event (or turn/end when frozen from a partial). */
@@ -95,8 +95,9 @@ export interface AssistantMessageNode {
     requestConfig?: AssistantRequestConfig;
     /** Timing derived from the recorded step/chunk/message event sequence. */
     timing?: AssistantTiming;
-    /** Frozen partial of an aborted turn (no finalize ever arrives): rendered with a 已停止 marker.
-     *  Synthetic seq (fractional, derived from the turn/end seq) keeps it ordered inside the flow. */
+    /** Prefix of an aborted turn, rendered with a 已停止 marker. A durable
+     *  finalized prefix uses its event seq; a chunk-only fallback uses a fractional
+     *  seq derived from the closing boundary to keep it ordered inside the flow. */
     interrupted?: true;
 }
 /** A human message admitted from the next-step inbox while a turn was running. */
@@ -135,7 +136,10 @@ export type ModelRetryNode = LlmRetryEventData & {
      */
     retryState: 'scheduled' | 'started' | 'cancelled';
 };
-/** Durable terminal failure for a turn that has no scheduled retry. */
+/**
+ * Durable terminal failure for a turn that ended with an error reason; the
+ * turn's settled retry chain renders separately and never replaces this node.
+ */
 export interface TurnErrorNode {
     kind: 'turn-error';
     /** Seq of the owning turn/end event. */

package/dist/kernel/client-runtime/lib/types/client/sessions/projection-store.d.ts

@@ -6,7 +6,7 @@
  * page's projections block and updated by `session/projection` push frames,
  * under the single rule **higher seq wins**. No client-side domain folding
  * exists: a domain ships projection support with zero client code. Per-key
- * bare observable faces feed `useProjection` (web-react binds them).
+ * bare observable faces feed `useProjection` (ui-renderer binds them).
  */
 import type { SessionProjectionMap } from '../../../../../session-projection/lib/types/types.js';
 import type { ObservableSnapshot } from '../contract/store.ts';

package/dist/kernel/client-runtime/lib/types/client/sessions/session.d.ts

@@ -134,7 +134,7 @@ export declare class Session implements SessionFace {
      * @param mode - queue appends after the current turn; steer interrupts it.
      * @returns the prompt result (also mirrored into promptError on failure).
      */
-    prompt(content: PromptContentPart[], mode: 'queue' | 'steer'): Promise<RpcResult<{
+    prompt(content: PromptContentPart[], mode: 'queue' | 'steer', signal?: AbortSignal): Promise<RpcResult<{
         accepted: true;
     }>>;
     /**

package/dist/kernel/client-runtime/lib/types/client/sessions/session.js

@@ -136,7 +136,7 @@ export class Session {
      * @param mode - queue appends after the current turn; steer interrupts it.
      * @returns the prompt result (also mirrored into promptError on failure).
      */
-    async prompt(content, mode) {
+    async prompt(content, mode, signal) {
         this.promptError = null;
         this.lastAgentError = null;
         // Synchronous, before the first await: the blank → engaging edge must be
@@ -154,7 +154,7 @@ export class Session {
                     mode,
                     content,
                     clientTimeZone: resolvedClientTimeZone(),
-                })).result;
+                }, signal)).result;
             }
             else if (this.address.mode === 'one-shot') {
                 result = {
@@ -184,7 +184,7 @@ export class Session {
                             ? [{ type: 'text', text: part.text }]
                             : []),
                         clientTimeZone: resolvedClientTimeZone(),
-                    })).result;
+                    }, signal)).result;
                     result = routed.ok ? { ok: true, value: { accepted: true } } : routed;
                 }
             }
@@ -309,7 +309,7 @@ export class Session {
      * @returns the admission result, or the error branch on transport failure.
      */
     async command(line) {
-        const result = await this.remote.commands.execute(this.sessionId, line);
+        const result = await this.remote.commands.execute(this.sessionId, line, []);
         if (!result.ok)
             return result;
         return { ok: true, value: { matched: result.value !== undefined } };

package/dist/kernel/client-runtime/lib/types/client/slots.d.ts

@@ -89,7 +89,7 @@ export declare class SlotRegistry extends Service {
      */
     inject(key: keyof SlotMap & string, callback: () => SlotInjectionEffect): () => void;
     /**
-     * Install the shell's renderer (web-react's createSlotRenderer product).
+     * Install the shell's renderer (ui-renderer's createSlotRenderer product).
      * Boot-once: a second install throws. Runs through the caller's ctx.effect,
      * so shell fiber unload uninstalls the renderer.
      * @param renderer - the outlet machinery implementing SlotRenderer.

package/dist/kernel/client-runtime/lib/types/client/slots.js

@@ -114,7 +114,7 @@ export class SlotRegistry extends Service {
         return () => { void disposeController(); };
     }
     /**
-     * Install the shell's renderer (web-react's createSlotRenderer product).
+     * Install the shell's renderer (ui-renderer's createSlotRenderer product).
      * Boot-once: a second install throws. Runs through the caller's ctx.effect,
      * so shell fiber unload uninstalls the renderer.
      * @param renderer - the outlet machinery implementing SlotRenderer.

package/dist/kernel/client-runtime/lib/types/client/workspaces/path.d.ts

@@ -5,4 +5,13 @@
  * @returns an absolute path when a workspace root is available, otherwise the original path.
  */
 export declare function resolveWorkspacePath(cwd: string | undefined, path: string): string;
+/**
+ * Display-only POSIX home abbreviation. Windows drive and UNC paths stay
+ * verbatim, including when `home` itself is a Windows path. A missing, empty,
+ * or filesystem-root `home` leaves `path` unchanged so `/` cannot become `~`.
+ * @param path - absolute or already-short display path.
+ * @param home - host account home from `host.describe`; absent skips abbreviation.
+ * @returns `~` or `~/…` for the POSIX home and its descendants, otherwise `path`.
+ */
+export declare function abbreviateHomePath(path: string, home?: string): string;
 //# sourceMappingURL=path.d.ts.map