@things-factory/ai-assistant 10.1.154 → 10.1.155

package/dist-client/utils/agent-choice.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Which AI agent the dock sends a turn with (design/ai/agent-settings.md §5).
+ *
+ * The server lists the agents a person may pick in this domain (`aiAgentChoices`); the dock sends the id of one, and
+ * the server decides the provider, the model and the key from it. What a person last picked is a convenience of this
+ * browser, kept per domain: an id the list no longer has is dropped and the domain's default answers.
+ */
+export interface AgentChoice {
+    id: string;
+    name: string;
+    provider: string;
+    model: string;
+    isDefault: boolean;
+}
+/** The agent to send with: the remembered one while the domain still offers it, else the default, else the first. */
+export declare function pickAgentId(choices: AgentChoice[], remembered?: string | null): string | undefined;
+/** A picker is drawn only when there is something to pick (the same rule as the mode picker, ADR-0072). */
+export declare function offersAgentPicker(choices: AgentChoice[]): boolean;
+export declare function agentMemoryKey(contextPath: string | undefined): string;
+export declare function rememberedAgent(contextPath: string | undefined): string | undefined;
+export declare function rememberAgent(contextPath: string | undefined, agentId: string): void;
+/** `Claude · claude-sonnet-4-6` - what the picker shows beside a name. */
+export declare function agentDetail(choice: Pick<AgentChoice, 'provider' | 'model'>): string;
+export declare function providerLabel(provider: string): string;

package/dist-client/utils/agent-choice.js

@@ -0,0 +1,38 @@
+/** The agent to send with: the remembered one while the domain still offers it, else the default, else the first. */
+export function pickAgentId(choices, remembered) {
+    if (remembered && choices.some(one => one.id === remembered))
+        return remembered;
+    return (choices.find(one => one.isDefault) ?? choices[0])?.id;
+}
+/** A picker is drawn only when there is something to pick (the same rule as the mode picker, ADR-0072). */
+export function offersAgentPicker(choices) {
+    return choices.length >= 2;
+}
+export function agentMemoryKey(contextPath) {
+    return `assistant-agent:${contextPath ?? ''}`;
+}
+export function rememberedAgent(contextPath) {
+    try {
+        return localStorage.getItem(agentMemoryKey(contextPath)) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function rememberAgent(contextPath, agentId) {
+    try {
+        localStorage.setItem(agentMemoryKey(contextPath), agentId);
+    }
+    catch {
+        /* A browser that blocks storage still picks - it just asks again next time. */
+    }
+}
+const PROVIDER_LABEL = { openai: 'OpenAI', anthropic: 'Claude', gemini: 'Gemini' };
+/** `Claude · claude-sonnet-4-6` - what the picker shows beside a name. */
+export function agentDetail(choice) {
+    return `${PROVIDER_LABEL[choice.provider] ?? choice.provider} · ${choice.model}`;
+}
+export function providerLabel(provider) {
+    return PROVIDER_LABEL[provider] ?? provider;
+}
+//# sourceMappingURL=agent-choice.js.map

package/dist-client/utils/agent-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-choice.js","sourceRoot":"","sources":["../../client/utils/agent-choice.ts"],"names":[],"mappings":"AAeA,qHAAqH;AACrH,MAAM,UAAU,WAAW,CAAC,OAAsB,EAAE,UAA0B;IAC5E,IAAI,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,CAAC;QAAE,OAAO,UAAU,CAAA;IAC/E,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC/D,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAA+B;IAC5D,OAAO,mBAAmB,WAAW,IAAI,EAAE,EAAE,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAA+B;IAC7D,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,IAAI,SAAS,CAAA;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAA+B,EAAE,OAAe;IAC5E,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;IACjF,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAA2B,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAE1G,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,MAA+C;IACzE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAA;AAC7C,CAAC","sourcesContent":["/**\n * Which AI agent the dock sends a turn with (design/ai/agent-settings.md §5).\n *\n * The server lists the agents a person may pick in this domain (`aiAgentChoices`); the dock sends the id of one, and\n * the server decides the provider, the model and the key from it. What a person last picked is a convenience of this\n * browser, kept per domain: an id the list no longer has is dropped and the domain's default answers.\n */\nexport interface AgentChoice {\n  id: string\n  name: string\n  provider: string\n  model: string\n  isDefault: boolean\n}\n\n/** The agent to send with: the remembered one while the domain still offers it, else the default, else the first. */\nexport function pickAgentId(choices: AgentChoice[], remembered?: string | null): string | undefined {\n  if (remembered && choices.some(one => one.id === remembered)) return remembered\n  return (choices.find(one => one.isDefault) ?? choices[0])?.id\n}\n\n/** A picker is drawn only when there is something to pick (the same rule as the mode picker, ADR-0072). */\nexport function offersAgentPicker(choices: AgentChoice[]): boolean {\n  return choices.length >= 2\n}\n\nexport function agentMemoryKey(contextPath: string | undefined): string {\n  return `assistant-agent:${contextPath ?? ''}`\n}\n\nexport function rememberedAgent(contextPath: string | undefined): string | undefined {\n  try {\n    return localStorage.getItem(agentMemoryKey(contextPath)) ?? undefined\n  } catch {\n    return undefined\n  }\n}\n\nexport function rememberAgent(contextPath: string | undefined, agentId: string): void {\n  try {\n    localStorage.setItem(agentMemoryKey(contextPath), agentId)\n  } catch {\n    /* A browser that blocks storage still picks - it just asks again next time. */\n  }\n}\n\nconst PROVIDER_LABEL: Record<string, string> = { openai: 'OpenAI', anthropic: 'Claude', gemini: 'Gemini' }\n\n/** `Claude · claude-sonnet-4-6` - what the picker shows beside a name. */\nexport function agentDetail(choice: Pick<AgentChoice, 'provider' | 'model'>): string {\n  return `${PROVIDER_LABEL[choice.provider] ?? choice.provider} · ${choice.model}`\n}\n\nexport function providerLabel(provider: string): string {\n  return PROVIDER_LABEL[provider] ?? provider\n}\n"]}

package/dist-client/utils/assistant-navigation.d.ts

@@ -1,6 +1,11 @@
-/** Screen changes offer a new subject; identity changes must never carry the old conversation. */
+/**
+ * The page decides the conversation (design/ai/shared-dock.md §2-3, 2026-10-12): moving to another screen moves the
+ * dock to that screen's conversation, with no choice put to the person. What was being written stays with its subject
+ * and comes back on return. An answer in progress finishes first - then the dock follows. An identity change never
+ * carries the old conversation.
+ */
 export declare function surfaceTransition(input: {
     identityChanged: boolean;
     sameSubject: boolean;
-    active: boolean;
-}): 'reset' | 'refresh' | 'offer' | 'follow';
+    busy: boolean;
+}): 'reset' | 'refresh' | 'wait' | 'follow';

