@hue-run/sdk 0.20.1 → 0.20.3

package/dist/evals/simulation.d.ts

@@ -4,6 +4,7 @@ import type { EnvironmentTool } from "../world/tools.js";
 import type { EnvironmentIdentity, PublishableEnvironmentDefinition, WorldHandoff } from "../world/types.js";
 import { type EvaluationClient } from "./client.js";
 import type { ActualAgentManifestInputV2, AttemptConnectionBundleV2, RequestedAttemptProviderV2 } from "./attempt.js";
+import { type EnvironmentTargetContext } from "./environment-target.js";
 import { type RunnerReport, type TelemetryNotAccepted } from "./runner.js";
 import type { ExperimentCase, Identity, JsonValue, LocalFile, LocalScorer, ScorerDefinition, SimulationMcpCapability, TargetResult } from "./types.js";
 /** Repository-authored scorer identity and its public definition or local binding. */
@@ -222,6 +223,9 @@ export interface SimulationReport extends RunnerReport {
  * @deprecated Use {@link SimulationDefinition}.
  */
 export type SimulationScenario = SimulationDefinition;
+/** The candidate-visible context of a world case, cloned from the environment target's: the
+ * frozen case's identity alone, never its expected outcome, metadata or source pins. */
+export declare function simulationTargetContext(context: EnvironmentTargetContext): SimulationTargetContext;
 /** Run an existing agent callback against one fresh hosted world per case. The helper
  * owns immutable resolution, execution linkage, finalization, scoring and resumable uploads.
  */

package/dist/evals/simulation.js

@@ -344,6 +344,29 @@ async function resolveExperiment(options, definition, idempotencyKey) {
     };
 }
 let scenarioDeprecationWarned = false;
+/** The candidate-visible context of a world case, cloned from the environment target's: the
+ * frozen case's identity alone, never its expected outcome, metadata or source pins. */
+export function simulationTargetContext(context) {
+    return {
+        config: structuredClone(context.config),
+        item: { id: context.item.id, externalKey: context.item.externalKey },
+        executionId: context.executionId,
+        environmentRunId: context.environmentRunId,
+        tools: context.tools,
+        ...(context.world ? { world: structuredClone(context.world) } : {}),
+        ...(context.mcp
+            ? {
+                mcp: { url: context.mcp.url, token: context.mcp.token, expiresAt: context.mcp.expiresAt },
+            }
+            : {}),
+        ...(context.connectionBundle
+            ? { connectionBundle: structuredClone(context.connectionBundle) }
+            : {}),
+        files: structuredClone(context.files),
+        outputDirectory: context.outputDirectory,
+        signal: context.signal,
+    };
+}
 /** Run an existing agent callback against one fresh hosted world per case. The helper
  * owns immutable resolution, execution linkage, finalization, scoring and resumable uploads.
  */
@@ -462,32 +485,7 @@ export async function runSimulation(options) {
                     executionId: context.executionId,
                     caseId: context.item.id,
                 }),
-                target: (targetInputs, targetContext) => options.target(structuredClone(targetInputs), {
-                    config: structuredClone(targetContext.config),
-                    item: {
-                        id: targetContext.item.id,
-                        externalKey: targetContext.item.externalKey,
-                    },
-                    executionId: targetContext.executionId,
-                    environmentRunId: targetContext.environmentRunId,
-                    tools: targetContext.tools,
-                    ...(targetContext.world ? { world: structuredClone(targetContext.world) } : {}),
-                    ...(targetContext.mcp
-                        ? {
-                            mcp: {
-                                url: targetContext.mcp.url,
-                                token: targetContext.mcp.token,
-                                expiresAt: targetContext.mcp.expiresAt,
-                            },
-                        }
-                        : {}),
-                    ...(targetContext.connectionBundle
-                        ? { connectionBundle: structuredClone(targetContext.connectionBundle) }
-                        : {}),
-                    files: structuredClone(targetContext.files),
-                    outputDirectory: targetContext.outputDirectory,
-                    signal: targetContext.signal,
-                }),
+                target: (targetInputs, targetContext) => options.target(structuredClone(targetInputs), simulationTargetContext(targetContext)),
             }),
         });
         const complete = { ...report, experimentId, runUrl };

package/dist/setup/cli.js

