@xyne/workflow-sdk 3.2.20 → 3.2.21

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"}