@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/file-reference-local/lib/types/index.js

@@ -0,0 +1,105 @@
+/**
+ * Local-filesystem implementation of `ctx.fileReferences`.
+ *
+ * @module @nomix-ai/nomix-file-reference-local
+ */
+import z from '../../../schemastery/lib/index.mjs';
+import FileReferenceService, { FILE_REFERENCE_PROMPT, } from '../../../file-reference/lib/index.js';
+import { DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES, DEFAULT_FILE_SEARCH_MAX_ENTRIES, DEFAULT_FILE_SEARCH_MAX_RESULTS, WorkspaceFileSearch, } from "./search.js";
+export { DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES, DEFAULT_FILE_SEARCH_MAX_ENTRIES, DEFAULT_FILE_SEARCH_MAX_RESULTS, WorkspaceFileSearch, } from "./search.js";
+export { FILE_REFERENCE_PROMPT } from '../../../file-reference/lib/index.js';
+export { activeAtToken, formatFileMention } from '../../../file-reference/lib/types/grammar.js';
+/** Local-filesystem owner of the file-reference discovery service. */
+export class LocalFileReferenceService extends FileReferenceService {
+    static inject = ['agents'];
+    static Config = z.object({
+        maxResults: z.number().step(1).min(1).default(DEFAULT_FILE_SEARCH_MAX_RESULTS),
+        maxEntries: z.number().step(1).min(1).default(DEFAULT_FILE_SEARCH_MAX_ENTRIES),
+        excludedDirectories: z.array(z.string()).default([...DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES]),
+    });
+    config;
+    searches = new Map();
+    promptFibers = new Map();
+    promptDisposals = new Set();
+    constructor(ctx, config = {}) {
+        super(ctx);
+        this.config = {
+            maxResults: config.maxResults ?? DEFAULT_FILE_SEARCH_MAX_RESULTS,
+            maxEntries: config.maxEntries ?? DEFAULT_FILE_SEARCH_MAX_ENTRIES,
+            excludedDirectories: config.excludedDirectories ?? DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES,
+        };
+        validateConfig(this.config);
+        const installPrompt = (agent) => {
+            if (this.promptFibers.has(agent))
+                return;
+            const fiber = agent.ctx.inject(['systemPrompt', 'tools'], (scope) => {
+                scope.systemPrompt.section({
+                    name: 'context:file-reference',
+                    order: 99,
+                    text: () => agent.ctx.tools.get('read', agent) === undefined ? '' : FILE_REFERENCE_PROMPT,
+                });
+            });
+            this.promptFibers.set(agent, fiber);
+        };
+        const disposePrompt = (agent) => {
+            const fiber = this.promptFibers.get(agent);
+            if (fiber === undefined)
+                return;
+            this.promptFibers.delete(agent);
+            const task = fiber.dispose().catch((error) => {
+                ctx.logger.warn(`file-reference-local: prompt cleanup failed: ${error instanceof Error ? error.message : String(error)}`);
+            });
+            this.promptDisposals.add(task);
+            void task.finally(() => {
+                this.promptDisposals.delete(task);
+            });
+        };
+        for (const agent of ctx.agents.list())
+            installPrompt(agent);
+        ctx.on('agent/created', ({ agent }) => { installPrompt(agent); });
+        ctx.on('agent/disposed', ({ agent }) => {
+            this.searches.get(agent)?.dispose();
+            this.searches.delete(agent);
+            disposePrompt(agent);
+        });
+        ctx.on('session/event', (session, event) => {
+            if (event.type !== 'tool/result')
+                return;
+            const agent = ctx.agents.get(session.id);
+            if (agent !== undefined)
+                this.searches.get(agent)?.invalidate();
+        });
+        ctx.effect(() => async () => {
+            for (const search of this.searches.values())
+                search.dispose();
+            this.searches.clear();
+            const promptFibers = [...this.promptFibers.values()];
+            this.promptFibers.clear();
+            await Promise.all([
+                ...promptFibers.map(fiber => fiber.dispose()),
+                ...this.promptDisposals,
+            ]);
+        }, 'file-reference-local: search cache');
+    }
+    list(agent, query, signal) {
+        let search = this.searches.get(agent);
+        if (search === undefined) {
+            search = new WorkspaceFileSearch(agent.session.header.cwd ?? process.cwd(), this.config);
+            this.searches.set(agent, search);
+        }
+        return search.list(query, signal);
+    }
+}
+function validateConfig(config) {
+    if (!Number.isSafeInteger(config.maxResults) || config.maxResults <= 0) {
+        throw new Error('file-reference-local: maxResults must be a positive safe integer');
+    }
+    if (!Number.isSafeInteger(config.maxEntries) || config.maxEntries <= 0) {
+        throw new Error('file-reference-local: maxEntries must be a positive safe integer');
+    }
+    if (config.excludedDirectories.some(name => name.length === 0 || name.includes('/') || name.includes('\\'))) {
+        throw new Error('file-reference-local: excludedDirectories entries must be non-empty directory basenames');
+    }
+}
+export default LocalFileReferenceService;
+//# sourceMappingURL=index.js.map

