@withgateway/sdk 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +5 -1
  2. package/dist/cli.js +1497 -712
  3. package/dist/cli.js.map +1 -1
  4. package/dist/cli.mjs +1500 -715
  5. package/dist/cli.mjs.map +1 -1
  6. package/dist/files/index.js +34 -0
  7. package/dist/files/index.js.map +1 -1
  8. package/dist/files/index.mjs +34 -0
  9. package/dist/files/index.mjs.map +1 -1
  10. package/dist/{index-DAb-FCMg.d.ts → index-CBqbB_0J.d.ts} +2 -12
  11. package/dist/{index-D6oi1TWE.d.mts → index-D-AMnAMa.d.mts} +2 -12
  12. package/dist/index.d.mts +3 -3
  13. package/dist/index.d.ts +3 -3
  14. package/dist/index.js +173 -50
  15. package/dist/index.js.map +1 -1
  16. package/dist/index.mjs +171 -50
  17. package/dist/index.mjs.map +1 -1
  18. package/dist/traces/index.js +34 -0
  19. package/dist/traces/index.js.map +1 -1
  20. package/dist/traces/index.mjs +34 -0
  21. package/dist/traces/index.mjs.map +1 -1
  22. package/dist/tracing/index.d.mts +1 -1
  23. package/dist/tracing/index.d.ts +1 -1
  24. package/dist/tracing/index.js +39 -20
  25. package/dist/tracing/index.js.map +1 -1
  26. package/dist/tracing/index.mjs +39 -20
  27. package/dist/tracing/index.mjs.map +1 -1
  28. package/dist/worlds/index.d.mts +66 -18
  29. package/dist/worlds/index.d.ts +66 -18
  30. package/dist/worlds/index.js +171 -50
  31. package/dist/worlds/index.js.map +1 -1
  32. package/dist/worlds/index.mjs +171 -50
  33. package/dist/worlds/index.mjs.map +1 -1
  34. package/package.json +1 -1
  35. package/runtime/gatewaysdk/environment/schema/api.py +7 -8
  36. package/runtime/gatewaysdk/environment/schema/cast.py +31 -4
  37. package/runtime/gatewaysdk/environment/schema/platform.py +1 -7
  38. package/runtime/gatewaysdk/environment/schema/skills/connector-schema-authoring/SKILL.md +3 -3
  39. package/runtime/gatewaysdk/environment/schema/skills/world-data-ingestion/SKILL.md +2 -2
  40. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/SKILL.md +6 -6
  41. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/references/cli-mcp-map.md +1 -1
  42. package/skills/connector-schema-authoring/SKILL.md +3 -3
  43. package/skills/connector-schema-authoring/connector-worlds.md +12 -5
  44. package/skills/connector-schema-authoring/world-schema.md +8 -0
  45. package/skills/world-data-ingestion/SKILL.md +2 -2
  46. package/skills/worlds-getting-started/SKILL.md +6 -6
  47. package/skills/worlds-getting-started/references/cli-mcp-map.md +1 -1
@@ -171,15 +171,9 @@ interface TracingState {
171
171
  }
172
172
 
173
173
  /**
174
- * Initialization and lifecycle management for GatewaySDK tracing.
175
- *
176
- * This module provides the core init(), shutdown(), and flush() functions
177
- * for managing the OpenTelemetry TracerProvider lifecycle, plus
178
- * initIsolated() for creating additional self-contained providers (e.g. one
179
- * process exporting different agents to different Gateway projects).
180
- *
181
- * Mirrors the Python SDK's tracing.init() for a consistent developer experience.
174
+ * Check if Gateway is configured via environment variables.
182
175
  */
176
+ declare function isGatewayConfigured(): boolean;
183
177
 
184
178
  /**
185
179
  * Handle to an isolated tracing provider created by initIsolated().
@@ -291,10 +285,6 @@ declare function shutdown(): Promise<void>;
291
285
  * Check if tracing has been initialized.
292
286
  */
293
287
  declare function isInitialized(): boolean;
294
- /**
295
- * Check if Gateway is configured via environment variables.
296
- */
297
- declare function isGatewayConfigured(): boolean;
298
288
 
299
289
  declare const SESSION_ID_ATTRIBUTE = "gateway.session.id";
300
290
  declare const WORLD_SESSION_ID_ATTRIBUTE = "gateway.trace.metadata.world_session_id";
@@ -171,15 +171,9 @@ interface TracingState {
171
171
  }
172
172
 
173
173
  /**
174
- * Initialization and lifecycle management for GatewaySDK tracing.
175
- *
176
- * This module provides the core init(), shutdown(), and flush() functions
177
- * for managing the OpenTelemetry TracerProvider lifecycle, plus
178
- * initIsolated() for creating additional self-contained providers (e.g. one
179
- * process exporting different agents to different Gateway projects).
180
- *
181
- * Mirrors the Python SDK's tracing.init() for a consistent developer experience.
174
+ * Check if Gateway is configured via environment variables.
182
175
  */
176
+ declare function isGatewayConfigured(): boolean;
183
177
 
184
178
  /**
185
179
  * Handle to an isolated tracing provider created by initIsolated().
@@ -291,10 +285,6 @@ declare function shutdown(): Promise<void>;
291
285
  * Check if tracing has been initialized.
292
286
  */
293
287
  declare function isInitialized(): boolean;
294
- /**
295
- * Check if Gateway is configured via environment variables.
296
- */
297
- declare function isGatewayConfigured(): boolean;
298
288
 
299
289
  declare const SESSION_ID_ATTRIBUTE = "gateway.session.id";
300
290
  declare const WORLD_SESSION_ID_ATTRIBUTE = "gateway.trace.metadata.world_session_id";
