@jangts/agent-core 0.3.5 → 0.5.0

package/dist/cjs/execution/workflow-chain.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectWorkflowChain = projectWorkflowChain;
+/** Read-side projection of captured workflow facts; never dispatches or reconstructs topology. */
+const index_js_1 = require("../diagnostics/index.js");
+const workflow_graph_js_1 = require("./workflow-graph.js");
+const lifecycleTypes = new Set(['enter', 'transition', 'complete', 'error']);
+/** Aggregate main visits by span and keep raw subflow records in their own append order. */
+function projectWorkflowChain(workflowId, runId, input) {
+    const coverage = structuredClone(input.coverage);
+    const issues = [...coverage.issues];
+    const issue = (code, spanId, eventId) => issues.push({ code, spanId, eventId });
+    const events = input.events
+        .map(index_js_1.normalizeDiagnosticEvent)
+        .filter((e) => e.runId === runId)
+        .sort((a, b) => a.producerSequence - b.producerSequence);
+    const visits = new Map();
+    const ledgers = new Map();
+    const transitions = [];
+    const seen = new Map();
+    for (const raw of events) {
+        const payload = raw.payload && typeof raw.payload === 'object'
+            ? raw.payload
+            : {};
+        const candidate = payload.event;
+        const fact = raw.type === 'workflow.event' && candidate && typeof candidate === 'object'
+            ? candidate
+            : undefined;
+        const belongs = fact?.workflowId === workflowId ||
+            (raw.nodeRole === 'workflow-node' && raw.definitionId === workflowId);
+        if (!belongs || (raw.nodeRole !== undefined && raw.nodeRole !== 'workflow-node'))
+            continue;
+        if (raw.type === 'workflow.event' && !fact) {
+            issue('invalid-workflow-event', raw.spanId, raw.eventId);
+            continue;
+        }
+        const identity = JSON.stringify(raw);
+        if (seen.has(raw.eventId)) {
+            if (seen.get(raw.eventId) !== identity)
+                issue('conflicting-event', raw.spanId, raw.eventId);
+            continue;
+        }
+        seen.set(raw.eventId, identity);
+        if (fact &&
+            (!lifecycleTypes.has(fact.type) ||
+                fact.eventId !== raw.eventId ||
+                fact.workflowId !== workflowId ||
+                (raw.workflowInvocationId !== undefined &&
+                    fact.workflowInvocationId !== raw.workflowInvocationId) ||
+                [
+                    'targetSpanId',
+                    'targetNodeId',
+                    'routeId',
+                    'conditionId',
+                    'errorCode',
+                    'errorEventId',
+                ].some((key) => {
+                    const value = fact[key];
+                    return value !== undefined && typeof value !== 'string';
+                }) ||
+                (fact.route !== undefined && (!Number.isSafeInteger(fact.route) || fact.route < 0)) ||
+                (fact.durationMs !== undefined &&
+                    (!Number.isFinite(fact.durationMs) || fact.durationMs < 0)) ||
+                !Number.isSafeInteger(fact.roundIndex) ||
+                typeof fact.workflowInvocationId !== 'string' ||
+                fact.nodeId !== raw.nodeId ||
+                (fact.spanId !== undefined && fact.spanId !== raw.spanId) ||
+                (fact.runId !== undefined && fact.runId !== runId))) {
+            issue('invalid-workflow-event', raw.spanId, raw.eventId);
+            continue;
+        }
+        if (!raw.nodeId) {
+            issue('missing-node-id', raw.spanId, raw.eventId);
+            continue;
+        }
+        let visit = visits.get(raw.spanId);
+        if (!visit) {
+            visit = {
+                spanId: raw.spanId,
+                nodeId: raw.nodeId,
+                workflowInvocationId: raw.workflowInvocationId ?? fact?.workflowInvocationId,
+                definitionRevision: raw.definitionRevision,
+                name: raw.nodeName,
+                description: raw.nodeDescription,
+                kind: raw.nodeKind,
+                roundIndex: fact?.roundIndex,
+                firstEventSequence: raw.producerSequence,
+                lastEventSequence: raw.producerSequence,
+                status: 'unknown',
+                events: [],
+                subflow: [],
+            };
+            visits.set(raw.spanId, visit);
+            ledgers.set(raw.spanId, new Map());
+        }
+        if (visit.nodeId !== raw.nodeId ||
+            visit.workflowInvocationId !== (raw.workflowInvocationId ?? fact?.workflowInvocationId)) {
+            issue('conflicting-span', raw.spanId, raw.eventId);
+            continue;
+        }
+        visit.lastEventSequence = raw.producerSequence;
+        if (raw.usedModel !== undefined)
+            visit.usedModel = raw.usedModel;
+        if (raw.subStepsDropped || raw.subStepsTruncated)
+            issue('subflow-truncated', raw.spanId, raw.eventId);
+        const ledger = ledgers.get(raw.spanId);
+        for (const step of raw.subSteps ?? []) {
+            const previous = ledger.get(step.stepId);
+            if (!previous)
+                ledger.set(step.stepId, structuredClone(step));
+            else if (JSON.stringify({ ...previous, sourceEventId: undefined, producerSequence: undefined }) !==
+                JSON.stringify(step))
+                issue('conflicting-subflow', raw.spanId, raw.eventId);
+        }
+        const progress = payload.subStep;
+        if (raw.type === 'node.progress' && progress) {
+            const record = progress.stepId ? ledger.get(progress.stepId) : undefined;
+            if (record) {
+                ledger.set(record.stepId, {
+                    ...record,
+                    sourceEventId: raw.eventId,
+                    producerSequence: raw.producerSequence,
+                });
+            }
+            else if (typeof progress.stepId === 'string' && Number.isSafeInteger(progress.sequence)) {
+                ledger.set(progress.stepId, {
+                    ...structuredClone(progress),
+                    origin: 'reported',
+                    sourceEventId: raw.eventId,
+                    producerSequence: raw.producerSequence,
+                });
+            }
+            else
+                issue('invalid-subflow-progress', raw.spanId, raw.eventId);
+            continue;
+        }
+        if (fact || raw.type === 'node.progress') {
+            visit.events.push({
+                eventId: raw.eventId,
+                producerSequence: raw.producerSequence,
+                occurredAtMs: raw.occurredAtMs,
+                type: fact?.type ?? 'progress',
+                phase: fact?.phase,
+                routeId: fact?.routeId,
+                conditionId: fact?.conditionId,
+                errorCode: fact?.errorCode,
+                errorEventId: fact?.errorEventId,
+                payload: payload.payload,
+            });
+        }
+        if (!fact)
+            continue;
+        visit.roundIndex ??= fact.roundIndex;
+        if (fact.type === 'enter') {
+            visit.enteredAtMs = raw.occurredAtMs;
+            visit.status = 'running';
+        }
+        if (fact.type === 'error')
+            visit.status =
+                fact.errorCode === 'CANCELLED' || fact.errorCode === 'TIMEOUT' ? 'cancelled' : 'error';
+        if (fact.type !== 'enter') {
+            visit.endedAtMs = raw.occurredAtMs;
+            visit.durationMs = fact.durationMs;
+            if (fact.type !== 'error' && visit.status !== 'error' && visit.status !== 'cancelled')
+                visit.status = 'success';
+        }
+        if (fact.type === 'transition' ||
+            fact.type === 'complete' ||
+            (fact.type === 'error' && fact.targetNodeId !== undefined))
+            transitions.push({
+                eventId: raw.eventId,
+                producerSequence: raw.producerSequence,
+                occurredAtMs: raw.occurredAtMs,
+                type: fact.type === 'complete' ? 'complete' : 'transition',
+                sourceSpanId: raw.spanId,
+                targetSpanId: fact.targetSpanId,
+                targetNodeId: fact.targetNodeId,
+                routeOrder: fact.route,
+                routeId: fact.routeId,
+                conditionId: fact.conditionId,
+                errorEventId: fact.type === 'error' ? raw.eventId : fact.errorEventId,
+            });
+    }
+    if (!visits.size)
+        throw new RangeError(`No captured workflow visits: ${workflowId} / ${runId}`);
+    for (const visit of visits.values()) {
+        visit.subflow = [...ledgers.get(visit.spanId).values()].sort((a, b) => a.sequence - b.sequence);
+        if (visit.enteredAtMs === undefined)
+            issue('missing-enter', visit.spanId);
+        if (visit.endedAtMs === undefined && coverage.complete === true) {
+            visit.status = 'unknown';
+            issue('missing-exit', visit.spanId);
+        }
+        for (const step of visit.subflow)
+            if (step.operation === undefined ||
+                step.revision === undefined ||
+                step.createdAtMs === undefined)
+                issue('historical-subflow-fields', visit.spanId);
+    }
+    for (const edge of transitions)
+        if (edge.targetSpanId && !visits.has(edge.targetSpanId))
+            issue('missing-target-enter', edge.targetSpanId, edge.eventId);
+    return (0, workflow_graph_js_1.freezeView)({
+        schemaVersion: 1,
+        workflowId,
+        runId,
+        nodes: [...visits.values()],
+        transitions,
+        coverage: { ...coverage, complete: issues.length ? false : coverage.complete, issues },
+    });
+}

