@qodo/sdk 0.13.4 → 2.0.0-next.1

package/dist/index.d.ts

@@ -1,43 +1,92 @@
-export { QodoSDK } from './sdk/index.js';
-export type { QodoSDKOptions, QodoSDKRunResult, QodoSDKStreamEvent, QodoSDKRunOptions, QodoSDKLogger, } from './sdk/index.js';
-export { SdkEventType, SDK_PROTOCOL_V2, matchSdkEvent, createSdkEvent, getSdkVersion, } from './sdk/events.js';
-export type { QodoSdkEvent, SdkEventTypeName, SdkEventEnvelope, SdkInitEvent, SdkRunStartedEvent, SdkMessageDeltaEvent, SdkMessageFullEvent, SdkProgressEvent, SdkToolRequestedEvent, SdkToolApprovedEvent, SdkToolExecutedEvent, SdkErrorEvent, SdkFinalEvent, SdkEventHandlers, SdkPipelineStartedEvent, SdkPipelineStepStartedEvent, SdkPipelineStepCompletedEvent, SdkPipelineStepProgressEvent, SdkPipelineGateEvaluatedEvent, SdkPipelineBranchEvaluatedEvent, SdkPipelineCompletedEvent, SdkPipelineErrorEvent, } from './sdk/events.js';
-export { sdkAgent, sdkCommand, sdkArgs } from './sdk/builders.js';
-export { zodOutputSchema, zodArgsSchema, zCoerce, zJsonValue, zJsonAny, parseArgsWithSchema, QodoSchemaError, } from './sdk/schemas.js';
-export { z } from 'zod/v3';
-export { QodoInfoClient } from './clients/info/index.js';
-export type { QodoBackendInfo } from './clients/info/types.js';
-export { QodoSessionsClient } from './clients/sessions/index.js';
-export type { RecentSession, SessionHistory, SessionMessage, } from './clients/sessions/types.js';
-export { QodoToolsClient } from './clients/tools/index.js';
-export type { QodoToolInfo } from './clients/tools/types.js';
-export { findNearestAgentConfig } from './sdk/discovery.js';
-export { buildDefaultSdkAgentConfig } from './sdk/defaults.js';
-export { QodoTracker } from './tracking/index.js';
-export type { AIAssistantConfig, CommandConfig, ModeConfig, MCPConfig, OutputSchema, CommandArgument, } from './parser/types.js';
-export { getCurrentVersion } from './version.js';
-export { BaseMessage, HumanMessage, AIMessage, SystemMessage, ToolMessage, } from './messages/index.js';
-export type { ToolCall, AIMessageInput, ToolMessageInput } from './messages/index.js';
-export { convertMessagesToOpenAI } from './messages/index.js';
-export type { OpenAIChatMessage } from './messages/index.js';
-export { sdkPipeline, PipelineBuilder, Pipeline, runPipeline, PipelineExecutionError } from './sdk/pipeline/index.js';
-export type { StepFn, StepContext, GateFn, ErrorStrategy, PipelineGate, PipelineBranch, PipelineResult, StepLog, StepOptions, PipelineEventCallback, } from './sdk/pipeline/index.js';
-export { compileDeclarativePipeline, DeclarativePipelineValidationError } from './sdk/pipeline/index.js';
-export type { DeclarativePipelineStep, DeclarativePipeline } from './sdk/pipeline/index.js';
-export type { ToolMiddleware } from './sdk/middleware.js';
-export { ToolMiddlewareError, MIDDLEWARE_TIMEOUT_MS, PROTECTED_TOOL_FIELDS } from './sdk/middleware.js';
-export { sdkPolicy, policyFromRules, Policy, PolicyBuilder, globMatch } from './sdk/policies.js';
-export type { PolicyRule, PolicyMatcher, PolicyDecision, PolicyEvalResult, PolicyOptions } from './sdk/policies.js';
-export { ArtifactStore, jsonSerializer, withArtifacts } from './sdk/artifacts.js';
-export type { Artifact, ArtifactSerializer, ArtifactStoreOptions, PersistHook } from './sdk/artifacts.js';
-export { QodoOutputValidationError } from './sdk/runner/finalize.js';
+/**
+ * `@qodo/sdk` 2.0 — public API surface.
+ *
+ * QAR-native typed bindings. The shape mirrors QAR's envelope vocabulary
+ * one level up; consumers `for await` `client.tasks.start({...})` and
+ * switch on `event.kind`. There is no adapter layer, no `QODO_RUNTIME`
+ * flag, no parallel 1.x client. SDK 1.x lives on `release/1.x`.
+ */
+export { QodoClient } from './client/QodoClient.js';
+export { TaskClient } from './client/TaskClient.js';
+export { ToolClient } from './client/ToolClient.js';
+export type { InfoClient } from './client/InfoClient.js';
+export type { SpecsClient } from './client/SpecsClient.js';
+export { PipelineClient, PipelineBuilder } from './client/PipelineClient.js';
+export { BulletinClient } from './client/BulletinClient.js';
+export { ArtifactsClient } from './client/ArtifactsClient.js';
+export { StateClient } from './client/StateClient.js';
+export { AgentsClient } from './client/AgentsClient.js';
+export { QarRegistryClient } from './client/QarRegistryClient.js';
+export type { A2AHitlKind, A2ARegistration, A2ARegistrationConfig, AgentCard, RegisteredA2ARef, } from './client/a2a/registerA2A.js';
+export type { AgentSpec, McpConfig, StdioMcpConfig, RemoteStreamableHttpMcpConfig, RemoteSseMcpConfig, UrlOnlyMcpConfig, SdkInProcessMcpConfig, McpInProcessHandler, RegisteredAgentRef, RegisteredMcpRef, RegisterOptions, RegisterMcpOptions, } from './client/QarRegistryClient.js';
+export type { ToolListEntry as McpToolListEntry } from './client/mcp/McpClientPool.js';
+export { projectMcpTools } from './client/mcp/projection.js';
+export type { ProjectionInput, ProjectionResult } from './client/mcp/projection.js';
+export { QodoNotImplementedError, QodoClientOptionsError, QodoTransportError, QodoBackpressureError, QodoSpecValidationError, QodoRegistryConflictError, QodoWireValidationError, QodoInlineGraphValidationError, QodoInlineAgentValidationError, QodoAgentSpecRejectedError, QodoServerError, QodoCancelRoutingFailedError, QodoCancelFailedError, QodoTaskNotFoundError, QodoTaskNotWaitingError, QodoAgentReconstructionFailedError, QodoCrossPodResumeAbortedError, QodoDepsConstructionFailedError, QodoMessageHistoryLoadFailedError, QodoHitlPersistFailedError, QodoHitlSubstrateUnavailableError, QodoUnauthorizedResolverError, QodoInvalidResolutionError, QodoGraphSpecRejectedError, QodoUnknownServerError, QodoIdempotencyKeyValidationError, QodoAdmissionStalledError, QodoAdmissionTimeoutError, QodoStreamAbortedError, QodoSessionMismatchError, QodoColdAddressError, QodoCancelAbortedError, classForServerErrorCode, ToolDeniedError, QodoMcpClientError, QodoMcpToolError, QodoUnknownMcpError, QodoUnknownMcpToolError, QodoMcpUnavailableError, RequiredGraphSpecError, } from './client/errors.js';
+export type { InlineGraphValidationFailure, InlineAgentSpecIssue, ServerErrorEntry, } from './client/errors.js';
+export { collectInlineAgentSpecPreWireIssues } from './qar/agentSpec.js';
+export type { InlineAgentSpecValidationIssue } from './qar/agentSpec.js';
+export type { ClientOptions, ClientAuth, ClientReconnectOptions, ClientBackpressureOptions, TaskOptions, ResubscribeOptions, TaskCancelOptions, ToolRespondOptions, } from './client/options.js';
+export type { ToolRequestHandler, WireValidationErrorHandler, Subscription, } from './client/ToolClient.js';
+export { defineFunctionTool, getFunctionToolHandler, FUNCTION_TOOL_HANDLER_KEY, } from './client/tools/defineFunctionTool.js';
+export type { DefineFunctionToolOptions, DefinedFunctionToolDef, FunctionToolHandler, FunctionToolHandlerBag, FunctionToolHandlerContext, FunctionToolHandlerReturn, } from './client/tools/defineFunctionTool.js';
+export type { ApprovalConfig, ApprovalDecision, ApprovalHandler, ApprovalKind, ApprovalRequest, ApprovalSensitivity, } from './client/tools/approval.js';
+export type { WireValidationContext } from './client/errors.js';
+export type { TaskCancelResult, TaskStartInput, TaskStartAgentInput, StartWithAgentOptions, TaskStartGraphInput, StartWithGraphOptions, TaskAdmissionResult, TaskHandle, TaskStartIterable, ForceResumeResult, } from './client/TaskClient.js';
+export { validateInlineGraphSpec, DEFAULT_INLINE_GRAPH_MAX_DEPTH, } from './client/inlineGraph.js';
+export type { InlineGraphValidationOptions } from './client/inlineGraph.js';
+export type { EventSubscription } from './client/observers.js';
+export type { BulletinFilter, BulletinHandler } from './client/BulletinClient.js';
+export type { ArtifactFilter, ArtifactHandler } from './client/ArtifactsClient.js';
+export type { StateFilter, StateHandler } from './client/StateClient.js';
+export type { AgentSpawnFilter, AgentSpawnHandler } from './client/AgentsClient.js';
+export { defaultTransportFactory, validateCloseReason, CLOSE_FRAME_REASON_MAX_BYTES, } from './client/transport.js';
+export type { WSTransport, WSTransportFactory, WSTransportFactoryArgs, WSEventHandlers, } from './client/transport.js';
+export type { PipelineStepFn, PipelineStepContext, PipelineGateFn, PipelineErrorStrategy, PipelineResult, PipelineStepLog, PipelineStepError, } from './client/PipelineClient.js';
+export type { Envelope, EnvelopeBase, EnvelopeKind, EnvelopeVersion, TaskStartEnvelope, TaskContinueEnvelope, TaskCancelEnvelope, TaskCancelingEnvelope, TaskStartedEnvelope, TaskResubscribeEnvelope, TaskDeltaEnvelope, TaskDoneEnvelope, TaskForceResumeEnvelope, TaskForceResumedEnvelope, ToolRequestEnvelope, ToolResponseEnvelope, StateUpdateEnvelope, AgentSpawnEnvelope, BulletinPostEnvelope, ArtifactAddEnvelope, FlowPauseEnvelope, FlowResumeEnvelope, ErrorEnvelope, ClientToServerKind, ServerToClientKind, BidirectionalKind, } from './qar/envelopes.js';
+export { CLIENT_TO_SERVER_KINDS, SERVER_TO_CLIENT_KINDS, BIDIRECTIONAL_KINDS, } from './qar/envelopes.js';
+export type { TaskEvent, TaskEventKind } from './qar/taskEvents.js';
+export type { ClientEvent, ClientEventKind, ClientReconnectingEvent, ClientReconnectedEvent, ClientReconnectFailedEvent, ClientCancelAckedEvent, } from './qar/clientEvents.js';
+export { isClientEvent } from './qar/clientEvents.js';
+export type { QodoTaskStartInput, QodoTaskStartPayload, TaskStartByIdPayload, TaskStartWithAgentPayload, TaskStartWithGraphPayload, TaskStartPayload, TaskContinuePayload, TaskCancelPayload, TaskCancelingPayload, TaskStartedPayload, TaskResubscribePayload, TaskDeltaPayload, TaskDonePayload, TaskStatus, TaskForceResumePayload, TaskForceResumedPayload, SessionState, ToolCall, HITLBlock, HITLChoiceOption, ToolResponseItem, ToolRequestPayload, ToolResponsePayload, ToolResponseResult, ToolResponseFor, ToolOutcome, StateUpdatePayload, StateUpdateOp, AgentSpawnPayload, SpawnProtocol, BulletinPostPayload, ArtifactAddPayload, FlowPausePayload, FlowResumePayload, ErrorPayload, } from './qar/payloads.js';
+export type { TraceContext } from './qar/trace.js';
+export type { JsonValue, JsonObject, JsonArray, JsonPrimitive } from './qar/json.js';
+export type { MessageId, SessionId, TaskId, ToolCallId } from './qar/ids.js';
+export type { QARInfo, ModelEntry, ToolEntry, RateLimitEntry, LeanPrincipal, BearerKind, } from './qar/info.js';
+export type { InlineAgentSpec, FunctionDef, FunctionToolDef, Instructions, InstructionsPreset, JsonSchemaSpec, OutputSchemaSpec, SkillRef, SpawnableAgentRef, InlineGraphSpec, InlineGraphAgent, InlineGraphAgentStaticRef, InlineGraphEdge, InlineEdgeOnError, InlineGraphRole, InlineGraphEdgeKind, InlineGraphLimits, InlineGraphBudget, InlineTerminationCondition, InlineSubgraphAllocation, InlineHITLMode, InlineSpec, InlineSpecKind, SpecValidationError, SpecValidateResult, VerdictResult, ContentTrustPolicy, ContentTrustMode, McpToolsSelector, McpToolsSelectorAllowBlock, McpToolsSelectorFilter, McpToolOverride, McpToolOverrides, DiscoveredMcpTool, McpToolAnnotations, } from './qar/specs.js';
+export { AuthProvider, QodoAuthError } from './auth/index.js';
+export type { AuthConfig, AuthSource } from './auth/index.js';
 export { SdkTracer, createSdkTracer } from './tracing/index.js';
 export type { SdkTracerOptions } from './tracing/index.js';
 export { tracePipeline } from './tracing/index.js';
