import type { ExactTelemetryAttributes, SchemaTelemetrySpan, TelemetrySchemaSpanEndAttributes, TelemetrySchemaSpanEventAttributes, TelemetrySchemaSpanEventName, TelemetrySchemaSpanName, TelemetrySchemaSpanStartAttributes, TelemetrySchemaSpanUnion } from "@earendil-works/pi-telemetry"; import { type Context } from "./context.ts"; export type { AttributeValue, ExactTelemetryAttributes, SchemaTelemetrySpan, SpanAttributes, SpanOptions, SpanStatus, TelemetryAttributeDefinition, TelemetryAttributeMetadata, TelemetryAttributeType, TelemetryContext, TelemetryEventAttributeDefinition, TelemetryEventDefinition, TelemetryParentDefinition, TelemetrySchemaDefinition, TelemetrySchemaSpanEndAttributes, TelemetrySchemaSpanEventAttributes, TelemetrySchemaSpanEventName, TelemetrySchemaSpanName, TelemetrySchemaSpanStartAttributes, TelemetrySchemaSpanUnion, TelemetrySpan, TelemetrySpanDefinition, TelemetryStartAttributeDefinition, TypedSpanStarter, } from "@earendil-works/pi-telemetry"; export declare const AI_TELEMETRY_SCHEMA: { readonly version: 1; readonly spans: { readonly "pi.ai.request": { readonly description: "One logical request to an AI provider"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.ai.operation": { readonly type: "string"; readonly required: true; readonly values: readonly ["stream", "fetch_deferred", "cancel_deferred", "generate_images"]; readonly description: "Logical provider operation"; }; readonly "pi.ai.provider": { readonly type: "string"; readonly required: true; readonly description: "Selected provider id"; }; readonly "pi.ai.model": { readonly type: "string"; readonly required: true; readonly description: "Requested model id"; }; readonly "pi.ai.api": { readonly type: "string"; readonly required: true; readonly description: "Provider API id"; }; readonly "pi.ai.streaming": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this operation returns a stream"; }; readonly "pi.ai.deferred": { readonly type: "boolean"; readonly required: false; readonly description: "Whether the operation requests or participates in deferred execution"; }; }; readonly endAttributes: { readonly "pi.ai.response.model": { readonly type: "string"; readonly description: "Concrete response model"; }; readonly "pi.ai.response.id": { readonly type: "string"; readonly cardinality: "high"; readonly description: "Provider response id"; }; readonly "pi.ai.response.stop_reason": { readonly type: "string"; readonly values: readonly ["stop", "length", "tool_use", "error", "aborted", "deferred"]; readonly description: "Normalized terminal response reason"; }; readonly "pi.ai.http.status_code": { readonly type: "number"; readonly description: "Final HTTP status"; }; readonly "pi.ai.usage.input_tokens": { readonly type: "number"; readonly description: "Reported input tokens"; }; readonly "pi.ai.usage.output_tokens": { readonly type: "number"; readonly description: "Reported output tokens"; }; readonly "pi.ai.usage.cache_read_tokens": { readonly type: "number"; readonly description: "Reported cache-read tokens"; }; readonly "pi.ai.usage.cache_write_tokens": { readonly type: "number"; readonly description: "Reported cache-write tokens"; }; readonly "pi.ai.usage.reasoning_tokens": { readonly type: "number"; readonly description: "Reported reasoning tokens"; }; readonly "pi.ai.usage.total_tokens": { readonly type: "number"; readonly description: "Reported total tokens"; }; readonly "pi.ai.usage.cost": { readonly type: "number"; readonly description: "Reported total cost"; }; readonly "pi.ai.stream.chunk_count": { readonly type: "number"; readonly description: "Streamed update chunk count"; }; readonly "pi.ai.stream.time_to_first_chunk_ms": { readonly type: "number"; readonly description: "Elapsed milliseconds to first update chunk"; }; readonly "pi.ai.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Provider or transport error class"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The operation throws or returns an error result"; }; }; }; }; export type AiSpanName = TelemetrySchemaSpanName; export type AiSpanStartAttributes = TelemetrySchemaSpanStartAttributes; export type AiSpanEndAttributes = TelemetrySchemaSpanEndAttributes; export type AiSpanAttributes = AiSpanStartAttributes & AiSpanEndAttributes; export type AiSpanEventName = TelemetrySchemaSpanEventName; export type AiSpanEventAttributes> = TelemetrySchemaSpanEventAttributes; export type AiTelemetrySpan = SchemaTelemetrySpan; export type AiSpan = TelemetrySchemaSpanUnion; export declare function startAiSpan, Result>(name: Name, attributes: ExactTelemetryAttributes, Attributes>, callback: (span: AiTelemetrySpan, context: Context) => Result | Promise, context: Context): Promise; export declare const HARNESS_TELEMETRY_SCHEMA: { readonly version: 1; readonly spans: { readonly "pi.harness.run": { readonly description: "One admitted in-process run invocation"; readonly parents: { readonly kind: "root_or_external"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.operation.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this invocation resumes durable work"; }; readonly "pi.operation.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["run"]; readonly description: "Run operation kind"; }; }; readonly endAttributes: { readonly "pi.error.code": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Stable operation error code"; }; readonly "pi.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Low-cardinality operation error class"; }; readonly "pi.operation.outcome": { readonly type: "string"; readonly values: readonly ["completed", "aborted", "failed", "suspended"]; readonly description: "Run invocation outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The run fails or throws"; }; }; readonly "pi.harness.compaction": { readonly description: "One admitted in-process manual compaction invocation"; readonly parents: { readonly kind: "root_or_external"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.operation.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this invocation resumes durable work"; }; readonly "pi.operation.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["compaction"]; readonly description: "Compaction operation kind"; }; }; readonly endAttributes: { readonly "pi.error.code": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Stable operation error code"; }; readonly "pi.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Low-cardinality operation error class"; }; readonly "pi.operation.outcome": { readonly type: "string"; readonly values: readonly ["completed", "declined", "aborted", "failed"]; readonly description: "Compaction invocation outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The compaction fails or throws"; }; }; readonly "pi.harness.navigation": { readonly description: "One admitted in-process navigation invocation"; readonly parents: { readonly kind: "root_or_external"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.operation.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this invocation resumes durable work"; }; readonly "pi.operation.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["navigation"]; readonly description: "Navigation operation kind"; }; }; readonly endAttributes: { readonly "pi.error.code": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Stable operation error code"; }; readonly "pi.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Low-cardinality operation error class"; }; readonly "pi.operation.outcome": { readonly type: "string"; readonly values: readonly ["completed", "declined", "aborted", "failed"]; readonly description: "Navigation invocation outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The navigation fails or throws"; }; }; readonly "pi.harness.checkpoint": { readonly description: "One run checkpoint"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.run"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.checkpoint.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["normal", "abort_reconcile"]; readonly description: "Checkpoint purpose"; }; }; readonly endAttributes: {}; readonly status: { readonly default: "ok"; readonly errorWhen: "Checkpoint work throws"; }; }; readonly "pi.harness.turn": { readonly description: "One assistant response and its tool batch"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.run"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.turn.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Invocation-local turn id"; }; }; readonly endAttributes: {}; readonly status: { readonly default: "ok"; readonly errorWhen: "Turn work throws"; }; }; readonly "pi.harness.step": { readonly description: "One durable retry attempt"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.turn", "pi.harness.checkpoint", "pi.harness.compaction", "pi.harness.navigation"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.step.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["assistant", "compaction", "branch_summary"]; readonly description: "Retryable step kind"; }; readonly "pi.step.attempt": { readonly type: "number"; readonly required: true; readonly description: "One-based durable attempt number"; }; readonly "pi.compaction.reason": { readonly type: "string"; readonly required: false; readonly values: readonly ["manual", "threshold", "overflow"]; readonly description: "Compaction trigger"; }; }; readonly endAttributes: { readonly "pi.step.outcome": { readonly type: "string"; readonly values: readonly ["succeeded", "retry", "failed", "aborted", "deferred", "overflow"]; readonly description: "Attempt outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The attempt retries, fails, or throws"; }; }; readonly "pi.harness.tool": { readonly description: "One raw phase-2 tool execution"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.turn", "pi.harness.run"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.turn.id": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Invocation-local live turn id"; }; readonly "pi.tool.name": { readonly type: "string"; readonly required: true; readonly description: "Tool name"; }; readonly "pi.tool.call_id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Tool call id"; }; readonly "pi.tool.replay": { readonly type: "string"; readonly required: true; readonly values: readonly ["never", "safe"]; readonly description: "Declared replay policy"; }; readonly "pi.tool.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this is recovery execution"; }; }; readonly endAttributes: { readonly "pi.tool.is_error": { readonly type: "boolean"; readonly description: "Whether raw phase-2 execution returned an error"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "Raw phase-2 execution returns an error"; }; }; readonly "pi.harness.hook": { readonly description: "One registered hook handler invocation"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Durable operation id when accepted"; }; readonly "pi.hook.name": { readonly type: "string"; readonly required: true; readonly values: readonly ["before_run", "before_drive", "before_run_end", "transform_context", "before_request", "before_payload", "after_response", "before_tool", "after_tool", "before_compaction", "before_navigation"]; readonly description: "Hook name"; }; readonly "pi.hook.registration_id": { readonly type: "string"; readonly required: false; readonly description: "Optional hook registration metadata"; }; }; readonly endAttributes: { readonly "pi.hook.outcome": { readonly type: "string"; readonly values: readonly ["completed", "skipped", "blocked", "failed"]; readonly description: "Handler outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The handler throws"; }; }; readonly "pi.harness.sleep": { readonly description: "One retry delay"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.run", "pi.harness.compaction", "pi.harness.navigation", "pi.harness.turn", "pi.harness.checkpoint"]; }; readonly startAttributes: { readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.sleep.delay_ms": { readonly type: "number"; readonly required: true; readonly description: "Requested delay in milliseconds"; }; }; readonly endAttributes: { readonly "pi.sleep.outcome": { readonly type: "string"; readonly values: readonly ["elapsed", "aborted"]; readonly description: "Delay outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "Sleep work throws"; }; }; readonly "pi.harness.event_handler": { readonly description: "One passive event listener invocation"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.event.type": { readonly type: "string"; readonly required: true; readonly cardinality: "low"; readonly values: readonly ["run_start", "run_resume", "run_suspend", "operation_abort", "run_end", "fault", "handler_error", "turn_start", "turn_end", "retry_scheduled", "retry_start", "retry_end", "message_start", "message_update", "message_end", "tool_start", "tool_update", "tool_end", "entry_added", "queue_update", "value_update", "config_update", "compaction_start", "compaction_end", "navigation_start", "navigation_end", "lane_created", "usage"]; readonly description: "Delivered harness event type"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Lane name for lane-scoped events"; }; }; readonly endAttributes: {}; readonly status: { readonly default: "ok"; readonly errorWhen: "The listener throws"; }; }; readonly "pi.session.write": { readonly description: "One committed session transaction"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Lane name when supplied by the caller"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Durable operation id when supplied by the caller"; }; readonly "pi.session.item_count": { readonly type: "number"; readonly required: true; readonly description: "Number of writes in the transaction"; }; readonly "pi.session.item_kinds": { readonly type: "string[]"; readonly required: true; readonly elementValues: readonly ["entry", "usage", "value", "list"]; readonly description: "Distinct write kinds in the transaction"; }; }; readonly endAttributes: { readonly "pi.session.first_seq": { readonly type: "number"; readonly description: "First committed sequence in the transaction"; }; readonly "pi.session.last_seq": { readonly type: "number"; readonly description: "Last committed sequence in the transaction"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "Storage rejects the transaction"; }; }; }; }; /** Combined typed span vocabulary for agent-owned AI-request and harness telemetry. */ export declare const AGENT_TELEMETRY_SCHEMAS: readonly [{ readonly version: 1; readonly spans: { readonly "pi.ai.request": { readonly description: "One logical request to an AI provider"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.ai.operation": { readonly type: "string"; readonly required: true; readonly values: readonly ["stream", "fetch_deferred", "cancel_deferred", "generate_images"]; readonly description: "Logical provider operation"; }; readonly "pi.ai.provider": { readonly type: "string"; readonly required: true; readonly description: "Selected provider id"; }; readonly "pi.ai.model": { readonly type: "string"; readonly required: true; readonly description: "Requested model id"; }; readonly "pi.ai.api": { readonly type: "string"; readonly required: true; readonly description: "Provider API id"; }; readonly "pi.ai.streaming": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this operation returns a stream"; }; readonly "pi.ai.deferred": { readonly type: "boolean"; readonly required: false; readonly description: "Whether the operation requests or participates in deferred execution"; }; }; readonly endAttributes: { readonly "pi.ai.response.model": { readonly type: "string"; readonly description: "Concrete response model"; }; readonly "pi.ai.response.id": { readonly type: "string"; readonly cardinality: "high"; readonly description: "Provider response id"; }; readonly "pi.ai.response.stop_reason": { readonly type: "string"; readonly values: readonly ["stop", "length", "tool_use", "error", "aborted", "deferred"]; readonly description: "Normalized terminal response reason"; }; readonly "pi.ai.http.status_code": { readonly type: "number"; readonly description: "Final HTTP status"; }; readonly "pi.ai.usage.input_tokens": { readonly type: "number"; readonly description: "Reported input tokens"; }; readonly "pi.ai.usage.output_tokens": { readonly type: "number"; readonly description: "Reported output tokens"; }; readonly "pi.ai.usage.cache_read_tokens": { readonly type: "number"; readonly description: "Reported cache-read tokens"; }; readonly "pi.ai.usage.cache_write_tokens": { readonly type: "number"; readonly description: "Reported cache-write tokens"; }; readonly "pi.ai.usage.reasoning_tokens": { readonly type: "number"; readonly description: "Reported reasoning tokens"; }; readonly "pi.ai.usage.total_tokens": { readonly type: "number"; readonly description: "Reported total tokens"; }; readonly "pi.ai.usage.cost": { readonly type: "number"; readonly description: "Reported total cost"; }; readonly "pi.ai.stream.chunk_count": { readonly type: "number"; readonly description: "Streamed update chunk count"; }; readonly "pi.ai.stream.time_to_first_chunk_ms": { readonly type: "number"; readonly description: "Elapsed milliseconds to first update chunk"; }; readonly "pi.ai.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Provider or transport error class"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The operation throws or returns an error result"; }; }; }; }, { readonly version: 1; readonly spans: { readonly "pi.harness.run": { readonly description: "One admitted in-process run invocation"; readonly parents: { readonly kind: "root_or_external"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.operation.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this invocation resumes durable work"; }; readonly "pi.operation.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["run"]; readonly description: "Run operation kind"; }; }; readonly endAttributes: { readonly "pi.error.code": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Stable operation error code"; }; readonly "pi.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Low-cardinality operation error class"; }; readonly "pi.operation.outcome": { readonly type: "string"; readonly values: readonly ["completed", "aborted", "failed", "suspended"]; readonly description: "Run invocation outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The run fails or throws"; }; }; readonly "pi.harness.compaction": { readonly description: "One admitted in-process manual compaction invocation"; readonly parents: { readonly kind: "root_or_external"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.operation.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this invocation resumes durable work"; }; readonly "pi.operation.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["compaction"]; readonly description: "Compaction operation kind"; }; }; readonly endAttributes: { readonly "pi.error.code": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Stable operation error code"; }; readonly "pi.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Low-cardinality operation error class"; }; readonly "pi.operation.outcome": { readonly type: "string"; readonly values: readonly ["completed", "declined", "aborted", "failed"]; readonly description: "Compaction invocation outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The compaction fails or throws"; }; }; readonly "pi.harness.navigation": { readonly description: "One admitted in-process navigation invocation"; readonly parents: { readonly kind: "root_or_external"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.operation.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this invocation resumes durable work"; }; readonly "pi.operation.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["navigation"]; readonly description: "Navigation operation kind"; }; }; readonly endAttributes: { readonly "pi.error.code": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Stable operation error code"; }; readonly "pi.error.type": { readonly type: "string"; readonly cardinality: "low"; readonly description: "Low-cardinality operation error class"; }; readonly "pi.operation.outcome": { readonly type: "string"; readonly values: readonly ["completed", "declined", "aborted", "failed"]; readonly description: "Navigation invocation outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The navigation fails or throws"; }; }; readonly "pi.harness.checkpoint": { readonly description: "One run checkpoint"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.run"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.checkpoint.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["normal", "abort_reconcile"]; readonly description: "Checkpoint purpose"; }; }; readonly endAttributes: {}; readonly status: { readonly default: "ok"; readonly errorWhen: "Checkpoint work throws"; }; }; readonly "pi.harness.turn": { readonly description: "One assistant response and its tool batch"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.run"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.turn.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Invocation-local turn id"; }; }; readonly endAttributes: {}; readonly status: { readonly default: "ok"; readonly errorWhen: "Turn work throws"; }; }; readonly "pi.harness.step": { readonly description: "One durable retry attempt"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.turn", "pi.harness.checkpoint", "pi.harness.compaction", "pi.harness.navigation"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.step.kind": { readonly type: "string"; readonly required: true; readonly values: readonly ["assistant", "compaction", "branch_summary"]; readonly description: "Retryable step kind"; }; readonly "pi.step.attempt": { readonly type: "number"; readonly required: true; readonly description: "One-based durable attempt number"; }; readonly "pi.compaction.reason": { readonly type: "string"; readonly required: false; readonly values: readonly ["manual", "threshold", "overflow"]; readonly description: "Compaction trigger"; }; }; readonly endAttributes: { readonly "pi.step.outcome": { readonly type: "string"; readonly values: readonly ["succeeded", "retry", "failed", "aborted", "deferred", "overflow"]; readonly description: "Attempt outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The attempt retries, fails, or throws"; }; }; readonly "pi.harness.tool": { readonly description: "One raw phase-2 tool execution"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.turn", "pi.harness.run"]; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.turn.id": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Invocation-local live turn id"; }; readonly "pi.tool.name": { readonly type: "string"; readonly required: true; readonly description: "Tool name"; }; readonly "pi.tool.call_id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Tool call id"; }; readonly "pi.tool.replay": { readonly type: "string"; readonly required: true; readonly values: readonly ["never", "safe"]; readonly description: "Declared replay policy"; }; readonly "pi.tool.recovery": { readonly type: "boolean"; readonly required: true; readonly description: "Whether this is recovery execution"; }; }; readonly endAttributes: { readonly "pi.tool.is_error": { readonly type: "boolean"; readonly description: "Whether raw phase-2 execution returned an error"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "Raw phase-2 execution returns an error"; }; }; readonly "pi.harness.hook": { readonly description: "One registered hook handler invocation"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.lane.name": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Lane name"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Durable operation id when accepted"; }; readonly "pi.hook.name": { readonly type: "string"; readonly required: true; readonly values: readonly ["before_run", "before_drive", "before_run_end", "transform_context", "before_request", "before_payload", "after_response", "before_tool", "after_tool", "before_compaction", "before_navigation"]; readonly description: "Hook name"; }; readonly "pi.hook.registration_id": { readonly type: "string"; readonly required: false; readonly description: "Optional hook registration metadata"; }; }; readonly endAttributes: { readonly "pi.hook.outcome": { readonly type: "string"; readonly values: readonly ["completed", "skipped", "blocked", "failed"]; readonly description: "Handler outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "The handler throws"; }; }; readonly "pi.harness.sleep": { readonly description: "One retry delay"; readonly parents: { readonly kind: "spans"; readonly spans: readonly ["pi.harness.run", "pi.harness.compaction", "pi.harness.navigation", "pi.harness.turn", "pi.harness.checkpoint"]; }; readonly startAttributes: { readonly "pi.operation.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Durable operation id"; }; readonly "pi.sleep.delay_ms": { readonly type: "number"; readonly required: true; readonly description: "Requested delay in milliseconds"; }; }; readonly endAttributes: { readonly "pi.sleep.outcome": { readonly type: "string"; readonly values: readonly ["elapsed", "aborted"]; readonly description: "Delay outcome"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "Sleep work throws"; }; }; readonly "pi.harness.event_handler": { readonly description: "One passive event listener invocation"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.event.type": { readonly type: "string"; readonly required: true; readonly cardinality: "low"; readonly values: readonly ["run_start", "run_resume", "run_suspend", "operation_abort", "run_end", "fault", "handler_error", "turn_start", "turn_end", "retry_scheduled", "retry_start", "retry_end", "message_start", "message_update", "message_end", "tool_start", "tool_update", "tool_end", "entry_added", "queue_update", "value_update", "config_update", "compaction_start", "compaction_end", "navigation_start", "navigation_end", "lane_created", "usage"]; readonly description: "Delivered harness event type"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Lane name for lane-scoped events"; }; }; readonly endAttributes: {}; readonly status: { readonly default: "ok"; readonly errorWhen: "The listener throws"; }; }; readonly "pi.session.write": { readonly description: "One committed session transaction"; readonly parents: { readonly kind: "any"; }; readonly startAttributes: { readonly "pi.session.id": { readonly type: "string"; readonly required: true; readonly cardinality: "high"; readonly description: "Session id"; }; readonly "pi.lane.name": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Lane name when supplied by the caller"; }; readonly "pi.operation.id": { readonly type: "string"; readonly required: false; readonly cardinality: "high"; readonly description: "Durable operation id when supplied by the caller"; }; readonly "pi.session.item_count": { readonly type: "number"; readonly required: true; readonly description: "Number of writes in the transaction"; }; readonly "pi.session.item_kinds": { readonly type: "string[]"; readonly required: true; readonly elementValues: readonly ["entry", "usage", "value", "list"]; readonly description: "Distinct write kinds in the transaction"; }; }; readonly endAttributes: { readonly "pi.session.first_seq": { readonly type: "number"; readonly description: "First committed sequence in the transaction"; }; readonly "pi.session.last_seq": { readonly type: "number"; readonly description: "Last committed sequence in the transaction"; }; }; readonly status: { readonly default: "ok"; readonly errorWhen: "Storage rejects the transaction"; }; }; }; }]; export type HarnessSpanName = TelemetrySchemaSpanName; export type HarnessSpanStartAttributes = TelemetrySchemaSpanStartAttributes; export type HarnessSpanEndAttributes = TelemetrySchemaSpanEndAttributes; export type HarnessSpanAttributes = HarnessSpanStartAttributes & HarnessSpanEndAttributes; export type HarnessSpanEventName = TelemetrySchemaSpanEventName; export type HarnessSpanEventAttributes> = TelemetrySchemaSpanEventAttributes; export type HarnessTelemetrySpan = SchemaTelemetrySpan; export type HarnessSpan = TelemetrySchemaSpanUnion; export declare function startHarnessSpan, Result>(name: Name, attributes: ExactTelemetryAttributes, Attributes>, callback: (span: HarnessTelemetrySpan, context: Context) => Result | Promise, context: Context): Promise; //# sourceMappingURL=telemetry.d.ts.map