@xyne/workflow-sdk 3.2.20 → 3.2.22

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

@@ -4,7 +4,7 @@
  * 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.
+ *    idea it came from `steps.ocr.output.results.0.pages.2.text` — nothing to cite.
  * 2. **Out of the response**: {@link splitCitedResponse} unwraps the
  *    `{ value, citation }` object the model returns.
  *
@@ -18,25 +18,36 @@ interface Warn {
 }
 /**
  * Re-render a *raw* (pre-resolution) message so every `{{ref}}` becomes a
- * labelled block naming the path its content came from:
+ * labelled block naming the source its content came from:
  *
- *   "Analyse: {{steps.ocr.output.results.0.data}}"
+ *   "Analyse: {{steps.ocr.output.results}}"
  *     →  "Analyse:
- *         [source: steps.ocr.output.results.0.data]
- *         <ocr text…>
+ *         [source: steps.ocr.output.results.0.source | page 1]
+ *         <text of page 1…>
+ *         [/source]
+ *         [source: steps.ocr.output.results.0.source | page 2]
+ *         <text of page 2…>
  *         [/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).
+ * Two rules do the work, and both exist so the agent only ever **copies** a
+ * label rather than composing one:
+ *
+ * 1. A ref onto an **array of records** (several OCR'd documents, a set of rows)
+ *    expands to one block per element. A single `[source: …results]` label would
+ *    leave no way to say *which* document a value came from.
+ * 2. A record carrying a **document** beside its data is labelled with that
+ *    document's ref plus a readable address (`| page 2`). So a citation names
+ *    something openable, not an internal text path — which keeps citations
+ *    decoupled from the producer's output shape (when `data` was removed from the
+ *    OCR step, every ref pointing at it broke).
+ *
+ * Composing is exactly what models get wrong: asked to build `…results.1.text`
+ * itself, one would plausibly emit `results[1].text`, and the ref grammar is
+ * dot-only (see resolvePath).
  */
 export declare function labelSources(rawMessage: string, workflow: WorkflowContext): string;
 /**

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

@@ -1 +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"}
+{"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;AAuGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAwBlF;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,CA6CxE;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

@@ -4,7 +4,7 @@
  * 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.
+ *    idea it came from `steps.ocr.output.results.0.pages.2.text` — nothing to cite.
  * 2. **Out of the response**: {@link splitCitedResponse} unwraps the
  *    `{ value, citation }` object the model returns.
  *
@@ -29,8 +29,9 @@ function stringifyForPrompt(value) {
         return String(value);
     }
 }
-function sourceBlock(ref, value) {
-    return `\n[source: ${ref}]\n${stringifyForPrompt(value)}\n[/source]\n`;
+function sourceBlock(ref, value, at) {
+    const head = at ? `${ref} | ${at}` : ref;
+    return `\n[source: ${head}]\n${stringifyForPrompt(value)}\n[/source]\n`;
 }
 /** An array of records — a list of independently-citable things. */
 function isRecordArray(v) {
@@ -38,27 +39,106 @@ function isRecordArray(v) {
         && v.length > 0
         && v.every((el) => el !== null && typeof el === 'object' && !Array.isArray(el)));
 }
