@things-factory/ai-assistant 10.1.90 → 10.1.97

package/dist-server/service/workspace/workspace-tools.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workspaceCategory = exports.WORKSPACE_CATEGORY = void 0;
+exports.showInWorkspace = showInWorkspace;
+/*
+ * showInWorkspace - the model puts a large result on the AI 작업판 (operato-application/design/ai/workspace.md §5).
+ *
+ * The result rides on the answer as a proposal of kind 'workspace', so the conversation's gates hold for it:
+ * who may read the conversation reads the workspace, and a value behind a door the reader cannot pass hides
+ * it with the answer (ADR-0073). The tool itself reaches no door - what it carries came from the turn's other
+ * tools, whose doors the answer row collects.
+ */
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+const workspace_blocks_js_1 = require("./workspace-blocks.js");
+exports.WORKSPACE_CATEGORY = 'assistant-workspace';
+function showInWorkspace(args) {
+    const { workspace, error } = (0, workspace_blocks_js_1.normalizeWorkspace)(args);
+    if (!workspace)
+        return { rejected: true, error, message: 'a workspace needs a title and at least one block.' };
+    const contents = (0, workspace_blocks_js_1.workspaceContents)(workspace);
+    return {
+        proposed: true,
+        kind: 'workspace',
+        icon: 'dashboard',
+        label: workspace.title,
+        workspace,
+        contents,
+        message: `put "${workspace.title}" on the workspace (${workspace.blocks.length} blocks). The person opens it from the card - say in one line what it holds; do not repeat its tables in the answer.`
+    };
+}
+const spec = {
+    kind: 'read',
+    name: 'showInWorkspace',
+    doors: [],
+    description: 'Put a large result on the AI workspace - a page the person opens from a card, beside the conversation. Blocks: ' +
+        'heading{text,level}, text{markdown}, metrics{items:[{label,value,unit,note}]}, table{columns:[{name,label,type:number|date|string}],rows,caption}, ' +
+        'chart{chart:bar|line, x:[labels], series:[{name,values:[numbers]}], unit, caption}, steps{items:[{label,state:done|doing|todo|failed,note}]}.',
+    schema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'A short key, lowercase with dashes ("contracts-by-customer"). The same name again makes a new version of the same workspace.' },
+            title: { type: 'string' },
+            summary: { type: 'string', description: 'One line under the title.' },
+            blocks: {
+                type: 'array',
+                items: { type: 'object', properties: { kind: { type: 'string', enum: [...workspace_blocks_js_1.WORKSPACE_BLOCK_KINDS] } }, required: ['kind'] }
+            }
+        },
+        required: ['name', 'title', 'blocks']
+    },
+    builder: (args) => showInWorkspace(args)
+};
+exports.workspaceCategory = {
+    name: exports.WORKSPACE_CATEGORY,
+    description: 'the AI workspace - a page for results too large for the conversation',
+    guidance: [
+        '- When a result is more than a short table (over 20 rows, or two or more tables or charts), or the person asks for a page, call showInWorkspace. Keep the answer short: the point, and that it is on the workspace.',
+        '- Every number in a block comes from a tool result in this conversation - never computed or guessed by you.',
+        '- To change a workspace, call showInWorkspace again with the same name and the whole new content; it becomes a new version.',
+        '- Never say something is on the workspace unless you called showInWorkspace in this turn.'
+    ].join('\n'),
+    specs: [spec]
+};
+(0, ai_client_base_1.registerToolCategory)(exports.workspaceCategory);
+//# sourceMappingURL=workspace-tools.js.map

