@memberjunction/ai-agents 5.48.0 → 5.50.0

package/dist/tool-result-format.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Single source of truth for the markdown tool-result section shape
+ * rendered back into the LLM's context:
+ *
+ * ```
+ * ### [ordinal. ][prefix.]tool({...input})
+ * ```json
+ * ...result data...
+ * ```
+ * ```
+ *
+ * Three call sites feed this shape to the model — same-turn conversation-tool
+ * injection, same-turn artifact-tool injection, and the prior-turn carry-forward
+ * message — and the loop-agent system prompt teaches the model to read it. All of
+ * them must render through these functions so the contract cannot drift between
+ * paths. Callers own size-capping policy; these functions only own the shape.
+ *
+ * @module @memberjunction/ai-agents
+ */
+/**
+ * The tool families whose step results are eligible for prior-turn carry-forward —
+ * single source of the family values. Stamp sites and the eligibility check both
+ * derive from this map so a renamed value breaks at compile time, never silently.
+ */
+export declare const CarryForwardToolFamily: {
+    readonly Conversation: "conversation";
+    readonly Artifact: "artifact";
+};
+/** One of the {@link CarryForwardToolFamily} values. */
+export type CarryForwardToolFamilyValue = typeof CarryForwardToolFamily[keyof typeof CarryForwardToolFamily];
+/**
+ * The cross-turn contract persisted in a tool step's `OutputData` by the conversation- and
+ * artifact-tool executors and read back by `BaseAgent.BuildPriorTurnToolResultsMessage` on
+ * the NEXT run. Write sites construct this type and the reader parses into a Partial of it,
+ * so the two sides cannot drift without a compile error.
+ */
+export interface CarryForwardToolStepOutput {
+    /** Structured carry-forward discriminator — StepName is display-only */
+    toolFamily: CarryForwardToolFamilyValue;
+    /** The tool that produced this result */
+    tool: string;
+    /** The tool's input object */
+    input: unknown;
+    /** The tool outcome; only `success === true` results are carried forward */
+    result: {
+        success: boolean;
+        data?: unknown;
+        errorMessage?: string;
+    };
+    /** Invocation duration in milliseconds */
+    durationMs?: number;
+    /** Artifact-family only: the artifact the tool ran against */
+    artifactId?: string;
+    /** summarizeRange only: the recursive sub-call's AIPromptRun ID */
+    promptRunId?: string;
+}
+/** The minimal step projection the prior-turn carry-forward loader fetches and the renderer reads. */
+export interface CarryForwardStepRecord {
+    OutputData: string | null;
+}
+/** Identifies one tool call within a rendered result section. */
+export interface ToolResultSectionParts {
+    /** The tool name, e.g. `getMessageBySequence` */
+    tool: string;
+    /** The tool's input object (rendered as compact JSON in the heading) */
+    input: unknown;
+    /** 1-based ordinal when rendering a numbered multi-result message */
+    ordinal?: number;
+    /** Signature prefix for target-scoped tools, e.g. an artifact ID (`{prefix}.{tool}(...)`) */
+    signaturePrefix?: string;
+}
+/** Renders result data for the fenced block: strings pass through, everything else pretty-JSON. */
+export declare function RenderToolResultData(data: unknown): string;
+/** One successful tool-result section: heading + fenced JSON body (body already capped by the caller). */
+export declare function FormatToolResultSection(parts: ToolResultSectionParts, body: string): string;
+/** One failed tool-result section: heading + bolded error line. */
+export declare function FormatToolErrorSection(parts: ToolResultSectionParts, errorMessage: string | undefined): string;
+//# sourceMappingURL=tool-result-format.d.ts.map

package/dist/tool-result-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-format.d.ts","sourceRoot":"","sources":["../src/tool-result-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX,wDAAwD;AACxD,MAAM,MAAM,2BAA2B,GAAG,OAAO,sBAAsB,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAE7G;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACvC,wEAAwE;IACxE,UAAU,EAAE,2BAA2B,CAAC;IACxC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sGAAsG;AACtG,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACnC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,0GAA0G;AAC1G,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE9G"}