package/dist/kernel/file-reference-local/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@nomix-ai/nomix-file-reference-local`.
+ * @module @nomix-ai/nomix-file-reference-local/invariant
+ */
+import type { Context } from '../../../cordis/lib/index.js';
+/** Cordis companion plugin name. */
+export declare const name = "file-reference-local-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/dist/kernel/file-reference-local/lib/types/invariant.js

@@ -0,0 +1,22 @@
+/**
+ * Package-owned invariant companion for `@nomix-ai/nomix-file-reference-local`.
+ * @module @nomix-ai/nomix-file-reference-local/invariant
+ */
+const PACKAGE_NAME = '@nomix-ai/nomix-file-reference-local';
+/** Cordis companion plugin name. */
+export const name = 'file-reference-local-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: per-agent indexes are private advisory caches whose
+ * invalidation and disposal are observed directly through service tests.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/dist/kernel/file-reference-local/lib/types/search.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Host-workspace discovery for `@file` completion. The index contains paths
+ * only: selected values remain ordinary prompt text and file contents stay
+ * behind the model-facing `read` tool.
+ *
+ * @module @nomix-ai/nomix-file-reference-local/search
+ */
+import type { FileReferenceCandidate } from '../../../file-reference/lib/index.js';
+export { activeAtToken, formatFileMention } from '../../../file-reference/lib/types/grammar.js';
+/** Default maximum file and directory candidates rendered for one query. */
+export declare const DEFAULT_FILE_SEARCH_MAX_RESULTS = 20;
+/** Default maximum entries retained in one workspace search index. */
+export declare const DEFAULT_FILE_SEARCH_MAX_ENTRIES = 10000;
+/** Directory basenames omitted from traversal unless the deployment overrides them. */
+export declare const DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES: readonly [".git", "node_modules"];
+/** Resolved limits and exclusions for one workspace index. */
+export interface FileSearchConfig {
+    /** Maximum ranked candidates returned for one query. */
+    maxResults: number;
+    /** Maximum indexed files and directories. */
+    maxEntries: number;
+    /** Directory basenames never traversed or offered. */
+    excludedDirectories: readonly string[];
+}
+/**
+ * Cancellable, reusable fuzzy index rooted at one agent working directory.
+ * Directory-scoped queries list live state; bare fuzzy queries share one
+ * bounded traversal until the `@` interaction ends or a tool result invalidates it.
+ */
+export declare class WorkspaceFileSearch {
+    private readonly root;
+    private readonly config;
+    private readonly excludedDirectories;
+    private generation;
+    private disposed;
+    constructor(root: string, config: FileSearchConfig);
+    /**
+     * Return ranked path candidates for the current token.
+     * @param rawQuery - path text following `@` or `@"`.
+     * @param signal - cancels this caller's wait without killing an index shared by a newer query.
+     * @returns at most `maxResults` deterministic candidates.
+     */
+    list(rawQuery: string, signal: AbortSignal): Promise<FileReferenceCandidate[]>;
+    /** Discard the current index so the next bare query observes a fresh tree. */
+    invalidate(): void;
+    /** Abort traversal and make later queries return no candidates. */
+    dispose(): void;
+    private ensureIndex;
+    private scanWorkspace;
+    private listDirectory;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/kernel/file-reference-local/lib/types/search.js