-export type { TracePipelineOptions, OTelAPI } from './tracing/index.js';
-export { resolveTriggerContext } from './sdk/trigger-context.js';
-export type { CITriggerContext, CIProvider } from './sdk/trigger-context.js';
-export { evaluateExitExpression } from './sdk/exit-expression.js';
-export { QodoAuthError, AuthProvider } from './auth/index.js';
-export { QodoBackendBootstrapError } from './session/serverData.js';
+export type { TracePipelineOptions } from './tracing/index.js';
+export type { OTelAPI, OTelSpan, OTelTracer, OTelContext, OTelContextAPI, OTelTraceAPI, } from './tracing/index.js';
+export { SERVICE_NAME, SERVICE_VERSION, SERVICE_NAMESPACE, SERVICE_NAME_VALUE, SERVICE_NAMESPACE_VALUE, QAR_SESSION_ID, QAR_MESSAGE_ID, QAR_PARENT_MESSAGE_ID, QAR_TASK_ID, QAR_ENVELOPE_KIND, QAR_TOOL_NAME, QAR_TOOL_CALL_ID, QAR_TOOL_ORIGIN, QAR_TOOL_OUTCOME, QAR_NODE_NAME, QAR_SKILL_NAME, QAR_AGENT_ID, QAR_GRAPH_ENTRY, QAR_GRAPH_DEPTH, QAR_AGENT_KIND, QAR_AGENT_ROLE, QAR_EVALUATOR_VERDICT, QAR_EVALUATOR_CONFIDENCE, GEN_AI_CONVERSATION_ID, GEN_AI_OPERATION_NAME, GEN_AI_OP_INVOKE_AGENT, GEN_AI_OP_EXECUTE_TOOL, SKIPPED_ATTRIBUTES, SPAN_TASK_OBSERVED, SPAN_TASK_START, SPAN_TASK_CONTINUE, SPAN_TASK_CANCEL, SPAN_TASK_RESUBSCRIBE, SPAN_TOOL_REQUEST, SPAN_TOOL_RESPOND, SPAN_TOOL_HANDLER, SPAN_CONNECT, SPAN_DISCONNECT, SPAN_PIPELINE, SPAN_PIPELINE_STEP, QAR_PIPELINE_STEP_NAME, QAR_PIPELINE_GATE_PASSED, QAR_PIPELINE_COLLECTED_ERRORS, QAR_PIPELINE_GATED, TOOL_ORIGIN_SDK_SIDE, TOOL_OUTCOME_SUCCESS, TOOL_OUTCOME_ERROR, TOOL_OUTCOME_DENIED, } from './observability/index.js';
+export type { SkippedAttribute } from './observability/index.js';
+export { TransportMetrics } from './observability/transportMetrics.js';
+export type { TransportMetricsSnapshot } from './observability/transportMetrics.js';
+export { SkillsManager, SkillNotFoundError, SkillAmbiguousPinError, SkillsBudgetExceededError, QodoSkillError, } from './skills/manager.js';
+export type { CatalogSnapshot, ResolvedRequiresCaps, SkillGetOptions, } from './skills/manager.js';
+export { isSkillTrusted, SkillsTrustConfigError, sourceIdentityKey, validateTrustedSources, } from './skills/trust.js';
+export { activationFailureMessage, lookupFromSnapshot, renderActiveSkillsBlock, resolveActivationGraph, resolveAllActivations, } from './skills/activation.js';
+export type { ActivationGraph, ActivationGraphResult, ActiveSkillsRenderResult, MultiActivationResult, SkillLookup, } from './skills/activation.js';
+export { renderSlimIndex } from './skills/render.js';
+export type { RenderOptions, RenderResult } from './skills/render.js';
+export { injectIntoAgentSpec, injectIntoGraphSpec } from './skills/inject.js';
+export type { InjectionResult } from './skills/inject.js';
+export type { AllowedToolEntry, ParsedSkill, SkillArgument, SkillEmbedder, SkillEvent, SkillEventKind, SkillEventSeverity, SkillFrontmatter, SkillSource, SkillSourceType, SkillSpecifier, SkillTrustTier, SkillsConfig, SkillsEventSink, SkillsPreprocessingConfig, SkillsPreprocessingMode, SkillsRequiresConfig, } from './skills/types.js';
+export { DEFAULT_INDEX_CHAR_BUDGET, REQUIRES_DEFAULT_MAX_DEPTH, REQUIRES_DEFAULT_MAX_TRANSITIVE, REQUIRES_DEFAULT_MAX_TRANSITIVE_TOKENS, SLIM_INDEX_ENTRY_BUDGET, SKILL_BODY_HARD_BYTES, } from './skills/types.js';
+export { SKILL_EVENT_KINDS, eventSubjectFqn, } from './skills/events.js';
+export { parseArgv as parseSkillArgv, substitute as substituteSkillBody, substituteWithArgumentsTrailer as substituteSkillBodyWithTrailer, } from './skills/substitute.js';
+export type { SubstitutionContext as SkillSubstitutionContext, SubstitutionResult as SkillSubstitutionResult, SubstitutionWarning as SkillSubstitutionWarning, } from './skills/substitute.js';
+export { SkillKit } from './skills/testing/index.js';
+export type { SkillKitOptions, SkillKitValidationIssue, SkillKitSnapshot, SkillKitActivationCandidate, SkillKitDiff, } from './skills/testing/index.js';
+export { runSkillsCli, defaultCliIo } from './skills/cli/index.js';
+export type { CliIo } from './skills/cli/index.js';
+export { LOCKFILE_BASENAME as SKILLS_LOCKFILE_BASENAME, LOCKFILE_SCHEMA_VERSION as SKILLS_LOCKFILE_SCHEMA_VERSION, LockfileParseError as SkillsLockfileParseError, LockfileValidationError as SkillsLockfileValidationError, buildLockfile as buildSkillsLockfile, computeSkillHash as computeSkillContentHash, findLockfile as findSkillsLockfile, loadLockfile as loadSkillsLockfile, parseLockfile as parseSkillsLockfile, validateLockfileEntry as validateSkillsLockfileEntry, writeLockfile as writeSkillsLockfile, } from './skills/lockfile.js';
+export type { Lockfile as SkillsLockfile, LockfileEntry as SkillsLockfileEntry, LockfileValidation as SkillsLockfileValidation, } from './skills/lockfile.js';
+export { QodoSkillsMcpServer, asMcpHandler as asQodoSkillsMcpHandler, QODO_SKILLS_TOOL_NAMES, qodoSkillsFunctionToolDefs, LIST_SKILLS_DEFAULT_LIMIT, resolveSkillFilePath as resolveQodoSkillFilePath, validateRelativePath as validateQodoSkillFilePath, SkillPathError, } from './skills/mcp/index.js';
+export type { QodoSkillsToolName, GetSkillArgs, GetSkillFileArgs, ListSkillsArgs, ListSkillsEntry, ListSkillsResponse, McpContent as QodoSkillsMcpContent, McpImageContent as QodoSkillsMcpImageContent, McpTextContent as QodoSkillsMcpTextContent, McpToolResult as QodoSkillsMcpToolResult, QodoSkillsMcpEvent, ResolvedSkillPath as ResolvedQodoSkillFilePath, } from './skills/mcp/index.js';
+export { getCurrentVersion } from './version.js';
+export type { Flags } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,46 +1,169 @@
-// Main SDK
-export { QodoSDK } from './sdk/index.js';
-// Events
-export { SdkEventType, SDK_PROTOCOL_V2, matchSdkEvent, createSdkEvent, getSdkVersion, } from './sdk/events.js';
-// Builders (Zod-first)
-export { sdkAgent, sdkCommand, sdkArgs } from './sdk/builders.js';
-export { zodOutputSchema, zodArgsSchema, zCoerce, zJsonValue, zJsonAny, parseArgsWithSchema, QodoSchemaError, } from './sdk/schemas.js';
-// Re-export zod for convenience and type compatibility
-// Users can import { z } from '@qodo/sdk' to ensure compatibility with SDK schema functions
-export { z } from 'zod/v3';
-// Info, Sessions & Tools clients
-export { QodoInfoClient } from './clients/info/index.js';
-export { QodoSessionsClient } from './clients/sessions/index.js';
-export { QodoToolsClient } from './clients/tools/index.js';
-// Agent discovery & defaults
-export { findNearestAgentConfig } from './sdk/discovery.js';
-export { buildDefaultSdkAgentConfig } from './sdk/defaults.js';
-// Tracking
-export { QodoTracker } from './tracking/index.js';
-// Version
-export { getCurrentVersion } from './version.js';
-// Message types (internal replacements for @langchain/core/messages)
-export { BaseMessage, HumanMessage, AIMessage, SystemMessage, ToolMessage, } from './messages/index.js';
-export { convertMessagesToOpenAI } from './messages/index.js';
-// Pipeline DSL
-export { sdkPipeline, PipelineBuilder, Pipeline, runPipeline, PipelineExecutionError } from './sdk/pipeline/index.js';
-// Declarative Pipeline
-export { compileDeclarativePipeline, DeclarativePipelineValidationError } from './sdk/pipeline/index.js';
-export { ToolMiddlewareError, MIDDLEWARE_TIMEOUT_MS, PROTECTED_TOOL_FIELDS } from './sdk/middleware.js';
-// Tool Approval Policy DSL
-export { sdkPolicy, policyFromRules, Policy, PolicyBuilder, globMatch } from './sdk/policies.js';
-// Artifacts (pipeline intermediate results)
-export { ArtifactStore, jsonSerializer, withArtifacts } from './sdk/artifacts.js';
-// Structured output validation
-export { QodoOutputValidationError } from './sdk/runner/finalize.js';
-// OpenTelemetry tracing adapter
+/**
+ * `@qodo/sdk` 2.0 — public API surface.
+ *
+ * QAR-native typed bindings. The shape mirrors QAR's envelope vocabulary
+ * one level up; consumers `for await` `client.tasks.start({...})` and
+ * switch on `event.kind`. There is no adapter layer, no `QODO_RUNTIME`
+ * flag, no parallel 1.x client. SDK 1.x lives on `release/1.x`.
+ */
+// ---------------------------------------------------------------------------
+// Top-level client surface
+// ---------------------------------------------------------------------------
+export { QodoClient } from './client/QodoClient.js';
+export { TaskClient } from './client/TaskClient.js';
+export { ToolClient } from './client/ToolClient.js';
+export { PipelineClient, PipelineBuilder } from './client/PipelineClient.js';
+export { BulletinClient } from './client/BulletinClient.js';
+export { ArtifactsClient } from './client/ArtifactsClient.js';
+export { StateClient } from './client/StateClient.js';
+export { AgentsClient } from './client/AgentsClient.js';
+export { QarRegistryClient } from './client/QarRegistryClient.js';
+// SDK-side MCP tool projection. `projectMcpTools` is the pure function
+// the SDK calls at `tasks.startWithAgent` / `tasks.startWithGraph` to
+// resolve `mcpTools` against the live `McpClientPool` catalog; exported
+// so consumers can pre-flight the projection locally (CI lint, Studio
+// previews) without going through the wire boundary.
+export { projectMcpTools } from './client/mcp/projection.js';
+// Errors thrown by client surface methods.
+export { QodoNotImplementedError, QodoClientOptionsError, QodoTransportError, QodoBackpressureError, QodoSpecValidationError, QodoRegistryConflictError, QodoWireValidationError, QodoInlineGraphValidationError, 
+// Inline-agent intake errors — pre-wire (client-side forbidden-key
+// rejection) and post-wire (server's `agent_spec_rejected` envelope
+// surfacing as a typed throw).
+QodoInlineAgentValidationError, QodoAgentSpecRejectedError, 
+// Typed server-error family — cancel / resume / HITL / graph codes
+// routed through subscription iterators as typed throws.
+QodoServerError, QodoCancelRoutingFailedError, QodoCancelFailedError, QodoTaskNotFoundError, QodoTaskNotWaitingError, QodoAgentReconstructionFailedError, QodoCrossPodResumeAbortedError, QodoDepsConstructionFailedError, QodoMessageHistoryLoadFailedError, QodoHitlPersistFailedError, QodoHitlSubstrateUnavailableError, QodoUnauthorizedResolverError, QodoInvalidResolutionError, QodoGraphSpecRejectedError, QodoUnknownServerError, 
+// Admission / idempotency-key typed errors. The first is thrown
+// synchronously by `tasks.start*` when the consumer-supplied
+// `idempotencyKey` fails pre-wire validation. The latter two arrive
+// on the iterator (or via `await stream.sessionId`) when QAR-side
+// admission exceeds its operator timeout — `Stalled` is the
+// server-emitted terminal, `Timeout` is the SDK-side cap on the retry
+// budget.
+QodoIdempotencyKeyValidationError, QodoAdmissionStalledError, QodoAdmissionTimeoutError, 
+// Typed error thrown on `await stream.sessionId` (or
+// `.admittedTaskId`) when the consumer breaks the iterator before
+// admission completes — distinguishes voluntary abort from genuine
+// admission failure.
+QodoStreamAbortedError, 
+// Typed error thrown when QAR rejects an outbound envelope with
+// `session_mismatch` — fires when the consumer-supplied `sessionId`
+// override on a cold-address API call doesn't actually match the
+// server's bound session for the referenced task.
+QodoSessionMismatchError, 
+// Synchronous typed throw on cold-address ongoing API calls
+// (`tasks.cancel` / `tasks.continue` / `tasks.resubscribe` /
+// `tools.respond`) when the SDK has no in-memory session AND the
+// caller didn't pass `sessionId` in the options.
+QodoColdAddressError, 
+// Typed throw on `tasks.cancel` when the consumer-supplied
+// AbortSignal fires before task.done arrives. Distinguishes
+// intentional abort from server-side cancel failure.
+QodoCancelAbortedError, classForServerErrorCode, ToolDeniedError, 
+// Typed MCP transport / tool-invocation errors. Connection failures
+// (`Client.connect`, `listTools` pre-fetch) surface as
+// QodoMcpClientError; runtime tool-invocation failures
+// (`Client.callTool` transport error OR MCP `isError: true` envelope)
+// surface as QodoMcpToolError.
+QodoMcpClientError, QodoMcpToolError, 
+// MCP projection errors — surfaced synchronously by
+// `tasks.startWithAgent` / `tasks.startWithGraph` BEFORE the wire write
+// when the consumer's `mcpTools` selector drifts from the live registry
+// / catalog.
+QodoUnknownMcpError, QodoUnknownMcpToolError, QodoMcpUnavailableError, 
+// Cold-start helper — thrown synchronously by `tasks.continueOrStart`
+// when `graphSpec` is undefined. Consumers without a graphSpec on hand
+// should reach for `tasks.continue` (known taskId) or
+// `tasks.forceResume` (stuck-session recovery) directly.
+RequiredGraphSpecError, } from './client/errors.js';
+// Pre-wire validator helper exposed for consumer-side CI gates that
+// want to lint inline AgentSpecs without round-tripping the wire (e.g.,
+// a pre-commit hook on a workflow repo).
+export { collectInlineAgentSpecPreWireIssues } from './qar/agentSpec.js';
+// `defineFunctionTool` — Zod-schema → OpenAI function-tool helper. The
+// returned object is a `FunctionToolDef` with the runtime handler
+// attached on a symbol-keyed property; auto-dispatched at
+// `tasks.startWithAgent` / `tasks.startWithGraph` time via the
+// per-client `FunctionToolRouter`. Hand-authored `FunctionToolDef`
+// literals continue to work unchanged.
+export { defineFunctionTool, getFunctionToolHandler, FUNCTION_TOOL_HANDLER_KEY, } from './client/tools/defineFunctionTool.js';
+// Inline-graph validator — exported for consumers who want to run the
+// SDK-side rule subset check off-band (CI gates, custom flows).
+export { validateInlineGraphSpec, DEFAULT_INLINE_GRAPH_MAX_DEPTH, } from './client/inlineGraph.js';
+// Transport plug — consumers BYO a fake WS for tests, or override the default
+// `ws`-based factory entirely. `validateCloseReason` +
+// `CLOSE_FRAME_REASON_MAX_BYTES` are exposed for custom-transport
+// authors who want the same RFC-6455 reason-length check the default
+// factory uses; both are platform-neutral so the browser stub re-exports
+// them identically.
+export { defaultTransportFactory, validateCloseReason, CLOSE_FRAME_REASON_MAX_BYTES, } from './client/transport.js';
+export { CLIENT_TO_SERVER_KINDS, SERVER_TO_CLIENT_KINDS, BIDIRECTIONAL_KINDS, } from './qar/envelopes.js';
+export { isClientEvent } from './qar/clientEvents.js';
+// ---------------------------------------------------------------------------
+// Auth — bearer model unchanged from 1.x
+// ---------------------------------------------------------------------------
+export { AuthProvider, QodoAuthError } from './auth/index.js';
+// ---------------------------------------------------------------------------
+// Observability — OTel attribute keys + tracing adapter shape
+// ---------------------------------------------------------------------------
 export { SdkTracer, createSdkTracer } from './tracing/index.js';
 export { tracePipeline } from './tracing/index.js';
