@xyne/workflow-sdk 3.2.12 → 3.2.14

package/dist/agents/agent-step.d.ts

@@ -41,12 +41,14 @@ export declare const AgentStepConfigSchema: z.ZodObject<{
     }>, "many">, z.ZodString]>>;
     outputType: z.ZodDefault<z.ZodEnum<["string", "json"]>>;
     outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cite: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     systemPrompt: string;
     userMessage: string;
     maxTurns: number;
     toolTimeout: number;
     outputType: "string" | "json";
+    cite: boolean;
     outputSchema?: Record<string, unknown> | undefined;
     attachments?: string | {
         name: string;
@@ -71,6 +73,7 @@ export declare const AgentStepConfigSchema: z.ZodObject<{
     maxTurns?: number | undefined;
     toolTimeout?: number | undefined;
     outputType?: "string" | "json" | undefined;
+    cite?: boolean | undefined;
 }>;
 export type AgentStepConfig = z.infer<typeof AgentStepConfigSchema>;
 export declare class AgentStep extends BaseActionStep<typeof AgentStepConfigSchema, AgentResult> {
@@ -104,12 +107,14 @@ export declare class AgentStep extends BaseActionStep<typeof AgentStepConfigSche
         }>, "many">, z.ZodString]>>;
         outputType: z.ZodDefault<z.ZodEnum<["string", "json"]>>;
         outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cite: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         systemPrompt: string;
         userMessage: string;
         maxTurns: number;
         toolTimeout: number;
         outputType: "string" | "json";
+        cite: boolean;
         outputSchema?: Record<string, unknown> | undefined;
         attachments?: string | {
             name: string;
@@ -134,6 +139,7 @@ export declare class AgentStep extends BaseActionStep<typeof AgentStepConfigSche
         maxTurns?: number | undefined;
         toolTimeout?: number | undefined;
         outputType?: "string" | "json" | undefined;
+        cite?: boolean | undefined;
     }>;
     readonly outputSchema: z.ZodObject<{
         response: z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
@@ -252,12 +258,17 @@ export declare class AgentStep extends BaseActionStep<typeof AgentStepConfigSche
      * `/mnt/files`. Returns the extras to merge into each tool's context, the
      * collected-artifacts array, and a `dispose()` that tears the sandbox down.
      */
-    /** Append the uploaded-files note to the system prompt when files were mounted. */
-    private withAttachmentsNote;
+    /**
+     * Shape the prompt the runtime actually sees: the uploaded-files note, and —
+     * when `cite` is on — source labels around every resolved ref plus the
+     * citation instruction. Applied at all three execute entry points.
+     */
+    private withPromptNotes;
     private openToolRuntime;
     /**
      * Attach collected artifacts and shape `response` per `outputType`
-     * (parse JSON when requested). Applied to every successful agent result.
+     * (parse JSON when requested, and split out citations when `cite` is on).
+     * Applied to every successful agent result.
      */
     private finalizeResult;
 }