@@ -0,0 +1,258 @@
+/**
+ * Host-workspace discovery for `@file` completion. The index contains paths
+ * only: selected values remain ordinary prompt text and file contents stay
+ * behind the model-facing `read` tool.
+ *
+ * @module @nomix-ai/nomix-file-reference-local/search
+ */
+import { lstat, readdir } from 'node:fs/promises';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+export { activeAtToken, formatFileMention } from '../../../file-reference/lib/types/grammar.js';
+/** Default maximum file and directory candidates rendered for one query. */
+export const DEFAULT_FILE_SEARCH_MAX_RESULTS = 20;
+/** Default maximum entries retained in one workspace search index. */
+export const DEFAULT_FILE_SEARCH_MAX_ENTRIES = 10_000;
+/** Directory basenames omitted from traversal unless the deployment overrides them. */
+export const DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES = ['.git', 'node_modules'];
+/**
+ * Cancellable, reusable fuzzy index rooted at one agent working directory.
+ * Directory-scoped queries list live state; bare fuzzy queries share one
+ * bounded traversal until the `@` interaction ends or a tool result invalidates it.
+ */
+export class WorkspaceFileSearch {
+    root;
+    config;
+    excludedDirectories;
+    generation;
+    disposed = false;
+    constructor(root, config) {
+        this.root = root;
+        this.config = config;
+        if (!Number.isSafeInteger(config.maxResults) || config.maxResults <= 0) {
+            throw new Error('file search maxResults must be a positive safe integer');
+        }
+        if (!Number.isSafeInteger(config.maxEntries) || config.maxEntries <= 0) {
+            throw new Error('file search maxEntries must be a positive safe integer');
+        }
+        if (config.excludedDirectories.some(name => name.length === 0 || name.includes('/') || name.includes('\\'))) {
+            throw new Error('file search excludedDirectories entries must be non-empty directory basenames');
+        }
+        this.excludedDirectories = new Set(config.excludedDirectories);
+    }
+    /**
+     * Return ranked path candidates for the current token.
+     * @param rawQuery - path text following `@` or `@"`.
+     * @param signal - cancels this caller's wait without killing an index shared by a newer query.
+     * @returns at most `maxResults` deterministic candidates.
+     */
+    async list(rawQuery, signal) {
+        signal.throwIfAborted();
+        if (this.disposed)
+            return [];
+        const query = rawQuery.replaceAll('\\', '/');
+        const slash = query.lastIndexOf('/');
+        if (query === '' || slash >= 0) {
+            const directory = slash < 0 ? '' : query.slice(0, slash + 1);
+            const fragment = slash < 0 ? '' : query.slice(slash + 1);
+            return this.listDirectory(directory, fragment, signal);
+        }
+        const indexed = await waitForPromise(this.ensureIndex(), signal);
+        return rankCandidates(indexed.filter(candidate => visibleForGlobalQuery(candidate.path, query)), query, this.config.maxResults);
+    }
+    /** Discard the current index so the next bare query observes a fresh tree. */
+    invalidate() {
+        this.generation?.controller.abort(new Error('file search index invalidated'));
+        this.generation = undefined;
+    }
+    /** Abort traversal and make later queries return no candidates. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.invalidate();
+    }
+    ensureIndex() {
+        if (this.generation !== undefined)
+            return this.generation.promise;
+        const controller = new AbortController();
+        const generation = {
+            controller,
+            promise: Promise.resolve([]),
+        };
+        generation.promise = this.scanWorkspace(controller.signal).catch((error) => {
+            /* v8 ignore next -- every owned abort clears `generation` synchronously; this only protects an unexpected scan failure */
+            if (this.generation === generation)
+                this.generation = undefined;
+            throw error;
+        });
+        this.generation = generation;
+        return generation.promise;
+    }
+    async scanWorkspace(signal) {
+        const indexed = [];
+        const directories = [{ absolute: this.root, relative: '' }];
+        for (let cursor = 0; cursor < directories.length && indexed.length < this.config.maxEntries; cursor += 1) {
+            signal.throwIfAborted();
+            const directory = directories[cursor];
+            /* v8 ignore next 3 -- cursor is bounded by this exact queue's length. */
+            if (directory === undefined) {
+                throw new Error('file search selected a missing directory');
+            }
+            const entries = await readDirectory(directory.absolute, signal);
+            for (const entry of entries) {
+                signal.throwIfAborted();
+                const path = directory.relative === '' ? entry.name : `${directory.relative}/${entry.name}`;
+                if (entry.isDirectory()) {
+                    if (this.excludedDirectories.has(entry.name))
+                        continue;
+                    indexed.push({ path, kind: 'directory' });
+                    directories.push({ absolute: join(directory.absolute, entry.name), relative: path });
+                }
+                else if (entry.isFile()) {
+                    indexed.push({ path, kind: 'file' });
+                }
+                if (indexed.length >= this.config.maxEntries)
+                    break;
+            }
+        }
+        return indexed;
+    }
+    async listDirectory(displayDirectory, fragment, signal) {
+        if (displayDirectory.split('/').some(segment => this.excludedDirectories.has(segment)))
+            return [];
+        const absolute = await resolveDisplayDirectory(this.root, displayDirectory, signal);
+        if (absolute === undefined)
+            return [];
+        const entries = await readDirectory(absolute, signal);
+        const candidates = [];
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') && !fragment.startsWith('.'))
+                continue;
+            if (entry.isDirectory()) {
+                if (this.excludedDirectories.has(entry.name))
+                    continue;
+                candidates.push({ path: `${displayDirectory}${entry.name}`, kind: 'directory' });
+            }
+            else if (entry.isFile()) {
+                candidates.push({ path: `${displayDirectory}${entry.name}`, kind: 'file' });
+            }
+        }
+        return rankCandidates(candidates, fragment, this.config.maxResults);
+    }
+}
+async function resolveDisplayDirectory(root, displayDirectory, signal) {
+    const resolvedRoot = resolve(root);
+    const absolute = resolve(resolvedRoot, displayDirectory === '' ? '.' : displayDirectory);
+    const fromRoot = relative(resolvedRoot, absolute);
+    if (fromRoot === '..' || fromRoot.startsWith(`..${sep}`))
+        return undefined;
+    /* v8 ignore next -- only Windows can produce a cross-volume absolute relative path */
+    if (isAbsolute(fromRoot))
+        return undefined;
+    let current = resolvedRoot;
+    for (const segment of fromRoot.split(sep).filter(Boolean)) {
+        signal.throwIfAborted();
+        current = join(current, segment);
+        try {
+            const status = await lstat(current);
+            signal.throwIfAborted();
+            if (status.isSymbolicLink() || !status.isDirectory())
+                return undefined;
+        }
+        catch (_error) {
+            signal.throwIfAborted();
+            return undefined;
+        }
+    }
+    return absolute;
+}
+async function readDirectory(absolute, signal) {
+    signal.throwIfAborted();
+    try {
+        const entries = await readdir(absolute, { withFileTypes: true });
+        signal.throwIfAborted();
+        return entries.sort((left, right) => compareText(left.name, right.name));
+    }
+    catch (_error) {
+        signal.throwIfAborted();
+        // An unreadable/missing subtree contributes no candidates; other readable
+        // branches remain useful and autocomplete is advisory.
+        return [];
+    }
+}
+function visibleForGlobalQuery(path, query) {
+    if (query.startsWith('.') || query.includes('/.'))
+        return true;
+    return !path.split('/').some(segment => segment.startsWith('.'));
+}
+function rankCandidates(candidates, query, limit) {
+    const ranked = [];
+    for (const candidate of candidates) {
+        const score = scoreCandidate(candidate, query);
+        if (score !== undefined)
+            ranked.push({ candidate, score });
+    }
+    ranked.sort((left, right) => right.score - left.score
+        || kindRank(left.candidate.kind) - kindRank(right.candidate.kind)
+        || (query === '' ? 0 : left.candidate.path.length - right.candidate.path.length)
+        || compareText(left.candidate.path, right.candidate.path));
+    return ranked.slice(0, limit).map(entry => entry.candidate);
+}
+function scoreCandidate(candidate, query) {
+    if (query === '')
+        return 0;
+    const path = candidate.path.toLowerCase();
+    const name = path.slice(path.lastIndexOf('/') + 1);
+    const needle = query.toLowerCase();
+    const directoryBonus = candidate.kind === 'directory' ? 25 : 0;
+    if (name === needle)
+        return 1_000 + directoryBonus;
+    if (name.startsWith(needle))
+        return 900 + directoryBonus;
+    if (name.includes(needle))
+        return 700 + directoryBonus;
+    if (path.includes(needle))
+        return 500 + directoryBonus;
+    const subsequence = subsequenceScore(path, needle);
+    return subsequence === undefined ? undefined : 300 + subsequence + directoryBonus;
+}
+function subsequenceScore(target, query) {
+    let targetIndex = 0;
+    let gap = 0;
+    for (const character of query) {
+        const found = target.indexOf(character, targetIndex);
+        if (found < 0)
+            return undefined;
+        gap += found - targetIndex;
+        targetIndex = found + 1;
+    }
+    return Math.max(0, 100 - gap);
+}
+function kindRank(kind) {
+    return kind === 'directory' ? 0 : 1;
+}
+function compareText(left, right) {
+    /* v8 ignore next -- entries and candidates are unique; host enumeration
+     * order determines which comparison direction sort requests. */
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function waitForPromise(promise, signal) {
+    /* v8 ignore next -- `list()` checks this signal immediately before its synchronous call into this helper */
+    if (signal.aborted)
+        return Promise.reject(errorReason(signal.reason, 'file search aborted'));
+    return new Promise((resolvePromise, rejectPromise) => {
+        const onAbort = () => { rejectPromise(errorReason(signal.reason, 'file search aborted')); };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolvePromise(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            rejectPromise(errorReason(error, 'file search index failed'));
+        });
+    });
+}
+function errorReason(reason, fallback) {
+    return reason instanceof Error ? reason : new Error(fallback, { cause: reason });
+}
+//# sourceMappingURL=search.js.map

