document-to-fields

1# SPDX-License-Identifier: Apache-2.02# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json3#4# TEMPLATE · document-to-fields · source text → anchored facts → nonempty proof.5#6# The source is trimmed and proved nonempty before inference. The extraction7# is typed, and every value carries the exact source fragment that supports it.8# An empty extraction is refused before it can look like a successful read.9#10# Needs · nothing. Runs offline in an empty directory with mock/echo.11# Run · nika run <file> --model mock/echo12nika: document-to-fields13​14model: mock/echo                     # SLOT: replace with a local or hosted seat15​16const:17  document: |                        # SLOT: replace with content from nika:read or nika:fetch18    Invoice INV-20419    Supplier: Northwind Tools20    Total: EUR 84.5021    Rehearsal marker: mock22​23⛨permits:24  ⛨tools: ["nika:jq", "nika:assert"]25​26tasks:27  normalize_document:28    ◆invoke:29      tool: nika:jq30      args:31        input: ${{ const.document }}32        expression: 'gsub("^\\s+|\\s+$"; "")'33​34  document_nonempty:35    with:36      document: ${{ tasks.normalize_document.output }}37    ◆invoke:38      tool: nika:assert39      args:40        condition: ${{ size(with.document) > 0 }}41        message: "Document is empty after whitespace is trimmed"42​43  extract:44    with:45      document: ${{ tasks.normalize_document.output }}46    after:47      document_nonempty: success48    ◇infer:49      max_tokens: 600                # SLOT: extraction spend ceiling50      prompt: |51        Extract only facts explicitly present in this document. For every52        value, copy the shortest exact source fragment that anchors it.53​54        ${{ with.document }}55      schema:56        type: object57        additionalProperties: false58        required: [fields]59        properties:60          fields:61            type: array62            minItems: 163            items:64              type: object65              additionalProperties: false66              required: [name, value, anchor]67              properties:68                name: { type: string, minLength: 1 }69                value: { type: string, minLength: 1 }70                anchor: { type: string, minLength: 1 }71​72  anchors_present:73    with:74      fields: ${{ tasks.extract.output.fields }}75      document: ${{ tasks.normalize_document.output }}76    ◆invoke:77      tool: nika:jq78      args:79        input: { fields: "${{ with.fields }}", document: "${{ with.document }}" }80        expression: '. as $root | ($root.fields | length) > 0 and all($root.fields[]; . as $field | (.name | length) > 0 and (.value | length) > 0 and (.anchor | length) > 0 and ($root.document | contains($field.anchor)))'81​82  compiled:83    with:84      anchors_present: ${{ tasks.anchors_present.output }}85    ◆invoke:86      tool: nika:assert87      args:88        condition: ${{ with.anchors_present }}89        message: "Document extraction returned no anchored fields"90​91outputs:92  fields: ${{ tasks.extract.output.fields }}93​