package/dist-client/utils/assistant-navigation.js

@@ -1,9 +1,14 @@
-/** Screen changes offer a new subject; identity changes must never carry the old conversation. */
+/**
+ * The page decides the conversation (design/ai/shared-dock.md §2-3, 2026-10-12): moving to another screen moves the
+ * dock to that screen's conversation, with no choice put to the person. What was being written stays with its subject
+ * and comes back on return. An answer in progress finishes first - then the dock follows. An identity change never
+ * carries the old conversation.
+ */
 export function surfaceTransition(input) {
     if (input.identityChanged)
         return 'reset';
     if (input.sameSubject)
         return 'refresh';
-    return input.active ? 'offer' : 'follow';
+    return input.busy ? 'wait' : 'follow';
 }
 //# sourceMappingURL=assistant-navigation.js.map

package/dist-client/utils/assistant-navigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-navigation.js","sourceRoot":"","sources":["../../client/utils/assistant-navigation.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAAC,KAA0E;IAC1G,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,OAAO,CAAA;IACzC,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IACvC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC1C,CAAC","sourcesContent":["/** Screen changes offer a new subject; identity changes must never carry the old conversation. */\nexport function surfaceTransition(input: { identityChanged: boolean; sameSubject: boolean; active: boolean }): 'reset' | 'refresh' | 'offer' | 'follow' {\n  if (input.identityChanged) return 'reset'\n  if (input.sameSubject) return 'refresh'\n  return input.active ? 'offer' : 'follow'\n}\n"]}
+{"version":3,"file":"assistant-navigation.js","sourceRoot":"","sources":["../../client/utils/assistant-navigation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAwE;IACxG,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,OAAO,CAAA;IACzC,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvC,CAAC","sourcesContent":["/**\n * The page decides the conversation (design/ai/shared-dock.md §2-3, 2026-10-12): moving to another screen moves the\n * dock to that screen's conversation, with no choice put to the person. What was being written stays with its subject\n * and comes back on return. An answer in progress finishes first - then the dock follows. An identity change never\n * carries the old conversation.\n */\nexport function surfaceTransition(input: { identityChanged: boolean; sameSubject: boolean; busy: boolean }): 'reset' | 'refresh' | 'wait' | 'follow' {\n  if (input.identityChanged) return 'reset'\n  if (input.sameSubject) return 'refresh'\n  return input.busy ? 'wait' : 'follow'\n}\n"]}

package/dist-client/utils/assistant-navigation.test.js

@@ -1,24 +1,30 @@
 import { surfaceTransition } from './assistant-navigation.js';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-describe('a screen offers context without taking over an active conversation', () => {
-    test.each([false, true])('a different identity resets even when active=%s', active => {
+describe('the page decides the conversation - no choice is put to the person', () => {
+    test.each([false, true])('a different identity resets even when busy=%s', busy => {
         for (const sameSubject of [false, true]) {
-            expect(surfaceTransition({ identityChanged: true, sameSubject, active })).toBe('reset');
+            expect(surfaceTransition({ identityChanged: true, sameSubject, busy })).toBe('reset');
         }
     });
-    test('an empty conversation follows the screen', () => {
-        expect(surfaceTransition({ identityChanged: false, sameSubject: false, active: false })).toBe('follow');
+    test('★ another screen is followed - a conversation in progress or text being written does not hold the dock', () => {
+        expect(surfaceTransition({ identityChanged: false, sameSubject: false, busy: false })).toBe('follow');
     });
-    test('an existing conversation, draft or ongoing response offers a switch', () => {
-        expect(surfaceTransition({ identityChanged: false, sameSubject: false, active: true })).toBe('offer');
+    test('★ an answer in progress finishes in its own conversation first, then the dock follows', () => {
+        expect(surfaceTransition({ identityChanged: false, sameSubject: false, busy: true })).toBe('wait');
     });
     test('returning to the same subject refreshes without reopening', () => {
-        expect(surfaceTransition({ identityChanged: false, sameSubject: true, active: true })).toBe('refresh');
+        expect(surfaceTransition({ identityChanged: false, sameSubject: true, busy: true })).toBe('refresh');
     });
 });
 describe('navigation wiring', () => {
     const dock = readFileSync(join(__dirname, '../components/assistant-dock.ts'), 'utf8');
+    test('★ what was being written stays with its subject and comes back on return', () => {
+        expect(dock).toMatch(/if \(transition !== 'reset'\) this\.keepDraft\(\)/);
+        expect(dock).toContain('void this.restoreDraft()');
+        expect(dock).not.toContain('screenChanged');
+        expect(dock).not.toContain('switch-to-screen');
+    });
     test('history hides rather than unmounts the chat and its unsent input', () => {
         expect(dock).toContain('?hidden=${this.showingHistory}');
         expect(dock).toContain('ready && !this.loading && !this.failure');

package/dist-client/utils/assistant-navigation.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-navigation.test.js","sourceRoot":"","sources":["../../client/utils/assistant-navigation.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { surfaceTransition } from './assistant-navigation.js'\nimport { readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\ndescribe('a screen offers context without taking over an active conversation', () => {\n  test.each([false, true])('a different identity resets even when active=%s', active => {\n    for (const sameSubject of [false, true]) {\n      expect(surfaceTransition({ identityChanged: true, sameSubject, active })).toBe('reset')\n    }\n  })\n  test('an empty conversation follows the screen', () => {\n    expect(surfaceTransition({ identityChanged: false, sameSubject: false, active: false })).toBe('follow')\n  })\n  test('an existing conversation, draft or ongoing response offers a switch', () => {\n    expect(surfaceTransition({ identityChanged: false, sameSubject: false, active: true })).toBe('offer')\n  })\n  test('returning to the same subject refreshes without reopening', () => {\n    expect(surfaceTransition({ identityChanged: false, sameSubject: true, active: true })).toBe('refresh')\n  })\n})\n\ndescribe('navigation wiring', () => {\n  const dock = readFileSync(join(__dirname, '../components/assistant-dock.ts'), 'utf8')\n  test('history hides rather than unmounts the chat and its unsent input', () => {\n    expect(dock).toContain('?hidden=${this.showingHistory}')\n    expect(dock).toContain('ready && !this.loading && !this.failure')\n  })\n  test('identity changes clear a carried ask and reread capability', () => {\n    expect(dock).toContain(\"if (transition === 'reset')\")\n    expect(dock).toContain('this.asking = undefined')\n    expect(dock).toContain(\"this.capability = 'unknown'\")\n  })\n  test('all direct board actions check the current screen, not the retained editor', () => {\n    expect(dock).toContain('if (!this.mayApplyOnScreen()) return')\n    expect(dock.match(/if \\(this.mayApplyOnScreen\\(\\)\\)/g)).toHaveLength(2)\n    expect(dock).toContain(\"errorCode: 'conversation-screen-changed'\")\n  })\n})\n\n\ndescribe('a carried draft survives opening a new conversation', () => {\n  test('automatic review starts after cleanup and is sent once per request', () => {\n    const source = readFileSync(join(__dirname, '../components/assistant-chat.ts'), 'utf8')\n    const update = source.slice(source.indexOf('  updated(changed:'), source.indexOf('  disconnectedCallback()', source.indexOf('  updated(changed:')))\n    const placement = update.indexOf('if (this.autoAsk &&')\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('sessionId')\"))\n    expect(update.slice(placement)).not.toContain(\"this.input = ''\")\n    expect(update.slice(placement)).toContain('!== this._autoAsked')\n    expect(update.slice(placement)).toContain('void this.send()')\n  })\n  test('draft placement follows subject, mode and session cleanup', () => {\n    const source = readFileSync(join(__dirname, '../components/assistant-chat.ts'), 'utf8')\n    const update = source.slice(source.indexOf('  updated(changed:'), source.indexOf('  disconnectedCallback()', source.indexOf('  updated(changed:')))\n    const placement = update.indexOf('const draft = assistantDraftDecision(')\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('subject'))\"))\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('mode')\"))\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('sessionId')\"))\n    expect(update.slice(placement)).not.toContain(\"this.input = ''\")\n  })\n})\n"]}
+{"version":3,"file":"assistant-navigation.test.js","sourceRoot":"","sources":["../../client/utils/assistant-navigation.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { surfaceTransition } from './assistant-navigation.js'\nimport { readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\ndescribe('the page decides the conversation - no choice is put to the person', () => {\n  test.each([false, true])('a different identity resets even when busy=%s', busy => {\n    for (const sameSubject of [false, true]) {\n      expect(surfaceTransition({ identityChanged: true, sameSubject, busy })).toBe('reset')\n    }\n  })\n  test('★ another screen is followed - a conversation in progress or text being written does not hold the dock', () => {\n    expect(surfaceTransition({ identityChanged: false, sameSubject: false, busy: false })).toBe('follow')\n  })\n  test('★ an answer in progress finishes in its own conversation first, then the dock follows', () => {\n    expect(surfaceTransition({ identityChanged: false, sameSubject: false, busy: true })).toBe('wait')\n  })\n  test('returning to the same subject refreshes without reopening', () => {\n    expect(surfaceTransition({ identityChanged: false, sameSubject: true, busy: true })).toBe('refresh')\n  })\n})\n\ndescribe('navigation wiring', () => {\n  const dock = readFileSync(join(__dirname, '../components/assistant-dock.ts'), 'utf8')\n  test('★ what was being written stays with its subject and comes back on return', () => {\n    expect(dock).toMatch(/if \\(transition !== 'reset'\\) this\\.keepDraft\\(\\)/)\n    expect(dock).toContain('void this.restoreDraft()')\n    expect(dock).not.toContain('screenChanged')\n    expect(dock).not.toContain('switch-to-screen')\n  })\n  test('history hides rather than unmounts the chat and its unsent input', () => {\n    expect(dock).toContain('?hidden=${this.showingHistory}')\n    expect(dock).toContain('ready && !this.loading && !this.failure')\n  })\n  test('identity changes clear a carried ask and reread capability', () => {\n    expect(dock).toContain(\"if (transition === 'reset')\")\n    expect(dock).toContain('this.asking = undefined')\n    expect(dock).toContain(\"this.capability = 'unknown'\")\n  })\n  test('all direct board actions check the current screen, not the retained editor', () => {\n    expect(dock).toContain('if (!this.mayApplyOnScreen()) return')\n    expect(dock.match(/if \\(this.mayApplyOnScreen\\(\\)\\)/g)).toHaveLength(2)\n    expect(dock).toContain(\"errorCode: 'conversation-screen-changed'\")\n  })\n})\n\n\ndescribe('a carried draft survives opening a new conversation', () => {\n  test('automatic review starts after cleanup and is sent once per request', () => {\n    const source = readFileSync(join(__dirname, '../components/assistant-chat.ts'), 'utf8')\n    const update = source.slice(source.indexOf('  updated(changed:'), source.indexOf('  disconnectedCallback()', source.indexOf('  updated(changed:')))\n    const placement = update.indexOf('if (this.autoAsk &&')\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('sessionId')\"))\n    expect(update.slice(placement)).not.toContain(\"this.input = ''\")\n    expect(update.slice(placement)).toContain('!== this._autoAsked')\n    expect(update.slice(placement)).toContain('void this.send()')\n  })\n  test('draft placement follows subject, mode and session cleanup', () => {\n    const source = readFileSync(join(__dirname, '../components/assistant-chat.ts'), 'utf8')\n    const update = source.slice(source.indexOf('  updated(changed:'), source.indexOf('  disconnectedCallback()', source.indexOf('  updated(changed:')))\n    const placement = update.indexOf('const draft = assistantDraftDecision(')\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('subject'))\"))\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('mode')\"))\n    expect(placement).toBeGreaterThan(update.indexOf(\"if (changed.has('sessionId')\"))\n    expect(update.slice(placement)).not.toContain(\"this.input = ''\")\n  })\n})\n"]}

package/dist-client/utils/composer-frame.d.ts

@@ -12,8 +12,15 @@ export type ComposerKey = {
     metaKey?: boolean;
     altKey?: boolean;
 };
-/** What a key does in the box: send, close the wide box, or nothing of ours (the textarea keeps it). */
-export declare function composerKeyAction(e: ComposerKey, wide: boolean): 'send' | 'narrow' | null;
+/**
+ * What a key does in the box: send, close the wide box, take the suggestion, or nothing of ours (the textarea keeps
+ * it). The words shown in an empty box are a request the screen suggests - a plain Tab writes them in, so the person
+ * does not have to type what the screen already said.
+ */
+export declare function composerKeyAction(e: ComposerKey, wide: boolean, box?: {
+    empty?: boolean;
+    suggestion?: string;
+}): 'send' | 'narrow' | 'take-suggestion' | null;
 /** The shortcut the wide box's send button names, in the keys of this machine. */
 export declare function sendShortcut(platform: string | undefined): string;
 /**
@@ -26,3 +33,17 @@ export declare function tableAsWords(table: {
 }): string;
 /** The words appended to what is already written - on a line of their own. */
 export declare function appendWords(written: string, words: string): string;
+/**
+ * The request the empty box suggests, which a Tab writes in: the conversation's first example request, its own
+ * before the host's. A placeholder is how to write, not a request, so it is never the suggestion. Once the
+ * conversation is under way an opening example no longer fits, and nothing is suggested.
+ */
+export declare function composerSuggestion(input: {
+    started: boolean;
+    modeExamples?: Array<{
+        items: string[];
+    }>;
+    hostExamples?: Array<{
+        items: string[];
+    }>;
+}): string | undefined;

package/dist-client/utils/composer-frame.js

@@ -15,8 +15,15 @@ export function composerHeight(content, chat, resting) {
     const cap = Math.max(resting, Math.floor(chat * COMPOSER_GROWTH));
     return { height: Math.min(Math.max(content, resting), cap), scrolls: content > cap };
 }
-/** What a key does in the box: send, close the wide box, or nothing of ours (the textarea keeps it). */
-export function composerKeyAction(e, wide) {
+/**
+ * What a key does in the box: send, close the wide box, take the suggestion, or nothing of ours (the textarea keeps
+ * it). The words shown in an empty box are a request the screen suggests - a plain Tab writes them in, so the person
+ * does not have to type what the screen already said.
+ */
+export function composerKeyAction(e, wide, box = {}) {
+    if (e.key === 'Tab' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey && box.empty && box.suggestion?.trim()) {
+        return 'take-suggestion';
+    }
     if (e.key === 'Escape')
         return wide ? 'narrow' : null;
     if (e.key !== 'Enter' || e.altKey)
@@ -43,4 +50,15 @@ export function tableAsWords(table) {
 export function appendWords(written, words) {
     return written.trim() ? `${written.replace(/\s+$/, '')}\n${words}` : words;
 }
+/**
+ * The request the empty box suggests, which a Tab writes in: the conversation's first example request, its own
+ * before the host's. A placeholder is how to write, not a request, so it is never the suggestion. Once the
+ * conversation is under way an opening example no longer fits, and nothing is suggested.
+ */
+export function composerSuggestion(input) {
+    if (input.started)
+        return undefined;
+    const groups = input.modeExamples?.length ? input.modeExamples : input.hostExamples;
+    return groups?.find(group => group.items.length > 0)?.items[0];
+}
 //# sourceMappingURL=composer-frame.js.map

package/dist-client/utils/composer-frame.js.map

@@ -1 +1 @@
-{"version":3,"file":"composer-frame.js","sourceRoot":"","sources":["../../client/utils/composer-frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAElC,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAY,EAAE,OAAe;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,eAAe,CAAC,CAAC,CAAA;IACjE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,EAAE,CAAA;AACtF,CAAC;AAID,wGAAwG;AACxG,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,IAAa;IAC7D,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;IACrD,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAC9C,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,MAAM,CAAA;IACzC,IAAI,IAAI,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,MAAM,CAAA;AACf,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,QAA4B;IACvD,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAA;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiD;IAC5E,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3E,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9E,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAa;IACxD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AAC5E,CAAC","sourcesContent":["/*\n * The composer's frame (operato-application/design/ai/shared-dock.md §10) - how tall it stands, what Enter does,\n * and what a pasted table gives back as words. Pure: the chat hands in its measures and the key.\n *\n * - The box grows with its text up to 40% of the chat's height, then scrolls. It never stands under its resting\n *   height, and on a chat too short for 40% to hold that height the resting height wins.\n * - The wide box (넓게 쓰기) covers the conversation inside the dock; the page beside it stays where it was.\n * - In the small box Enter sends and Shift+Enter breaks the line, as in every chat. In the wide box Enter breaks\n *   the line - long writing is made of lines - and Ctrl/Cmd+Enter sends. Ctrl/Cmd+Enter sends in both.\n */\n\n/** The part of the chat's height the small box may take before it scrolls. */\nexport const COMPOSER_GROWTH = 0.4\n\n/** The box's height for its content, both border-box pixels. */\nexport function composerHeight(content: number, chat: number, resting: number): { height: number; scrolls: boolean } {\n  const cap = Math.max(resting, Math.floor(chat * COMPOSER_GROWTH))\n  return { height: Math.min(Math.max(content, resting), cap), scrolls: content > cap }\n}\n\nexport type ComposerKey = { key: string; shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean; altKey?: boolean }\n\n/** What a key does in the box: send, close the wide box, or nothing of ours (the textarea keeps it). */\nexport function composerKeyAction(e: ComposerKey, wide: boolean): 'send' | 'narrow' | null {\n  if (e.key === 'Escape') return wide ? 'narrow' : null\n  if (e.key !== 'Enter' || e.altKey) return null\n  if (e.ctrlKey || e.metaKey) return 'send'\n  if (wide || e.shiftKey) return null\n  return 'send'\n}\n\n/** The shortcut the wide box's send button names, in the keys of this machine. */\nexport function sendShortcut(platform: string | undefined): string {\n  return /mac|iphone|ipad/i.test(platform ?? '') ? '⌘ Enter' : 'Ctrl+Enter'\n}\n\n/**\n * A pasted table given back as words: what the clipboard held as text, or - when it held only HTML - the rows with\n * a tab between cells, as a spreadsheet copies them.\n */\nexport function tableAsWords(table: { rows: string[][]; text?: string | null }): string {\n  const text = (table.text ?? '').replace(/\\r\\n?/g, '\\n').replace(/\\n+$/, '')\n  return text.trim() ? text : table.rows.map(row => row.join('\\t')).join('\\n')\n}\n\n/** The words appended to what is already written - on a line of their own. */\nexport function appendWords(written: string, words: string): string {\n  return written.trim() ? `${written.replace(/\\s+$/, '')}\\n${words}` : words\n}\n"]}
+{"version":3,"file":"composer-frame.js","sourceRoot":"","sources":["../../client/utils/composer-frame.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The composer's frame (operato-application/design/ai/shared-dock.md §10) - how tall it stands, what Enter does,\n * and what a pasted table gives back as words. Pure: the chat hands in its measures and the key.\n *\n * - The box grows with its text up to 40% of the chat's height, then scrolls. It never stands under its resting\n *   height, and on a chat too short for 40% to hold that height the resting height wins.\n * - The wide box (넓게 쓰기) covers the conversation inside the dock; the page beside it stays where it was.\n * - In the small box Enter sends and Shift+Enter breaks the line, as in every chat. In the wide box Enter breaks\n *   the line - long writing is made of lines - and Ctrl/Cmd+Enter sends. Ctrl/Cmd+Enter sends in both.\n */\n\n/** The part of the chat's height the small box may take before it scrolls. */\nexport const COMPOSER_GROWTH = 0.4\n\n/** The box's height for its content, both border-box pixels. */\nexport function composerHeight(content: number, chat: number, resting: number): { height: number; scrolls: boolean } {\n  const cap = Math.max(resting, Math.floor(chat * COMPOSER_GROWTH))\n  return { height: Math.min(Math.max(content, resting), cap), scrolls: content > cap }\n}\n\nexport type ComposerKey = { key: string; shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean; altKey?: boolean }\n\n/**\n * What a key does in the box: send, close the wide box, take the suggestion, or nothing of ours (the textarea keeps\n * it). The words shown in an empty box are a request the screen suggests - a plain Tab writes them in, so the person\n * does not have to type what the screen already said.\n */\nexport function composerKeyAction(\n  e: ComposerKey,\n  wide: boolean,\n  box: { empty?: boolean; suggestion?: string } = {}\n): 'send' | 'narrow' | 'take-suggestion' | null {\n  if (e.key === 'Tab' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey && box.empty && box.suggestion?.trim()) {\n    return 'take-suggestion'\n  }\n  if (e.key === 'Escape') return wide ? 'narrow' : null\n  if (e.key !== 'Enter' || e.altKey) return null\n  if (e.ctrlKey || e.metaKey) return 'send'\n  if (wide || e.shiftKey) return null\n  return 'send'\n}\n\n/** The shortcut the wide box's send button names, in the keys of this machine. */\nexport function sendShortcut(platform: string | undefined): string {\n  return /mac|iphone|ipad/i.test(platform ?? '') ? '⌘ Enter' : 'Ctrl+Enter'\n}\n\n/**\n * A pasted table given back as words: what the clipboard held as text, or - when it held only HTML - the rows with\n * a tab between cells, as a spreadsheet copies them.\n */\nexport function tableAsWords(table: { rows: string[][]; text?: string | null }): string {\n  const text = (table.text ?? '').replace(/\\r\\n?/g, '\\n').replace(/\\n+$/, '')\n  return text.trim() ? text : table.rows.map(row => row.join('\\t')).join('\\n')\n}\n\n/** The words appended to what is already written - on a line of their own. */\nexport function appendWords(written: string, words: string): string {\n  return written.trim() ? `${written.replace(/\\s+$/, '')}\\n${words}` : words\n}\n\n/**\n * The request the empty box suggests, which a Tab writes in: the conversation's first example request, its own\n * before the host's. A placeholder is how to write, not a request, so it is never the suggestion. Once the\n * conversation is under way an opening example no longer fits, and nothing is suggested.\n */\nexport function composerSuggestion(input: {\n  started: boolean\n  modeExamples?: Array<{ items: string[] }>\n  hostExamples?: Array<{ items: string[] }>\n}): string | undefined {\n  if (input.started) return undefined\n  const groups = input.modeExamples?.length ? input.modeExamples : input.hostExamples\n  return groups?.find(group => group.items.length > 0)?.items[0]\n}\n"]}

package/dist-client/utils/menu-room.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The page's menu gives the dock its room (2026-10-12). When the dock opens beside the page, the left menu folds to its
+ * icons; when the dock closes, the menu opens again - only if it is still folded the way the dock left it. A menu the
+ * person folded themselves stays folded, and the dock's fold is never saved as the person's choice: it sets the menu's
+ * state without the menu's own `setCollapsed`, which stores it.
+ */
+export interface MenuLike {
+    collapsed: boolean;
+}
+export declare function foldForDock(menu: MenuLike | undefined): boolean;
+export declare function unfoldAfterDock(menu: MenuLike | undefined, foldedByDock: boolean): void;
+/** The framework's menu (`ox-menu-part` of @operato/menu), wherever the layout put it. */
+export declare function findMenu(root?: Document | ShadowRoot): (HTMLElement & MenuLike) | undefined;

package/dist-client/utils/menu-room.js

@@ -0,0 +1,26 @@
+export function foldForDock(menu) {
+    if (!menu || menu.collapsed)
+        return false;
+    menu.collapsed = true;
+    return true;
+}
+export function unfoldAfterDock(menu, foldedByDock) {
+    if (!menu || !foldedByDock || !menu.collapsed)
+        return;
+    menu.collapsed = false;
+}
+/** The framework's menu (`ox-menu-part` of @operato/menu), wherever the layout put it. */
+export function findMenu(root = document) {
+    const found = root.querySelector('ox-menu-part');
+    if (found)
+        return found;
+    for (const element of root.querySelectorAll('*')) {
+        if (element.shadowRoot) {
+            const inner = findMenu(element.shadowRoot);
+            if (inner)
+                return inner;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=menu-room.js.map

package/dist-client/utils/menu-room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-room.js","sourceRoot":"","sources":["../../client/utils/menu-room.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,WAAW,CAAC,IAA0B;IACpD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;IACrB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAA0B,EAAE,YAAqB;IAC/E,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAM;IACrD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;AACxB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,QAAQ,CAAC,OAA8B,QAAQ;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAoC,CAAA;IACnF,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAC1C,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC","sourcesContent":["/**\n * The page's menu gives the dock its room (2026-10-12). When the dock opens beside the page, the left menu folds to its\n * icons; when the dock closes, the menu opens again - only if it is still folded the way the dock left it. A menu the\n * person folded themselves stays folded, and the dock's fold is never saved as the person's choice: it sets the menu's\n * state without the menu's own `setCollapsed`, which stores it.\n */\nexport interface MenuLike {\n  collapsed: boolean\n}\n\nexport function foldForDock(menu: MenuLike | undefined): boolean {\n  if (!menu || menu.collapsed) return false\n  menu.collapsed = true\n  return true\n}\n\nexport function unfoldAfterDock(menu: MenuLike | undefined, foldedByDock: boolean): void {\n  if (!menu || !foldedByDock || !menu.collapsed) return\n  menu.collapsed = false\n}\n\n/** The framework's menu (`ox-menu-part` of @operato/menu), wherever the layout put it. */\nexport function findMenu(root: Document | ShadowRoot = document): (HTMLElement & MenuLike) | undefined {\n  const found = root.querySelector('ox-menu-part') as (HTMLElement & MenuLike) | null\n  if (found) return found\n  for (const element of root.querySelectorAll('*')) {\n    if (element.shadowRoot) {\n      const inner = findMenu(element.shadowRoot)\n      if (inner) return inner\n    }\n  }\n  return undefined\n}\n"]}

package/dist-server/service/ai-agent-resolver.d.ts

@@ -0,0 +1,82 @@
+import '@things-factory/auth-base';
+declare class AiAgentDomain {
+    id: string;
+    name: string;
+}
+declare class AiAgentView {
+    id: string;
+    name: string;
+    provider: string;
+    model: string;
+    baseURL?: string;
+    organization?: string;
+    active: boolean;
+    owner: AiAgentDomain;
+    inherited: boolean;
+    turnedOff: boolean;
+    keyState: string;
+    keyDomain?: AiAgentDomain;
+    keyHint?: string;
+    usable: boolean;
+    isDefault: boolean;
+    usedBelow: AiAgentDomain[];
+}
+declare class AiAgentSettings {
+    chain: AiAgentDomain[];
+    agents: AiAgentView[];
+    defaultAgentId?: string;
+    defaultFrom: string;
+    state: string;
+    reason?: string;
+}
+declare class AiAgentChoice {
+    id: string;
+    name: string;
+    provider: string;
+    model: string;
+    isDefault: boolean;
+}
+declare class AiAgentInput {
+    id?: string;
+    name: string;
+    provider: string;
+    model: string;
+    baseURL?: string;
+    organization?: string;
+    active: boolean;
+    apiKey?: string;
+}
+declare class InheritedKeyInput {
+    agentId: string;
+    apiKey?: string;
+    clear?: boolean;
+}
+declare class AiAgentsInput {
+    agents: AiAgentInput[];
+    defaultAgentId?: string;
+    turnedOff?: string[];
+    inheritedKeys?: InheritedKeyInput[];
+}
+declare class AiUsageBucket {
+    bucket: string;
+    agentId?: string;
+    agentName?: string;
+    provider: string;
+    model: string;
+    domainId: string;
+    domainName: string;
+    userId?: string;
+    userName?: string;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    failures: number;
+}
+export declare class AiAgentResolver {
+    aiAgentSettings(context: ResolverContext): Promise<AiAgentSettings>;
+    aiAgentChoices(context: ResolverContext): Promise<AiAgentChoice[]>;
+    aiProviderModels(provider: string, apiKey: string, agentId: string, baseURL: string, organization: string, context: ResolverContext): Promise<string[]>;
+    saveAiAgents(input: AiAgentsInput, context: ResolverContext): Promise<boolean>;
+    aiUsageSummary(from: Date, to: Date, bucket: string, agentIds: string[], userIds: string[], includeDescendants: boolean, context: ResolverContext): Promise<AiUsageBucket[]>;
+}
+export {};