package/dist/kernel/file-reference-local/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nomix-ai/nomix-file-reference-local",
+  "description": "Local-filesystem ctx.fileReferences provider with bounded fuzzy indexes",
+  "version": "0.2.6",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ditgaldev/nomix-harness.git",
+    "directory": "packages/context/file-reference-local"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./search": {
+      "types": "./lib/types/search.d.ts",
+      "default": "./lib/types/search.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@nomix-ai/schemastery": "workspace:^"
+  },
+  "peerDependencies": {
+    "@nomix-ai/nomix-agent": "workspace:^",
+    "@nomix-ai/nomix-file-reference": "workspace:^",
+    "@nomix-ai/nomix-invariants": "workspace:^",
+    "@nomix-ai/nomix-system-prompt": "workspace:^",
+    "@nomix-ai/nomix-tools": "workspace:^",
+    "@nomix-ai/cordis": "workspace:^"
+  },
+  "devDependencies": {
+    "@nomix-ai/nomix-agent": "workspace:^",
+    "@nomix-ai/nomix-file-reference": "workspace:^",
+    "@nomix-ai/nomix-invariants": "workspace:^",
+    "@nomix-ai/nomix-system-prompt": "workspace:^",
+    "@nomix-ai/nomix-tools": "workspace:^",
+    "@nomix-ai/cordis": "workspace:^"
+  }
+}

