agentfootprint 10.2.0 → 10.3.0

package/dist/adapters/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAkOH;;;;GAIG;AACU,QAAA,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAqpBH;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAsC,EACtC,UAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAPD,wCAOC;AAqID;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAgGpD;uDACuD;AACvD,SAAgB,kBAAkB,CAChC,OAAoB;IAEpB,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;AACnD,CAAC;AAJD,gDAIC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAkOH;;;;GAIG;AACU,QAAA,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AA6rBH;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAsC,EACtC,UAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAPD,wCAOC;AAqID;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAgGpD;uDACuD;AACvD,SAAgB,kBAAkB,CAChC,OAAoB;IAEpB,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;AACnD,CAAC;AAJD,gDAIC"}

package/dist/core/Agent.js

@@ -46,6 +46,7 @@ const PolicyHaltError_js_1 = require("../security/PolicyHaltError.js");
 const CacheGateDecider_js_1 = require("../cache/CacheGateDecider.js");
 const cacheStrategyFor_js_1 = require("../cache/cacheStrategyFor.js");
 const forcedToolChoice_js_1 = require("../adapters/forcedToolChoice.js");
+const nativeOutputSchema_js_1 = require("../adapters/nativeOutputSchema.js");
 const requestRefusal_js_1 = require("../adapters/requestRefusal.js");
 const assistantReplay_js_1 = require("./agent/assistantReplay.js");
 const skillBrains_js_1 = require("./agent/skillBrains.js");
@@ -1449,29 +1450,38 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             return (0, outputSchema_js_1.applyOutputSchema)(raw, parser);
         }
         catch (err) {
-            if (!this.outputFallbackCfg || !(err instanceof outputSchema_js_1.OutputSchemaError))
-                throw err;
-            // Engage the 3-tier fallback. The dispatcher gives us the
-            // typed-event entry; we synthesize a minimal event shape since
-            // these events have no per-stage anchor.
-            // Typed via `OutputFallbackEmit`, so the registry — not a grep — is what
-            // decides these two names are real. The cast is now only the envelope
-            // assembly (type + payload are already checked against the event map).
-            const emit = (eventType, payload) => {
-                try {
-                    this.dispatcher.dispatch({
-                        type: eventType,
-                        timestamp: Date.now(),
-                        payload,
-                    });
-                }
-                catch {
-                    /* observability errors must not poison the fallback path */
-                }
-            };
-            return (0, outputFallback_js_1.applyOutputFallback)(raw, parser, this.outputFallbackCfg, emit, err, this.lastRunRetriesSpent());
+            return this.settleTypedFailure(raw, err);
         }
     }
