@hue-run/sdk 0.13.1 → 0.14.0

package/CLI.md

@@ -42,7 +42,7 @@ project manifest are refused because managers can update ancestor locks; Python
 The generated `hue.setup.mjs` or `hue_setup.py` always selects `captureContent: false` /
 `capture_content=False`. For a supported application, setup installs the dependency and adds the
 managed import and middleware registration to the existing entrypoint; an unreferenced helper is
-not a completed integration. TypeScript uses `@hue-run/sdk@0.13.1`, `@opentelemetry/api@1.9.1` and
+not a completed integration. TypeScript uses `@hue-run/sdk@0.14.0`, `@opentelemetry/api@1.9.1` and
 `@opentelemetry/context-async-hooks@2.11.0`; Python setup uses its separately tested package pin.
 Content capture requires an ordinary account-managed key and a later explicit application decision.
 
@@ -469,7 +469,7 @@ node packages/sdk-typescript/scripts/verify-package.mjs --artifacts-dir .artifac
 # Set project to an existing supported fixture; use the same directory on resume.
 project=/absolute/path/to/supported-fixture
 node packages/sdk-typescript/scripts/verify-setup-live.mjs \
-  --archive .artifacts/typescript/hue-run-sdk-0.13.1.tgz \
+  --archive .artifacts/typescript/hue-run-sdk-0.14.0.tgz \
   --origin https://STAGING_ORIGIN \
   --project "$project" --command setup \
   --evidence .context/setup-staging-before-claim.json
@@ -480,7 +480,7 @@ the private local handoff and finish the real browser claim, then reconcile the
 
 ```sh
 node packages/sdk-typescript/scripts/verify-setup-live.mjs \
-  --archive .artifacts/typescript/hue-run-sdk-0.13.1.tgz \
+  --archive .artifacts/typescript/hue-run-sdk-0.14.0.tgz \
   --origin https://STAGING_ORIGIN \
   --project "$project" --command claim \
   --evidence .context/setup-staging-after-claim.json
@@ -523,10 +523,10 @@ production agent lacks. Pin the SDK and bring its `zod` peer along, so the agent
 gains no dependency:
 
 ```sh
-npx --yes --package @hue-run/sdk@0.13.1 --package "zod@^4.6.5" hue eval --case "Refund an eligible charge" --command "node agent.js" --env-file .env.hue
-npx --yes --package @hue-run/sdk@0.13.1 --package "zod@^4.6.5" hue eval --case https://app.hue.run/projects/demo/scenarios/<id> --command "python agent.py" --timeout 120 --baseline <experiment id>
-npx --yes --package @hue-run/sdk@0.13.1 --package "zod@^4.6.5" hue eval --set "Billing regressions" --scorer-version <id> --command "node agent.js" --save-version
-npx --yes --package @hue-run/sdk@0.13.1 --package "zod@^4.6.5" hue eval --worker --command "node agent.js" --agent-key support-agent --env-file .env.hue
+npx --yes --package @hue-run/sdk@0.14.0 --package "zod@^4.6.5" hue eval --case "Refund an eligible charge" --command "node agent.js" --env-file .env.hue
+npx --yes --package @hue-run/sdk@0.14.0 --package "zod@^4.6.5" hue eval --case https://app.hue.run/projects/demo/scenarios/<id> --command "python agent.py" --timeout 120 --baseline <experiment id>
+npx --yes --package @hue-run/sdk@0.14.0 --package "zod@^4.6.5" hue eval --set "Billing regressions" --scorer-version <id> --command "node agent.js" --save-version
+npx --yes --package @hue-run/sdk@0.14.0 --package "zod@^4.6.5" hue eval --worker --command "node agent.js" --agent-key support-agent --revision <new-agent-revision> --env-file .env.hue
 ```
 
 Without the second `--package`, `hue eval` exits with `hue eval needs zod`, even for `--help`;
@@ -562,7 +562,7 @@ export default function runMyAgent(inputs: JsonValue, context: SimulationTargetC
 ```
 
 ```sh
-npx --yes --package @hue-run/sdk@0.13.1 --package "zod@^4.6.5" hue eval --case "Refund an eligible charge" ./hue-agent.ts --content --env-file .env.hue
+npx --yes --package @hue-run/sdk@0.14.0 --package "zod@^4.6.5" hue eval --case "Refund an eligible charge" ./hue-agent.ts --content --env-file .env.hue
 ```
 
 `--scenario` remains an alias for `--case` for existing scripts. Pass one selection flag.