+/** Structural check for an Attachment — the same three fields the SDK guards on. */
+function isAttachmentLike(v) {
+    if (!isPlainObject(v))
+        return false;
+    return (typeof v['name'] === 'string'
+        && typeof v['mimeType'] === 'string'
+        && typeof v['data'] === 'string');
+}
+/**
+ * The document a record was derived from, if it carries one.
+ *
+ * Producer convention: a step that turns a document into data emits the
+ * `Attachment` beside the data (OCR's `results[i].source`). One level only — the
+ * document is a *sibling* of the text it produced, so a deeper scan could only
+ * surface something unrelated.
+ */
+function documentFieldOf(record) {
+    for (const [k, v] of Object.entries(record)) {
+        if (isAttachmentLike(v))
+            return k;
+    }
+    return undefined;
+}
+/** A human-readable address for a record that carries one — shown in the label. */
+function addressOf(record) {
+    if (typeof record['page'] === 'number')
+        return `page ${String(record['page'])}`;
+    const row = record['row'];
+    const col = record['col'];
+    if (typeof row === 'number' && (typeof col === 'string' || typeof col === 'number')) {
+        const sheet = typeof record['sheet'] === 'string' ? `${record['sheet']}!` : '';
+        return `cell ${sheet}${String(col)}${String(row)}`;
+    }
+    if (typeof record['line'] === 'number')
+        return `line ${String(record['line'])}`;
+    return undefined;
+}
+/**
+ * Expand one record into labelled blocks, naming the **document** it came from
+ * rather than the internal path its text happens to live at.
+ *
+ * A record like `{ source: <Attachment>, pages: [{page,text}, …] }` becomes one
+ * block per page, each labelled `<…>.source | page N` — so the agent cites a
+ * document plus an address, both copied verbatim. Without this the agent could
+ * only cite a text path, leaving the reader to reconstruct the document by
+ * climbing the tree, and coupling every citation to the producer's output shape.
+ */
+function expandRecord(basePath, record) {
+    const docField = documentFieldOf(record);
+    if (!docField)
+        return sourceBlock(basePath, record);
+    const docRef = `${basePath}.${docField}`;
+    let out = '';
+    let emitted = false;
+    for (const [key, value] of Object.entries(record)) {
+        if (key === docField)
+            continue;
+        if (isRecordArray(value)) {
+            // e.g. `pages: [{page, text}, …]` — one citable block per entry.
+            for (const entry of value) {
+                out += sourceBlock(docRef, entry, addressOf(entry));
+                emitted = true;
+            }
+        }
+    }
+    // No per-entry data (or nothing but the document) — cite the document itself.
+    return emitted ? out : sourceBlock(docRef, record);
+}
 /**
  * Re-render a *raw* (pre-resolution) message so every `{{ref}}` becomes a
- * labelled block naming the path its content came from:
+ * labelled block naming the source its content came from:
  *
- *   "Analyse: {{steps.ocr.output.results.0.data}}"
+ *   "Analyse: {{steps.ocr.output.results}}"
  *     →  "Analyse:
- *         [source: steps.ocr.output.results.0.data]
- *         <ocr text…>
+ *         [source: steps.ocr.output.results.0.source | page 1]
+ *         <text of page 1…>
+ *         [/source]
+ *         [source: steps.ocr.output.results.0.source | page 2]
+ *         <text of page 2…>
  *         [/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).
+ * Two rules do the work, and both exist so the agent only ever **copies** a
+ * label rather than composing one:
+ *
+ * 1. A ref onto an **array of records** (several OCR'd documents, a set of rows)
+ *    expands to one block per element. A single `[source: …results]` label would
+ *    leave no way to say *which* document a value came from.
+ * 2. A record carrying a **document** beside its data is labelled with that
+ *    document's ref plus a readable address (`| page 2`). So a citation names
+ *    something openable, not an internal text path — which keeps citations
+ *    decoupled from the producer's output shape (when `data` was removed from the
+ *    OCR step, every ref pointing at it broke).
+ *
+ * Composing is exactly what models get wrong: asked to build `…results.1.text`
+ * itself, one would plausibly emit `results[1].text`, and the ref grammar is
+ * dot-only (see resolvePath).
  */
 export function labelSources(rawMessage, workflow) {
     const tokens = tokenize(rawMessage);
@@ -73,10 +153,14 @@ export function labelSources(rawMessage, workflow) {
         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]);
+                out += expandRecord(`${tok.path}.${String(i)}`, value[i]);
             }
             continue;
         }
+        if (isPlainObject(value)) {
+            out += expandRecord(tok.path, value);
+            continue;
+        }
         out += sourceBlock(tok.path, value);
     }
     return out;