package/dist/kernel/fs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-fs",
   "description": "Abstract filesystem capability seam (ctx.fs) for the Nomix Harness — vocabulary types, the FileSystem service (text IO + optional version-guarded atomic mutations), and the fs/* policy event vocabulary",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/fs-e2b/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-fs-e2b",
   "description": "E2B filesystem implementation for Nomix Harness",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/fs-local/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-fs-local",
   "description": "Local-filesystem implementation of the Nomix Harness filesystem seam (ctx.fs)",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/fs-observation-policy/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-fs-observation-policy",
   "description": "File-context policy plugin for the Nomix Harness — observed-state, read-before-edit, and version-guarded write/edit added over the ctx.fs provider seam through the fs/* event gate (no service API)",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/fs-sandbox/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-fs-sandbox",
   "description": "Sandbox-enforcing implementation of the Nomix Harness filesystem seam: fences write/edit by the per-call sandbox mode (read-only denies mutation, workspace-write contains it to the workspace + temp roots) while reads pass through",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/goal/lib/index.js

@@ -522,10 +522,13 @@ let GoalService = (() => {
 			ctx.inject(["sessionProjections"], (projectionCtx) => {
 				projectionCtx.sessionProjections.register({
 					key: "goal",
-					schema: goalProjectionSchema,
+					stateSchema: goalProjectionSchema,
 					init: () => null,
 					apply: applyGoalProjection,
-					view: (state) => state,
+					wire: {
+						viewSchema: goalProjectionSchema,
+						view: (state) => state
+					},
 					stateVersion: 4
 				});
 			});

package/dist/kernel/goal/lib/typert.host.js

@@ -518,6 +518,10 @@ export const TYPERT = {
             "name": "CommandSourceMap",
             "declaration": "export interface CommandSourceMap {\n    user: { kind: 'user'; };\n}"
           },
+          {
+            "name": "CompactionId",
+            "declaration": "export type CompactionId = Branded<'CompactionId'>;"
+          },
           {
             "name": "ContentBlock",
             "declaration": "export type ContentBlock = ContentBlockMap[ContentBlockType];"
@@ -612,7 +616,7 @@ export const TYPERT = {
           },
           {
             "name": "ImageAttachmentRef",
-            "declaration": "export interface ImageAttachmentRef {\n    attachmentId: AttachmentId;\n    mediaType: ImageMediaType;\n    bytes: number;\n    width: number;\n    height: number;\n    name?: string;\n}"
+            "declaration": "export interface ImageAttachmentRef {\n    attachmentId: AttachmentId;\n    mediaType: ImageMediaType;\n    bytes: number;\n    width: number;\n    height: number;\n    name?: string;\n    originalDimensions?: { width: number; height: number; };\n}"
           },
           {
             "name": "ImageBlock",
@@ -660,7 +664,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    goal: GoalMessageSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    goal: GoalMessageSource;\n    'session-reference': SessionReferenceSource;\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -700,7 +704,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'assistant/chunk': { turn: number; step: number; chunk: StreamChunk; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; usage?: TokenUsage; };\n    'tool/call': { turn: number; step: number; callId: CallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'todo/write': { todos: TodoItem[]; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; };\n    'request/context': RequestContext;\n    'session/end-seed': Record<string, never>;\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: number; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: CallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/code-dispatch-start': CodeDispatchStartEventData;\n    'tool/code-dispatch': CodeDispatchEventData;\n    'goal/change': GoalChangeMeta;\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'assistant/chunk': { turn: number; step: number; chunk: StreamChunk; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; usage?: TokenUsage; interrupted?: true; };\n    'tool/call': { turn: number; step: number; callId: CallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'todo/write': { todos: TodoItem[]; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; };\n    'request/context': RequestContext;\n    'session/end-seed': Record<string, never>;\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: number; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: CallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/code-dispatch-start': CodeDispatchStartEventData;\n    'tool/code-dispatch': CodeDispatchEventData;\n    'goal/change': GoalChangeMeta;\n    'session/title': SessionTitleEventData;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: number; end: number; }; shadowedSeqs: number[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: number; end: number; }; shadowedSeqs: number[]; shadowedTokenCount: number; };\n}"
           },
           {
             "name": "SessionEventType",
@@ -714,10 +718,30 @@ export const TYPERT = {
             "name": "SessionId",
             "declaration": "export type SessionId = Branded<'SessionId'>;"
           },
+          {
+            "name": "SessionReferenceSource",
+            "declaration": "export interface SessionReferenceSource {\n    kind: 'session-reference';\n    form: 'recall';\n    version: 1;\n    references: { sessionId: string; label: string; capturedThroughSeq: number | null; compacted: boolean; originalMessages: number; retainedMessages: number; omittedMessages: number; omittedBytes: number; truncated: boolean; inputIndex: number; }[];\n}"
+          },
           {
             "name": "SessionSurface",
             "declaration": "export interface SessionSurface {\n    readonly nodes: readonly number[];\n    readonly replaceGeneration: number;\n}"
           },
+          {
+            "name": "SessionTitleEventData",
+            "declaration": "export interface SessionTitleEventData {\n    readonly title: string;\n    readonly messageSeqs: number[];\n    readonly source: SessionTitleSource;\n}"
+          },
+          {
+            "name": "SessionTitleModelProvenance",
+            "declaration": "export interface SessionTitleModelProvenance {\n    readonly provider: string;\n    readonly model: string;\n}"
+          },
+          {
+            "name": "SessionTitleProviderId",
+            "declaration": "export type SessionTitleProviderId = Branded<'SessionTitleProviderId'>;"
+          },
+          {
+            "name": "SessionTitleSource",
+            "declaration": "export type SessionTitleSource = { readonly kind: 'fallback'; } | { readonly kind: 'provider'; readonly provider: SessionTitleProviderId; readonly model?: SessionTitleModelProvenance; } | { readonly kind: 'user'; };"
+          },
           {
             "name": "StreamChunk",
             "declaration": "export type StreamChunk = { type: 'block-start'; index: number; blockType: ContentBlockType; } | { type: 'text-delta'; index: number; text: string; } | { type: 'reasoning-delta'; index: number; text: string; } | { type: 'tool-call-delta'; index: number; id: CallId; name?: string; argumentsDelta: string; } | { type: 'block-end'; index: number; block: ContentBlock; } | { type: 'usage'; usage: TokenUsage; } | { type: 'finish'; reason: FinishReason; replayState?: ReplayEnvelope; };"