@@ -581,9 +581,11 @@ Failing cases print the scorer explanation. An evaluator Hue records as not appl
 that case's columns and neither passes nor fails it, so in a mixed eval set a case is decided by
 the evaluators that apply to it; the pass line counts the not-applicable results. A case that no
 pinned evaluator applies to is an error that names what they need. A result of a pinned Hue judge
-(an evaluator of kind `world_judge`) that Hue marks advisory, as it does every judge's today, is
+(an evaluator of kind `world_judge`) that Hue marks advisory is
 shown in its column, marked `(advisory)`, but never decides a case or the exit code; the pass line
-counts advisory failures as not counted, and a case only advisory results ran for is an error. Any
+counts advisory failures as not counted, and a case only advisory results ran for is an error.
+The Answer outcome evaluator uses its required judge to decide answer-only cases; if that judge
+cannot run, the case is inconclusive. Any
 other evaluator's result, an error, or a metric that carries `passed` is never advisory, whatever
 its evidence says. A metric name that
 several evaluators report, such as two judges' `verdict`, gets a column per evaluator, labelled
@@ -629,8 +631,21 @@ script name; `--revision` is sent to Hue as the agent revision of every world.
 
 `--worker` registers the adapter through `runLocalAgent()` with key `--agent-key` (default: the
 adapter filename slug), name `--agent-name` (default: the key), revision `--revision` (default:
-`AGENT_REVISION`, then the Git `HEAD` short hash, then `dev`) and capability `environment:v1`
-plus any repeated `--capability <value>`, prints the registration and each claimed run with its
+`AGENT_REVISION`, then the Git `HEAD` short hash, then `dev`). Command workers register both
+`environment:v1` and `direct:v1`, plus any repeated `--capability <value>`: the same worker runs
+world cases, answer-only cases and mixed eval sets launched from Hue. Commands keep the launch
+directory for both case kinds, so relative application entry points and configuration work.
+Direct cases receive the task/config on stdin and private files/output through `HUE_CASE_*`,
+without a world token, MCP connection or `HUE_ENVIRONMENT_RUN_ID`. App calls that require a world
+must stay disabled for this handoff; never fall back to live app credentials.
+
+Adapter-file workers register `environment:v1` by default. Add `--capability direct:v1` only when
+the adapter also handles `context.mode === "direct"`; its direct context carries `config`, case
+identity, `executionId`, `files`, `outputDirectory` and `signal`, with no world or tools. These
+worker behaviors are added in TypeScript 0.13.2. Upgrading an existing command worker requires a
+new `--revision`, because adding a capability to a previously registered revision is refused.
+
+The worker prints the registration and each claimed run with its
 URL, executes runs launched from Hue until Ctrl+C or `--max-runs <n>`, and prints the verdict table
 after each run. Selection flags do not apply; Hue chooses the pinned experiment. The worker exits 0
 when it stops normally. Hue offers a case whose world comes with agent-visible files only to a
@@ -652,21 +667,21 @@ A Scenario or eval set whose dataset version is not saved cannot back an experim
 exits 1 and asks for **Save eval-set version** in Hue or `--save-version`, which freezes that
 version at its current revision. Connection settings are `HUE_API_KEY` and `HUE_BASE_URL`
 (default `https://app.hue.run`), loaded from `--env-file <path>` (or its alias `--env-path`) first when given; `--origin`