@@ -95,23 +179,40 @@ export function attachmentRefBase(rawAttachments) {
 /** 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.`;
+        + `Each source above is labelled "[source: <ref> | <address>]". `
+        + `Copy the <ref> verbatim — never build one yourself, and never invent one. `
+        + `When the label shows an address, copy it as "locator": `
+        + `"| page 2" becomes {"at":"page","page":2}, `
+        + `"| cell Sheet1!B14" becomes {"at":"cell","sheet":"Sheet1","col":"B","row":14}, `
+        + `"| line 42" becomes {"at":"line","from":42}. `
+        + `A label with no address has nothing to locate — omit "locator". `
+        + `Always add "quote": the exact text you took the value from, so the reader can be `
+        + `shown the passage. For something you read on the web, cite {"kind":"url"} instead.`;
     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.`);
+            + `{"kind":"ref","ref":"<a ref shown above>","locator":<the address shown>,"quote":"<exact text>"} `
+            + `or {"kind":"url","url":"https://…","quote":"<exact text>"}. `
+            + `Example: {"value":{"total":"5000"},"citation":{"total":[{"kind":"ref","ref":"steps.ocr.output.results.0.source","locator":{"at":"page","page":2},"quote":"TOTAL DUE 5000"}]}}. `
+            + `Omit a leaf from "citation" only when you genuinely cannot source it.`
+            // Only json mode gets this: a prose agent rarely computes structured values,
+            // and every extra instruction is a chance for the model to comply less well
+            // with the ones that matter.
+            + `\n\nIf you CALCULATED a value instead of reading it (a total, a ratio, a `
+            + `growth rate), do not quote it — it appears nowhere in the source. Cite it as `
+            + `{"kind":"derived","label":"Debt Service Coverage Ratio","expression":"(#2 - #1) / #1",`
+            + `"inputs":[<the sources you combined, in order>]}, where #1 is the first input, `
+            + `#2 the second. Keep "expression" to + - * / ( ) and numbers so a reader can follow `
+            + `it. List every input you used — the positions must line up with the expression. `
+            + `ALWAYS include "label": a short plain-language name of what the value represents `
+            + `(e.g. "Debt Service Coverage Ratio", "Year-on-year revenue growth") — never leave `
+            + `it out, because the expression alone tells a reader nothing about what was computed.`);
     }
     return (common
         + `\n\nWrap every sourced statement in a citation directive:\n`
-        + `:::citation{ref="<a ref shown above>" page=3 quote="<exact text>"}\n`
+        + `:::citation{ref="<a ref shown above>" page=2 quote="<exact text>"}\n`
         + `the statement\n`
         + `:::\n`
         + `or :::citation{url="https://…"} … :::. Use only these attributes: ref, page, url, quote, title.`);

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

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

package/dist/builder/index.d.ts

@@ -18,8 +18,8 @@
 export { VARIABLE_REF_REGEX, VARIABLE_REF_DESCRIPTION_PREFIX, tokenize, isPureRef, extractRefPath, collectRefs, parseRef, findStepsReferencing, } from '../util/variable-ref.js';
 export type { VariableRefToken, FoundRef, ParsedRef } from '../util/variable-ref.js';
 export { ensureCitationPath, tryCitationPath, parseCitationPath, resolveCitationPath, } from '../util/citation-path.js';
-export type { CitationRef, RefCitation, UrlCitation, CitationMap, } from '../common/citation-ref.js';
-export { CitationRefSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from '../common/citation-ref.js';
+export type { CitationRef, Locator, RefCitation, UrlCitation, DerivedCitation, SourceCitation, CitationMap, } from '../common/citation-ref.js';
+export { CitationRefSchema, LocatorSchema, DerivedCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from '../common/citation-ref.js';
 export { getAvailableContext } from '../engine/available-context.js';
 export type { AvailableContext } from '../engine/available-context.js';
 export { VariableResolver, resolvePath, stripNullForOptionalKeys, } from '../engine/variable-resolver.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,QAAQ,EACR,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,SAAS,GACV,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,QAAQ,EACR,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,SAAS,GACV,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/builder/index.js

@@ -18,7 +18,7 @@
 // ─── Variable Reference Utilities ───
 export { VARIABLE_REF_REGEX, VARIABLE_REF_DESCRIPTION_PREFIX, tokenize, isPureRef, extractRefPath, collectRefs, parseRef, findStepsReferencing, } from '../util/variable-ref.js';
 export { ensureCitationPath, tryCitationPath, parseCitationPath, resolveCitationPath, } from '../util/citation-path.js';
-export { CitationRefSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from '../common/citation-ref.js';
+export { CitationRefSchema, LocatorSchema, DerivedCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from '../common/citation-ref.js';
 // ─── Available Context ───
 export { getAvailableContext } from '../engine/available-context.js';
 // ─── Variable Resolution ───

package/dist/builder/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uCAAuC;AAEvC,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,QAAQ,EACR,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,4BAA4B;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,8BAA8B;AAE9B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAExC,+BAA+B;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,oBAAoB;AAEpB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAI/B,gCAAgC;AAEhC,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,6BAA6B,CAAC;AAgBrC,qDAAqD;AAErD,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,+BAA+B,CAAC;AASvC,4BAA4B;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAUlE,6BAA6B;AAE7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uCAAuC;AAEvC,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,QAAQ,EACR,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAalC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,4BAA4B;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,8BAA8B;AAE9B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAExC,+BAA+B;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,oBAAoB;AAEpB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAI/B,gCAAgC;AAEhC,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,6BAA6B,CAAC;AAgBrC,qDAAqD;AAErD,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,+BAA+B,CAAC;AASvC,4BAA4B;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAUlE,6BAA6B;AAE7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/common/citation-ref.d.ts

@@ -8,7 +8,7 @@ import { z } from 'zod';
  * execution time and travels *with the output data* — `output.response.citation`,
  * a structural mirror of `output.response.value`.
  *
- * Two kinds, because exactly two things are knowable to a model:
+ * Three kinds — everything a model can honestly say about where a value came from:
  *
  * - `ref` — a path the agent was explicitly shown (the `[source: ...]` labels the
  *   agent step injects around resolved `{{refs}}`). An agent can never emit an
@@ -16,78 +16,592 @@ import { z } from 'zod';
  *   to know. Turning a `ref` into an openable document happens in the UI, which
  *   alone holds the workflow config + step outputs required to walk to the source.
  * - `url` — an external link the agent browsed. Already concrete; nothing to resolve.
+ * - `derived` — the value was **computed**, so it appears nowhere to be quoted;
+ *   its provenance is the inputs it combined and how. See {@link DerivedCitationSchema}.
  *
- * `page` / `quote` are the half only the reader of the text can supply: they
- * locate the passage *inside* the resolved document. Which document a value came
- * from is structural (the workflow knows it); where inside it is data (only the
- * agent knows it) — this split is why citations are never inferred by tracing.
+ * `locator` / `quote` are the half only the reader of the text can supply: they
+ * locate the passage *inside* the source the `ref` names. Which source a value
+ * came from is structural (the workflow knows it); where inside it is data (only
+ * the agent knows it) — this split is why citations are never inferred by tracing.
+ *
+ * **There is deliberately no separate "document" vs "value" kind.** Whether a ref
+ * resolves to an openable document or to plain step output is a *structural* fact
+ * the model cannot know — it saw text, not the workflow graph. Asking it to
+ * classify would guarantee confident mis-labelling, and a wrong discriminator is
+ * far worse than an omitted optional field. So the emitted union is shaped by what
+ * the agent can know; the *resolved* union (UI) splits `doc` from `value`, where
+ * the answer is actually available. When there is nothing to locate within, the
+ * agent simply omits `locator`/`quote`.
+ */
+/**
+ * Where inside a source a value sits.
+ *
+ * Discriminated rather than a bag of optional fields: a spreadsheet has no pages
+ * and a PDF has no rows, so `page?`/`row?`/`line?` side by side would make most
+ * combinations meaningless and every consumer defensive.
+ *
+ * The agent asserts this only because the `[source: …]` label *shows* it — it is
+ * copied, never inferred. Anything a label can't show stays out of this union
+ * (an image bounding box, for instance, which no reader of text could know).
  */
+export declare const LocatorSchema: z.ZodDiscriminatedUnion<"at", [z.ZodObject<{
+    at: z.ZodLiteral<"page">;
+    page: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    at: "page";
+    page: number;
+}, {
+    at: "page";
+    page: number;
+}>, z.ZodObject<{
+    at: z.ZodLiteral<"cell">;
+    sheet: z.ZodOptional<z.ZodString>;
+    row: z.ZodNumber;
+    col: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+}, "strip", z.ZodTypeAny, {
+    at: "cell";
+    row: number;
+    col: string | number;
+    sheet?: string | undefined;
+}, {
+    at: "cell";
+    row: number;
+    col: string | number;
+    sheet?: string | undefined;
+}>, z.ZodObject<{
+    at: z.ZodLiteral<"line">;
+    from: z.ZodNumber;
+    to: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    at: "line";
+    from: number;
+    to?: number | undefined;
+}, {
+    at: "line";
+    from: number;
+    to?: number | undefined;
+}>]>;
+export type Locator = z.infer<typeof LocatorSchema>;
 export declare const RefCitationSchema: z.ZodObject<{
     kind: z.ZodLiteral<"ref">;
     ref: z.ZodString;
-    page: z.ZodOptional<z.ZodNumber>;
+    locator: z.ZodOptional<z.ZodDiscriminatedUnion<"at", [z.ZodObject<{
+        at: z.ZodLiteral<"page">;
+        page: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        at: "page";
+        page: number;
+    }, {
+        at: "page";
+        page: number;
+    }>, z.ZodObject<{
+        at: z.ZodLiteral<"cell">;
+        sheet: z.ZodOptional<z.ZodString>;
+        row: z.ZodNumber;
+        col: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    }, "strip", z.ZodTypeAny, {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    }, {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    }>, z.ZodObject<{
+        at: z.ZodLiteral<"line">;
+        from: z.ZodNumber;
+        to: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    }, {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    }>]>>;
     quote: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     ref: string;
     kind: "ref";
     label?: string | undefined;
-    page?: number | undefined;
+    locator?: {
+        at: "page";
+        page: number;
+    } | {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    } | {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    } | undefined;
     quote?: string | undefined;
 }, {
     ref: string;
     kind: "ref";
     label?: string | undefined;
-    page?: number | undefined;
+    locator?: {
+        at: "page";
+        page: number;
+    } | {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    } | {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    } | undefined;
     quote?: string | undefined;
 }>;
 export declare const UrlCitationSchema: z.ZodObject<{
     kind: z.ZodLiteral<"url">;
     url: z.ZodString;
+    quote: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     kind: "url";
+    quote?: string | undefined;
     title?: string | undefined;
 }, {
     url: string;
     kind: "url";
+    quote?: string | undefined;
     title?: string | undefined;
 }>;
+/**
+ * A value the agent **computed** rather than read — a total, a ratio, a growth
+ * rate. It appears nowhere in the source, so there is no passage to quote and no
+ * page to open; its provenance is *these inputs, combined this way*.
+ *
+ * This is a distinct kind rather than "several citations on one value" because
+ * the two mean opposite things. Two citations on a name are **corroboration** —
+ * either alone still supports it. Two inputs to a subtraction are **required** —
+ * if one is wrong, the value is wrong. Rendering them identically would hide that.
+ *
+ * `inputs` is deliberately only one level deep (an input can't itself be
+ * `derived`): it keeps every union member a plain `ZodObject`, which is what
+ * `z.discriminatedUnion` requires — a recursive member would force `z.union` plus
+ * lazy schemas for no real gain, since a chain of derivations is already handled
+ * by resolving *through* the upstream agent's own citation.
+ */
+export declare const DerivedCitationSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"derived">;
+    expression: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"ref">;
+        ref: z.ZodString;
+        locator: z.ZodOptional<z.ZodDiscriminatedUnion<"at", [z.ZodObject<{
+            at: z.ZodLiteral<"page">;
+            page: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            at: "page";
+            page: number;
+        }, {
+            at: "page";
+            page: number;
+        }>, z.ZodObject<{
+            at: z.ZodLiteral<"cell">;
+            sheet: z.ZodOptional<z.ZodString>;
+            row: z.ZodNumber;
+            col: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        }, "strip", z.ZodTypeAny, {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        }, {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        }>, z.ZodObject<{
+            at: z.ZodLiteral<"line">;
+            from: z.ZodNumber;
+            to: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        }, {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        }>]>>;
+        quote: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    }, {
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        quote: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    }, {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    }>]>, "many">;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "derived";
+    inputs: ({
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    } | {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    })[];
+    expression?: string | undefined;
+    label?: string | undefined;
+}, {
+    kind: "derived";
+    inputs: ({
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    } | {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    })[];
+    expression?: string | undefined;
+    label?: string | undefined;
+}>;
 export declare const CitationRefSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"ref">;
     ref: z.ZodString;