package/dist/cjs/execution/workflow-graph.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectWorkflowGraph = projectWorkflowGraph;
+exports.freezeView = freezeView;
+/** Edge identity depends on topology, never on a route label or callback. */
+function projectWorkflowGraph(workflowId, entryNodeId, revision, definitions) {
+    const edges = new Map();
+    const nodes = definitions.map((node, order) => {
+        const edgeFor = (kind, targetNodeId) => {
+            const id = JSON.stringify([node.id, kind, targetNodeId ?? null]);
+            if (!edges.has(id))
+                edges.set(id, {
+                    id,
+                    kind,
+                    sourceNodeId: node.id,
+                    targetNodeId,
+                    routeOrders: [],
+                    ...(kind === 'error' ? { errorRouteId: node.onErrorRouteId } : {}),
+                });
+            return edges.get(id);
+        };
+        const routes = node.routes.map((route, order) => {
+            const edge = edgeFor(route.complete ? 'complete' : 'transition', route.targetNodeId);
+            edge.routeOrders.push(order);
+            return {
+                order,
+                routeId: route.id,
+                description: route.description,
+                conditional: !!route.when,
+                conditionId: route.conditionId,
+                edgeId: edge.id,
+            };
+        });
+        if (node.onErrorNodeId)
+            edgeFor('error', node.onErrorNodeId);
+        return {
+            id: node.id,
+            name: node.name ?? node.id,
+            description: node.description,
+            order,
+            startsRound: !!node.startsRound,
+            requires: [...(node.requires ?? [])],
+            provides: [...(node.provides ?? [])],
+            routes,
+            incomingEdgeIds: [],
+            outgoingEdgeIds: [],
+        };
+    });
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    for (const edge of edges.values()) {
+        byId.get(edge.sourceNodeId).outgoingEdgeIds.push(edge.id);
+        if (edge.targetNodeId)
+            byId.get(edge.targetNodeId).incomingEdgeIds.push(edge.id);
+    }
+    return freezeView({
+        schemaVersion: 1,
+        workflowId,
+        revision,
+        entryNodeId,
+        nodes,
+        edges: [...edges.values()],
+    });
+}
+/** Freeze detached JSON data recursively so callers cannot alter another consumer's view. */
+function freezeView(value) {
+    if (value && typeof value === 'object') {
+        for (const child of Object.values(value))
+            freezeView(child);
+        Object.freeze(value);
+    }
+    return value;
+}

