maestro-core 0.2.3 → 0.2.4

package/dist/runtime/anti-narration.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Anti-narration system-prompt fragment.
+ *
+ * Anthropic models sometimes emit BOTH structured `tool_use` blocks
+ * AND a prose narration of the same call using the legacy
+ * `<function_calls>` / `<invoke>` XML format from their training
+ * corpus. Tools execute correctly either way — the AI SDK only acts
+ * on the structured blocks — but the XML leaks into the user-visible
+ * answer and the chat bubble looks broken.
+ *
+ * The default behaviour can be suppressed by an explicit instruction
+ * in the system prompt. Compose this constant into your
+ * `systemPrompt.static`:
+ *
+ *   ```ts
+ *   import { ANTI_TOOL_NARRATION_RULE } from 'maestro-core/runtime'
+ *
+ *   runChatTurn({
+ *     systemPrompt: {
+ *       static: `${persona}\n\n${ANTI_TOOL_NARRATION_RULE}\n\n${corpus}`,
+ *     },
+ *     // ...
+ *   })
+ *   ```
+ *
+ * Hosts that already have a long multi-segment system prompt with
+ * explicit guidance on tool/UI rendering (barbeiro's legacy route,
+ * for example) often don't need this — the existing prose pre-empts
+ * the narration bias. Short prompts (the common case when extracting
+ * a kernel) re-surface it.
+ *
+ * See [[ai_sdk_tools_function_calls_xml_in_prose]] memory note for
+ * the full trap catalog.
+ */
+export declare const ANTI_TOOL_NARRATION_RULE: string;
+//# sourceMappingURL=anti-narration.d.ts.map

package/dist/runtime/anti-narration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-narration.d.ts","sourceRoot":"","sources":["../../src/runtime/anti-narration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,wBAAwB,QAMf,CAAA"}

package/dist/runtime/anti-narration.js

@@ -0,0 +1,41 @@
+/**
+ * Anti-narration system-prompt fragment.
+ *
+ * Anthropic models sometimes emit BOTH structured `tool_use` blocks
+ * AND a prose narration of the same call using the legacy
+ * `<function_calls>` / `<invoke>` XML format from their training
+ * corpus. Tools execute correctly either way — the AI SDK only acts
+ * on the structured blocks — but the XML leaks into the user-visible
+ * answer and the chat bubble looks broken.
+ *
+ * The default behaviour can be suppressed by an explicit instruction
+ * in the system prompt. Compose this constant into your
+ * `systemPrompt.static`:
+ *
+ *   ```ts
+ *   import { ANTI_TOOL_NARRATION_RULE } from 'maestro-core/runtime'
+ *
+ *   runChatTurn({
+ *     systemPrompt: {
+ *       static: `${persona}\n\n${ANTI_TOOL_NARRATION_RULE}\n\n${corpus}`,
+ *     },
+ *     // ...
+ *   })
+ *   ```
+ *
+ * Hosts that already have a long multi-segment system prompt with
+ * explicit guidance on tool/UI rendering (barbeiro's legacy route,
+ * for example) often don't need this — the existing prose pre-empts
+ * the narration bias. Short prompts (the common case when extracting
+ * a kernel) re-surface it.
+ *
+ * See [[ai_sdk_tools_function_calls_xml_in_prose]] memory note for
+ * the full trap catalog.
+ */
+export const ANTI_TOOL_NARRATION_RULE = 'When you call tools, do NOT narrate the call or include any ' +
+    '`<function_calls>`, `<invoke>`, or similar XML in your text ' +
+    'output. The tool runs structurally; your reply must contain ' +
+    'only the natural-language answer derived from the tool ' +
+    'results. Never repeat the tool name, parameters, or any XML ' +
+    'markup in prose.';
+//# sourceMappingURL=anti-narration.js.map

package/dist/runtime/anti-narration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-narration.js","sourceRoot":"","sources":["../../src/runtime/anti-narration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACjC,8DAA8D;IAC9D,8DAA8D;IAC9D,8DAA8D;IAC9D,yDAAyD;IACzD,8DAA8D;IAC9D,kBAAkB,CAAA"}

package/dist/runtime/index.d.ts

@@ -1,3 +1,4 @@
+export { ANTI_TOOL_NARRATION_RULE } from './anti-narration.js';
 export { decideEmptyRecovery, type DecideEmptyRecoveryArgs, type EmptyRecoveryDecision, type EmptyRecoveryMode, } from './empty-recovery.js';
 export { formatMemoryBlock, loadMemoryBlock } from './memory.js';
 export { mapModelIdToOpenAI, shouldFallback } from './providers.js';

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EACH,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,eAAe,EACf,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACxB,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACH,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EACH,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,eAAe,EACf,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACxB,MAAM,oBAAoB,CAAA"}

package/dist/runtime/index.js

@@ -1,3 +1,4 @@
+export { ANTI_TOOL_NARRATION_RULE } from './anti-narration.js';
 export { decideEmptyRecovery, } from './empty-recovery.js';
 export { formatMemoryBlock, loadMemoryBlock } from './memory.js';
 export { mapModelIdToOpenAI, shouldFallback } from './providers.js';

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,GAItB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EACH,kBAAkB,EAGlB,eAAe,EACf,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,WAAW,GAGd,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACH,mBAAmB,GAItB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EACH,kBAAkB,EAGlB,eAAe,EACf,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,WAAW,GAGd,MAAM,oBAAoB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "maestro-core",
-    "version": "0.2.3",
+    "version": "0.2.4",
     "description": "Runtime kernel for the Maestro agent platform — tool envelope, tool definition factory, base context, port interfaces, and AI-SDK + MCP adapters.",
     "license": "Apache-2.0",
     "author": "Costa Software",