package/dist/agents/agent-step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-step.d.ts","sourceRoot":"","sources":["../../src/agents/agent-step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAa5D,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAehC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AA2EpE,qBAAa,SAAU,SAAQ,cAAc,CAC3C,OAAO,qBAAqB,EAC5B,WAAW,CACZ;IASG,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAT/B,SAAkB,IAAI,EAAE,QAAQ,CAAe;IAC/C,SAAkB,IAAI,eAAe;IACrC,SAAkB,WAAW,qCAAqC;IAClE,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAyB;IACvD,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAqB;IACnD,SAAkB,QAAQ,EAAE,YAAY,CAAQ;gBAG7B,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,iBAAiB;IAKzC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA8BlF,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmB3E,OAAO,CACpB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,WAAW,CAAC;IA0CvB;;;;;;;OAOG;YACW,oBAAoB;IA0DnB,QAAQ,CACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,WAAW,CAAC;IAwDvB,OAAO,CAAC,YAAY;IAgCpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;YAgBJ,aAAa;IA8H3B,OAAO,CAAC,WAAW;IAsBnB;;;;;;OAMG;IACH,mFAAmF;IACnF,OAAO,CAAC,mBAAmB;YAQb,eAAe;IAqE7B;;;OAGG;IACH,OAAO,CAAC,cAAc;CAWvB"}
+{"version":3,"file":"agent-step.d.ts","sourceRoot":"","sources":["../../src/agents/agent-step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmB5D,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAgFpE,qBAAa,SAAU,SAAQ,cAAc,CAC3C,OAAO,qBAAqB,EAC5B,WAAW,CACZ;IASG,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAT/B,SAAkB,IAAI,EAAE,QAAQ,CAAe;IAC/C,SAAkB,IAAI,eAAe;IACrC,SAAkB,WAAW,qCAAqC;IAClE,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAyB;IACvD,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAqB;IACnD,SAAkB,QAAQ,EAAE,YAAY,CAAQ;gBAG7B,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,iBAAiB;IAKzC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA8BlF,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA8B3E,OAAO,CACpB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,WAAW,CAAC;IA0CvB;;;;;;;OAOG;YACW,oBAAoB;IA0DnB,QAAQ,CACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,WAAW,CAAC;IAwDvB,OAAO,CAAC,YAAY;IAgCpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;YAgBJ,aAAa;IA8H3B,OAAO,CAAC,WAAW;IAsBnB;;;;;;OAMG;IACH;;;;OAIG;IACH,OAAO,CAAC,eAAe;YA8BT,eAAe;IAqE7B;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAavB"}

package/dist/agents/agent-step.js

@@ -12,6 +12,7 @@ import { z } from 'zod';
 import { BaseActionStep } from '../steps/base-step.js';
 import { variableRef } from '../types/workflow-config.js';
 import { AttachmentSchema, ATTACHMENT_ARRAY_JSON_SCHEMA, markAttachmentFields } from '../common/attachment.js';
+import { labelSources, attachmentRefBase, citationSystemNote, splitCitedResponse, } from './citation-resolve.js';
 import { bindSandboxSession } from '../sandbox/types.js';
 import { runInterceptorChain, } from './interceptor.js';
 import { ApprovalGateInterceptor } from './interceptors/approval-gate.js';
@@ -30,6 +31,8 @@ export const AgentStepConfigSchema = z.object({
         .describe('Shape of the agent response: free text, or a JSON object matching outputSchema'),
     outputSchema: z.record(z.unknown()).optional()
         .describe('When outputType is "json", the JSON Schema the response object should match'),
+    cite: z.boolean().default(false)
+        .describe('Require the agent to cite the source of every data point it produces'),
 });
 // ─── Result Schema ───
 const AgentResultSchema = z.object({
@@ -82,8 +85,13 @@ function extractResponseText(message) {
  * via `run_code` (otherwise it has no idea attachments exist). Appended to the
  * system prompt when input attachments were mounted into the sandbox.
  */
-function attachmentsSystemNote(files) {
-    const list = files.map((f) => `/mnt/files/${f}`).join(', ');
+function attachmentsSystemNote(files, refBase) {
+    // With a ref base, name each file's ref alongside its path — that's what the
+    // agent cites when it takes a value from a mounted document. Mount order
+    // mirrors the resolved attachment array, so index i is `<base>.i`.
+    const list = refBase
+        ? files.map((f, i) => `/mnt/files/${f} (ref: ${refBase}.${String(i)})`).join(', ')
+        : files.map((f) => `/mnt/files/${f}`).join(', ');
     return (`\n\nThe user attached ${files.length} file(s), available in the sandbox at: ${list}. `
         + `Use the run_code tool to read them (e.g. open the file under /mnt/files) before responding. `
         + `Write any files you generate to /mnt/output.`);
@@ -133,9 +141,19 @@ export class AgentStep extends BaseActionStep {
     resolveOutputJsonSchema(config) {
         const outputType = config['outputType'] === 'json' ? 'json' : 'string';
         const userSchema = config['outputSchema'];
-        const response = outputType === 'json'
+        let response = outputType === 'json'
             ? (userSchema && Object.keys(userSchema).length > 0 ? userSchema : { type: 'object' })
             : { type: 'string' };
+        // With citations on the agent returns `{value, citation}`, so downstream refs
+        // and layouts address `output.response.value.*`. Gating the schema on the same
+        // flag as the runtime split keeps the declared and actual shapes in step —
+        // they flip together, per step, or not at all.
+        if (outputType === 'json' && config['cite'] === true) {
+            response = {
+                type: 'object',
+                properties: { value: response, citation: { type: 'object' } },
+            };
+        }
         return {
             type: 'object',
             properties: {
@@ -160,7 +178,7 @@ export class AgentStep extends BaseActionStep {
             : [];
         const bag = await this.openToolRuntime(config, ctx);
         try {
-            const runConfig = this.withAttachmentsNote(config, bag.mountedFiles);
+            const runConfig = this.withPromptNotes(config, bag.mountedFiles, ctx);
             const piTools = this.convertTools(workflowTools, config.toolTimeout, ctx, bag.extras);
             const effectiveMaxTurns = this.runtime.capabilities.multiTurn
                 ? config.maxTurns
@@ -173,7 +191,7 @@ export class AgentStep extends BaseActionStep {
                 signal: ctx.runtime.metadata['signal'] ?? new AbortController().signal,
             }, ctx);
             const result = await this.consumeEvents(events, ctx, effectiveMaxTurns);
-            return this.finalizeResult(result, config, bag.collected);
+            return this.finalizeResult(result, config, bag.collected, ctx);
         }
         finally {
             await bag.dispose();
@@ -200,7 +218,7 @@ export class AgentStep extends BaseActionStep {
         const currentTurn = priorState.currentTurn ?? 0;
         const bag = await this.openToolRuntime(config, ctx);
         try {
-            const runConfig = this.withAttachmentsNote(config, bag.mountedFiles);
+            const runConfig = this.withPromptNotes(config, bag.mountedFiles, ctx);
             const piTools = this.convertTools(workflowTools, config.toolTimeout, ctx, bag.extras);
             const interceptors = this.buildInterceptors(config, ctx);
             const hooks = this.buildHooks(interceptors, ctx);
@@ -231,7 +249,7 @@ export class AgentStep extends BaseActionStep {
                 completedToolCalls,
                 usage,
             });
-            return this.finalizeResult(result, config, bag.collected);
+            return this.finalizeResult(result, config, bag.collected, ctx);
         }
         finally {
             await bag.dispose();
@@ -261,7 +279,7 @@ export class AgentStep extends BaseActionStep {
             : 1;
         const bag = await this.openToolRuntime(config, ctx);
         try {
-            const runConfig = this.withAttachmentsNote(config, bag.mountedFiles);
+            const runConfig = this.withPromptNotes(config, bag.mountedFiles, ctx);
             const piTools = this.convertTools(workflowTools, config.toolTimeout, ctx, bag.extras);
             const interceptors = this.buildInterceptors(config, ctx);
             const hooks = this.buildHooks(interceptors, ctx);
@@ -280,7 +298,7 @@ export class AgentStep extends BaseActionStep {
             const events = this.runtime.execute(runConfig, input, ctx);
             // Consume events, carrying over state from before pause
             const result = await this.consumeEvents(events, ctx, effectiveMaxTurns, pauseState);
-            return this.finalizeResult(result, config, bag.collected);
+            return this.finalizeResult(result, config, bag.collected, ctx);
         }
         finally {
             await bag.dispose();
@@ -460,11 +478,33 @@ export class AgentStep extends BaseActionStep {
      * `/mnt/files`. Returns the extras to merge into each tool's context, the
      * collected-artifacts array, and a `dispose()` that tears the sandbox down.
      */
-    /** Append the uploaded-files note to the system prompt when files were mounted. */
-    withAttachmentsNote(config, mountedFiles) {
-        if (mountedFiles.length === 0)
+    /**
+     * Shape the prompt the runtime actually sees: the uploaded-files note, and —
+     * when `cite` is on — source labels around every resolved ref plus the
+     * citation instruction. Applied at all three execute entry points.
+     */
+    withPromptNotes(config, mountedFiles, ctx) {
+        let systemPrompt = config.systemPrompt;
+        let userMessage = config.userMessage;
+        if (mountedFiles.length > 0) {
+            const refBase = config.cite
+                ? attachmentRefBase(ctx.rawConfig?.['attachments'])
+                : undefined;
+            systemPrompt += attachmentsSystemNote(mountedFiles, refBase);
+        }
+        if (config.cite) {
+            // The executor already collapsed `userMessage`'s refs into bare values, so
+            // re-render it from the raw template — otherwise the agent has the content
+            // but no ref to cite it by.
+            const raw = ctx.rawConfig?.['userMessage'];
+            if (typeof raw === 'string')
+                userMessage = labelSources(raw, ctx.workflow);
+            systemPrompt += citationSystemNote(config.outputType);
+        }
+        if (systemPrompt === config.systemPrompt && userMessage === config.userMessage) {
             return config;
-        return { ...config, systemPrompt: config.systemPrompt + attachmentsSystemNote(mountedFiles) };
+        }
+        return { ...config, systemPrompt, userMessage };
     }
     async openToolRuntime(config, ctx) {
         const collected = [];
@@ -519,12 +559,14 @@ export class AgentStep extends BaseActionStep {
     }
     /**
      * Attach collected artifacts and shape `response` per `outputType`
-     * (parse JSON when requested). Applied to every successful agent result.
+     * (parse JSON when requested, and split out citations when `cite` is on).
+     * Applied to every successful agent result.
      */
-    finalizeResult(result, config, collected) {
+    finalizeResult(result, config, collected, ctx) {
         let response = result.response;
         if (config.outputType === 'json' && typeof response === 'string') {
-            response = parseJsonResponse(response);
+            const parsed = parseJsonResponse(response);
+            response = config.cite ? splitCitedResponse(parsed, ctx.log) : parsed;
         }
         return { ...result, response, attachments: collected };
     }

package/dist/agents/agent-step.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-step.js","sourceRoot":"","sources":["../../src/agents/agent-step.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-step.js","sourceRoot":"","sources":["../../src/agents/agent-step.ts"],"names":[],"mappings":"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"}

package/dist/agents/citation-resolve.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Cited-agent-output plumbing — the two halves of making an agent cite its work:
+ *
+ * 1. **Into the prompt**: {@link labelSources} wraps each resolved `{{ref}}` in a
+ *    `[source: <ref>]` block. The executor resolves config to bare values before
+ *    the step runs, so without this the agent would see the OCR text but have no
+ *    idea it came from `steps.ocr.output.results.0.data` — and nothing to cite.
+ * 2. **Out of the response**: {@link splitCitedResponse} unwraps the
+ *    `{ value, citation }` object the model returns.
+ *
+ * Pure functions (no ctx, no I/O) so the tricky parts are directly unit-testable.
+ */
+import type { CitationMap } from '../common/citation-ref.js';
+import type { WorkflowContext } from '../types/context.js';
+/** The slice of `ctx.log` this module needs. Agent output must never throw. */
+interface Warn {
+    warn(msg: string): void;
+}
+/**
+ * Re-render a *raw* (pre-resolution) message so every `{{ref}}` becomes a
+ * labelled block naming the path its content came from:
+ *
+ *   "Analyse: {{steps.ocr.output.results.0.data}}"
+ *     →  "Analyse:
+ *         [source: steps.ocr.output.results.0.data]
+ *         <ocr text…>
+ *         [/source]"
+ *
+ * The content is identical to what the resolver would have interpolated — only
+ * the provenance label is added, which is the thing the agent cites.
+ * Returns the input unchanged when it holds no refs.
+ *
+ * A ref onto an **array of records** (several OCR'd documents, a set of rows) is
+ * expanded into one labelled block per element, index baked into the label. Each
+ * element is a separate source — often with its own document — and a single
+ * `[source: …results]` label would leave the agent no way to say *which* one a
+ * value came from. Expanding also means the agent only ever copies a label
+ * verbatim: asked to build `…results.1.data` itself it would plausibly emit
+ * `results[1].data`, and the ref grammar is dot-only (see resolvePath).
+ */
+export declare function labelSources(rawMessage: string, workflow: WorkflowContext): string;
+/**
+ * The ref the `attachments` field was bound to, e.g. `"{{trigger.documents}}"` →
+ * `"trigger.documents"`. Mounted file *i* is then citable as `<base>.i`, since
+ * the mounted order mirrors the resolved array. Undefined when attachments were
+ * bound to a literal rather than a ref (nothing citable to name).
+ */
+export declare function attachmentRefBase(rawAttachments: unknown): string | undefined;
+/** The system-prompt instruction that tells the agent how to cite. */
+export declare function citationSystemNote(outputType: 'string' | 'json'): string;
+export declare function sanitizeCitationMap(raw: unknown, log: Warn): CitationMap;
+/**
+ * Split the `{ value, citation }` wrapper out of a JSON-mode agent response.
+ *
+ * Models don't always comply, so every shape degrades to something renderable:
+ * - `{value, citation}` → the wrapper, citations sanitized.
+ * - `{value}` alone (the only key) → the wrapper minus citations. This is also
+ *   what `parseJsonResponse` produces for non-object JSON, so the two agree.
+ * - anything else → treated as the bare output. A user field literally named
+ *   `value` is why we require `citation` (or a lone key) before unwrapping:
+ *   misreading `{value, other}` as the wrapper would silently drop `other`.
+ */
+export declare function splitCitedResponse(parsed: Record<string, unknown>, log: Warn): {
+    value: unknown;
+    citation: CitationMap;
+};
+export {};
+//# sourceMappingURL=citation-resolve.d.ts.map

package/dist/agents/citation-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-resolve.d.ts","sourceRoot":"","sources":["../../src/agents/citation-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,+EAA+E;AAC/E,UAAU,IAAI;IACZ,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA+BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAoBlF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CA4BxE;AA2CD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,WAAW,CAExE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,IAAI,GACR;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAW3C"}

package/dist/agents/citation-resolve.js

@@ -0,0 +1,183 @@
+/**
+ * Cited-agent-output plumbing — the two halves of making an agent cite its work:
+ *
+ * 1. **Into the prompt**: {@link labelSources} wraps each resolved `{{ref}}` in a
+ *    `[source: <ref>]` block. The executor resolves config to bare values before
+ *    the step runs, so without this the agent would see the OCR text but have no
+ *    idea it came from `steps.ocr.output.results.0.data` — and nothing to cite.
+ * 2. **Out of the response**: {@link splitCitedResponse} unwraps the
+ *    `{ value, citation }` object the model returns.
+ *
+ * Pure functions (no ctx, no I/O) so the tricky parts are directly unit-testable.
+ */
+import { CitationRefSchema } from '../common/citation-ref.js';
+import { resolvePath } from '../engine/variable-resolver.js';
+import { tokenize, extractRefPath } from '../util/variable-ref.js';
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+// ─── Prompt side ───
+function stringifyForPrompt(value) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value, null, 2) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function sourceBlock(ref, value) {
+    return `\n[source: ${ref}]\n${stringifyForPrompt(value)}\n[/source]\n`;
+}
+/** An array of records — a list of independently-citable things. */
+function isRecordArray(v) {
+    return (Array.isArray(v)
+        && v.length > 0
+        && v.every((el) => el !== null && typeof el === 'object' && !Array.isArray(el)));
+}
+/**
+ * Re-render a *raw* (pre-resolution) message so every `{{ref}}` becomes a
+ * labelled block naming the path its content came from:
+ *
+ *   "Analyse: {{steps.ocr.output.results.0.data}}"
+ *     →  "Analyse:
+ *         [source: steps.ocr.output.results.0.data]
+ *         <ocr text…>
+ *         [/source]"
+ *
+ * The content is identical to what the resolver would have interpolated — only
+ * the provenance label is added, which is the thing the agent cites.
+ * Returns the input unchanged when it holds no refs.
+ *
+ * A ref onto an **array of records** (several OCR'd documents, a set of rows) is
+ * expanded into one labelled block per element, index baked into the label. Each
+ * element is a separate source — often with its own document — and a single
+ * `[source: …results]` label would leave the agent no way to say *which* one a
+ * value came from. Expanding also means the agent only ever copies a label
+ * verbatim: asked to build `…results.1.data` itself it would plausibly emit
+ * `results[1].data`, and the ref grammar is dot-only (see resolvePath).
+ */
+export function labelSources(rawMessage, workflow) {
+    const tokens = tokenize(rawMessage);
+    if (!tokens.some((t) => t.kind === 'ref'))
+        return rawMessage;
+    let out = '';
+    for (const tok of tokens) {
+        if (tok.kind === 'literal') {
+            out += tok.text;
+            continue;
+        }
+        const value = resolvePath(workflow, tok.path);
+        if (isRecordArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                out += sourceBlock(`${tok.path}.${String(i)}`, value[i]);
+            }
+            continue;
+        }
+        out += sourceBlock(tok.path, value);
+    }
+    return out;
+}
+/**
+ * The ref the `attachments` field was bound to, e.g. `"{{trigger.documents}}"` →
+ * `"trigger.documents"`. Mounted file *i* is then citable as `<base>.i`, since
+ * the mounted order mirrors the resolved array. Undefined when attachments were
+ * bound to a literal rather than a ref (nothing citable to name).
+ */
+export function attachmentRefBase(rawAttachments) {
+    if (typeof rawAttachments !== 'string')
+        return undefined;
+    return extractRefPath(rawAttachments) ?? undefined;
+}
+/** The system-prompt instruction that tells the agent how to cite. */
+export function citationSystemNote(outputType) {
+    const common = `\n\nCITATIONS: every value you output must say where it came from. `
+        + `Cite using the exact "[source: <ref>]" paths shown to you above — copy the ref verbatim. `
+        + `Add "page" (1-based) and "quote" (the exact source text) whenever you took the value from a document, `
+        + `so the reader can be taken straight to the passage. `
+        + `For something you read on the web, cite the URL instead. Never invent a ref.`;
+    if (outputType === 'json') {
+        return (common
+            + `\n\nReturn JSON with exactly two top-level keys: "value" and "citation". `
+            + `"value" is the requested output. "citation" MIRRORS the structure of "value", `
+            + `but every leaf is an array of sources: `
+            + `{"kind":"ref","ref":"<a ref shown above>","page":<n>,"quote":"<exact text>"} `
+            + `or {"kind":"url","url":"https://…","title":"<optional>"}. `
+            + `Example: {"value":{"total":"5000"},"citation":{"total":[{"kind":"ref","ref":"steps.ocr.output.results.0.data","page":3,"quote":"5000"}]}}. `
+            + `Omit a leaf from "citation" only when you genuinely cannot source it.`);
+    }
+    return (common
+        + `\n\nWrap every sourced statement in a citation directive:\n`
+        + `:::citation{ref="<a ref shown above>" page=3 quote="<exact text>"}\n`
+        + `the statement\n`
+        + `:::\n`
+        + `or :::citation{url="https://…"} … :::. Use only these attributes: ref, page, url, quote, title.`);
+}
+// ─── Response side ───
+/** Does this look like a citation leaf entry (rather than a mirror branch)? */
+function isCitationLike(v) {
+    return isPlainObject(v) && typeof v['kind'] === 'string';
+}
+/**
+ * Walk the citation mirror, keeping only well-formed {@link CitationRef} leaves.
+ *
+ * Why filter rather than trust: the renderers treat a leaf as citations only if
+ * *every* entry is valid, so a single hallucinated entry would silently suppress
+ * the good ones sitting beside it. Dropping the bad entry preserves the rest.
+ *
+ * An array is a leaf if anything in it looks citation-like (`kind`); otherwise
+ * it's a branch mirroring an array of values, and we recurse. Scalars are noise.
+ */
+function sanitizeNode(node, log) {
+    if (Array.isArray(node)) {
+        if (node.some(isCitationLike)) {
+            const kept = node.filter((el) => {
+                if (CitationRefSchema.safeParse(el).success)
+                    return true;
+                log.warn(`dropping malformed citation: ${JSON.stringify(el)}`);
+                return false;
+            });
+            return kept.length > 0 ? kept : undefined;
+        }
+        const mapped = node.map((el) => sanitizeNode(el, log));
+        return mapped.some((el) => el !== undefined) ? mapped : undefined;
+    }
+    if (isPlainObject(node)) {
+        const out = {};
+        for (const [k, v] of Object.entries(node)) {
+            const s = sanitizeNode(v, log);
+            if (s !== undefined)
+                out[k] = s;
+        }
+        return Object.keys(out).length > 0 ? out : undefined;
+    }
+    return undefined;
+}
+export function sanitizeCitationMap(raw, log) {
+    return sanitizeNode(raw, log) ?? {};
+}
+/**
+ * Split the `{ value, citation }` wrapper out of a JSON-mode agent response.
+ *
+ * Models don't always comply, so every shape degrades to something renderable:
+ * - `{value, citation}` → the wrapper, citations sanitized.
+ * - `{value}` alone (the only key) → the wrapper minus citations. This is also
+ *   what `parseJsonResponse` produces for non-object JSON, so the two agree.
+ * - anything else → treated as the bare output. A user field literally named
+ *   `value` is why we require `citation` (or a lone key) before unwrapping:
+ *   misreading `{value, other}` as the wrapper would silently drop `other`.
+ */
+export function splitCitedResponse(parsed, log) {
+    if ('value' in parsed && isPlainObject(parsed['citation'])) {
+        return { value: parsed['value'], citation: sanitizeCitationMap(parsed['citation'], log) };
+    }
+    if ('value' in parsed && Object.keys(parsed).length === 1) {
+        return { value: parsed['value'], citation: {} };
+    }
+    log.warn('cite is enabled but the agent returned no "citation" map — its data points will render uncited');
+    return { value: parsed, citation: {} };
+}
+//# sourceMappingURL=citation-resolve.js.map

package/dist/agents/citation-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-resolve.js","sourceRoot":"","sources":["../../src/agents/citation-resolve.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.d.ts

@@ -10,5 +10,7 @@ export { runInterceptorChain } from './interceptor.js';
 export { ApprovalGateInterceptor } from './interceptors/approval-gate.js';
 export { ToolLoggingInterceptor } from './interceptors/tool-logger.js';
 export { AgentStep, AgentStepConfigSchema, type AgentStepConfig, } from './agent-step.js';
+export type { CitationRef, CitationMap } from '../common/citation-ref.js';
+export { CitationRefSchema, isCitationRef } from '../common/citation-ref.js';
 export { PiMonoRuntime, PiMonoConfigSchema, type PiMonoConfig, type PiMonoRuntimeOptions, } from './pi-mono-runtime.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAEV,UAAU,EACV,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EAEN,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIvF,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAEV,UAAU,EACV,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EAEN,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIvF,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI7E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/agents/index.js

@@ -14,6 +14,7 @@ export { ApprovalGateInterceptor } from './interceptors/approval-gate.js';
 export { ToolLoggingInterceptor } from './interceptors/tool-logger.js';
 // ─── Agent Step ───
 export { AgentStep, AgentStepConfigSchema, } from './agent-step.js';
+export { CitationRefSchema, isCitationRef } from '../common/citation-ref.js';
 // ─── Pi-Mono Runtime ───
 export { PiMonoRuntime, PiMonoConfigSchema, } from './pi-mono-runtime.js';
 //# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,0EAA0E;AAC1E,kCAAkC;AAClC,0BAA0B;AA+C1B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,uBAAuB;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,qBAAqB;AAErB,OAAO,EACL,SAAS,EACT,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AAEzB,0BAA0B;AAE1B,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,0EAA0E;AAC1E,kCAAkC;AAClC,0BAA0B;AA+C1B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,uBAAuB;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,qBAAqB;AAErB,OAAO,EACL,SAAS,EACT,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE7E,0BAA0B;AAE1B,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC"}