-    page: z.ZodOptional<z.ZodNumber>;
+    locator: z.ZodOptional<z.ZodDiscriminatedUnion<"at", [z.ZodObject<{
+        at: z.ZodLiteral<"page">;
+        page: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        at: "page";
+        page: number;
+    }, {
+        at: "page";
+        page: number;
+    }>, z.ZodObject<{
+        at: z.ZodLiteral<"cell">;
+        sheet: z.ZodOptional<z.ZodString>;
+        row: z.ZodNumber;
+        col: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    }, "strip", z.ZodTypeAny, {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    }, {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    }>, z.ZodObject<{
+        at: z.ZodLiteral<"line">;
+        from: z.ZodNumber;
+        to: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    }, {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    }>]>>;
     quote: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     ref: string;
     kind: "ref";
     label?: string | undefined;
-    page?: number | undefined;
+    locator?: {
+        at: "page";
+        page: number;
+    } | {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    } | {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    } | undefined;
     quote?: string | undefined;
 }, {
     ref: string;
     kind: "ref";
     label?: string | undefined;
-    page?: number | undefined;
+    locator?: {
+        at: "page";
+        page: number;
+    } | {
+        at: "cell";
+        row: number;
+        col: string | number;
+        sheet?: string | undefined;
+    } | {
+        at: "line";
+        from: number;
+        to?: number | undefined;
+    } | undefined;
     quote?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"url">;
     url: z.ZodString;
+    quote: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     kind: "url";
+    quote?: string | undefined;
     title?: string | undefined;
 }, {
     url: string;
     kind: "url";
+    quote?: string | undefined;
     title?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"derived">;
+    expression: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"ref">;
+        ref: z.ZodString;
+        locator: z.ZodOptional<z.ZodDiscriminatedUnion<"at", [z.ZodObject<{
+            at: z.ZodLiteral<"page">;
+            page: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            at: "page";
+            page: number;
+        }, {
+            at: "page";
+            page: number;
+        }>, z.ZodObject<{
+            at: z.ZodLiteral<"cell">;
+            sheet: z.ZodOptional<z.ZodString>;
+            row: z.ZodNumber;
+            col: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        }, "strip", z.ZodTypeAny, {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        }, {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        }>, z.ZodObject<{
+            at: z.ZodLiteral<"line">;
+            from: z.ZodNumber;
+            to: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        }, {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        }>]>>;
+        quote: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    }, {
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        quote: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    }, {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    }>]>, "many">;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "derived";
+    inputs: ({
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    } | {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    })[];
+    expression?: string | undefined;
+    label?: string | undefined;
+}, {
+    kind: "derived";
+    inputs: ({
+        ref: string;
+        kind: "ref";
+        label?: string | undefined;
+        locator?: {
+            at: "page";
+            page: number;
+        } | {
+            at: "cell";
+            row: number;
+            col: string | number;
+            sheet?: string | undefined;
+        } | {
+            at: "line";
+            from: number;
+            to?: number | undefined;
+        } | undefined;
+        quote?: string | undefined;
+    } | {
+        url: string;
+        kind: "url";
+        quote?: string | undefined;
+        title?: string | undefined;
+    })[];
+    expression?: string | undefined;
+    label?: string | undefined;
 }>]>;
 export type CitationRef = z.infer<typeof CitationRefSchema>;
 export type RefCitation = z.infer<typeof RefCitationSchema>;
 export type UrlCitation = z.infer<typeof UrlCitationSchema>;