+    /**
+     * A typed answer that failed: rethrow, or — with `.outputFallback()` and an
+     * `OutputSchemaError` — hand it to the 3-tier fallback. The one settle for
+     * `parseOutputAsync`'s parse failure and `runTyped`'s native stop failure.
+     */
+    async settleTypedFailure(raw, err) {
+        const parser = this.outputSchemaParser;
+        if (!this.outputFallbackCfg || !(err instanceof outputSchema_js_1.OutputSchemaError))
+            throw err;
+        // Engage the 3-tier fallback. The dispatcher gives us the
+        // typed-event entry; we synthesize a minimal event shape since
+        // these events have no per-stage anchor.
+        // Typed via `OutputFallbackEmit`, so the registry — not a grep — is what
+        // decides these two names are real. The cast is now only the envelope
+        // assembly (type + payload are already checked against the event map).
+        const emit = (eventType, payload) => {
+            try {
+                this.dispatcher.dispatch({
+                    type: eventType,
+                    timestamp: Date.now(),
+                    payload,
+                });
+            }
+            catch {
+                /* observability errors must not poison the fallback path */
+            }
+        };
+        return (0, outputFallback_js_1.applyOutputFallback)(raw, parser, this.outputFallbackCfg, emit, err, this.lastRunRetriesSpent());
+    }
     /**
      * Corrective re-asks the agent's LAST run paid for, read off its own ledger.
      *
@@ -1510,6 +1520,15 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             throw new Error('Agent.runTyped: run paused — typed mode does not support pauses. ' +
                 'Use agent.run() + agent.parseOutput(...) after resume.');
         }
+        // `strategy: 'native'`: an answer whose last attempt failed on a refusal
+        // or truncation stop is refused here even when its text parses — the
+        // format did not hold for it (outputEnforcement.ts · nativeStopFailure).
+        // FIRST, before any delivery path. It takes the same path a parse failure
+        // takes, `.outputFallback()` included.
+        const stopped = this.outputEnforcement?.outputFormat !== undefined ? this.outputContractUnmet() : undefined;
+        if (stopped?.stopReason !== undefined) {
+            return this.settleTypedFailure(out, new outputSchema_js_1.OutputSchemaError(stopped.error, { rawOutput: out, stage: stopped.stage }));
+        }
         if (this.answerValidationConfig !== undefined) {
             // The validator judged the schema's JSON output. Do not run a transforming
             // or stateful parser again and hand back a value the validator never saw.
@@ -3017,9 +3036,38 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             `{ strategy: 'instruct', retries: N } on this provider — it works on every wire — or ` +
             `run the forced strategy on a provider that declares the capability.`);
     }
+    /**
+     * Refuse, at run start, a `'native'` output strategy on a provider that
+     * does not put a structured-output format on its wire, or on a model that
+     * does not take one — the `assertForcedToolChoiceSupported` twin, for the
+     * same reasons: run start because a decorated provider is only what it is
+     * once composed; a refusal because `'instruct'` asks in prose for what this
+     * strategy constrains at decoding, and a quiet swap would be config that
+     * lies.
+     */
+    assertNativeOutputSchemaSupported() {
+        if (this.outputEnforcement?.outputFormat === undefined)
+            return;
+        const first = this.reliabilityConfig?.providers?.[0];
+        const provider = first?.provider ?? this.provider;
+        const model = first?.model ?? this.model;
+        if (provider.carriesNativeOutputSchema === true) {
+            // A configured agent resolves its model at seed; callLLM judges it there.
+            if ((first === undefined && this.runConfigFn !== undefined) ||
+                (0, nativeOutputSchema_js_1.nativeOutputSchemaFor)(provider, model))
+                return;
+            throw new nativeOutputSchema_js_1.UnsupportedNativeOutputError({ provider: provider.name, model });
+        }
+        throw new Error(`Agent: .outputSchema(parser, { strategy: 'native' }) needs a provider that puts a ` +
+            `structured-output format on its wire, and '${provider.name}' does not declare one. ` +
+            `anthropic(), browserAnthropic() and the mock do; the Bedrock and gateway adapters do ` +
+            `not in this release. Use { strategy: 'instruct', retries: N } on this provider — it ` +
+            `works on every wire — or run the native strategy on a provider that declares it.`);
+    }
     createExecutor(runOptions) {
         this.assertDeliverableRoles();
         this.assertForcedToolChoiceSupported();
+        this.assertNativeOutputSchemaSupported();
         const correlationId = runOptions?.correlationId;
         const traceId = runOptions?.traceId ?? runOptions?.env?.traceId;
         const sessionId = runOptions?.sessionId;
@@ -4646,6 +4694,10 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             ...(this.outputEnforcement?.schemaTool !== undefined && {
                 schemaTool: this.outputEnforcement.schemaTool,
             }),
+            // The structured-output format, under `strategy: 'native'` only.
+            ...(this.outputEnforcement?.outputFormat !== undefined && {
+                outputFormat: this.outputEnforcement.outputFormat,
+            }),
             ...(this.thinkingBudget !== undefined && { thinkingBudget: this.thinkingBudget }),
             // Only a configured agent reads `scope.resolvedModel` — see the dep's
             // JSDoc for why this is a build-time flag and not a runtime fallback.
@@ -4777,7 +4829,7 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         answerArmed ? true : undefined);
         const routeDecider = this.answerValidationConfig === undefined
             ? baseRouteDecider
-            : (0, answerValidation_js_1.withAnswerValidation)(baseRouteDecider, this.answerValidationConfig, this.outputSchemaParser, artifactStore, () => this.consentOutstanding.size > 0);
+            : (0, answerValidation_js_1.withAnswerValidation)(baseRouteDecider, this.answerValidationConfig, this.outputSchemaParser, artifactStore, () => this.consentOutstanding.size > 0, this.outputEnforcement?.outputFormat !== undefined);
         // `.limitsTravelWithTheAnswer()` on a TYPED answer — decided once, here.
         // An output schema makes the answer JSON, and the appended block would
         // make it JSON followed by prose, which `runTyped()` cannot parse. So the