@@ -32,6 +32,10 @@ const extensions = new Map([
         "listen",
         async () => (await loadCommand("listen", () => import("../cli/listen.js"))).runListenCommand(process.argv.slice(3)),
     ],
+    [
+        "traces",
+        async () => (await loadCommand("traces", () => import("../cli/traces-import.js"))).runTracesCommand(process.argv.slice(3)),
+    ],
 ]);
 function writeEvent(event, mode, width) {
     const line = mode === "jsonl"
@@ -74,7 +78,7 @@ async function main() {
     }
     catch {
         if (!agentRequested) {
-            process.stderr.write("Usage: hue <setup|resume|status|claim|login|eval|mcp|listen|import> [--agent|--format human|plain|jsonl] [--project PATH] [--origin URL] [--restart]\n");
+            process.stderr.write("Usage: hue <setup|resume|status|claim|login|eval|mcp|listen|import|traces> [--agent|--format human|plain|jsonl] [--project PATH] [--origin URL] [--restart]\n");
             return 2;
         }
         const event = {
@@ -105,7 +109,7 @@ async function main() {
             process.stdout.write(`${renderJsonlEvent(event)}\n`);
             return 2;
         }
-        process.stdout.write("Usage: hue <setup|resume|status|claim|login|eval|mcp|listen|import> [--agent|--format human|plain|jsonl] [--project PATH] [--origin URL] [--restart]\n");
+        process.stdout.write("Usage: hue <setup|resume|status|claim|login|eval|mcp|listen|import|traces> [--agent|--format human|plain|jsonl] [--project PATH] [--origin URL] [--restart]\n");
         return 0;
     }
     const command = parsed.positionals[0];
@@ -137,7 +141,7 @@ async function main() {
             process.stdout.write(`${renderJsonlEvent(event)}\n`);
         }
         else
-            process.stderr.write("Usage: hue <setup|resume|status|claim|login|eval|mcp|listen|import> [--agent|--format human|plain|jsonl] [--project PATH] [--origin URL] [--restart]\n");
+            process.stderr.write("Usage: hue <setup|resume|status|claim|login|eval|mcp|listen|import|traces> [--agent|--format human|plain|jsonl] [--project PATH] [--origin URL] [--restart]\n");
         return 2;
     }
     const mode = selectSetupOutputMode({

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.20.1";
+export declare const sdkVersion = "0.20.3";

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.20.1";
+export const sdkVersion = "0.20.3";

package/dist/world/world.d.ts

@@ -16,8 +16,9 @@ export declare function worldNow(source?: WorldHandoff | Record<string, string |
 /** Variables that authenticate against Hue's control plane rather than a simulated provider. */
 export declare const HUE_CONTROL_PLANE_VARIABLES: readonly string[];
 /** Prefixes of the Hue control-plane credentials the server issues: project and setup keys,
- * attempt grants, the project MCP key, invocation and installation tokens, and OAuth tokens and
- * secrets. World tokens (`hue_world_`) and MCP capabilities (`hue_sim_`) are what the agent holds. */
+ * attempt grants, the project MCP key, invocation and installation tokens, OAuth tokens, trace
+ * import authorizations and secrets. World tokens (`hue_world_`) and MCP capabilities
+ * (`hue_sim_`) are what the agent holds. */
 export declare const HUE_CONTROL_PLANE_CREDENTIAL_PREFIXES: readonly string[];
 /** True for a control-plane variable by name, or for a value carrying a Hue control-plane
  * credential anywhere in it, including wrapped, percent-encoded or JSON-Unicode-escaped values. */

package/dist/world/world.js

@@ -53,8 +53,9 @@ export const HUE_CONTROL_PLANE_VARIABLES = [
     "HUE_SERVICE_KEY",
 ];
 /** Prefixes of the Hue control-plane credentials the server issues: project and setup keys,
- * attempt grants, the project MCP key, invocation and installation tokens, and OAuth tokens and
- * secrets. World tokens (`hue_world_`) and MCP capabilities (`hue_sim_`) are what the agent holds. */
+ * attempt grants, the project MCP key, invocation and installation tokens, OAuth tokens, trace
+ * import authorizations and secrets. World tokens (`hue_world_`) and MCP capabilities
+ * (`hue_sim_`) are what the agent holds. */
 export const HUE_CONTROL_PLANE_CREDENTIAL_PREFIXES = [
     "hue_sk_",
     "hue_attempt_",
@@ -64,6 +65,7 @@ export const HUE_CONTROL_PLANE_CREDENTIAL_PREFIXES = [
     "hue_install_",
     "hue_at_",
     "hue_rt_",
+    "hue_it_",
     "hue_oauth_",
 ];
 /** A Hue credential anywhere in a value, including JSON Unicode escapes, not inside a longer word. */

package/package.json

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