+export type DerivedCitation = z.infer<typeof DerivedCitationSchema>;
+/** An input to a derived citation — anything directly citable. */
+export type SourceCitation = RefCitation | UrlCitation;
 /**
  * The `citation` half of a cited agent response — a structural mirror of `value`
  * whose leaves are `CitationRef[]`.

package/dist/common/citation-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"citation-ref.d.ts","sourceRoot":"","sources":["../../src/common/citation-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAsB5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAK5D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAMlE;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,EAAE,CAEzE;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mDAAoD,CAAC"}
+{"version":3,"file":"citation-ref.d.ts","sourceRoot":"","sources":["../../src/common/citation-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAM5D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAUlE;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,EAAE,CAEzE;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mDAAoD,CAAC"}

package/dist/common/citation-ref.js

@@ -9,7 +9,7 @@ import { zodToJsonSchemaRecord } from '../util/schema-convert.js';
  * execution time and travels *with the output data* — `output.response.citation`,
  * a structural mirror of `output.response.value`.
  *
- * Two kinds, because exactly two things are knowable to a model:
+ * Three kinds — everything a model can honestly say about where a value came from:
  *
  * - `ref` — a path the agent was explicitly shown (the `[source: ...]` labels the
  *   agent step injects around resolved `{{refs}}`). An agent can never emit an
@@ -17,26 +17,66 @@ import { zodToJsonSchemaRecord } from '../util/schema-convert.js';
  *   to know. Turning a `ref` into an openable document happens in the UI, which
  *   alone holds the workflow config + step outputs required to walk to the source.
  * - `url` — an external link the agent browsed. Already concrete; nothing to resolve.
+ * - `derived` — the value was **computed**, so it appears nowhere to be quoted;
+ *   its provenance is the inputs it combined and how. See {@link DerivedCitationSchema}.
  *
- * `page` / `quote` are the half only the reader of the text can supply: they
- * locate the passage *inside* the resolved document. Which document a value came
- * from is structural (the workflow knows it); where inside it is data (only the
- * agent knows it) — this split is why citations are never inferred by tracing.
+ * `locator` / `quote` are the half only the reader of the text can supply: they
+ * locate the passage *inside* the source the `ref` names. Which source a value
+ * came from is structural (the workflow knows it); where inside it is data (only
+ * the agent knows it) — this split is why citations are never inferred by tracing.
+ *
+ * **There is deliberately no separate "document" vs "value" kind.** Whether a ref
+ * resolves to an openable document or to plain step output is a *structural* fact
+ * the model cannot know — it saw text, not the workflow graph. Asking it to
+ * classify would guarantee confident mis-labelling, and a wrong discriminator is
+ * far worse than an omitted optional field. So the emitted union is shaped by what
+ * the agent can know; the *resolved* union (UI) splits `doc` from `value`, where
+ * the answer is actually available. When there is nothing to locate within, the
+ * agent simply omits `locator`/`quote`.
+ */
+/**
+ * Where inside a source a value sits.
+ *
+ * Discriminated rather than a bag of optional fields: a spreadsheet has no pages
+ * and a PDF has no rows, so `page?`/`row?`/`line?` side by side would make most
+ * combinations meaningless and every consumer defensive.
+ *
+ * The agent asserts this only because the `[source: …]` label *shows* it — it is
+ * copied, never inferred. Anything a label can't show stays out of this union
+ * (an image bounding box, for instance, which no reader of text could know).
  */