-// CI Trigger Context
-export { resolveTriggerContext } from './sdk/trigger-context.js';
-// Exit Expression
-export { evaluateExitExpression } from './sdk/exit-expression.js';
-// Error classes
-export { QodoAuthError, AuthProvider } from './auth/index.js';
-export { QodoBackendBootstrapError } from './session/serverData.js';
+export { SERVICE_NAME, SERVICE_VERSION, SERVICE_NAMESPACE, SERVICE_NAME_VALUE, SERVICE_NAMESPACE_VALUE, QAR_SESSION_ID, QAR_MESSAGE_ID, QAR_PARENT_MESSAGE_ID, QAR_TASK_ID, QAR_ENVELOPE_KIND, QAR_TOOL_NAME, QAR_TOOL_CALL_ID, QAR_TOOL_ORIGIN, QAR_TOOL_OUTCOME, QAR_NODE_NAME, QAR_SKILL_NAME, QAR_AGENT_ID, QAR_GRAPH_ENTRY, QAR_GRAPH_DEPTH, QAR_AGENT_KIND, QAR_AGENT_ROLE, QAR_EVALUATOR_VERDICT, QAR_EVALUATOR_CONFIDENCE, GEN_AI_CONVERSATION_ID, GEN_AI_OPERATION_NAME, GEN_AI_OP_INVOKE_AGENT, GEN_AI_OP_EXECUTE_TOOL, SKIPPED_ATTRIBUTES, SPAN_TASK_OBSERVED, SPAN_TASK_START, SPAN_TASK_CONTINUE, SPAN_TASK_CANCEL, SPAN_TASK_RESUBSCRIBE, SPAN_TOOL_REQUEST, SPAN_TOOL_RESPOND, SPAN_TOOL_HANDLER, SPAN_CONNECT, SPAN_DISCONNECT, SPAN_PIPELINE, SPAN_PIPELINE_STEP, QAR_PIPELINE_STEP_NAME, QAR_PIPELINE_GATE_PASSED, QAR_PIPELINE_COLLECTED_ERRORS, QAR_PIPELINE_GATED, TOOL_ORIGIN_SDK_SIDE, TOOL_OUTCOME_SUCCESS, TOOL_OUTCOME_ERROR, TOOL_OUTCOME_DENIED, } from './observability/index.js';
+// Wire-level reconnect/replay counters surfaced on
+// `client.transportMetrics`.
+export { TransportMetrics } from './observability/transportMetrics.js';
+// ---------------------------------------------------------------------------
+// Skills foundation
+//
+// Consumers reach the skills layer two ways:
+//   1. Via `ClientOptions.skills` at construction. The client owns a
+//      `SkillsManager` instance and `tasks.startWithAgent` /
+//      `tasks.startWithGraph` auto-inject the slim `<available_skills>`
+//      block into inline-agent instructions before each wire write.
+//   2. Via `client.skills` for direct introspection — `list()`, `get()`.
+//
+// The foundation includes parser + validator + manager + renderer +
+// injection, the in-process `qodo-skills` MCP server, trust enforcement,
+// lockfile, and hot reload.
+// ---------------------------------------------------------------------------
+export { SkillsManager, SkillNotFoundError, SkillAmbiguousPinError, SkillsBudgetExceededError, QodoSkillError, } from './skills/manager.js';
+// Trust model helpers + structured construction-time error.
+export { isSkillTrusted, SkillsTrustConfigError, sourceIdentityKey, validateTrustedSources, } from './skills/trust.js';
+// Activation pipeline. Re-exported so consumers can drive the resolver
+// themselves (e.g., a UI that previews a pin list's effects before
+// dispatching).
+export { activationFailureMessage, lookupFromSnapshot, renderActiveSkillsBlock, resolveActivationGraph, resolveAllActivations, } from './skills/activation.js';
+export { renderSlimIndex } from './skills/render.js';
+export { injectIntoAgentSpec, injectIntoGraphSpec } from './skills/inject.js';
+export { DEFAULT_INDEX_CHAR_BUDGET, REQUIRES_DEFAULT_MAX_DEPTH, REQUIRES_DEFAULT_MAX_TRANSITIVE, REQUIRES_DEFAULT_MAX_TRANSITIVE_TOKENS, SLIM_INDEX_ENTRY_BUDGET, SKILL_BODY_HARD_BYTES, } from './skills/types.js';
+// Event factories + canonical kind catalog.
+export { SKILL_EVENT_KINDS, eventSubjectFqn, } from './skills/events.js';
+// Argument substitutions (`$ARGUMENTS`, `$N`, `${QODO_*}`).
+export { parseArgv as parseSkillArgv, substitute as substituteSkillBody, substituteWithArgumentsTrailer as substituteSkillBodyWithTrailer, } from './skills/substitute.js';
+// `SkillKit` testing toolkit. Authors import for CI-side validation,
+// snapshot tests, and activation-rank simulation without round-tripping
+// through the runtime client surface.
+export { SkillKit } from './skills/testing/index.js';
+// `qodo-skills` CLI dispatcher. Exposed as a library function so
+// consumers can embed the dispatcher inside a larger CLI surface; the
+// binary entrypoint `bin/qodo-skills.mjs` defers to the same function.
+export { runSkillsCli, defaultCliIo } from './skills/cli/index.js';
+// Lockfile API. Consumers + the `qodo skills` CLI
+// reuse the same parser, writer, hasher, and validation entrypoints the
+// manager uses at boot, so a single discovery+lock pipeline lives across
+// runtime + tooling.
+export { LOCKFILE_BASENAME as SKILLS_LOCKFILE_BASENAME, LOCKFILE_SCHEMA_VERSION as SKILLS_LOCKFILE_SCHEMA_VERSION, LockfileParseError as SkillsLockfileParseError, LockfileValidationError as SkillsLockfileValidationError, buildLockfile as buildSkillsLockfile, computeSkillHash as computeSkillContentHash, findLockfile as findSkillsLockfile, loadLockfile as loadSkillsLockfile, parseLockfile as parseSkillsLockfile, validateLockfileEntry as validateSkillsLockfileEntry, writeLockfile as writeSkillsLockfile, } from './skills/lockfile.js';
+// ---------------------------------------------------------------------------
+// `qodo-skills` MCP server.
+//
+// Auto-registered by `QodoClient` when `ClientOptions.skills` is provided.
+// Consumers usually reach the server indirectly through
+// `client.skillsMcpServer` / `client.qar.getMcp('qodo-skills')`; the
+// standalone exports here exist for tests and bespoke dispatch flows.
+// ---------------------------------------------------------------------------
+export { QodoSkillsMcpServer, asMcpHandler as asQodoSkillsMcpHandler, QODO_SKILLS_TOOL_NAMES, qodoSkillsFunctionToolDefs, LIST_SKILLS_DEFAULT_LIMIT, resolveSkillFilePath as resolveQodoSkillFilePath, validateRelativePath as validateQodoSkillFilePath, SkillPathError, } from './skills/mcp/index.js';
+// ---------------------------------------------------------------------------
+// Misc
+// ---------------------------------------------------------------------------
+export { getCurrentVersion } from './version.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AASzC,SAAS;AACT,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AA2BzB,uBAAuB;AACvB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,uDAAuD;AACvD,4FAA4F;AAC5F,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,iCAAiC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,6BAA6B;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYlD,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qEAAqE;AACrE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AActH,uBAAuB;AACvB,OAAO,EAAE,0BAA0B,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAKzG,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAExG,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGjG,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGlF,+BAA+B;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,gCAAgC;AAChC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,qBAAqB;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/observability/attributes.d.ts