package/dist/tool-result-format.js

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Single source of truth for the markdown tool-result section shape
+ * rendered back into the LLM's context:
+ *
+ * ```
+ * ### [ordinal. ][prefix.]tool({...input})
+ * ```json
+ * ...result data...
+ * ```
+ * ```
+ *
+ * Three call sites feed this shape to the model — same-turn conversation-tool
+ * injection, same-turn artifact-tool injection, and the prior-turn carry-forward
+ * message — and the loop-agent system prompt teaches the model to read it. All of
+ * them must render through these functions so the contract cannot drift between
+ * paths. Callers own size-capping policy; these functions only own the shape.
+ *
+ * @module @memberjunction/ai-agents
+ */
+/**
+ * The tool families whose step results are eligible for prior-turn carry-forward —
+ * single source of the family values. Stamp sites and the eligibility check both
+ * derive from this map so a renamed value breaks at compile time, never silently.
+ */
+export const CarryForwardToolFamily = {
+    Conversation: 'conversation',
+    Artifact: 'artifact'
+};
+function formatHeading(parts) {
+    const ordinal = parts.ordinal !== undefined ? `${parts.ordinal}. ` : '';
+    const prefix = parts.signaturePrefix ? `${parts.signaturePrefix}.` : '';
+    return `### ${ordinal}${prefix}${parts.tool}(${JSON.stringify(parts.input || {})})`;
+}
+/** Renders result data for the fenced block: strings pass through, everything else pretty-JSON. */
+export function RenderToolResultData(data) {
+    return typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+}
+/** One successful tool-result section: heading + fenced JSON body (body already capped by the caller). */
+export function FormatToolResultSection(parts, body) {
+    return `${formatHeading(parts)}\n\`\`\`json\n${body}\n\`\`\``;
+}
+/** One failed tool-result section: heading + bolded error line. */
+export function FormatToolErrorSection(parts, errorMessage) {
+    return `${formatHeading(parts)}\n**Error:** ${errorMessage}`;
+}
+//# sourceMappingURL=tool-result-format.js.map

package/dist/tool-result-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-format.js","sourceRoot":"","sources":["../src/tool-result-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;CACd,CAAC;AA6CX,SAAS,aAAa,CAAC,KAA6B;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO,OAAO,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC;AACxF,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAC9C,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,uBAAuB,CAAC,KAA6B,EAAE,IAAY;IAC/E,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,iBAAiB,IAAI,UAAU,CAAC;AAClE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,sBAAsB,CAAC,KAA6B,EAAE,YAAgC;IAClG,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,gBAAgB,YAAY,EAAE,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-agents",
   "type": "module",
-  "version": "5.48.0",
+  "version": "5.50.0",
   "description": "MemberJunction: AI Agent Execution and Management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,23 +17,23 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/actions": "5.48.0",
-    "@memberjunction/actions-base": "5.48.0",
-    "@memberjunction/ai": "5.48.0",
-    "@memberjunction/ai-core-plus": "5.48.0",
-    "@memberjunction/ai-engine-base": "5.48.0",
-    "@memberjunction/ai-prompts": "5.48.0",
-    "@memberjunction/ai-reranker": "5.48.0",
-    "@memberjunction/ai-vector-dupe": "5.48.0",
-    "@memberjunction/ai-vector-sync": "5.48.0",
-    "@memberjunction/aiengine": "5.48.0",
-    "@memberjunction/context-crush": "5.48.0",
-    "@memberjunction/core": "5.48.0",
-    "@memberjunction/core-entities": "5.48.0",
-    "@memberjunction/global": "5.48.0",
-    "@memberjunction/search-engine": "5.48.0",
-    "@memberjunction/storage": "5.48.0",
-    "@memberjunction/templates": "5.48.0",
+    "@memberjunction/actions": "5.50.0",
+    "@memberjunction/actions-base": "5.50.0",
+    "@memberjunction/ai": "5.50.0",
+    "@memberjunction/ai-core-plus": "5.50.0",
+    "@memberjunction/ai-engine-base": "5.50.0",
+    "@memberjunction/ai-prompts": "5.50.0",
+    "@memberjunction/ai-reranker": "5.50.0",
+    "@memberjunction/ai-vector-dupe": "5.50.0",
+    "@memberjunction/ai-vector-sync": "5.50.0",
+    "@memberjunction/aiengine": "5.50.0",
+    "@memberjunction/context-crush": "5.50.0",
+    "@memberjunction/core": "5.50.0",
+    "@memberjunction/core-entities": "5.50.0",
+    "@memberjunction/global": "5.50.0",
+    "@memberjunction/search-engine": "5.50.0",
+    "@memberjunction/storage": "5.50.0",
+    "@memberjunction/templates": "5.50.0",
     "dotenv": "^17.2.4",
     "exceljs": "^4.4.0",
     "lodash": "^4.17.23",