+export const LocatorSchema = z.discriminatedUnion('at', [
+    z.object({
+        at: z.literal('page'),
+        page: z.number().int().positive().describe('1-based page'),
+    }),
+    z.object({
+        at: z.literal('cell'),
+        sheet: z.string().optional().describe('Sheet name, when the file has several'),
+        row: z.number().int().describe('1-based row, header included — as shown in Excel'),
+        col: z.union([z.string(), z.number()]).describe('Column letter ("B") or index'),
+    }),
+    z.object({
+        at: z.literal('line'),
+        from: z.number().int().describe('1-based first line'),
+        to: z.number().int().optional().describe('Last line, for a range'),
+    }),
+]);
 export const RefCitationSchema = z.object({
     kind: z.literal('ref'),
     // The `{{ref}}` grammar (see util/variable-ref.ts + engine/resolvePath): dotted
-    // throughout, arrays indexed as plain segments (`results.0.data`). NOT the
-    // bracketed CitationPath grammar (`results[id].data`), which addresses config.
+    // throughout, arrays indexed as plain segments (`results.0.source`). NOT the
+    // bracketed CitationPath grammar (`results[id].text`), which addresses config.
+    //
+    // Names the SOURCE, not the text: `labelSources` surfaces the owning document
+    // when there is one, so a cited passage points at the document it lives in
+    // rather than at an internal text path. That keeps citations decoupled from a
+    // producer's output shape, and means the document is a direct lookup rather
+    // than something reconstructed by climbing the tree.
     ref: z
         .string()
-        .describe('Path to the cited source, e.g. "steps.ocr.output.results.0.data"'),
-    page: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('1-based page within the resolved document'),
+        .describe('Path to the cited source, e.g. "steps.ocr.output.results.0.source"'),
+    locator: LocatorSchema.optional().describe('Where inside that source the value sits'),
     quote: z
         .string()
         .optional()
@@ -49,11 +89,56 @@ export const RefCitationSchema = z.object({
 export const UrlCitationSchema = z.object({
     kind: z.literal('url'),
     url: z.string().describe('External source — http(s) only'),
+    quote: z.string().optional().describe('Exact text quoted from the page'),
     title: z.string().optional().describe('Short title shown instead of the bare URL'),
 });
+/**
+ * A value the agent **computed** rather than read — a total, a ratio, a growth
+ * rate. It appears nowhere in the source, so there is no passage to quote and no
+ * page to open; its provenance is *these inputs, combined this way*.
+ *
+ * This is a distinct kind rather than "several citations on one value" because
+ * the two mean opposite things. Two citations on a name are **corroboration** —
+ * either alone still supports it. Two inputs to a subtraction are **required** —
+ * if one is wrong, the value is wrong. Rendering them identically would hide that.
+ *
+ * `inputs` is deliberately only one level deep (an input can't itself be
+ * `derived`): it keeps every union member a plain `ZodObject`, which is what
+ * `z.discriminatedUnion` requires — a recursive member would force `z.union` plus
+ * lazy schemas for no real gain, since a chain of derivations is already handled
+ * by resolving *through* the upstream agent's own citation.
+ */
+export const DerivedCitationSchema = z.object({
+    kind: z.literal('derived'),
+    expression: z
+        .string()
+        .optional()
+        .describe('Arithmetic over the inputs, referenced positionally: "(#2 - #1) / #1". '
+        + 'Only + - * / ( ) and numbers — no names or function calls, so it can be '
+        + 'recomputed and verified.'),
+    // Validated all-or-nothing, unlike a list of plain citations where a malformed
+    // entry is dropped and the rest kept. That is a correctness requirement, not
+    // strictness: `expression` addresses inputs *by position*, so silently dropping
+    // a bad one shifts every later index and the recomputation would quietly
+    // evaluate something different. An unparseable derivation must fail whole.
+    inputs: z
+        .array(z.discriminatedUnion('kind', [RefCitationSchema, UrlCitationSchema]))
+        .min(1)
+        .describe('The values that were combined, in the order `#1`, `#2`, … refer to'),
+    // The prompt asks the agent to always supply this (an expression like
+    // `(#1+#2+#3)/(#4+#5)` is meaningless without a name), but it stays schema-optional
+    // so a derivation is never dropped for lacking it — the UI falls back to the
+    // expression. Hard-enforcement (required + sanitize backfill) is a later step.
+    label: z
+        .string()
+        .optional()
+        .describe('Plain-language name of what the value represents — e.g. "Debt Service '
+        + 'Coverage Ratio" — so a reader understands what the expression computes.'),
+});
 export const CitationRefSchema = z.discriminatedUnion('kind', [
     RefCitationSchema,
     UrlCitationSchema,
+    DerivedCitationSchema,
 ]);
 /**
  * JSON Schema for one CitationRef — DERIVED from the Zod members (the single
@@ -63,6 +148,7 @@ export const CITATION_REF_JSON_SCHEMA = {
     oneOf: [
         zodToJsonSchemaRecord(RefCitationSchema),
         zodToJsonSchemaRecord(UrlCitationSchema),
+        zodToJsonSchemaRecord(DerivedCitationSchema),
     ],
 };
 /**
@@ -81,6 +167,11 @@ export function isCitationRef(value) {
         return typeof v['ref'] === 'string';
     if (v['kind'] === 'url')
         return typeof v['url'] === 'string';
+    // Load-bearing: `isCitationRefArray` uses this to tell a citation *leaf* from a
+    // mirror *branch*. Omit `derived` here and a computed value's citation would be
+    // walked past as if it were structure, and never render.
+    if (v['kind'] === 'derived')
+        return Array.isArray(v['inputs']);
     return false;
 }
 /** Is `value` a citation *leaf* — a non-empty array of {@link CitationRef}? */

package/dist/common/citation-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"citation-ref.js","sourceRoot":"","sources":["../../src/common/citation-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,gFAAgF;IAChF,2EAA2E;IAC3E,+EAA+E;IAC/E,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC5D,iBAAiB;IACjB,iBAAiB;CAClB,CAAC,CAAC;AAkBH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAC/D,KAAK,EAAE;QACL,qBAAqB,CAAC,iBAAiB,CAAC;QACxC,qBAAqB,CAAC,iBAAiB,CAAC;KACzC;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC;IAC7D,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC"}
+{"version":3,"file":"citation-ref.js","sourceRoot":"","sources":["../../src/common/citation-ref.ts"],"names":[],"mappings":"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"}

package/dist/common/index.d.ts

@@ -17,8 +17,8 @@
  */
 export type { Attachment } from './attachment.js';
 export { AttachmentSchema, ATTACHMENT_FORMAT, ATTACHMENT_JSON_SCHEMA, ATTACHMENT_ARRAY_JSON_SCHEMA, markAttachmentFields, isAttachment, mimeAccepted, attachmentProperty, } from './attachment.js';
-export type { CitationRef, RefCitation, UrlCitation, CitationMap, } from './citation-ref.js';
-export { CitationRefSchema, RefCitationSchema, UrlCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './citation-ref.js';
+export type { CitationRef, Locator, RefCitation, UrlCitation, DerivedCitation, SourceCitation, CitationMap, } from './citation-ref.js';
+export { CitationRefSchema, LocatorSchema, RefCitationSchema, UrlCitationSchema, DerivedCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './citation-ref.js';
 export type { PayloadError } from './validate-payload.js';
 export { validateTriggerPayload } from './validate-payload.js';
 export type { ResumePayload, ResumeAttachment, ResumeAction, } from './resume-payload.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/common/index.js

@@ -16,7 +16,7 @@
  * browser bundle.
  */
 export { AttachmentSchema, ATTACHMENT_FORMAT, ATTACHMENT_JSON_SCHEMA, ATTACHMENT_ARRAY_JSON_SCHEMA, markAttachmentFields, isAttachment, mimeAccepted, attachmentProperty, } from './attachment.js';
-export { CitationRefSchema, RefCitationSchema, UrlCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './citation-ref.js';
+export { CitationRefSchema, LocatorSchema, RefCitationSchema, UrlCitationSchema, DerivedCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './citation-ref.js';
 export { validateTriggerPayload } from './validate-payload.js';
 export { isExecutable, extensionOf, BLOCKED_EXECUTABLE_MIME_TYPES, BLOCKED_EXECUTABLE_EXTENSIONS, } from './executable-check.js';
 // Node-path addressing for step records — pure string utilities (no Node deps),

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,gFAAgF;AAChF,kFAAkF;AAClF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,gFAAgF;AAChF,kFAAkF;AAClF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.d.ts

@@ -37,8 +37,8 @@ export type { OperatorDescriptor, StepType, TriggerType, StepCategory, Validatio
 export { VARIABLE_REF_REGEX, VARIABLE_REF_DESCRIPTION_PREFIX, tokenize, isPureRef, extractRefPath, collectRefs, parseRef, findStepsReferencing, } from './util/variable-ref.js';
 export type { VariableRefToken, FoundRef, ParsedRef } from './util/variable-ref.js';
 export { ensureCitationPath, tryCitationPath, parseCitationPath, resolveCitationPath, } from './util/citation-path.js';
-export type { Attachment, CitationRef, RefCitation, UrlCitation, CitationMap, ResumePayload, ResumeAttachment, ResumeAction, } from './common/index.js';
-export { isExecutable, extensionOf, BLOCKED_EXECUTABLE_MIME_TYPES, BLOCKED_EXECUTABLE_EXTENSIONS, AttachmentSchema, CitationRefSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './common/index.js';
+export type { Attachment, CitationRef, Locator, RefCitation, UrlCitation, DerivedCitation, SourceCitation, CitationMap, ResumePayload, ResumeAttachment, ResumeAction, } from './common/index.js';
+export { isExecutable, extensionOf, BLOCKED_EXECUTABLE_MIME_TYPES, BLOCKED_EXECUTABLE_EXTENSIONS, AttachmentSchema, CitationRefSchema, LocatorSchema, DerivedCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './common/index.js';
 export { zodToJsonSchemaRecord } from './util/schema-convert.js';
 export { TYPE_KINDS, kindsCompatible } from './util/type-compat.js';
 export type { TypeKind } from './util/type-compat.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,eAAe,EACf,cAAc,GACf,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI5E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,YAAY,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAIlF,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAIhF,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAEL,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EAExB,eAAe,EACf,qBAAqB,EAErB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EAEpB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EAErB,mBAAmB,EACnB,yBAAyB,EAEzB,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,cAAc,EAEd,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAEV,kBAAkB,EAElB,QAAQ,EACR,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAEhB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAEf,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EAEb,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAEf,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,SAAS,GACV,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,QAAQ,EACR,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAOjC,YAAY,EACV,UAAU,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,6BAA6B,EAC7B,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAI1F,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,QAAQ,EACR,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,QAAQ,EACR,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,SAAS,EACT,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,eAAe,EACf,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,YAAY,EACZ,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,QAAQ,EACR,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,sCAAsC,CAAC;AAI9C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAI5B,YAAY,EACV,kBAAkB,EAClB,MAAM,EACN,YAAY,EACZ,WAAW,EACX,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -44,7 +44,7 @@ WorkflowVariableSchema, VariableKeySchema, projectVariables, varsJsonSchema, } f
 // ─── Util ───
 export { VARIABLE_REF_REGEX, VARIABLE_REF_DESCRIPTION_PREFIX, tokenize, isPureRef, extractRefPath, collectRefs, parseRef, findStepsReferencing, } from './util/variable-ref.js';
 export { ensureCitationPath, tryCitationPath, parseCitationPath, resolveCitationPath, } from './util/citation-path.js';
-export { isExecutable, extensionOf, BLOCKED_EXECUTABLE_MIME_TYPES, BLOCKED_EXECUTABLE_EXTENSIONS, AttachmentSchema, CitationRefSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './common/index.js';
+export { isExecutable, extensionOf, BLOCKED_EXECUTABLE_MIME_TYPES, BLOCKED_EXECUTABLE_EXTENSIONS, AttachmentSchema, CitationRefSchema, LocatorSchema, DerivedCitationSchema, CITATION_REF_JSON_SCHEMA, CITATION_DIRECTIVE_ATTRS, isCitationRef, isCitationRefArray, } from './common/index.js';
 export { zodToJsonSchemaRecord } from './util/schema-convert.js';
 // ─── Type Compatibility (shared by picker, validator, runtime) ───
 export { TYPE_KINDS, kindsCompatible } from './util/type-compat.js';

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyne/workflow-sdk",
-  "version": "3.2.20",
+  "version": "3.2.22",
   "description": "Workflow engine SDK — steps, triggers, executor, agents, and a framework-agnostic HTTP router.",
   "license": "UNLICENSED",
   "repository": {