package/dist/index.d.mts CHANGED
@@ -7,12 +7,12 @@ export { GatewayAgentDescriptor, GatewaySecurity, GatewaySecurityConfig, Gateway
7
7
  export { DEFAULT_TIMEOUT_SECONDS, ENV_GATEWAY_HOST, ENV_GATEWAY_PUBLIC_KEY, ENV_GATEWAY_SECRET_KEY, LoadSessionOptions, SessionLoadError, SessionObservation, SessionRecording, SessionTrace, basicAuthHeader, loadSession, sessionObservationFromApi, sessions } from './sessions/index.mjs';
8
8
  export { UserEvent, UserEventOptions, UserProfile, UserProfileError, UserProfileUpdate, UsersClient, UsersClientConfig, UsersClientFromEnvConfig, users } from './users/index.mjs';
9
9
  export { AGENT_ID_KEY, SUCCESS_METRIC_NAME_KEY, SUCCESS_SIGNAL_KEY, ScoreDataType, ScoreError, ScoreOptions, ScoresClient, ScoresClientConfig, ScoresClientFromEnvConfig, SuccessOptions, currentTraceId, scores, success } from './scores/index.mjs';
10
- export { ACTION_NAMES, ActionArgs, ActionResult, ActionTracer, AiSdkAnthropicOutput, AiSdkComputerCall, AiSdkComputerOutput, AiSdkModelOutput, AnthropicComputer, AnthropicComputer20251124, AnthropicToolResult, ApiError, BROWSER_GONE_PATTERNS, BROWSER_TIERS, BrowserActionEvent, BrowserActionRecorder, BrowserConnection, BrowserMode, BrowserPage, BrowserReconnected, BrowserReconnector, BrowserTier, BrowserUnrecoverable, CALL_BODY_LIMIT_BYTES, CALL_BODY_LIMIT_LABEL, COMPUTER_USE_SPECS, Checkout, CheckoutProvenance, ComputerAction, ComputerCallOutput, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DRY_RUN_AGENT, DRY_RUN_KIND, DetachedPushError, DispatchedRun, Display, DryRunImageDecision, DryRunOutcome, DryRunSettlement, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EXPLORATORY_TASK, EXPLORATORY_TASK_SOURCE, EditSessionCloseInput, EditSessionList, EditSessionListQuery, EditSessionResult, EditSessionRollbackInput, EditSessionSummary, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, HostedDryRunClient, HostedDryRunDispatch, HostedDryRunStatus, HostedDryRunVerdict, IDLE_WARNING_MINUTES, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, KEY_NAMES, KeyChord, ListRunsFilter, ListSessionsFilter, LiveTaskSession, LocalMeta, MigrateWorldOptions, NOT_EXECUTED, NO_GRADER_REASON, NativeComputer, NativeComputerKinds, NativeComputerOptions, NativeComputerProvider, NativePage, ObservationConversion, ObservationLike, OpenAIComputer, OpenAIPreviewComputer, OpenSessionOptions, OpenTaskOptions, ParsedToolCall, PendingSafetyChecks, Plaintext, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RECOVER_BUDGET_MS, RebaseConflictPath, RecoveryResult, RedactMode, RedactPolicy, Redaction, RepairAnswer, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunSetOptions, RunSetResult, RunSummary, RunTaskOptions, RunTaskSummary, SANDBOX_REQUEST_TIMEOUT_MS, SECRET_KEY, SESSION_STATES, SPAN_PREFIX, STATUS_WAIT_CAP_SECONDS, STRIP_PREFIX, SURFACE_KINDS, SafetyCheck, SandboxChanges, SandboxCheckResult, SandboxCommitInput, SandboxCommitResult, SandboxExecResult, SandboxImportInput, SandboxImportPending, SandboxImportResult, SandboxListFilter, SandboxOpenExisting, SandboxOpenNew, SandboxOpenTarget, SandboxOpened, SandboxSummary, Screen, ScreenBrowser, SecretScrubber, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SetRunDoc, SettleOptions, SlugDeclaration, TRANSFORMS, TaskEditClient, TaskEditCloseInput, TaskEditCloseResult, TaskEditRollbackInput, TaskEditRollbackResult, TaskEditSealed, TaskEditStatus, TaskEditTarget, TaskEditTaskRef, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldRef, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, VERIFIER_REWARD_PREFIX, ValidateReport, ValidatedRun, VerifierGrade, WHITESPACE, WorldBrowser, WorldCallTooLarge, WorldDependency, WorldDeprecation, WorldDescription, WorldEditClient, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionListItem, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVerifier, WorldTaskVerifierRow, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, assertBrowserTier, assertTaskRef, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, checkoutIdentity, closeConnection, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, idleWarning, ingest, ingestToolCalls, isBrowserGone, isSandboxImportPending, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listRuns, listSessions, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseErrorBody, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, playwrightKey, preserveForm, propose, pull, push, pushBranch, pushSlug, pyText, queryRows, queryRowsSearch, readField, readLocalMeta, readToolCallRecords, rebaseConflicts, redactActionArgs, redactionOf, releaseConnection, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runSet, runTask, schemaFromSignature, serializeCallBody, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, uncommittedPaths, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.mjs';
10
+ export { ACTION_NAMES, ActionArgs, ActionResult, ActionTracer, AiSdkAnthropicOutput, AiSdkComputerCall, AiSdkComputerOutput, AiSdkModelOutput, AnthropicComputer, AnthropicComputer20251124, AnthropicToolResult, ApiError, BROWSER_GONE_PATTERNS, BROWSER_TIERS, BrowserActionEvent, BrowserActionRecorder, BrowserConnection, BrowserMode, BrowserPage, BrowserReconnected, BrowserReconnector, BrowserTier, BrowserUnrecoverable, CALL_BODY_LIMIT_BYTES, CALL_BODY_LIMIT_LABEL, COMPUTER_USE_SPECS, Checkout, CheckoutProvenance, ComputerAction, ComputerCallOutput, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DRY_RUN_AGENT, DRY_RUN_KIND, DetachedPushError, DispatchedRun, Display, DryRunImageDecision, DryRunOutcome, DryRunSettlement, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EXPLORATORY_TASK, EXPLORATORY_TASK_SOURCE, EditSessionCloseInput, EditSessionList, EditSessionListQuery, EditSessionResult, EditSessionRollbackInput, EditSessionSummary, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, HostedDryRunClient, HostedDryRunDispatch, HostedDryRunStatus, HostedDryRunVerdict, IDLE_WARNING_MINUTES, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, KEY_NAMES, KeyChord, ListRunsFilter, ListSessionsFilter, LiveTaskSession, LocalMeta, MigrateWorldOptions, NOT_EXECUTED, NO_GRADER_REASON, NativeComputer, NativeComputerKinds, NativeComputerOptions, NativeComputerProvider, NativePage, ObservationConversion, ObservationLike, OpenAIComputer, OpenAIPreviewComputer, OpenSessionOptions, OpenTaskOptions, ParsedToolCall, PendingSafetyChecks, Plaintext, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RECOVER_BUDGET_MS, RebaseConflictPath, RecoveryResult, RedactMode, RedactPolicy, Redaction, RepairAnswer, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunSetOptions, RunSetResult, RunSummary, RunTaskOptions, RunTaskSummary, SANDBOX_REQUEST_TIMEOUT_MS, SECRET_KEY, SESSION_STATES, SPAN_PREFIX, STATUS_WAIT_CAP_SECONDS, STRIP_PREFIX, SURFACE_KINDS, SafetyCheck, SandboxChanges, SandboxCheckResult, SandboxCommitInput, SandboxCommitResult, SandboxExecResult, SandboxImportInput, SandboxImportPending, SandboxImportResult, SandboxListFilter, SandboxOpenExisting, SandboxOpenNew, SandboxOpenTarget, SandboxOpened, SandboxSummary, Screen, ScreenBrowser, SecretScrubber, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SetRunDoc, SettleOptions, SlugDeclaration, SurfaceDescriptor, TRANSFORMS, TaskEditClient, TaskEditCloseInput, TaskEditCloseResult, TaskEditRollbackInput, TaskEditRollbackResult, TaskEditSealed, TaskEditStatus, TaskEditTarget, TaskEditTaskRef, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldRef, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, VERIFIER_REWARD_PREFIX, ValidateReport, ValidatedRun, VerifierGrade, WHITESPACE, WorldBrowser, WorldCallTooLarge, WorldDependency, WorldDeprecation, WorldDescription, WorldEditClient, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldRequest, WorldRequestLog, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionListItem, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVerifier, WorldTaskVerifierRow, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, assertBrowserTier, assertTaskRef, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, checkoutIdentity, closeConnection, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, idleWarning, ingest, ingestToolCalls, isBrowserGone, isSandboxImportPending, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listRuns, listSessions, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseErrorBody, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, playwrightKey, preserveForm, propose, pull, push, pushBranch, pushSlug, pyText, queryRows, queryRowsSearch, readField, readLocalMeta, readToolCallRecords, rebaseConflicts, redactActionArgs, redactionOf, releaseConnection, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runSet, runTask, schemaFromSignature, serializeCallBody, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceDescriptor, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, uncommittedPaths, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.mjs';
11
11
  export { i as files } from './index-FfK4Nump.mjs';
12
12
  export { i as traces } from './index-CiKWoroJ.mjs';
13
13
  export { i as hooks } from './index-C3UzD0G3.mjs';
14
- import { _ as _tracingModule } from './index-D6oi1TWE.mjs';
15
- export { I as IdentifyOptions, i as identify, r as resolveUserId } from './index-D6oi1TWE.mjs';
14
+ import { _ as _tracingModule } from './index-D-AMnAMa.mjs';
15
+ export { I as IdentifyOptions, i as identify, r as resolveUserId } from './index-D-AMnAMa.mjs';
16
16
  export { P as PLATFORM_TIMEOUT_DEFAULT_MS, a as PLATFORM_TIMEOUT_ENV, b as PlatformEndpoint, c as PlatformMethod, d as PlatformReply, e as PlatformTransport, T as TransportCause, U as UnreachableError, p as platformTimeoutMs } from './media-CbcAfQvd.mjs';
17
17
  import 'async_hooks';
18
18
  import '@opentelemetry/api';
package/dist/index.d.ts CHANGED
@@ -7,12 +7,12 @@ export { GatewayAgentDescriptor, GatewaySecurity, GatewaySecurityConfig, Gateway
7
7
  export { DEFAULT_TIMEOUT_SECONDS, ENV_GATEWAY_HOST, ENV_GATEWAY_PUBLIC_KEY, ENV_GATEWAY_SECRET_KEY, LoadSessionOptions, SessionLoadError, SessionObservation, SessionRecording, SessionTrace, basicAuthHeader, loadSession, sessionObservationFromApi, sessions } from './sessions/index.js';
8
8
  export { UserEvent, UserEventOptions, UserProfile, UserProfileError, UserProfileUpdate, UsersClient, UsersClientConfig, UsersClientFromEnvConfig, users } from './users/index.js';
9
9
  export { AGENT_ID_KEY, SUCCESS_METRIC_NAME_KEY, SUCCESS_SIGNAL_KEY, ScoreDataType, ScoreError, ScoreOptions, ScoresClient, ScoresClientConfig, ScoresClientFromEnvConfig, SuccessOptions, currentTraceId, scores, success } from './scores/index.js';
10
- export { ACTION_NAMES, ActionArgs, ActionResult, ActionTracer, AiSdkAnthropicOutput, AiSdkComputerCall, AiSdkComputerOutput, AiSdkModelOutput, AnthropicComputer, AnthropicComputer20251124, AnthropicToolResult, ApiError, BROWSER_GONE_PATTERNS, BROWSER_TIERS, BrowserActionEvent, BrowserActionRecorder, BrowserConnection, BrowserMode, BrowserPage, BrowserReconnected, BrowserReconnector, BrowserTier, BrowserUnrecoverable, CALL_BODY_LIMIT_BYTES, CALL_BODY_LIMIT_LABEL, COMPUTER_USE_SPECS, Checkout, CheckoutProvenance, ComputerAction, ComputerCallOutput, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DRY_RUN_AGENT, DRY_RUN_KIND, DetachedPushError, DispatchedRun, Display, DryRunImageDecision, DryRunOutcome, DryRunSettlement, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EXPLORATORY_TASK, EXPLORATORY_TASK_SOURCE, EditSessionCloseInput, EditSessionList, EditSessionListQuery, EditSessionResult, EditSessionRollbackInput, EditSessionSummary, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, HostedDryRunClient, HostedDryRunDispatch, HostedDryRunStatus, HostedDryRunVerdict, IDLE_WARNING_MINUTES, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, KEY_NAMES, KeyChord, ListRunsFilter, ListSessionsFilter, LiveTaskSession, LocalMeta, MigrateWorldOptions, NOT_EXECUTED, NO_GRADER_REASON, NativeComputer, NativeComputerKinds, NativeComputerOptions, NativeComputerProvider, NativePage, ObservationConversion, ObservationLike, OpenAIComputer, OpenAIPreviewComputer, OpenSessionOptions, OpenTaskOptions, ParsedToolCall, PendingSafetyChecks, Plaintext, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RECOVER_BUDGET_MS, RebaseConflictPath, RecoveryResult, RedactMode, RedactPolicy, Redaction, RepairAnswer, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunSetOptions, RunSetResult, RunSummary, RunTaskOptions, RunTaskSummary, SANDBOX_REQUEST_TIMEOUT_MS, SECRET_KEY, SESSION_STATES, SPAN_PREFIX, STATUS_WAIT_CAP_SECONDS, STRIP_PREFIX, SURFACE_KINDS, SafetyCheck, SandboxChanges, SandboxCheckResult, SandboxCommitInput, SandboxCommitResult, SandboxExecResult, SandboxImportInput, SandboxImportPending, SandboxImportResult, SandboxListFilter, SandboxOpenExisting, SandboxOpenNew, SandboxOpenTarget, SandboxOpened, SandboxSummary, Screen, ScreenBrowser, SecretScrubber, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SetRunDoc, SettleOptions, SlugDeclaration, TRANSFORMS, TaskEditClient, TaskEditCloseInput, TaskEditCloseResult, TaskEditRollbackInput, TaskEditRollbackResult, TaskEditSealed, TaskEditStatus, TaskEditTarget, TaskEditTaskRef, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldRef, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, VERIFIER_REWARD_PREFIX, ValidateReport, ValidatedRun, VerifierGrade, WHITESPACE, WorldBrowser, WorldCallTooLarge, WorldDependency, WorldDeprecation, WorldDescription, WorldEditClient, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionListItem, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVerifier, WorldTaskVerifierRow, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, assertBrowserTier, assertTaskRef, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, checkoutIdentity, closeConnection, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, idleWarning, ingest, ingestToolCalls, isBrowserGone, isSandboxImportPending, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listRuns, listSessions, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseErrorBody, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, playwrightKey, preserveForm, propose, pull, push, pushBranch, pushSlug, pyText, queryRows, queryRowsSearch, readField, readLocalMeta, readToolCallRecords, rebaseConflicts, redactActionArgs, redactionOf, releaseConnection, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runSet, runTask, schemaFromSignature, serializeCallBody, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, uncommittedPaths, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.js';
10
+ export { ACTION_NAMES, ActionArgs, ActionResult, ActionTracer, AiSdkAnthropicOutput, AiSdkComputerCall, AiSdkComputerOutput, AiSdkModelOutput, AnthropicComputer, AnthropicComputer20251124, AnthropicToolResult, ApiError, BROWSER_GONE_PATTERNS, BROWSER_TIERS, BrowserActionEvent, BrowserActionRecorder, BrowserConnection, BrowserMode, BrowserPage, BrowserReconnected, BrowserReconnector, BrowserTier, BrowserUnrecoverable, CALL_BODY_LIMIT_BYTES, CALL_BODY_LIMIT_LABEL, COMPUTER_USE_SPECS, Checkout, CheckoutProvenance, ComputerAction, ComputerCallOutput, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DRY_RUN_AGENT, DRY_RUN_KIND, DetachedPushError, DispatchedRun, Display, DryRunImageDecision, DryRunOutcome, DryRunSettlement, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EXPLORATORY_TASK, EXPLORATORY_TASK_SOURCE, EditSessionCloseInput, EditSessionList, EditSessionListQuery, EditSessionResult, EditSessionRollbackInput, EditSessionSummary, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, HostedDryRunClient, HostedDryRunDispatch, HostedDryRunStatus, HostedDryRunVerdict, IDLE_WARNING_MINUTES, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, KEY_NAMES, KeyChord, ListRunsFilter, ListSessionsFilter, LiveTaskSession, LocalMeta, MigrateWorldOptions, NOT_EXECUTED, NO_GRADER_REASON, NativeComputer, NativeComputerKinds, NativeComputerOptions, NativeComputerProvider, NativePage, ObservationConversion, ObservationLike, OpenAIComputer, OpenAIPreviewComputer, OpenSessionOptions, OpenTaskOptions, ParsedToolCall, PendingSafetyChecks, Plaintext, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RECOVER_BUDGET_MS, RebaseConflictPath, RecoveryResult, RedactMode, RedactPolicy, Redaction, RepairAnswer, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunSetOptions, RunSetResult, RunSummary, RunTaskOptions, RunTaskSummary, SANDBOX_REQUEST_TIMEOUT_MS, SECRET_KEY, SESSION_STATES, SPAN_PREFIX, STATUS_WAIT_CAP_SECONDS, STRIP_PREFIX, SURFACE_KINDS, SafetyCheck, SandboxChanges, SandboxCheckResult, SandboxCommitInput, SandboxCommitResult, SandboxExecResult, SandboxImportInput, SandboxImportPending, SandboxImportResult, SandboxListFilter, SandboxOpenExisting, SandboxOpenNew, SandboxOpenTarget, SandboxOpened, SandboxSummary, Screen, ScreenBrowser, SecretScrubber, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SetRunDoc, SettleOptions, SlugDeclaration, SurfaceDescriptor, TRANSFORMS, TaskEditClient, TaskEditCloseInput, TaskEditCloseResult, TaskEditRollbackInput, TaskEditRollbackResult, TaskEditSealed, TaskEditStatus, TaskEditTarget, TaskEditTaskRef, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldRef, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, VERIFIER_REWARD_PREFIX, ValidateReport, ValidatedRun, VerifierGrade, WHITESPACE, WorldBrowser, WorldCallTooLarge, WorldDependency, WorldDeprecation, WorldDescription, WorldEditClient, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldRequest, WorldRequestLog, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionListItem, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVerifier, WorldTaskVerifierRow, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, assertBrowserTier, assertTaskRef, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, checkoutIdentity, closeConnection, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, idleWarning, ingest, ingestToolCalls, isBrowserGone, isSandboxImportPending, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listRuns, listSessions, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseErrorBody, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, playwrightKey, preserveForm, propose, pull, push, pushBranch, pushSlug, pyText, queryRows, queryRowsSearch, readField, readLocalMeta, readToolCallRecords, rebaseConflicts, redactActionArgs, redactionOf, releaseConnection, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runSet, runTask, schemaFromSignature, serializeCallBody, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceDescriptor, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, uncommittedPaths, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.js';
11
11
  export { i as files } from './index-D-_4Ibcn.js';
12
12
  export { i as traces } from './index-BgvvQ3BC.js';
13
13
  export { i as hooks } from './index-C3UzD0G3.js';
14
- import { _ as _tracingModule } from './index-DAb-FCMg.js';
15
- export { I as IdentifyOptions, i as identify, r as resolveUserId } from './index-DAb-FCMg.js';
14
+ import { _ as _tracingModule } from './index-CBqbB_0J.js';
15
+ export { I as IdentifyOptions, i as identify, r as resolveUserId } from './index-CBqbB_0J.js';
16
16
  export { P as PLATFORM_TIMEOUT_DEFAULT_MS, a as PLATFORM_TIMEOUT_ENV, b as PlatformEndpoint, c as PlatformMethod, d as PlatformReply, e as PlatformTransport, T as TransportCause, U as UnreachableError, p as platformTimeoutMs } from './media-CbcAfQvd.js';
17
17
  import 'async_hooks';
18
18
  import '@opentelemetry/api';
package/dist/index.js CHANGED
@@ -3479,6 +3479,28 @@ var init_tasks = __esm({
3479
3479
  }
3480
3480
  });
3481
3481
 
3482
+ // src/worlds/surfaceDescriptor.ts
3483
+ function surfaceDescriptor(s) {
3484
+ return {
3485
+ surfaces: surfaceKinds(s),
3486
+ ...s.api ? { api: { url: s.api.url, ...s.api.token ? { token: s.api.token } : {} } } : {},
3487
+ ...s.ui ? { ui: { url: s.ui.url, entry: uiEntryUrl(s.ui), apiPath: s.ui.apiPath ?? null } } : {},
3488
+ ...s.browser ? {
3489
+ browser: {
3490
+ wsUrl: s.browser.wsUrl,
3491
+ viewport: s.browser.viewport,
3492
+ ...s.browser.tier ? { tier: s.browser.tier } : {}
3493
+ }
3494
+ } : {}
3495
+ };
3496
+ }
3497
+ var init_surfaceDescriptor = __esm({
3498
+ "src/worlds/surfaceDescriptor.ts"() {
3499
+ "use strict";
3500
+ init_browser();
3501
+ }
3502
+ });
3503
+
3482
3504
  // src/worlds/taskSessions.ts
3483
3505
  function aggregateTaskGrade(worlds) {
3484
3506
  const rewards = {};
@@ -3629,6 +3651,7 @@ var init_taskSessions = __esm({
3629
3651
  "use strict";
3630
3652
  init_worlds();
3631
3653
  init_browser();
3654
+ init_surfaceDescriptor();
3632
3655
  init_session2();
3633
3656
  TASK_SESSIONS = "/api/public/world-task-sessions";
3634
3657
  VERIFIER_REWARD_PREFIX = "x.";
@@ -3640,18 +3663,7 @@ var init_taskSessions = __esm({
3640
3663
  sessionId: state2.sessionId,
3641
3664
  ready: state2.ready,
3642
3665
  state: state2.state,
3643
- surfaces: surfaceKinds(s),
3644
- ...s.api ? {
3645
- api: { url: s.api.url, ...s.api.token ? { token: s.api.token } : {} }
3646
- } : {},
3647
- ...s.ui ? {
3648
- ui: {
3649
- url: s.ui.url,
3650
- entry: uiEntryUrl(s.ui),
3651
- apiPath: s.ui.apiPath ?? null
3652
- }
3653
- } : {},
3654
- ...s.browser ? { browser: { wsUrl: s.browser.wsUrl, viewport: s.browser.viewport } } : {}
3666
+ ...surfaceDescriptor(s)
3655
3667
  });
3656
3668
  TaskSessions = class {
3657
3669
  constructor(taskId, taskVersion, name, instruction, sessions2, worlds, hash = null) {
@@ -3830,6 +3842,49 @@ var init_evals = __esm({
3830
3842
  }
3831
3843
  });
3832
3844
 
3845
+ // src/tracing/prerequisites.ts
3846
+ function getEnv(key2) {
3847
+ const value = process.env[key2];
3848
+ return value ? value : void 0;
3849
+ }
3850
+ function isGatewayConfigured() {
3851
+ return !!(getEnv(GATEWAY_ENV.HOST) && getEnv(GATEWAY_ENV.PUBLIC_KEY) && getEnv(GATEWAY_ENV.SECRET_KEY));
3852
+ }
3853
+ var GATEWAY_ENV, OPENTELEMETRY_PEERS, MODULE_NOT_FOUND, OpenTelemetryMissing;
3854
+ var init_prerequisites = __esm({
3855
+ "src/tracing/prerequisites.ts"() {
3856
+ "use strict";
3857
+ GATEWAY_ENV = {
3858
+ HOST: "GATEWAY_HOST",
3859
+ PUBLIC_KEY: "GATEWAY_PUBLIC_KEY",
3860
+ SECRET_KEY: "GATEWAY_SECRET_KEY",
3861
+ ENDPOINT: "GATEWAY_OTLP_ENDPOINT"
3862
+ };
3863
+ OPENTELEMETRY_PEERS = [
3864
+ "@opentelemetry/api",
3865
+ "@opentelemetry/exporter-trace-otlp-http",
3866
+ "@opentelemetry/resources",
3867
+ "@opentelemetry/sdk-trace-base",
3868
+ "@opentelemetry/sdk-trace-node"
3869
+ ];
3870
+ MODULE_NOT_FOUND = /* @__PURE__ */ new Set(["MODULE_NOT_FOUND", "ERR_MODULE_NOT_FOUND"]);
3871
+ OpenTelemetryMissing = class _OpenTelemetryMissing extends Error {
3872
+ constructor() {
3873
+ super(
3874
+ `OpenTelemetry packages not found. Install them with:
3875
+ npm install ${OPENTELEMETRY_PEERS.join(" ")}`
3876
+ );
3877
+ this.name = "OpenTelemetryMissing";
3878
+ }
3879
+ static explains(error) {
3880
+ if (error instanceof _OpenTelemetryMissing) return true;
3881
+ const { code, message } = error ?? {};
3882
+ return MODULE_NOT_FOUND.has(String(code)) && String(message).includes("@opentelemetry/");
3883
+ }
3884
+ };
3885
+ }
3886
+ });
3887
+
3833
3888
  // src/tracing/identity.ts
3834
3889
  function resolveUserId() {
3835
3890
  const contextual = currentUserStorage.getStore();
@@ -4130,7 +4185,7 @@ var require_package = __commonJS({
4130
4185
  "package.json"(exports2, module2) {
4131
4186
  module2.exports = {
4132
4187
  name: "@withgateway/sdk",
4133
- version: "0.3.0",
4188
+ version: "0.3.1",
4134
4189
  description: "Gateway SDK for TypeScript - A/B experiments, tracing, and observability",
4135
4190
  main: "./dist/index.js",
4136
4191
  module: "./dist/index.mjs",
@@ -4626,10 +4681,6 @@ __export(init_exports, {
4626
4681
  isInitialized: () => isInitialized,
4627
4682
  shutdown: () => shutdown2
4628
4683
  });
4629
- function getEnv(key2) {
4630
- const value = process.env[key2];
4631
- return value ? value : void 0;
4632
- }
4633
4684
  function log(message, ...args) {
4634
4685
  if (state.debug) {
4635
4686
  console.log(`[gatewaysdk.tracing] ${message}`, ...args);
@@ -4639,10 +4690,10 @@ function warn(message, ...args) {
4639
4690
  console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
4640
4691
  }
4641
4692
  function buildProvider(config, logFn) {
4642
- const host = config.host ?? getEnv(ENV_VARS.HOST);
4643
- const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
4644
- const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
4645
- const endpoint = config.endpoint ?? getEnv(ENV_VARS.ENDPOINT) ?? (host ? `${host.replace(/\/$/, "")}${DEFAULT_OTLP_PATH}` : void 0);
4693
+ const host = config.host ?? getEnv(GATEWAY_ENV.HOST);
4694
+ const publicKey = config.publicKey ?? getEnv(GATEWAY_ENV.PUBLIC_KEY);
4695
+ const secretKey = config.secretKey ?? getEnv(GATEWAY_ENV.SECRET_KEY);
4696
+ const endpoint = config.endpoint ?? getEnv(GATEWAY_ENV.ENDPOINT) ?? (host ? `${host.replace(/\/$/, "")}${DEFAULT_OTLP_PATH}` : void 0);
4646
4697
  const missing = [];
4647
4698
  if (!host) missing.push("host (or GATEWAY_HOST env var)");
4648
4699
  if (!publicKey) missing.push("publicKey (or GATEWAY_PUBLIC_KEY env var)");
@@ -4679,9 +4730,7 @@ function buildProvider(config, logFn) {
4679
4730
  ATTR_SERVICE_NAME = "service.name";
4680
4731
  }
4681
4732
  } catch {
4682
- throw new Error(
4683
- "OpenTelemetry packages not found. Install them with:\nnpm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http @opentelemetry/resources"
4684
- );
4733
+ throw new OpenTelemetryMissing();
4685
4734
  }
4686
4735
  const resourceAttrs = {
4687
4736
  [ATTR_SERVICE_NAME]: config.serviceName ?? "gatewaysdk-tracing"
@@ -4887,13 +4936,7 @@ async function shutdown2() {
4887
4936
  function isInitialized() {
4888
4937
  return state.initialized;
4889
4938
  }
4890
- function isGatewayConfigured() {
4891
- const host = getEnv(ENV_VARS.HOST);
4892
- const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);
4893
- const secretKey = getEnv(ENV_VARS.SECRET_KEY);
4894
- return !!(host && publicKey && secretKey);
4895
- }
4896
- var ENV_VARS, DEFAULT_OTLP_PATH, state;
4939
+ var DEFAULT_OTLP_PATH, state;
4897
4940
  var init_init = __esm({
4898
4941
  "src/tracing/init.ts"() {
4899
4942
  "use strict";
@@ -4902,12 +4945,8 @@ var init_init = __esm({
4902
4945
  init_session();
4903
4946
  init_scores();
4904
4947
  init_build();
4905
- ENV_VARS = {
4906
- HOST: "GATEWAY_HOST",
4907
- PUBLIC_KEY: "GATEWAY_PUBLIC_KEY",
4908
- SECRET_KEY: "GATEWAY_SECRET_KEY",
4909
- ENDPOINT: "GATEWAY_OTLP_ENDPOINT"
4910
- };
4948
+ init_prerequisites();
4949
+ init_prerequisites();
4911
4950
  DEFAULT_OTLP_PATH = "/api/public/otel/v1/traces";
4912
4951
  state = {
4913
4952
  initialized: false,
@@ -4916,6 +4955,45 @@ var init_init = __esm({
4916
4955
  }
4917
4956
  });
4918
4957
 
4958
+ // src/worlds/taskTracing.ts
4959
+ var TaskTracing;
4960
+ var init_taskTracing = __esm({
4961
+ "src/worlds/taskTracing.ts"() {
4962
+ "use strict";
4963
+ init_prerequisites();
4964
+ TaskTracing = class _TaskTracing {
4965
+ constructor(load = () => Promise.resolve().then(() => (init_init(), init_exports))) {
4966
+ this.load = load;
4967
+ }
4968
+ load;
4969
+ static warned = false;
4970
+ async start(requested) {
4971
+ if (!requested || !isGatewayConfigured()) return false;
4972
+ try {
4973
+ (await this.load()).init();
4974
+ return true;
4975
+ } catch (error) {
4976
+ _TaskTracing.warnOnce(error);
4977
+ return false;
4978
+ }
4979
+ }
4980
+ static warnOnce(error) {
4981
+ if (_TaskTracing.warned) return;
4982
+ _TaskTracing.warned = true;
4983
+ console.warn(
4984
+ `[gatewaysdk.tracing] Task runs in this process are not traced. ${_TaskTracing.reason(error)}
4985
+ Pass --no-trace (trace: false) to run untraced without this warning.`
4986
+ );
4987
+ }
4988
+ static reason(error) {
4989
+ if (OpenTelemetryMissing.explains(error))
4990
+ return new OpenTelemetryMissing().message;
4991
+ return error instanceof Error ? error.message : String(error);
4992
+ }
4993
+ };
4994
+ }
4995
+ });
4996
+
4919
4997
  // src/worlds/taskRun.ts
4920
4998
  function worldRef(live, alias) {
4921
4999
  const { slug, ref } = live.worldRef(alias);
@@ -5028,18 +5106,7 @@ async function runTask(ref, agent, opts) {
5028
5106
  const started = Date.now();
5029
5107
  try {
5030
5108
  await live.ready();
5031
- let traced = false;
5032
- if (opts.trace !== false) {
5033
- try {
5034
- const { isGatewayConfigured: isGatewayConfigured2, init: init3 } = await Promise.resolve().then(() => (init_init(), init_exports));
5035
- if (isGatewayConfigured2()) {
5036
- init3();
5037
- traced = true;
5038
- }
5039
- } catch {
5040
- traced = false;
5041
- }
5042
- }
5109
+ const traced = await new TaskTracing().start(opts.trace !== false);
5043
5110
  const taskRun = new TaskRun(
5044
5111
  runId,
5045
5112
  live.instruction ?? "",
@@ -5130,6 +5197,7 @@ var init_taskRun = __esm({
5130
5197
  init_evals();
5131
5198
  init_session2();
5132
5199
  init_taskSessions();
5200
+ init_taskTracing();
5133
5201
  TaskRun = class {
5134
5202
  constructor(runId, instruction, model, sessions2, manifest) {
5135
5203
  this.runId = runId;
@@ -5333,6 +5401,52 @@ var init_setRun = __esm({
5333
5401
  }
5334
5402
  });
5335
5403
 
5404
+ // src/worlds/requestLog.ts
5405
+ var WorldRequestLog;
5406
+ var init_requestLog = __esm({
5407
+ "src/worlds/requestLog.ts"() {
5408
+ "use strict";
5409
+ WorldRequestLog = class _WorldRequestLog {
5410
+ constructor(requests) {
5411
+ this.requests = requests;
5412
+ }
5413
+ requests;
5414
+ static async read(session) {
5415
+ const state2 = await session.state();
5416
+ const calls = state2?.calls;
5417
+ if (!Array.isArray(calls)) return null;
5418
+ return new _WorldRequestLog(calls.filter((c) => typeof c === "object" && c !== null));
5419
+ }
5420
+ /** How many older requests the world no longer keeps (its log is bounded): the gap
5421
+ * before the first entry it still holds. */
5422
+ get dropped() {
5423
+ const first = Number(this.requests[0]?.seq) || 1;
5424
+ return Math.max(0, first - 1);
5425
+ }
5426
+ /** Each request in the shape of a ledger line, `kind: "request"`, so one JSONL
5427
+ * file holds both. */
5428
+ asCalls() {
5429
+ return this.requests.map((r) => ({
5430
+ seq: Number(r.seq) || 0,
5431
+ kind: "request",
5432
+ tool: r.operation ?? null,
5433
+ args: {
5434
+ method: r.method ?? null,
5435
+ path: r.path ?? null,
5436
+ args: r.args ?? null,
5437
+ query: r.query ?? null,
5438
+ body: r.body ?? null,
5439
+ via: r.via ?? null
5440
+ },
5441
+ result: { status: r.status ?? null, rows: r.rows ?? null, found: r.found ?? null },
5442
+ error: null,
5443
+ completedAt: r.at ?? null
5444
+ }));
5445
+ }
5446
+ };
5447
+ }
5448
+ });
5449
+
5336
5450
  // src/worlds/checkoutTarget.ts
5337
5451
  var fs2, path2, CheckoutRefusedError, NAMED_EDITS, CheckoutTarget;
5338
5452
  var init_checkoutTarget = __esm({
@@ -7162,7 +7276,7 @@ async function localBridge(request, local, opts = {}) {
7162
7276
  child.stdin.end(input);
7163
7277
  });
7164
7278
  }
7165
- var import_node_child_process2, fs7, net, path7, MIN_PYTHON, DIAGNOSTIC_TAIL, BRIDGE_BOOTSTRAP, pythonCache, pythonProbes, PYTHON_CANDIDATES, UV_FIND;
7279
+ var import_node_child_process2, fs7, net, path7, MIN_PYTHON, MIN_PYTHON_LABEL, DIAGNOSTIC_TAIL, BRIDGE_BOOTSTRAP, pythonCache, pythonProbes, PYTHON_CANDIDATES, UV_FIND;
7166
7280
  var init_local = __esm({
7167
7281
  "src/cli/runtime/local.ts"() {
7168
7282
  "use strict";
@@ -7173,6 +7287,7 @@ var init_local = __esm({
7173
7287
  init_router();
7174
7288
  init_config();
7175
7289
  MIN_PYTHON = [3, 12];
7290
+ MIN_PYTHON_LABEL = MIN_PYTHON.join(".");
7176
7291
  DIAGNOSTIC_TAIL = 600;
7177
7292
  BRIDGE_BOOTSTRAP = `import sys,runpy,types,os
7178
7293
  root=sys.argv[1]
@@ -8542,6 +8657,7 @@ __export(worlds_exports, {
8542
8657
  WorldBrowser: () => WorldBrowser,
8543
8658
  WorldCallTooLarge: () => WorldCallTooLarge,
8544
8659
  WorldEditClient: () => WorldEditClient,
8660
+ WorldRequestLog: () => WorldRequestLog,
8545
8661
  WorldSandboxClient: () => WorldSandboxClient,
8546
8662
  WorldSession: () => WorldSession,
8547
8663
  WorldSessionCallError: () => WorldSessionCallError,
@@ -8635,6 +8751,7 @@ __export(worlds_exports, {
8635
8751
  shapeText: () => shapeText,
8636
8752
  snapshotTreeHashes: () => snapshotTreeHashes,
8637
8753
  storedForms: () => storedForms,
8754
+ surfaceDescriptor: () => surfaceDescriptor,
8638
8755
  surfaceKinds: () => surfaceKinds,
8639
8756
  taskLabel: () => taskLabel,
8640
8757
  toolCallRecordsIn: () => toolCallRecordsIn,
@@ -8876,6 +8993,8 @@ var init_worlds = __esm({
8876
8993
  init_checkoutProvenance();
8877
8994
  init_evals();
8878
8995
  init_browser();
8996
+ init_surfaceDescriptor();
8997
+ init_requestLog();
8879
8998
  init_browserReconnect();
8880
8999
  init_nativeComputer();
8881
9000
  init_hub();
@@ -9086,6 +9205,7 @@ __export(src_exports, {
9086
9205
  WorldBrowser: () => WorldBrowser,
9087
9206
  WorldCallTooLarge: () => WorldCallTooLarge,
9088
9207
  WorldEditClient: () => WorldEditClient,
9208
+ WorldRequestLog: () => WorldRequestLog,
9089
9209
  WorldSandboxClient: () => WorldSandboxClient,
9090
9210
  WorldSession: () => WorldSession,
9091
9211
  WorldSessionCallError: () => WorldSessionCallError,
@@ -9219,6 +9339,7 @@ __export(src_exports, {
9219
9339
  storedForms: () => storedForms,
9220
9340
  success: () => success,
9221
9341
  suite: () => suite,
9342
+ surfaceDescriptor: () => surfaceDescriptor,
9222
9343
  surfaceKinds: () => surfaceKinds,
9223
9344
  taskLabel: () => taskLabel,
9224
9345
  toolCallRecordsIn: () => toolCallRecordsIn,
@@ -17015,6 +17136,7 @@ var tracing = {
17015
17136
  WorldBrowser,
17016
17137
  WorldCallTooLarge,
17017
17138
  WorldEditClient,
17139
+ WorldRequestLog,
17018
17140
  WorldSandboxClient,
17019
17141
  WorldSession,
17020
17142
  WorldSessionCallError,
@@ -17148,6 +17270,7 @@ var tracing = {
17148
17270
  storedForms,
17149
17271
  success,
17150
17272
  suite,
17273
+ surfaceDescriptor,
17151
17274
  surfaceKinds,
17152
17275
  taskLabel,
17153
17276
  toolCallRecordsIn,