@@ -0,0 +1,136 @@
+/**
+ * OTel attribute keys used by the SDK 2.0 observability layer.
+ *
+ * Mirrors QAR's `src/qar/observability/attributes.py` discipline: every attribute
+ * string lives here, never inline. Per-attribute notes record the rationale so
+ * future implementers don't accidentally re-add keys that were
+ * intentionally skipped on the SDK side.
+ *
+ * Span emission lives in `src/observability/spans.ts` (per-public-API,
+ * client-side) and `src/tracing/SdkTracer.ts` (observer-side). Attribute
+ * strings are read from this module exclusively — grep for `qar.` /
+ * `gen_ai.` outside this file fails the audit test.
+ */
+export declare const SERVICE_NAME: "service.name";
+export declare const SERVICE_VERSION: "service.version";
+export declare const SERVICE_NAMESPACE: "service.namespace";
+/** Stamped on every SDK-side span. QAR's spans carry `service.name = "qar"`; correlation across the wire is by `trace_id`, never service identity. */
+export declare const SERVICE_NAME_VALUE: "@qodo/sdk";
+/** Same `qodo` namespace QAR uses, so a Phoenix query filtering `service.namespace = "qodo"` returns SDK + runtime spans. */
+export declare const SERVICE_NAMESPACE_VALUE: "qodo";
+export declare const QAR_SESSION_ID: "qar.session_id";
+export declare const QAR_MESSAGE_ID: "qar.message_id";
+export declare const QAR_PARENT_MESSAGE_ID: "qar.parent_message_id";
+export declare const QAR_TASK_ID: "qar.task_id";
+export declare const QAR_ENVELOPE_KIND: "qar.envelope.kind";
+export declare const QAR_TOOL_NAME: "qar.tool_name";
+export declare const QAR_TOOL_CALL_ID: "qar.tool_call_id";
+/** `"sdk-side"` on every tool span the SDK opens; QAR sets `"runtime-side"` / `"mcp:<server>"` on its own. */
+export declare const QAR_TOOL_ORIGIN: "qar.tool_origin";
+export declare const QAR_TOOL_OUTCOME: "qar.tool_outcome";
+/**
+ * Originating node name for parallel-batched tool calls. Set on every
+ * `qar.client.tool.handler` and `qar.client.tool.respond` span:
+ * `default` (or the configured agent
+ * identifier) for single-agent Pattern A/B, the graph node id for Pattern C.
+ * Without this, multi-node graphs with parallel in-flight tool calls couldn't
+ * be disambiguated in traces.
+ */
+export declare const QAR_NODE_NAME: "qar.node_name";
+export declare const QAR_SKILL_NAME: "qar.skill_name";
+export declare const QAR_AGENT_ID: "qar.agent_id";
+/**
+ * Inline-graph attributes. Set on the `qar.client.task.start` span the
+ * SDK opens for an inline-graph dispatch.
+ *
+ *   - `qar.graph.entry`  — entry-point node name (`graph.entry`).
+ *   - `qar.graph.depth`  — longest acyclic path length from `entry`, computed
+ *     client-side at validate-time. Lets traces distinguish flat fan-outs
+ *     (depth 1) from deeply-nested chains without re-parsing the spec.
+ *   - `qar.agent.kind`   — closed value set `"inline" | "agent_id"`. The
+ *     SDK stamps the parent `qar.client.task.start` span with `"inline"`
+ *     when *any* node carries an inline `AgentSpec` and `"agent_id"` when
+ *     every node is a server-static reference. QAR's per-node spans use
+ *     the same vocabulary, set per-node from each agent's shape.
+ */
+export declare const QAR_GRAPH_ENTRY: "qar.graph.entry";
+export declare const QAR_GRAPH_DEPTH: "qar.graph.depth";
+export declare const QAR_AGENT_KIND: "qar.agent.kind";
+/**
+ * Evaluator attributes. Set on per-node spans QAR emits when the runtime
+ * dispatches an evaluator node and a `VerdictResult` returns.
+ *
+ *   - `qar.agent.role`            — closed enum from `InlineGraphRole`.
+ *   - `qar.evaluator.verdict`     — `verdict` from the returned `VerdictResult`.
+ *   - `qar.evaluator.confidence`  — `confidence` from the same (if present).
+ *
+ * SDK-side these are exported strings; QAR's `dispatch_evaluator` stamps
+ * them on the matching server-side span. The SDK never sees the verdict
+ * payload directly — it surfaces through QAR's runtime trace.
+ */
+export declare const QAR_AGENT_ROLE: "qar.agent.role";
+export declare const QAR_EVALUATOR_VERDICT: "qar.evaluator.verdict";
+export declare const QAR_EVALUATOR_CONFIDENCE: "qar.evaluator.confidence";
+export declare const GEN_AI_CONVERSATION_ID: "gen_ai.conversation.id";
+export declare const GEN_AI_OPERATION_NAME: "gen_ai.operation.name";
+/** Sub-agent activation reports `"invoke_agent"`; the spawn-vs-invoke nuance lives on `qar.spawn_protocol`, not by overloading the operation name. */
+export declare const GEN_AI_OP_INVOKE_AGENT: "invoke_agent";
+/** Per OTel GenAI semconv: tool execution. */
+export declare const GEN_AI_OP_EXECUTE_TOOL: "execute_tool";
+/**
+ * Tuple of attribute strings the SDK is intentionally NOT setting on its own
+ * spans. Tests + audits import this; emission code never does.
+ *
+ * Rationale per entry:
+ *   - `qar.tenant_id`            — resolved by QAR via `/platform/v2/users`. SDK never sees the tenant id.
+ *   - `qar.principal_id`         — same: resolved server-side from the bearer token.
+ *   - `qar.deployment_kind`      — server-side concept (`qodo-cloud` vs `self-tenant`); the SDK is identical across both.
+ *   - `qar.skill_version`        — bound at task-start by QAR's skill registry.
+ *   - `qar.skill_state_schema_v` — same: resolved by the server's skill loader.
+ *   - `qar.skill_invocation_id`  — minted by QAR per skill activation.
+ *   - `qar.skill_activation`     — `"agent" | "user" | "always"`; server-side bookkeeping.
+ *   - `gen_ai.provider.name`     — provider chosen by QAR's gateway/router; SDK never sees model details.
+ *   - `gen_ai.request.model`     — same: chosen at dispatch time.
+ *   - `gen_ai.request.temperature`, `gen_ai.request.top_p`, `gen_ai.request.max_tokens` — request params QAR sends to the LLM provider.
+ *   - `gen_ai.response.model`    — model that actually answered (provider may downgrade); only QAR sees it.
+ *   - `gen_ai.response.finish_reason` / `gen_ai.response.finish_reasons` — emitted by the LLM provider span.
+ *   - `gen_ai.usage.input_tokens`, `gen_ai.usage.output_tokens`, `gen_ai.usage.total_tokens` — token accounting attached to the LLM-provider span.
+ *   - `qar.usage.cost_usd`       — cost rollup computed by QAR over the LLM response.
+ *   - `qar.bulletin.topic`, `qar.bulletin.from_agent`, `qar.bulletin.to_agent` — server-emitted on `bulletin.post` envelopes; the SDK forwards as wire payloads, doesn't attach to its own spans.
+ *   - `qar.state.skill`, `qar.state.op`, `qar.state.size_bytes`, `qar.state.schema_version` — server-emitted on `state.update` envelopes; same forwarding rule.
+ *
+ * (Order: server-only identity first (tenant / principal / deployment),
+ *  then skill bookkeeping, then `gen_ai.*` LLM-call detail, then
+ *  per-envelope server-side attrs.)
+ */
+export declare const SKIPPED_ATTRIBUTES: readonly ["qar.tenant_id", "qar.principal_id", "qar.deployment_kind", "qar.skill_version", "qar.skill_state_schema_v", "qar.skill_invocation_id", "qar.skill_activation", "gen_ai.provider.name", "gen_ai.request.model", "gen_ai.request.temperature", "gen_ai.request.top_p", "gen_ai.request.max_tokens", "gen_ai.response.model", "gen_ai.response.finish_reason", "gen_ai.response.finish_reasons", "gen_ai.usage.input_tokens", "gen_ai.usage.output_tokens", "gen_ai.usage.total_tokens", "qar.usage.cost_usd", "qar.bulletin.topic", "qar.bulletin.from_agent", "qar.bulletin.to_agent", "qar.state.skill", "qar.state.op", "qar.state.size_bytes", "qar.state.schema_version"];
+export type SkippedAttribute = (typeof SKIPPED_ATTRIBUTES)[number];
+/** Observer-side span name — used by `SdkTracer.onEvent` for the per-task lifecycle it stitches from inbound envelopes. Distinct from the per-public-API `qar.client.task.start`. */
+export declare const SPAN_TASK_OBSERVED: "qar.client.task.observed";
+export declare const SPAN_TASK_START: "qar.client.task.start";
+export declare const SPAN_TASK_CONTINUE: "qar.client.task.continue";
+export declare const SPAN_TASK_CANCEL: "qar.client.task.cancel";
+export declare const SPAN_TASK_RESUBSCRIBE: "qar.client.task.resubscribe";
+export declare const SPAN_TOOL_REQUEST: "qar.client.tool.request";
+export declare const SPAN_TOOL_RESPOND: "qar.client.tool.respond";
+/** Span around an inbound `tool.request` → registered handler invocation. Distinct from `tool.respond` (which covers the WS write). */
+export declare const SPAN_TOOL_HANDLER: "qar.client.tool.handler";
+export declare const SPAN_CONNECT: "qar.client.connect";
+export declare const SPAN_DISCONNECT: "qar.client.disconnect";
+export declare const SPAN_PIPELINE: "qar.client.pipeline";
+export declare const SPAN_PIPELINE_STEP: "qar.client.pipeline.step";
+/** Pipeline child-span attribute — name of the executed step (or gate). */
+export declare const QAR_PIPELINE_STEP_NAME: "qar.pipeline.step_name";
+/** Pipeline gate child-span attribute — whether the predicate evaluated truthy. */
+export declare const QAR_PIPELINE_GATE_PASSED: "qar.pipeline.gate_passed";
+/** Pipeline root-span attribute — count of errors aggregated under `collect` strategy. */
+export declare const QAR_PIPELINE_COLLECTED_ERRORS: "qar.pipeline.collected_errors";
+/** Pipeline root-span attribute — `true` when a gate short-circuited the run. */
+export declare const QAR_PIPELINE_GATED: "qar.pipeline.gated";
+/** Constant value the SDK stamps on tool spans so server-side tools are distinguishable. */
+export declare const TOOL_ORIGIN_SDK_SIDE: "sdk-side";
+/** Tool-outcome value enums — the SDK reports one of these on every closed tool span. */
+export declare const TOOL_OUTCOME_SUCCESS: "success";
+export declare const TOOL_OUTCOME_ERROR: "error";
+export declare const TOOL_OUTCOME_DENIED: "denied";
+//# sourceMappingURL=attributes.d.ts.map

package/dist/observability/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/observability/attributes.ts"],"names":[],"mappings":"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"}