-overrides the origin. Telemetry content capture stays off unless `--content` is passed; the
-examples pass it so the run's case spans carry content. Model and tool spans inside the agent come
+overrides the origin. Starting with TypeScript 0.14.0, telemetry content capture defaults on; `--no-content` opts out.
+Earlier releases require `--content`; the examples include it for compatibility. Model and tool spans inside the agent come
 only from the agent's own instrumentation. Case outputs, error messages and explanations are
-stored in Hue whether or not `--content` is passed, so a case's answer can be graded and read on
+stored in Hue independently of the telemetry capture setting, so a case's answer can be graded and read on
 its run page. A `--command`'s stdout is its answer unless it writes a result file, and is stored,
 so it must not print credentials or debug logs there; before storing, `hue eval` replaces the
 credentials it handed the case (the world token and MCP headers, a legacy MCP token, attempt
 bearers) and every Hue control-plane credential in its environment with `[redacted]`, in the
 answer, an adapter's thrown message and name, generated file names and the local checkpoint.
 `--no-output` keeps outputs, error messages and explanations out of a one-shot run's stored
-results; with `--content` the case span still carries the output. `--worker` always stores them, because a run launched from Hue is read
+results; captured telemetry still carries the output. Pass `--no-output --no-content` to omit both. `--worker` always stores them, because a run launched from Hue is read
 on its run page (that is `runLocalAgent()`'s contract), and refuses `--no-output`. An interrupted
 one-shot run keeps the choice it started with, so one run never mixes stored and unstored outputs:
-rerunning it with other `--no-output` or `--content` flags is refused with the flags it started
-with. Resume a run that an earlier SDK started without `--content` by passing `--no-output`.
+rerunning it with another output or telemetry capture policy is refused with the flags that resume it.
+To resume a metadata-only trace from an earlier release, add `--no-content` and keep its original `--no-output` choice.
 
 Files the agent writes to `output/` are uploaded as generated documents with or without
 `--no-output`, and they are not redacted the way the answer is: `hue eval` replaces the same

package/EVALUATIONS.md

@@ -297,12 +297,19 @@ acceptance remains a post-publication Fern gate.
 
 ## Direct cases and files
 
-Cases without a simulated world — document workflows whose inputs are a task plus pinned files —
+Cases without a simulated world — answer-only tasks, or document workflows with pinned files —
 run on the same runner under the same checkpoint rules. They shipped in `@hue-run/sdk` `0.5.0`
 and require a Hue deployment that serves case `inputFiles` on experiment
 items, subject `files`, and the artifact reservation, upload, completion and download APIs. The
 Python SDK has no equivalent.
 
+Since TypeScript 0.13.2, the `hue eval --worker --command "…"` wrapper supplies both callbacks, so one
+command worker accepts direct and world cases, including mixed eval sets. It keeps the launch
+directory for relative application entry points; private case inputs/output still use
+`HUE_CASE_*`. An adapter-file worker opts into the direct callback with `--capability direct:v1`
+and must handle `context.mode === "direct"`. Restart an existing environment-only command
+registration with a new `--revision` when upgrading.
+
 On the outbound worker, supply `directTarget` beside or instead of `target`. Supplying
 `directTarget` registers the `direct:v1` capability and supplying `target` registers
 `environment:v1` (both strings are exported as `localAgentCapabilities`). Declare the file

package/README.md

@@ -35,7 +35,7 @@ import { createHue, HueExportError } from "@hue-run/sdk";
 const hue = createHue({
   apiKey: process.env.HUE_API_KEY!, // a project service key, on the server only
   serviceName: "my-agent",
-  captureContent: true, // required: true records content; false sends metadata only
+  captureContent: true, // Also works with older releases; false sends metadata only
   onExportIssue: (issue) => console.error(issue), // sanitized counts, never server bodies
 });
 
@@ -57,7 +57,7 @@ try {
 await hue.shutdown(); // flushes and releases providers owned by this client
 ```
 
-`captureContent` is required. The example sets `true`, the recommended choice: trace inspection,
+Starting with TypeScript 0.14.0, `captureContent` defaults to `true`. Earlier releases require an explicit choice. The example sets `true`: trace inspection,
 evaluations and judges read the prompts, responses and tool inputs/outputs it records. Choose
 `false` for metadata only when a policy forbids sending that content; see
 [Privacy and content](#privacy-and-content).
@@ -647,11 +647,13 @@ their agents with `runLocalAgent()`; setup does not register workers or launch s
 The `hue eval` command, shipped in TypeScript `0.5.0` (`--case` since `0.6.0`, `--scenario`
 before), wraps `runSimulation()` and `runLocalAgent()` for an adapter file or a shell command:
 `hue eval --case "<name>" ./hue-agent.ts --content` creates a fresh run from a published case's
-immutable pins, runs the agent in one isolated world per case, waits
+immutable pins, runs the agent with an isolated world when the case pins one, waits
 for Hue's outcome checks and prints the run URL and per-case PASS/FAIL verdicts with an exit code;
-`--worker` registers the same adapter for runs launched from Hue. It needs a Read and
-write key in `HUE_API_KEY` (never printed). Content capture stays off unless `--content` is
-passed; the example passes it so case spans carry content. Case outputs, error messages and
+`--worker` registers the same adapter for runs launched from Hue. Since TypeScript 0.13.2, a
+command worker handles both world and answer-only cases; adapter workers opt into direct cases
+with `--capability direct:v1`. Upgrade an existing command registration under a new `--revision`.
+It needs a Read and write key in `HUE_API_KEY` (never printed). Content capture defaults on; `--no-content` opts out. The example passes `--content` explicitly
+for compatibility with older releases. Case outputs, error messages and
 explanations are stored in Hue either way (`--no-output` keeps them out of a one-shot run's
 results); a command's stdout is its stored answer, with the credentials `hue eval` handed the case
 replaced by `[redacted]`.

package/dist/cli/eval.js

@@ -60,6 +60,8 @@ Agent (exactly one):
 
 Modes:
   --worker                        Register the agent and poll for runs launched from Hue
+                                  Commands support cases with or without a world; adapter files
+                                  opt into direct cases with --capability direct:v1
   --max-runs <n>                  Stop the worker after n completed runs
   --agent-key <key>               Agent key (default: slug of the adapter filename)
   --agent-name <name>             Agent display name (default: the key)
@@ -76,7 +78,8 @@ Output and limits:
   --name <run name>               Run name (default: <agent key> @ <revision>, hashes shortened)
   --baseline <experiment id|url>  Compare verdicts with a previous experiment
   --json                          Print one JSON document on stdout; progress goes to stderr
-  --content                       Capture telemetry content (span inputs, outputs and messages)
+  --content                       Capture telemetry content (the default)
+  --no-content                    Omit telemetry inputs, outputs and messages
   --no-output                     One-shot: do not store case outputs, error messages and
                                   explanations (stored by default; --worker always stores); with
                                   --content the case span still carries the output
@@ -139,7 +142,8 @@ function parse(argv) {
                 name: { type: "string" },
                 baseline: { type: "string" },
                 json: { type: "boolean", default: false },
-                content: { type: "boolean", default: false },
+                content: { type: "boolean" },
+                "no-content": { type: "boolean", default: false },
                 "no-output": { type: "boolean", default: false },
                 "trace-not-accepted": { type: "string" },
                 "save-version": { type: "boolean", default: false },
@@ -600,9 +604,11 @@ function redacting(adapter) {
 function parentEnvironment(allowHueCredentials) {
     // A world variable left in this process's environment belongs to another world: only the
     // current case's world sets them, whether or not the case has one.
-    return withoutWorldVariables(allowHueCredentials
+    const parent = withoutWorldVariables(allowHueCredentials
         ? Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined))
         : stripHueControlPlaneCredentials(process.env));
+    delete parent.HUE_ENVIRONMENT_RUN_ID;
+    return parent;
 }
 function commandAdapter(command, timeoutSeconds, options) {
     return async (inputs, context) => {
@@ -683,7 +689,7 @@ function directCommandAdapter(command, timeoutSeconds, options) {
             files: context.files,
         });
         const stdout = await spawnAgentCommand(command, {
-            cwd: layout.caseDirectory,
+            cwd: options.workingDirectory ?? layout.caseDirectory,
             env: {
                 ...parentEnvironment(options.allowHueCredentials),
                 HUE_CASE_DIR: layout.caseDirectory,
@@ -813,9 +819,9 @@ export function explain(error) {
     if (error instanceof CheckpointIdentityError && error.startedWith) {
         const flags = [
             error.startedWith.persistResultContent === false ? "--no-output" : "",
-            error.startedWith.captureContent === true ? "--content" : "",
+            error.startedWith.captureContent === false ? "--no-content" : "",
         ].filter(Boolean);
-        return `This unfinished run was started ${flags.length ? `with ${flags.join(" and ")}` : "without --no-output or --content"}; rerun with the same flags to resume it, or remove its checkpoint directory to start over`;
+        return `This unfinished run was started ${flags.length ? `with ${flags.join(" and ")}` : "without --no-output or --no-content"}; rerun with the same flags to resume it, or remove its checkpoint directory to start over`;
     }
     // The error's own message points at an in-memory report the user cannot reach.
     if (error instanceof HueExportError)
@@ -1286,7 +1292,7 @@ async function runDirect(run, connection) {
         telemetryNotAccepted: report.telemetryNotAccepted,
     }, run.baselineId, output, signal);
 }
-async function runWorker(values, connection, adapter, agent, hue, output, signal) {
+async function runWorker(values, connection, agents, agent, hue, output, signal) {
     const client = new ObservedClient(connection);
     const environmentClient = createEnvironmentClient(connection);
     const wait = integer("wait", values.wait, 300, 0, 86_400);
@@ -1305,6 +1311,9 @@ async function runWorker(values, connection, adapter, agent, hue, output, signal
         output.log(`Claimed run ${claim.runId}: ${new URL(`/experiments/${claim.experimentId}`, connection.baseUrl).toString()}`);
     };
     const telemetry = telemetryReporter(output);
+    // A command can use the same stdin contract for both case kinds. Existing adapter files
+    // may require a world, so their direct context remains an explicit capability opt-in.
+    const direct = values.command !== undefined || values.capability?.includes("direct:v1");
     await runLocalAgent({
         client,
         environmentClient,
@@ -1339,7 +1348,7 @@ async function runWorker(values, connection, adapter, agent, hue, output, signal
         },
         target(inputs, tools, context) {
             output.log(`[${context.item.externalKey}] agent started`);
-            return adapter(inputs, {
+            return agents.simulation(inputs, {
                 config: context.config,
                 item: context.item,
                 executionId: context.executionId,
@@ -1355,6 +1364,22 @@ async function runWorker(values, connection, adapter, agent, hue, output, signal
                 signal: context.signal ?? signal,
             });
         },
+        ...(direct
+            ? {
+                directTarget(inputs, context) {
+                    output.log(`[${context.item.externalKey}] agent started`);
+                    return agents.direct(inputs, {
+                        mode: "direct",
+                        config: context.config,
+                        item: context.item,
+                        executionId: context.executionId,
+                        files: context.files,
+                        outputDirectory: context.outputDirectory,
+                        signal: context.signal ?? signal,
+                    });
+                },
+            }
+            : {}),
         async onCompleted(report) {
             output.log(`Run ${report.runId} completed: ${report.subjectIds.length} case${report.subjectIds.length === 1 ? "" : "s"}`);
             telemetry.rest(report.telemetryNotAccepted);
@@ -1423,6 +1448,8 @@ export async function runEvalCommand(argv) {
     let json = false;
     try {
         const { values, positionals } = parse(argv);
+        if (values.content && values["no-content"])
+            throw new UsageError("Choose either --content or --no-content");
         // A usage error before anything is prepared or created: no run is left to recover from it.
         traceNotAcceptedPolicy(values["trace-not-accepted"]);
         json = values.json;
@@ -1490,17 +1517,20 @@ export async function runEvalCommand(argv) {
             direct: redacting(loaded ??
                 directCommandAdapter(values.command, timeout, {
                     allowHueCredentials: values["allow-hue-credentials"],
+                    // A worker's single command must resolve relative entry points the same way for
+                    // direct and world cases. One-shot direct runs keep their private-directory cwd.
+                    ...(values.worker ? { workingDirectory: process.cwd() } : {}),
                 })),
         };
         hue = createHue({
             apiKey,
             baseUrl,
             serviceName: key,
-            captureContent: values.content,
+            captureContent: values.content ?? !values["no-content"],
             timeoutMillis: CASE_TRACE_EXPORT_MILLIS,
         });
         return values.worker
-            ? await runWorker(values, connection, agents.simulation, agent, hue, output, controller.signal)
+            ? await runWorker(values, connection, agents, agent, hue, output, controller.signal)
             : await runOnce(values, connection, agents, agent, hue, output, controller.signal);
     }
     catch (error) {

package/dist/config.js

@@ -37,8 +37,8 @@ export function validateOptions(options) {
             liveSpans: false,
         };
     }
-    if (typeof options.captureContent !== "boolean")
-        throw new TypeError("Choose captureContent explicitly: true or false");
+    if (options.captureContent !== undefined && typeof options.captureContent !== "boolean")
+        throw new TypeError("captureContent must be a boolean");
     if (typeof options.apiKey !== "string" ||
         !options.apiKey ||
         options.apiKey.length > 4096 ||
@@ -83,5 +83,12 @@ export function validateOptions(options) {
         throw new TypeError("liveSpans must be a boolean");
     // Setup credentials send installer telemetry only, never in-progress placeholders.
     const liveSpans = options.liveSpans !== false && !options.apiKey.startsWith("hue_setup_");
-    return { ...options, baseUrl: url.origin, timeoutMillis, maxQueueBytes, liveSpans };
+    return {
+        ...options,
+        captureContent: options.captureContent ?? true,
+        baseUrl: url.origin,
+        timeoutMillis,
+        maxQueueBytes,
+        liveSpans,
+    };
 }

package/dist/evals/client.d.ts

@@ -110,7 +110,7 @@ export declare class EvaluationClient {
     createScorer(input: TaggedIdentity): Promise<Scorer>;
     /** Renames a scorer or replaces its tags by name; the same values again change nothing. */
     updateScorer(id: string, input: IdentityUpdate): Promise<Scorer>;
-    /** Lists the project's tags in the order they were created. */
+    /** Lists the project's tags in its order: as people arranged them in Hue, then newer tags. */
     listTags(): Promise<{
         /** The project's tags. */
         items: Tag[];

package/dist/evals/client.js

@@ -451,7 +451,7 @@ export class EvaluationClient {
     updateScorer(id, input) {
         return this.request("PATCH", `/scorers/${uuid(id)}`, withTagNames(input), undefined, undefined, true);
     }
-    /** Lists the project's tags in the order they were created. */
+    /** Lists the project's tags in its order: as people arranged them in Hue, then newer tags. */
     listTags() {
         return this.request("GET", "/tags");
     }

package/dist/evals/scorer-publication.js

@@ -142,12 +142,17 @@ const sdkScorerPublication = z.union([
     }),
     z.strictObject({
         kind: z.literal("world_outcome"),
-        entry: z.literal("hue.outcome_assertions.v2"),
+        entry: z.enum([
+            "hue.outcome_assertions.v2",
+            "hue.outcome_assertions.v4",
+            "hue.outcome_assertions.v5",
+            "hue.outcome_assertions.v6",
+        ]),
         metrics: fixedMetrics(outcomeAssertionMetrics),
     }),
     z.strictObject({
         kind: z.literal("world_outcome"),
-        entry: z.literal("hue.outcome_assertions.v3"),
+        entry: z.enum(["hue.outcome_assertions.v3", "hue.answer_outcome.v1", "hue.answer_outcome.v2"]),
         metrics: fixedMetrics(outcomeAssertionV3Metrics),
         config: z.strictObject({ judge: outcomeJudgeConfig }),
     }),

package/dist/evals/types.d.ts

@@ -275,6 +275,25 @@ export type ScorerDefinition = {
         /** The judge every case scored by this version uses. */
         judge: OutcomeJudgeConfig;
     };
+} | {
+    /** A case's reviewed assertions, scored inside Hue from gateway evidence. */
+    kind: "world_outcome";
+    /** Versioned gateway-ledger assertion semantics. */
+    entry: "hue.outcome_assertions.v4" | "hue.outcome_assertions.v5" | "hue.outcome_assertions.v6";
+    /** `task_success` and the fixed assertion counts defined by the entry. */
+    metrics: MetricDefinition[];
+} | {
+    /** An answer-only case, scored inside Hue without world evidence. */
+    kind: "world_outcome";
+    /** Versioned answer semantics; the pinned judge is required to decide the case. */
+    entry: "hue.answer_outcome.v1" | "hue.answer_outcome.v2";
+    /** The assertion and judge counts defined by the entry. */
+    metrics: MetricDefinition[];
+    /** The judge pin used to score the answer. */
+    config: {
+        /** The required judge every case scored by this version uses. */
+        judge: OutcomeJudgeConfig;
+    };
 } | {
     /** Scored by a person in Hue; the local runner defers it. */
     kind: "manual";

package/dist/types.d.ts

@@ -13,10 +13,11 @@ export type Signal = "traces" | "logs";
 /** Options accepted by every Hue client and transport, whether enabled or disabled. */
 export interface SharedHueOptions {
     /**
-     * Whether helpers record prompts, responses, tool arguments and results. Required for an enabled
-     * client, with no default; a disabled client (`enabled: false`) defaults it to `false`.
+     * Whether helpers record prompts, responses, tool arguments and results. Defaults to `true`
+     * for an enabled client; set `false` explicitly for metadata-only export. A disabled client
+     * (`enabled: false`) exports nothing and defaults it to `false`.
      */
-    captureContent: boolean;
+    captureContent?: boolean;
     /** Hue origin, `https://app.hue.run` by default. An origin only: no path, query, fragment or credentials. */
     baseUrl?: string;
     /** Recorded as the `service.version` resource attribute of an owned client. */
@@ -52,7 +53,8 @@ export interface SharedHueOptions {
 }
 /**
  * Options for a client that owns its OpenTelemetry providers. An enabled client needs a project
- * key, a service name and an explicit `captureContent` choice. The kill switch (`enabled: false`)
+ * key and a service name. Content capture defaults to `true`; `captureContent: false` opts out.
+ * The kill switch (`enabled: false`)
  * exports nothing while helpers keep running application code, so it needs no key and
  * `captureContent` defaults to `false`.
  */

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Package version shared by the instrumentation scope and the export User-Agent. */
-export declare const sdkVersion = "0.13.1";
+export declare const sdkVersion = "0.14.0";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Generated by scripts/write-version.mjs from package.json; do not edit by hand.
 /** Package version shared by the instrumentation scope and the export User-Agent. */
-export const sdkVersion = "0.13.1";
+export const sdkVersion = "0.14.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hue-run/sdk",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "private": false,
   "license": "MIT",
   "publishConfig": {