package/dist/cjs/execution/workflow.js

@@ -2,6 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkflowContractError = exports.route = exports.requireWorkflowValue = exports.AttemptBudget = exports.AgentWorkflow = void 0;
 exports.defineWorkflow = defineWorkflow;
+/**
+ * Validated workflow catalog and round accounting.
+ *
+ * A workflow is declared as data (nodes plus routes) and validated before any handler
+ * runs: references must resolve, every node must be reachable from the entry, and every
+ * cycle must cross a round boundary so the engine's budget stays authoritative. This
+ * module owns the catalog; `engine.ts` owns traversal and execution.
+ *
+ * Exports: `AgentWorkflow`, `defineWorkflow`, `AttemptBudget`, the re-exported
+ * `requireWorkflowValue` and `route`, and the workflow contract types.
+ */
+const workflow_graph_js_1 = require("./workflow-graph.js");
+const workflow_chain_js_1 = require("./workflow-chain.js");
 /**
  * Derive unique route ids for one node.
  *
@@ -55,6 +68,7 @@ class AgentWorkflow {
     revision;
     /** Optional result guard; when present it must return exactly true. */
     isResult;
+    chainSource;
     nodes = new Map();
     /**
      * Build and validate a workflow.
@@ -72,6 +86,7 @@ class AgentWorkflow {
         if (!definition.id?.trim() || !entry?.trim() || !definition.nodes.length) {
             throw new TypeError('Invalid workflow');
         }
+        this.chainSource = definition.chainSource?.bind(definition);
         this.id = definition.id;
         this.entryNodeId = entry;
         this.revision = definition.revision;
@@ -108,6 +123,7 @@ class AgentWorkflow {
         return new AgentWorkflow({
             id: this.id,
             revision: patch.revision,
+            chainSource: this.chainSource,
             entryNodeId: this.entryNodeId,
             isResult: this.isResult,
             nodes: nodes.map((node) => ({
@@ -125,6 +141,18 @@ class AgentWorkflow {
             })),
         });
     }
+    /** Export topology from the registered snapshot without executing callbacks. */
+    toGraph() {
+        return (0, workflow_graph_js_1.projectWorkflowGraph)(this.id, this.entryNodeId, this.revision, this.definitions);
+    }
+    /** Read an authorized run through the bound App source, or an explicit per-call source. */
+    async toChain(runId, source = this.chainSource) {
+        if (!runId.trim())
+            throw new TypeError('A runId is required');
+        if (!source)
+            throw new TypeError('Workflow chainSource is not configured');
+        return (0, workflow_chain_js_1.projectWorkflowChain)(this.id, runId, await source(runId));
+    }
     /**
      * Look up a node that must exist.
      *
@@ -207,25 +235,26 @@ class AgentWorkflow {
      * @throws TypeError When the node, a route or a state contract is invalid.
      */
     register(node) {
+        const declaredRoutes = node.routes;
         if (!node.id?.trim() ||
             !node.description?.trim() ||
             this.nodes.has(node.id) ||
-            !node.routes.length ||
+            !declaredRoutes.length ||
             (node.run !== undefined && typeof node.run !== 'function')) {
             throw new TypeError('Invalid or duplicate workflow node');
         }
         validateNodeFields(node);
         if (node.onErrorRouteId !== undefined && (!node.onErrorRouteId.trim() || !node.onErrorNodeId))
             throw new TypeError(`Invalid workflow error route identity: ${node.id}`);
-        const ids = assignRouteIds(node.routes);
-        for (const [index, route] of node.routes.entries()) {
+        const ids = assignRouteIds(declaredRoutes);
+        for (const [index, route] of declaredRoutes.entries()) {
             if ('to' in route ||
                 (route.id !== undefined && !route.id.trim()) ||
                 (route.conditionId !== undefined && (!route.conditionId.trim() || !route.when)))
                 throw new TypeError(`Invalid workflow route identity: ${node.id}`);
             const hasTarget = typeof route.targetNodeId === 'string';
             const hasCompletion = typeof route.complete === 'function';
-            const shadowsFollowingRoutes = !route.when && index !== node.routes.length - 1;
+            const shadowsFollowingRoutes = !route.when && index !== declaredRoutes.length - 1;
             if (hasTarget === hasCompletion ||
                 shadowsFollowingRoutes ||
                 (route.when !== undefined && typeof route.when !== 'function')) {
@@ -239,7 +268,7 @@ class AgentWorkflow {
                 throw new TypeError(`Invalid workflow state contract: ${node.id}`);
             }
         }
-        const routes = Object.freeze(node.routes.map((route, index) => {
+        const routes = Object.freeze(declaredRoutes.map((route, index) => {
             const id = ids[index];
             const conditionId = route.conditionId?.replace(/\{(nid|rid)\}/g, (_, key) => {
                 if (key === 'nid')
@@ -262,7 +291,6 @@ class AgentWorkflow {
         // only when it declares it explicitly.
         const startsRound = node.startsRound ?? (node.id === this.entryNodeId ? true : undefined);
         this.nodes.set(node.id, Object.freeze({
-            ...node,
             id: node.id,
             description: node.description,
             name: node.name,

package/dist/cjs/index.js

@@ -36,22 +36,20 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assembleContextPlan = exports.Support = exports.defineCandidateSelection = exports.ToolLifecycleRegistry = exports.defineTextSkillLoader = exports.defineRetrieval = exports.defineEvidenceProjection = exports.defineEvidenceChecklist = exports.assembleFragments = exports.defineRecoveryChain = exports.definePolicySet = exports.ValidationError = exports.BudgetError = exports.getErrorInfo = void 0;
+exports.assembleContextPlan = exports.Support = exports.defineCandidateSelection = exports.ToolLifecycleRegistry = exports.defineTextSkillLoader = exports.defineRetrieval = exports.commandSchema = exports.defineCommand = exports.defineEvidenceProjection = exports.defineEvidenceChecklist = exports.defineRecoveryChain = exports.definePolicySet = exports.ValidationError = exports.BudgetError = exports.getErrorInfo = void 0;
 /**
  * Aggregate public entry of `@jangts/agent-core`: Core runtime contracts, one `Support`
- * namespace with a few named Support helpers, and the declaration helpers of optional Kits.
+ * namespace, and the optional Kit declaration helpers.
  *
- * Layering. Core owns the runtime contracts Apps call (engine, model runner, capabilities,
- * context, diagnostics) and the handler contracts Core calls back into the App. Support only
- * supplies recommended implementations of those same contracts, so it is published as a single
- * namespace instead of a second dispatch layer. Kits are optional business libraries reached
- * through their own subpath entries; the Kit entries re-exported here are declaration helpers
- * and standalone modules, not additional Core guarantees. Shared utilities are re-exported
- * because they are needed alongside these contracts, and they carry no Agent semantics.
+ * Layering. Core owns the runtime contracts Apps call (engine, model runner, tools,
+ * context, diagnostics) and the handler contracts Core calls back into. Support supplies
+ * recommended implementations of those contracts. Kits are optional App-side libraries;
+ * they are available from this root convenience surface and from `/kits` / `/kits/*`
+ * subpaths. Importing a Kit is a choice, never a requirement.
  *
  * Exports are grouped by responsibility, not by dependency order. Deep subpath entries
  * (`/engine`, `/model`, `/tools`, `/context`, `/journal`, `/diagnostics`, `/kits/...`)
- * resolve to the same implementations, so this file is a convenience surface only.
+ * resolve to the same implementations.
  */
 __exportStar(require("./execution/engine.js"), exports);
 var errors_js_1 = require("./errors.js");
@@ -66,17 +64,23 @@ __exportStar(require("./model/index.js"), exports);
 __exportStar(require("./capabilities/index.js"), exports);
 __exportStar(require("./context/fragments.js"), exports);
 __exportStar(require("./context/journal.js"), exports);
-// Named re-export: the context barrel also forwards its Kit evidence helpers, which the
-// root surface publishes separately below.
-var assembly_js_1 = require("./context/assembly.js");
-Object.defineProperty(exports, "assembleFragments", { enumerable: true, get: function () { return assembly_js_1.assembleFragments; } });
+__exportStar(require("./context/assembly.js"), exports);
 __exportStar(require("./support/context/assembly.js"), exports);
 var evidence_js_1 = require("./kits/evidence.js");
 Object.defineProperty(exports, "defineEvidenceChecklist", { enumerable: true, get: function () { return evidence_js_1.defineEvidenceChecklist; } });
 Object.defineProperty(exports, "defineEvidenceProjection", { enumerable: true, get: function () { return evidence_js_1.defineEvidenceProjection; } });
+var command_js_1 = require("./kits/interaction/command.js");
+Object.defineProperty(exports, "defineCommand", { enumerable: true, get: function () { return command_js_1.defineCommand; } });
+Object.defineProperty(exports, "commandSchema", { enumerable: true, get: function () { return command_js_1.commandSchema; } });
+__exportStar(require("./kits/interaction/commands.js"), exports);
+__exportStar(require("./kits/interaction/transfer.js"), exports);
+__exportStar(require("./kits/interaction/handlers.js"), exports);
 __exportStar(require("./kits/presentation/events.js"), exports);
 __exportStar(require("./support/transport/index.js"), exports);
 __exportStar(require("./support/model/chat-completions.js"), exports);
+__exportStar(require("./support/model/compatible-provider.js"), exports);
+__exportStar(require("./support/model/transports.js"), exports);
+__exportStar(require("./support/model/interactions/index.js"), exports);
 __exportStar(require("./utils/index.js"), exports);
 __exportStar(require("./kits/presentation/templates.js"), exports);
 var retrieval_js_1 = require("./kits/retrieval.js");
@@ -84,11 +88,11 @@ Object.defineProperty(exports, "defineRetrieval", { enumerable: true, get: funct
 var text_skills_js_1 = require("./kits/text-skills.js");
 Object.defineProperty(exports, "defineTextSkillLoader", { enumerable: true, get: function () { return text_skills_js_1.defineTextSkillLoader; } });
 __exportStar(require("./diagnostics/index.js"), exports);
-__exportStar(require("./kits/intents/registry.js"), exports);
-__exportStar(require("./kits/intents/scopes.js"), exports);
+__exportStar(require("./kits/domains/registry.js"), exports);
+__exportStar(require("./kits/domains/scopes.js"), exports);
 var tools_js_1 = require("./kits/tools.js");
 Object.defineProperty(exports, "ToolLifecycleRegistry", { enumerable: true, get: function () { return tools_js_1.ToolLifecycleRegistry; } });
-__exportStar(require("./kits/intents/catalog.js"), exports);
+__exportStar(require("./kits/domains/catalog.js"), exports);
 __exportStar(require("./support/registration.js"), exports);
 var candidates_js_1 = require("./kits/candidates.js");
 Object.defineProperty(exports, "defineCandidateSelection", { enumerable: true, get: function () { return candidates_js_1.defineCandidateSelection; } });

package/dist/cjs/kits/aggregation.js

@@ -11,6 +11,7 @@ exports.defineQueryAggregation = defineQueryAggregation;
  *
  * Exports: `mergeByKey`, `defineQueryAggregation`, `Aggregation`.
  */
+const native_sub_flow_js_1 = require("../diagnostics/native-sub-flow.js");
 const synchronous_js_1 = require("../utils/synchronous.js");
 /**
  * Merge duplicates without moving their first position; selection policy remains host-owned.
@@ -56,21 +57,23 @@ function defineQueryAggregation(options) {
          * @param context - Host context forwarded unchanged to `execute`, `key` and `merge`.
          * @returns The merged items and their count.
          */
-        collect(inputs, context) {
-            const rows = [], merged = new Map();
-            for (const input of inputs)
-                for (const item of (0, synchronous_js_1.synchronous)(execute(input, context), 'Query aggregation must be synchronous')) {
-                    if (!keyFor) {
-                        rows.push(item);
-                        continue;
+        collect(inputs, context, execution = {}) {
+            return (0, native_sub_flow_js_1.nativeSubFlowSync)(execution, 'aggregation', 'query-aggregation', () => {
+                const rows = [], merged = new Map();
+                for (const input of inputs)
+                    for (const item of (0, synchronous_js_1.synchronous)(execute(input, context), 'Query aggregation must be synchronous')) {
+                        if (!keyFor) {
+                            rows.push(item);
+                            continue;
+                        }
+                        const key = (0, synchronous_js_1.synchronous)(keyFor(item, input, context), 'Aggregation keys must be synchronous');
+                        merged.set(key, merge
+                            ? (0, synchronous_js_1.synchronous)(merge(item, merged.get(key), input, context), 'Aggregation merge must be synchronous')
+                            : item);
                     }
-                    const key = (0, synchronous_js_1.synchronous)(keyFor(item, input, context), 'Aggregation keys must be synchronous');
-                    merged.set(key, merge
-                        ? (0, synchronous_js_1.synchronous)(merge(item, merged.get(key), input, context), 'Aggregation merge must be synchronous')
-                        : item);
-                }
-            const items = keyFor ? [...merged.values()] : rows;
-            return { total: items.length, items };
+                const items = keyFor ? [...merged.values()] : rows;
+                return { total: items.length, items };
+            });
         },
     });
 }

package/dist/cjs/kits/answering/checks.js

@@ -9,6 +9,7 @@ exports.defineAnswerCheckCatalog = defineAnswerCheckCatalog;
  *
  * Exports: `defineAnswerCheckCatalog`, and the answer checker types.
  */
+const native_sub_flow_js_1 = require("../../diagnostics/native-sub-flow.js");
 const check_result_js_1 = require("./check-result.js");
 const catalog_js_1 = require("../../utils/catalog.js");
 const synchronous_js_1 = require("../../utils/synchronous.js");
@@ -40,7 +41,7 @@ function defineAnswerCheckCatalog(definitions) {
                 throw new TypeError('Duplicate selected check id');
             for (const id of request.checkIds) {
                 context.signal.throwIfAborted();
-                const result = (0, check_result_js_1.snapshotAnswerCheck)((0, synchronous_js_1.synchronous)(checks.require(id).check(value, context), 'Answer checkers must be synchronous'), id);
+                const result = (0, native_sub_flow_js_1.nativeSubFlowSync)(context, 'check', id, () => (0, check_result_js_1.snapshotAnswerCheck)((0, synchronous_js_1.synchronous)(checks.require(id).check(value, context), 'Answer checkers must be synchronous'), id));
                 context.signal.throwIfAborted();
                 if (Object.hasOwn(result, 'value'))
                     value = result.value;

package/dist/cjs/kits/answering/flow.js

@@ -10,6 +10,7 @@ exports.defineAnswerFlow = defineAnswerFlow;
  *
  * Exports: `defineAnswerFlow`, and the answer flow/item/result/check types.
  */
+const native_sub_flow_js_1 = require("../../diagnostics/native-sub-flow.js");
 const synchronous_js_1 = require("../../utils/synchronous.js");
 const cancellation_js_1 = require("../../utils/cancellation.js");
 const engine_js_1 = require("../../execution/engine.js");
@@ -282,27 +283,29 @@ function defineAnswerFlow(definition) {
          *   exhausted without a final result.
          */
         async run(request, context) {
-            context.signal.throwIfAborted();
-            (0, batch_js_1.validateAnswerBatch)(request.inputIds, request.items, maxItems);
-            const cells = request.items.map((item) => ({
-                item: Object.freeze({
-                    id: item.id,
-                    data: item.data,
-                    sourceStatus: item.sourceStatus,
-                    inputIds: Object.freeze([...item.inputIds]),
-                }),
-                hasValue: false,
-                local: { status: 'not-run', issues: [] },
-                review: { status: 'not-run', issues: [] },
-                knownReviewFailure: false,
-            }));
-            return new engine_js_1.AgentCoreEngine({
-                maxRounds: maxRepairs + 1,
-                errors: { exhausted: () => new TypeError('Answer flow exhausted') },
-                execution: { signal: context.signal, diagnostics: context.diagnostics },
-            })
-                .bindWorkflow(workflow, context.app)
-                .run({ cells, pending: [], repairBudget: new workflow_js_1.AttemptBudget(maxRepairs) });
+            return (0, native_sub_flow_js_1.nativeSubFlowAsync)(context, 'answer', 'answer-flow', async () => {
+                context.signal.throwIfAborted();
+                (0, batch_js_1.validateAnswerBatch)(request.inputIds, request.items, maxItems);
+                const cells = request.items.map((item) => ({
+                    item: Object.freeze({
+                        id: item.id,
+                        data: item.data,
+                        sourceStatus: item.sourceStatus,
+                        inputIds: Object.freeze([...item.inputIds]),
+                    }),
+                    hasValue: false,
+                    local: { status: 'not-run', issues: [] },
+                    review: { status: 'not-run', issues: [] },
+                    knownReviewFailure: false,
+                }));
+                return new engine_js_1.AgentCoreEngine({
+                    maxRounds: maxRepairs + 1,
+                    errors: { exhausted: () => new TypeError('Answer flow exhausted') },
+                    execution: { signal: context.signal, diagnostics: context.diagnostics },
+                })
+                    .bindWorkflow(workflow, context.app)
+                    .run({ cells, pending: [], repairBudget: new workflow_js_1.AttemptBudget(maxRepairs) });
+            });
         },
     });
 }