package/dist-server/service/workspace/workspace-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tools.js","sourceRoot":"","sources":["../../../server/service/workspace/workspace-tools.ts"],"names":[],"mappings":";;;AAcA,0CAaC;AA3BD;;;;;;;GAOG;AACH,mEAAuG;AAEvG,+DAAoG;AAEvF,QAAA,kBAAkB,GAAG,qBAAqB,CAAA;AAEvD,SAAgB,eAAe,CAAC,IAAS;IACvC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAA,wCAAkB,EAAC,IAAI,CAAC,CAAA;IACrD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAA;IAC9G,MAAM,QAAQ,GAAG,IAAA,uCAAiB,EAAC,SAAS,CAAC,CAAA;IAC7C,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,SAAS;QACT,QAAQ;QACR,OAAO,EAAE,QAAQ,SAAS,CAAC,KAAK,uBAAuB,SAAS,CAAC,MAAM,CAAC,MAAM,sHAAsH;KACrM,CAAA;AACH,CAAC;AAED,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,EAAE;IACT,WAAW,EACT,iHAAiH;QACjH,qJAAqJ;QACrJ,+IAA+I;IACjJ,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8HAA8H,EAAE;YACrK,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACrE,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,2CAAqB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;aAC1H;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;KACtC;IACD,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;CAClC,CAAA;AAEA,QAAA,iBAAiB,GAAiB;IAC7C,IAAI,EAAE,0BAAkB;IACxB,WAAW,EAAE,sEAAsE;IACnF,QAAQ,EAAE;QACR,qNAAqN;QACrN,6GAA6G;QAC7G,6HAA6H;QAC7H,2FAA2F;KAC5F,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,KAAK,EAAE,CAAC,IAAI,CAAC;CACd,CAAA;AAED,IAAA,qCAAoB,EAAC,yBAAiB,CAAC,CAAA","sourcesContent":["/*\n * showInWorkspace - the model puts a large result on the AI 작업판 (operato-application/design/ai/workspace.md §5).\n *\n * The result rides on the answer as a proposal of kind 'workspace', so the conversation's gates hold for it:\n * who may read the conversation reads the workspace, and a value behind a door the reader cannot pass hides\n * it with the answer (ADR-0073). The tool itself reaches no door - what it carries came from the turn's other\n * tools, whose doors the answer row collects.\n */\nimport { registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'\n\nimport { normalizeWorkspace, workspaceContents, WORKSPACE_BLOCK_KINDS } from './workspace-blocks.js'\n\nexport const WORKSPACE_CATEGORY = 'assistant-workspace'\n\nexport function showInWorkspace(args: any) {\n  const { workspace, error } = normalizeWorkspace(args)\n  if (!workspace) return { rejected: true, error, message: 'a workspace needs a title and at least one block.' }\n  const contents = workspaceContents(workspace)\n  return {\n    proposed: true,\n    kind: 'workspace',\n    icon: 'dashboard',\n    label: workspace.title,\n    workspace,\n    contents,\n    message: `put \"${workspace.title}\" on the workspace (${workspace.blocks.length} blocks). The person opens it from the card - say in one line what it holds; do not repeat its tables in the answer.`\n  }\n}\n\nconst spec = {\n  kind: 'read',\n  name: 'showInWorkspace',\n  doors: [],\n  description:\n    'Put a large result on the AI workspace - a page the person opens from a card, beside the conversation. Blocks: ' +\n    'heading{text,level}, text{markdown}, metrics{items:[{label,value,unit,note}]}, table{columns:[{name,label,type:number|date|string}],rows,caption}, ' +\n    'chart{chart:bar|line, x:[labels], series:[{name,values:[numbers]}], unit, caption}, steps{items:[{label,state:done|doing|todo|failed,note}]}.',\n  schema: {\n    type: 'object',\n    properties: {\n      name: { type: 'string', description: 'A short key, lowercase with dashes (\"contracts-by-customer\"). The same name again makes a new version of the same workspace.' },\n      title: { type: 'string' },\n      summary: { type: 'string', description: 'One line under the title.' },\n      blocks: {\n        type: 'array',\n        items: { type: 'object', properties: { kind: { type: 'string', enum: [...WORKSPACE_BLOCK_KINDS] } }, required: ['kind'] }\n      }\n    },\n    required: ['name', 'title', 'blocks']\n  },\n  builder: (args: any) => showInWorkspace(args)\n} as ToolSpec\n\nexport const workspaceCategory: ToolCategory = {\n  name: WORKSPACE_CATEGORY,\n  description: 'the AI workspace - a page for results too large for the conversation',\n  guidance: [\n    '- When a result is more than a short table (over 20 rows, or two or more tables or charts), or the person asks for a page, call showInWorkspace. Keep the answer short: the point, and that it is on the workspace.',\n    '- Every number in a block comes from a tool result in this conversation - never computed or guessed by you.',\n    '- To change a workspace, call showInWorkspace again with the same name and the whole new content; it becomes a new version.',\n    '- Never say something is on the workspace unless you called showInWorkspace in this turn.'\n  ].join('\\n'),\n  specs: [spec]\n}\n\nregisterToolCategory(workspaceCategory)\n"]}