@harness-kernel/core 0.2.1 → 0.3.0

package/dist/{context-BfpLqV11.d.ts → context-Bz9C_rL9.d.ts}

@@ -1,6 +1,5 @@
 import { c as HarnessRoleSelector } from './role-BN6KhQxx.js';
-import { E as EventCursor, J as JsonObject, a as HarnessEventClass, d as HarnessEventQuery, e as HarnessEventRecord, H as HarnessEvent, b as HarnessEventEmitOptions } from './events-D4xcDi53.js';
-import { b as HarnessLogClass, c as HarnessLogContext } from './types-BPmsw-mF.js';
+import { E as EventCursor, J as JsonObject, a as HarnessErrorCode, H as HarnessErrorCategory, d as HarnessErrorSeverity, g as HarnessEventClass, j as HarnessEventQuery, k as HarnessEventRecord, f as HarnessEvent, h as HarnessEventEmitOptions } from './errors-hpkW3tfR.js';
 import { HarnessSandboxSession } from './runner/sandbox.js';
 
 type AgentMessageRole = "system" | "user" | "assistant" | "tool" | "event" | (string & {});
@@ -51,11 +50,95 @@ interface TranscriptBranch {
     metadata?: JsonObject;
 }
 
+type HarnessLogLevel = "debug" | "info" | "warn" | "error";
+type HarnessLoggingLevel = "silent" | HarnessLogLevel;
+type HarnessLogCategory = "session" | "run" | "turn" | "context" | "model" | "tool" | "approval" | "snapshot" | "transcript" | "storage" | "agent";
+type HarnessLogSourceKind = "runtime" | "model_provider" | "tool" | "hook" | "context_provider" | "mode" | "user" | "custom";
+interface HarnessLogSource {
+    kind: HarnessLogSourceKind;
+    id?: string;
+    type?: string;
+    name?: string;
+    label?: string;
+}
+interface HarnessLogError {
+    code?: HarnessErrorCode;
+    category?: HarnessErrorCategory;
+    severity?: HarnessErrorSeverity;
+    recoverable?: boolean;
+    name?: string;
+    message: string;
+    stack?: string;
+}
+interface HarnessLogRecord {
+    id: string;
+    at: string;
+    level: HarnessLogLevel;
+    category: HarnessLogCategory;
+    type: string;
+    message: string;
+    sessionId?: string;
+    runId?: string;
+    turnId?: string;
+    modeId?: string;
+    branchId?: string;
+    source: HarnessLogSource;
+    correlationId?: string;
+    causationId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    durationMs?: number;
+    fields?: Record<string, unknown>;
+    error?: HarnessLogError;
+}
+declare abstract class HarnessLog<TFields = Record<string, unknown>> {
+    abstract level: HarnessLogLevel;
+    abstract category: HarnessLogCategory;
+    abstract message(fields: TFields): string;
+    levelFor?(fields: TFields): HarnessLogLevel;
+    redact?(fields: TFields): TFields;
+}
+type HarnessLogClass<TFields = Record<string, unknown>> = new () => HarnessLog<TFields>;
+declare abstract class HarnessLogSink {
+    abstract write(record: HarnessLogRecord): void | Promise<void>;
+    flush?(): void | Promise<void>;
+    close?(): void | Promise<void>;
+}
+interface HarnessLoggingConfig {
+    level?: HarnessLoggingLevel;
+    sinks?: HarnessLogSink[];
+    format?: "pretty" | "json";
+    modelDeltas?: "none" | "summary" | "full" | boolean;
+    events?: boolean;
+    redact?: {
+        keys?: string[];
+        replacement?: string;
+    };
+}
+interface HarnessRedactionConfig {
+    keys?: string[];
+    replacement?: string;
+}
+interface HarnessLogContext {
+    sessionId?: string;
+    runId?: string;
+    turnId?: string;
+    modeId?: string;
+    branchId?: string;
+    source?: HarnessLogSource;
+    correlationId?: string;
+    causationId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    durationMs?: number;
+}
+
 type HarnessContextProviderClass<TProvider extends HarnessContextProvider = HarnessContextProvider> = abstract new (...args: any[]) => TProvider;
 type HarnessContextProviderSelector<TOptions extends JsonObject = JsonObject> = HarnessContextProvider<TOptions> | HarnessContextProviderClass<HarnessContextProvider<TOptions>>;
 interface ContextProviderBinding<TOptions extends JsonObject = JsonObject> {
     provider: HarnessContextProviderSelector<TOptions>;
     options?: TOptions;
+    required?: boolean;
 }
 type ContextProviderReference<TOptions extends JsonObject = JsonObject> = HarnessContextProviderSelector<TOptions> | ContextProviderBinding<TOptions>;
 interface ContextProviderSummary {
@@ -139,6 +222,7 @@ declare abstract class HarnessContextProvider<TOptions extends JsonObject = Json
     label?: string;
     priority?: number;
     role?: HarnessRoleSelector;
+    required?: boolean;
     get type(): string;
     with(options: TOptions): ContextProviderBinding<TOptions>;
     abstract render(session: AgentReadSession, options?: TOptions): ContextProviderOutput | Promise<ContextProviderOutput>;
@@ -159,6 +243,7 @@ declare abstract class HarnessMode {
     tools?: AgentToolSource[];
     maxTurns?: number;
     toolApproval?: ToolApprovalMode;
+    contextFailure?: "fail" | "warn-and-skip";
     get type(): string;
     getPrompt?(session: AgentReadSession): string | Promise<string>;
     onEnter?(session: AgentActionSession, input?: unknown): void | Promise<void>;
@@ -393,4 +478,4 @@ interface ToolApprovalRequest {
     approvalTimeoutMs?: number;
 }
 
-export { type HarnessToolSelector as $, type AgentActionSession as A, type ContextContributionInput as B, ContextConsume as C, type ContextEntry as D, type ContextEntryFilter as E, type ContextProviderBinding as F, type ContextProviderOutput as G, type ContextProviderReference as H, type ContextProviderRenderResult as I, type ContextProviderSummary as J, type ContextRegistrationOptions as K, ContextScopes as L, type ContextSnapshot as M, HarnessContextProvider as N, type HarnessContextProviderClass as O, type HarnessContextProviderSelector as P, HarnessMode as Q, type HarnessModeClass as R, type HarnessModeSelector as S, type HarnessModeSummary as T, type HarnessSnapshot as U, type HarnessSnapshotCreator as V, type HarnessSnapshotInput as W, type HarnessSnapshotSession as X, type HarnessSnapshotSummary as Y, HarnessTool as Z, type HarnessToolClass as _, type AgentContextProvider as a, type HarnessTranscriptSession as a0, type RunInfo as a1, type ToolApprovalDecision as a2, type ToolApprovalMode as a3, type ToolApprovalRequest as a4, type ToolApprovalResolver as a5, type ToolCatalogEntry as a6, type ToolPermission as a7, type ToolRef as a8, type ToolRisk as a9, type TranscriptBranch as aa, type TranscriptCursor as ab, type TranscriptQuery as ac, type TranscriptSeekTarget as ad, type TurnInfo as ae, type AgentContextReader as b, type AgentContextSession as c, type AgentEventReader as d, type AgentEventSession as e, type AgentHistorySession as f, type AgentLogSession as g, type AgentMessage as h, type AgentMessageEnqueueOptions as i, type AgentMessageInput as j, type AgentMessageRole as k, type AgentMessageSession as l, type AgentModeDefinition as m, type AgentModeReader as n, type AgentModeSession as o, type AgentReadSession as p, type AgentRuntimeLogger as q, type AgentSharedState as r, type AgentSharedStateDefinition as s, type AgentStateReader as t, type AgentStateSession as u, type AgentToolDefinition as v, type AgentToolResult as w, type AgentToolSession as x, type AgentToolSource as y, type ContextContribution as z };
+export { type HarnessLoggingLevel as $, type AgentActionSession as A, type ContextContributionInput as B, ContextConsume as C, type ContextEntry as D, type ContextEntryFilter as E, type ContextProviderBinding as F, type ContextProviderOutput as G, type ContextProviderReference as H, type ContextProviderRenderResult as I, type ContextProviderSummary as J, type ContextRegistrationOptions as K, ContextScopes as L, type ContextSnapshot as M, HarnessContextProvider as N, type HarnessContextProviderClass as O, type HarnessContextProviderSelector as P, HarnessLog as Q, type HarnessLogCategory as R, type HarnessLogClass as S, type HarnessLogContext as T, type HarnessLogError as U, type HarnessLogLevel as V, type HarnessLogRecord as W, HarnessLogSink as X, type HarnessLogSource as Y, type HarnessLogSourceKind as Z, type HarnessLoggingConfig as _, type AgentContextProvider as a, HarnessMode as a0, type HarnessModeClass as a1, type HarnessModeSelector as a2, type HarnessModeSummary as a3, type HarnessRedactionConfig as a4, type HarnessSnapshot as a5, type HarnessSnapshotCreator as a6, type HarnessSnapshotInput as a7, type HarnessSnapshotSession as a8, type HarnessSnapshotSummary as a9, HarnessTool as aa, type HarnessToolClass as ab, type HarnessToolSelector as ac, type HarnessTranscriptSession as ad, type RunInfo as ae, type ToolApprovalDecision as af, type ToolApprovalMode as ag, type ToolApprovalRequest as ah, type ToolApprovalResolver as ai, type ToolCatalogEntry as aj, type ToolPermission as ak, type ToolRef as al, type ToolRisk as am, type TranscriptBranch as an, type TranscriptCursor as ao, type TranscriptQuery as ap, type TranscriptSeekTarget as aq, type TurnInfo as ar, type AgentContextReader as b, type AgentContextSession as c, type AgentEventReader as d, type AgentEventSession as e, type AgentHistorySession as f, type AgentLogSession as g, type AgentMessage as h, type AgentMessageEnqueueOptions as i, type AgentMessageInput as j, type AgentMessageRole as k, type AgentMessageSession as l, type AgentModeDefinition as m, type AgentModeReader as n, type AgentModeSession as o, type AgentReadSession as p, type AgentRuntimeLogger as q, type AgentSharedState as r, type AgentSharedStateDefinition as s, type AgentStateReader as t, type AgentStateSession as u, type AgentToolDefinition as v, type AgentToolResult as w, type AgentToolSession as x, type AgentToolSource as y, type ContextContribution as z };

package/dist/errors-DHHy8V3O.d.ts

@@ -0,0 +1,6 @@
+import { b as HarnessErrorContext, c as HarnessErrorPolicy, e as HarnessErrorShape } from './errors-hpkW3tfR.js';
+
+declare function normalizeHarnessError(error: unknown, context?: HarnessErrorContext, policy?: HarnessErrorPolicy): HarnessErrorShape;
+declare function sanitizeHarnessError(error: HarnessErrorShape, policy?: HarnessErrorPolicy): HarnessErrorShape;
+
+export { normalizeHarnessError as n, sanitizeHarnessError as s };

package/dist/errors-hpkW3tfR.d.ts

@@ -0,0 +1,112 @@
+type JsonObject = Record<string, unknown>;
+
+interface HarnessEventMetadata extends JsonObject {
+    label?: string;
+}
+interface HarnessEventSource {
+    kind: "runtime" | "model_provider" | "tool" | "hook" | "context_provider" | "mode" | "user" | "custom";
+    id?: string;
+    name?: string;
+}
+interface HarnessEventRecord<TPayload = unknown> {
+    id: string;
+    seq: number;
+    branchId: string;
+    type: string;
+    eventClassId: string;
+    at: string;
+    source: HarnessEventSource;
+    payload: TPayload;
+    runId: string;
+    turnId?: string;
+    modeId?: string;
+    correlationId?: string;
+    causationId?: string;
+    hidden: true;
+    metadata?: HarnessEventMetadata;
+}
+declare abstract class HarnessEvent<TPayload = unknown> {
+    readonly record: HarnessEventRecord<TPayload>;
+    static type?: string;
+    static schema?: unknown;
+    constructor(record: HarnessEventRecord<TPayload>);
+    get id(): string;
+    get type(): string;
+    get payload(): TPayload;
+    get at(): string;
+}
+type HarnessEventClass<TPayload = unknown, TEvent extends HarnessEvent<TPayload> = HarnessEvent<TPayload>> = {
+    readonly type?: string;
+    readonly schema?: unknown;
+    new (record: HarnessEventRecord<any>): TEvent;
+};
+interface HarnessEventEmitOptions {
+    source?: HarnessEventSource;
+    correlationId?: string;
+    causationId?: string;
+    metadata?: HarnessEventMetadata;
+    hiddenTranscript?: boolean;
+    skipHooks?: boolean;
+}
+interface HarnessEventQuery<TPayload = unknown> {
+    event?: HarnessEventClass<TPayload>;
+    type?: string;
+    sourceKind?: HarnessEventSource["kind"];
+    limit?: number;
+    since?: string;
+    until?: string;
+    includeInactive?: boolean;
+}
+interface EventCursor {
+    id: string;
+    branchId: string;
+    headEventId?: string;
+    seq: number;
+    updatedAt: string;
+}
+type RunnerEventListener = (event: HarnessEventRecord) => void | Promise<void>;
+
+type HarnessErrorCategory = "run" | "model" | "tool" | "context" | "storage" | "sandbox" | "approval" | "runtime";
+type HarnessErrorSeverity = "warn" | "error" | "fatal";
+type HarnessErrorCode = "run.failed" | "run.aborted" | "model.failed" | "model.rate_limited" | "model.timeout" | "tool.failed" | "tool.args.invalid_schema" | "tool.approval.denied" | "context.provider.failed" | "storage.write_failed" | "sandbox.exec.failed" | "runtime.failed";
+interface HarnessErrorShape {
+    code: HarnessErrorCode;
+    message: string;
+    publicMessage?: string;
+    category: HarnessErrorCategory;
+    severity: HarnessErrorSeverity;
+    recoverable: boolean;
+    source?: HarnessEventSource;
+    name?: string;
+    stack?: string;
+    cause?: unknown;
+    details?: unknown;
+}
+interface HarnessRetryPolicy {
+    attempts?: number;
+    backoffMs?: number;
+    maxBackoffMs?: number;
+}
+interface HarnessErrorPolicy {
+    exposeInternalErrors?: boolean;
+    includeStackInStatus?: boolean;
+    closeSessionOnFatal?: boolean;
+    contextFailure?: "fail" | "warn-and-skip";
+    retry?: {
+        model?: HarnessRetryPolicy;
+        storage?: HarnessRetryPolicy;
+    };
+    classify?(error: unknown, context: HarnessErrorContext): Partial<HarnessErrorShape> | undefined;
+}
+interface HarnessErrorContext {
+    code?: HarnessErrorCode;
+    category?: HarnessErrorCategory;
+    severity?: HarnessErrorSeverity;
+    recoverable?: boolean;
+    source?: HarnessEventSource;
+    message?: string;
+    publicMessage?: string;
+    details?: unknown;
+}
+
+export { type EventCursor as E, type HarnessErrorCategory as H, type JsonObject as J, type RunnerEventListener as R, type HarnessErrorCode as a, type HarnessErrorContext as b, type HarnessErrorPolicy as c, type HarnessErrorSeverity as d, type HarnessErrorShape as e, HarnessEvent as f, type HarnessEventClass as g, type HarnessEventEmitOptions as h, type HarnessEventMetadata as i, type HarnessEventQuery as j, type HarnessEventRecord as k, type HarnessEventSource as l, type HarnessRetryPolicy as m };

package/dist/{event-CKV4EeZ3.d.ts → event-DMBY-R6h.d.ts}

@@ -1,5 +1,6 @@
-import { H as HarnessEvent } from './events-D4xcDi53.js';
-import { ObjectSchema, StringSchema, NumberSchema, OptionalSchema, LiteralSchema, UnknownSchema, EnumSchema } from './schema.js';
+import { f as HarnessEvent, e as HarnessErrorShape, a as HarnessErrorCode } from './errors-hpkW3tfR.js';
+import { R as RunMetrics } from './metrics-DMN8bfY6.js';
+import { ObjectSchema, StringSchema, NumberSchema, UnknownSchema, OptionalSchema, LiteralSchema, EnumSchema } from './schema.js';
 
 declare class RunStartEvent extends HarnessEvent<{
     agentKey: string;
@@ -107,14 +108,42 @@ declare class RunEndEvent extends HarnessEvent<{
         finalAnswer: StringSchema;
     }>;
 }
+declare class RunFailedEvent extends HarnessEvent<{
+    error: HarnessErrorShape;
+    metrics: RunMetrics;
+    finalAnswer?: string;
+}> {
+    static type: string;
+    static schema: ObjectSchema<{
+        error: UnknownSchema;
+        metrics: UnknownSchema;
+        finalAnswer: OptionalSchema<unknown, string | undefined>;
+    }>;
+}
+declare class RunAbortedEvent extends HarnessEvent<{
+    error: HarnessErrorShape;
+    metrics: RunMetrics;
+    finalAnswer?: string;
+}> {
+    static type: string;
+    static schema: ObjectSchema<{
+        error: UnknownSchema;
+        metrics: UnknownSchema;
+        finalAnswer: OptionalSchema<unknown, string | undefined>;
+    }>;
+}
 declare class ErrorEvent extends HarnessEvent<{
+    error: HarnessErrorShape;
     message: string;
+    code?: HarnessErrorCode;
     recoverable?: boolean;
     details?: unknown;
 }> {
     static type: string;
     static schema: ObjectSchema<{
+        error: UnknownSchema;
         message: StringSchema;
+        code: OptionalSchema<unknown, string | undefined>;
         recoverable: OptionalSchema<unknown, boolean | undefined>;
         details: OptionalSchema<unknown, unknown>;
     }>;
@@ -225,6 +254,6 @@ declare class TranscriptCursorChangedEvent extends HarnessEvent<{
         cursor: UnknownSchema;
     }>;
 }
-declare const runtimeEventClasses: (typeof RunStartEvent | typeof TurnStartEvent | typeof ContextReadyEvent | typeof ModelBeforeEvent | typeof ModelAfterEvent | typeof ToolStartEvent | typeof ToolEndEvent | typeof TurnEndEvent | typeof RunEndEvent | typeof MessageStartEvent | typeof MessageDeltaEvent | typeof MessageEndEvent | typeof ModeChangedEvent | typeof SnapshotCreatedEvent | typeof TranscriptCursorChangedEvent)[];
+declare const runtimeEventClasses: (typeof RunStartEvent | typeof TurnStartEvent | typeof ContextReadyEvent | typeof ModelBeforeEvent | typeof ModelAfterEvent | typeof ToolStartEvent | typeof ToolEndEvent | typeof TurnEndEvent | typeof RunEndEvent | typeof RunFailedEvent | typeof MessageStartEvent | typeof MessageDeltaEvent | typeof MessageEndEvent | typeof ModeChangedEvent | typeof SnapshotCreatedEvent | typeof TranscriptCursorChangedEvent)[];
 
-export { ContextReadyEvent as C, ErrorEvent as E, MessageDeltaEvent as M, RunEndEvent as R, SnapshotCreatedEvent as S, ToolApprovalRequestedEvent as T, MessageEndEvent as a, MessageStartEvent as b, ModeChangedEvent as c, ModelAfterEvent as d, ModelBeforeEvent as e, RunStartEvent as f, SnapshotDeletedEvent as g, SnapshotRestoredEvent as h, ToolApprovalResolvedEvent as i, ToolEndEvent as j, ToolStartEvent as k, TranscriptCursorChangedEvent as l, TurnEndEvent as m, TurnStartEvent as n, runtimeEventClasses as r };
+export { ContextReadyEvent as C, ErrorEvent as E, MessageDeltaEvent as M, RunAbortedEvent as R, SnapshotCreatedEvent as S, ToolApprovalRequestedEvent as T, MessageEndEvent as a, MessageStartEvent as b, ModeChangedEvent as c, ModelAfterEvent as d, ModelBeforeEvent as e, RunEndEvent as f, RunFailedEvent as g, RunStartEvent as h, SnapshotDeletedEvent as i, SnapshotRestoredEvent as j, ToolApprovalResolvedEvent as k, ToolEndEvent as l, ToolStartEvent as m, TranscriptCursorChangedEvent as n, TurnEndEvent as o, TurnStartEvent as p, runtimeEventClasses as r };

package/dist/{hook-CfBbhUQf.d.ts → hook-DD7uuzE3.d.ts}

@@ -1,5 +1,5 @@
-import { H as HarnessEvent, a as HarnessEventClass } from './events-D4xcDi53.js';
-import { A as AgentActionSession } from './context-BfpLqV11.js';
+import { f as HarnessEvent, g as HarnessEventClass } from './errors-hpkW3tfR.js';
+import { A as AgentActionSession } from './context-Bz9C_rL9.js';
 
 interface HarnessHookSummary {
     type: string;

package/dist/index.d.ts

@@ -1,22 +1,23 @@
-import { R as RunnerEventListener, J as JsonObject, d as HarnessEventQuery, e as HarnessEventRecord, b as HarnessEventEmitOptions } from './events-D4xcDi53.js';
-export { E as EventCursor, H as HarnessEvent, a as HarnessEventClass, c as HarnessEventMetadata, f as HarnessEventSource } from './events-D4xcDi53.js';
-import { a as HarnessAgentManifest } from './approval-D_G2w-fW.js';
-export { H as HarnessAgentInput, b as HarnessAppConfig, c as HarnessErrorShape, d as HarnessEventSummary, e as HarnessRunStream, f as HarnessSession, g as HarnessSessionEventListener, h as HarnessSessionListener, i as HarnessSessionPhase, j as HarnessSessionStatus, k as HarnessSessionStore, l as HarnessSessionStoreEvent, m as HarnessSessionStoreListener, n as HarnessStorageConfig, o as HarnessStreamEvent, p as HarnessUserInput, S as SendOptions, q as SendResult, r as StreamOptions, T as ToolApprovalHandle, W as WaitForEventOptions } from './approval-D_G2w-fW.js';
-import { ac as TranscriptQuery, h as AgentMessage, ab as TranscriptCursor, ad as TranscriptSeekTarget, r as AgentSharedState, W as HarnessSnapshotInput, U as HarnessSnapshot, Y as HarnessSnapshotSummary, M as ContextSnapshot, E as ContextEntryFilter, D as ContextEntry, S as HarnessModeSelector } from './context-BfpLqV11.js';
-export { A as AgentActionSession, a as AgentContextProvider, b as AgentContextReader, c as AgentContextSession, d as AgentEventReader, e as AgentEventSession, f as AgentHistorySession, g as AgentLogSession, i as AgentMessageEnqueueOptions, j as AgentMessageInput, k as AgentMessageRole, l as AgentMessageSession, m as AgentModeDefinition, n as AgentModeReader, o as AgentModeSession, p as AgentReadSession, q as AgentRuntimeLogger, s as AgentSharedStateDefinition, t as AgentStateReader, u as AgentStateSession, v as AgentToolDefinition, w as AgentToolResult, x as AgentToolSession, y as AgentToolSource, C as ContextConsume, z as ContextContribution, B as ContextContributionInput, F as ContextProviderBinding, G as ContextProviderOutput, H as ContextProviderReference, I as ContextProviderRenderResult, J as ContextProviderSummary, K as ContextRegistrationOptions, L as ContextScopes, N as HarnessContextProvider, O as HarnessContextProviderClass, P as HarnessContextProviderSelector, Q as HarnessMode, R as HarnessModeClass, T as HarnessModeSummary, V as HarnessSnapshotCreator, X as HarnessSnapshotSession, Z as HarnessTool, _ as HarnessToolClass, $ as HarnessToolSelector, a0 as HarnessTranscriptSession, a1 as RunInfo, a2 as ToolApprovalDecision, a3 as ToolApprovalMode, a4 as ToolApprovalRequest, a5 as ToolApprovalResolver, a6 as ToolCatalogEntry, a7 as ToolPermission, a8 as ToolRef, a9 as ToolRisk, aa as TranscriptBranch, ae as TurnInfo } from './context-BfpLqV11.js';
+import { R as RunnerEventListener, J as JsonObject, j as HarnessEventQuery, k as HarnessEventRecord, h as HarnessEventEmitOptions } from './errors-hpkW3tfR.js';
+export { E as EventCursor, H as HarnessErrorCategory, a as HarnessErrorCode, b as HarnessErrorContext, c as HarnessErrorPolicy, d as HarnessErrorSeverity, e as HarnessErrorShape, f as HarnessEvent, g as HarnessEventClass, i as HarnessEventMetadata, l as HarnessEventSource, m as HarnessRetryPolicy } from './errors-hpkW3tfR.js';
+import { a as HarnessAgentManifest } from './approval-Ch0LwJFM.js';
+export { H as HarnessAgentInput, b as HarnessAppConfig, c as HarnessEventSummary, d as HarnessRunStream, e as HarnessSession, f as HarnessSessionEventListener, g as HarnessSessionListener, h as HarnessSessionPhase, i as HarnessSessionStatus, j as HarnessSessionStore, k as HarnessSessionStoreEvent, l as HarnessSessionStoreListener, m as HarnessStorageConfig, n as HarnessStreamEvent, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, T as ToolApprovalHandle, W as WaitForEventOptions } from './approval-Ch0LwJFM.js';
+import { ap as TranscriptQuery, h as AgentMessage, ao as TranscriptCursor, aq as TranscriptSeekTarget, r as AgentSharedState, a7 as HarnessSnapshotInput, a5 as HarnessSnapshot, a9 as HarnessSnapshotSummary, M as ContextSnapshot, E as ContextEntryFilter, D as ContextEntry, a2 as HarnessModeSelector } from './context-Bz9C_rL9.js';
+export { A as AgentActionSession, a as AgentContextProvider, b as AgentContextReader, c as AgentContextSession, d as AgentEventReader, e as AgentEventSession, f as AgentHistorySession, g as AgentLogSession, i as AgentMessageEnqueueOptions, j as AgentMessageInput, k as AgentMessageRole, l as AgentMessageSession, m as AgentModeDefinition, n as AgentModeReader, o as AgentModeSession, p as AgentReadSession, q as AgentRuntimeLogger, s as AgentSharedStateDefinition, t as AgentStateReader, u as AgentStateSession, v as AgentToolDefinition, w as AgentToolResult, x as AgentToolSession, y as AgentToolSource, C as ContextConsume, z as ContextContribution, B as ContextContributionInput, F as ContextProviderBinding, G as ContextProviderOutput, H as ContextProviderReference, I as ContextProviderRenderResult, J as ContextProviderSummary, K as ContextRegistrationOptions, L as ContextScopes, N as HarnessContextProvider, O as HarnessContextProviderClass, P as HarnessContextProviderSelector, a0 as HarnessMode, a1 as HarnessModeClass, a3 as HarnessModeSummary, a6 as HarnessSnapshotCreator, a8 as HarnessSnapshotSession, aa as HarnessTool, ab as HarnessToolClass, ac as HarnessToolSelector, ad as HarnessTranscriptSession, ae as RunInfo, af as ToolApprovalDecision, ag as ToolApprovalMode, ah as ToolApprovalRequest, ai as ToolApprovalResolver, aj as ToolCatalogEntry, ak as ToolPermission, al as ToolRef, am as ToolRisk, an as TranscriptBranch, ar as TurnInfo } from './context-Bz9C_rL9.js';
 export { A as AssistantRole, H as HarnessRole, a as HarnessRoleClass, b as HarnessRoleDefinition, c as HarnessRoleSelector, d as HarnessRoleSummary, N as NativeRoles, R as RoleTargets, S as SystemRole, T as ToolRole, U as UserRole, e as assistantRole, s as systemRole, t as toolRole, u as userRole } from './role-BN6KhQxx.js';
-export { H as HarnessHook, a as HarnessHookEventClass, b as HarnessHookSummary } from './hook-CfBbhUQf.js';
-import { h as RunMetrics } from './storage-DCZE_hES.js';
-export { C as CreateStoredRunInput, a as CreateStoredSessionInput, H as HarnessRunStorage, b as HarnessRunStore, c as HarnessSessionStorage, d as HarnessSessionSummary, M as MemoryRunStorage, e as MemoryRunStore, f as MemorySessionStorage, N as NoopRunStorage, g as NoopRunStore, O as OpenRunStoreInput, R as RunCursorState, S as SessionListQuery, i as SessionListResult, j as StoredRunSummary, T as ToolCallMetric, k as TouchStoredSessionInput } from './storage-DCZE_hES.js';
-import { N as NormalizedAgentDefinition, c as AgentSessionRunnerOptions, b as AgentRunnerRunOptions, a as AgentRunResult, e as ModelProviderInfo } from './model-provider-Ch7tzk1x.js';
-export { A as AgentDefinition, H as HarnessModelProvider, d as HarnessModelProviderRegistry, M as ModelInfo, f as ModelProviderPreparedContext, g as ModelProviderRunInput, h as ModelProviderRunResult, R as ResolvedModelProvider, m as modelProviderId, p as parseModelRef } from './model-provider-Ch7tzk1x.js';
-export { C as ContextReadyEvent, E as ErrorEvent, M as MessageDeltaEvent, a as MessageEndEvent, b as MessageStartEvent, c as ModeChangedEvent, d as ModelAfterEvent, e as ModelBeforeEvent, R as RunEndEvent, f as RunStartEvent, S as SnapshotCreatedEvent, g as SnapshotDeletedEvent, h as SnapshotRestoredEvent, T as ToolApprovalRequestedEvent, i as ToolApprovalResolvedEvent, j as ToolEndEvent, k as ToolStartEvent, l as TranscriptCursorChangedEvent, m as TurnEndEvent, n as TurnStartEvent, r as runtimeEventClasses } from './event-CKV4EeZ3.js';
+export { H as HarnessHook, a as HarnessHookEventClass, b as HarnessHookSummary } from './hook-DD7uuzE3.js';
+import { R as RunMetrics } from './metrics-DMN8bfY6.js';
+export { T as ToolCallMetric } from './metrics-DMN8bfY6.js';
+import { N as NormalizedAgentDefinition, c as AgentSessionRunnerOptions, b as AgentRunnerRunOptions, a as AgentRunResult, e as ModelProviderInfo } from './model-provider-DGkLQJWP.js';
+export { A as AgentDefinition, H as HarnessModelProvider, d as HarnessModelProviderRegistry, M as ModelInfo, f as ModelProviderPreparedContext, g as ModelProviderRunInput, h as ModelProviderRunResult, R as ResolvedModelProvider, m as modelProviderId, p as parseModelRef } from './model-provider-DGkLQJWP.js';
+export { C as ContextReadyEvent, E as ErrorEvent, M as MessageDeltaEvent, a as MessageEndEvent, b as MessageStartEvent, c as ModeChangedEvent, d as ModelAfterEvent, e as ModelBeforeEvent, R as RunAbortedEvent, f as RunEndEvent, g as RunFailedEvent, h as RunStartEvent, S as SnapshotCreatedEvent, i as SnapshotDeletedEvent, j as SnapshotRestoredEvent, T as ToolApprovalRequestedEvent, k as ToolApprovalResolvedEvent, l as ToolEndEvent, m as ToolStartEvent, n as TranscriptCursorChangedEvent, o as TurnEndEvent, p as TurnStartEvent, r as runtimeEventClasses } from './event-DMBY-R6h.js';
+export { n as normalizeHarnessError, s as sanitizeHarnessError } from './errors-DHHy8V3O.js';
 export { defineAgent } from './agent.js';
 export { HarnessSandbox, HarnessSandboxOpenInput, HarnessSandboxSession, NoopSandbox, NoopSandboxSession, SandboxExecInput, SandboxExecResult } from './runner/sandbox.js';
-export { C as CreateHarnessSessionInternalOptions, H as HarnessSessionImpl, a as HarnessSessionStoreImpl, c as createHarnessSession, b as createHarnessSessionStore } from './runner-B41JEovO.js';
+export { CreateStoredRunInput, CreateStoredSessionInput, HarnessRunStorage, HarnessRunStore, HarnessSessionStorage, HarnessSessionSummary, MemoryRunStorage, MemoryRunStore, MemorySessionStorage, NoopRunStorage, NoopRunStore, OpenRunStoreInput, RunCursorState, SessionListQuery, SessionListResult, StoredRunSummary, TouchStoredSessionInput } from './runner/storage.js';
+export { C as CreateHarnessSessionInternalOptions, H as HarnessSessionImpl, a as HarnessSessionStoreImpl, c as createHarnessSession, b as createHarnessSessionStore } from './runner-CZHeMHKV.js';
 export { ArraySchema, BooleanSchema, DefaultSchema, EnumSchema, InferInput, InferOutput, JsonSchema, LiteralSchema, NormalizedSchema, NumberSchema, ObjectSchema, OptionalSchema, RecordSchema, SafeParseResult, Schema, SchemaError, SchemaIssue, SchemaIssueCode, SchemaSource, StringSchema, UnknownSchema, formatSchemaPath, normalizeSchema, s, schemaIssuesFromError } from './schema.js';
-export { T as ToolErrorCode, a as ToolErrorPayload, b as ToolInvalidField, c as createToolErrorPayload } from './tool-errors-CygY1Nba.js';
-import './types-BPmsw-mF.js';
+export { ToolErrorCode, ToolErrorPayload, ToolInvalidField, createToolErrorPayload, createToolErrorResult } from './agent/tool.js';
 
 declare class AgentSessionRunner {
     private readonly options;
@@ -53,6 +54,8 @@ declare class AgentSessionRunner {
     private turnHandoffRequested;
     private restoredFromRun;
     constructor(options: AgentSessionRunnerOptions);
+    private normalizeError;
+    private publicError;
     private logSource;
     private logContext;
     private log;
@@ -71,6 +74,8 @@ declare class AgentSessionRunner {
     private beginNewRun;
     run(message: string, options?: AgentRunnerRunOptions): Promise<AgentRunResult>;
     prompt(message: string, options?: AgentRunnerRunOptions): Promise<AgentRunResult>;
+    private finalizeMetrics;
+    private tryFailureWrite;
     hydrate(): Promise<void>;
     close(): Promise<void>;
     getTranscript(options?: TranscriptQuery): AgentMessage[];
@@ -142,6 +147,7 @@ declare class AgentSessionRunner {
     private clearDynamicContext;
     private buildContextSnapshot;
     private loadContextProvider;
+    private handleContextProviderFailure;
     private normalizeContextContribution;
     private normalizeContextOutput;
     private resolveRole;

package/dist/index.js

@@ -4,15 +4,17 @@ import {
   HarnessSessionPhase,
   HarnessSessionStoreImpl,
   createHarnessSession,
-  createHarnessSessionStore,
-  createToolErrorPayload
-} from "./chunk-QEVKKJ7N.js";
+  createHarnessSessionStore
+} from "./chunk-UKXJIKED.js";
 import {
   HarnessModelProviderRegistry,
   modelProviderId,
   parseModelRef
 } from "./chunk-Q73WH5D7.js";
-import "./chunk-Q44U2CMM.js";
+import {
+  normalizeHarnessError,
+  sanitizeHarnessError
+} from "./chunk-2NQ3JL7K.js";
 import {
   HarnessSandbox,
   HarnessSandboxSession,
@@ -32,6 +34,10 @@ import {
 import {
   defineAgent
 } from "./chunk-RRWJUHJG.js";
+import {
+  createToolErrorPayload,
+  createToolErrorResult
+} from "./chunk-NCSQEUQC.js";
 import {
   ContextReadyEvent,
   ErrorEvent,
@@ -41,7 +47,9 @@ import {
   ModeChangedEvent,
   ModelAfterEvent,
   ModelBeforeEvent,
+  RunAbortedEvent,
   RunEndEvent,
+  RunFailedEvent,
   RunStartEvent,
   SnapshotCreatedEvent,
   SnapshotDeletedEvent,
@@ -54,7 +62,7 @@ import {
   TurnEndEvent,
   TurnStartEvent,
   runtimeEventClasses
-} from "./chunk-JIJHGB6H.js";
+} from "./chunk-3QOAFCCZ.js";
 import {
   ArraySchema,
   BooleanSchema,
@@ -93,7 +101,7 @@ import {
   systemRole,
   toolRole,
   userRole
-} from "./chunk-B4Q6CPYO.js";
+} from "./chunk-TCHZYK5Y.js";
 export {
   AgentSessionRunner,
   ArraySchema,
@@ -140,7 +148,9 @@ export {
   OptionalSchema,
   RecordSchema,
   RoleTargets,
+  RunAbortedEvent,
   RunEndEvent,
+  RunFailedEvent,
   RunStartEvent,
   Schema,
   SchemaError,
@@ -163,13 +173,16 @@ export {
   createHarnessSession,
   createHarnessSessionStore,
   createToolErrorPayload,
+  createToolErrorResult,
   defineAgent,
   formatSchemaPath,
   modelProviderId,
+  normalizeHarnessError,
   normalizeSchema,
   parseModelRef,
   runtimeEventClasses,
   s,
+  sanitizeHarnessError,
   schemaIssuesFromError,
   systemRole,
   toolRole,

package/dist/metrics-DMN8bfY6.d.ts

@@ -0,0 +1,23 @@
+import { e as HarnessErrorShape } from './errors-hpkW3tfR.js';
+
+interface ToolCallMetric {
+    name: string;
+    count: number;
+    errorCount: number;
+    totalDurationMs: number;
+}
+interface RunMetrics {
+    startedAt: string;
+    completedAt?: string;
+    durationMs: number;
+    turnCount: number;
+    messageCount: number;
+    eventCount: number;
+    toolCallCount: number;
+    finalMode?: string;
+    tools: Record<string, ToolCallMetric>;
+    errors: HarnessErrorShape[];
+    usage?: unknown;
+}
+
+export type { RunMetrics as R, ToolCallMetric as T };

package/dist/{model-provider-Ch7tzk1x.d.ts → model-provider-DGkLQJWP.d.ts}

@@ -1,9 +1,10 @@
-import { H as HarnessEvent, a as HarnessEventClass, b as HarnessEventEmitOptions, e as HarnessEventRecord, J as JsonObject } from './events-D4xcDi53.js';
-import { h as AgentMessage, v as AgentToolDefinition, w as AgentToolResult, M as ContextSnapshot, S as HarnessModeSelector, Q as HarnessMode, s as AgentSharedStateDefinition, a4 as ToolApprovalRequest, a2 as ToolApprovalDecision, q as AgentRuntimeLogger } from './context-BfpLqV11.js';
+import { f as HarnessEvent, g as HarnessEventClass, h as HarnessEventEmitOptions, k as HarnessEventRecord, J as JsonObject, c as HarnessErrorPolicy } from './errors-hpkW3tfR.js';
+import { h as AgentMessage, v as AgentToolDefinition, w as AgentToolResult, M as ContextSnapshot, a2 as HarnessModeSelector, a0 as HarnessMode, s as AgentSharedStateDefinition, ah as ToolApprovalRequest, af as ToolApprovalDecision, q as AgentRuntimeLogger } from './context-Bz9C_rL9.js';
 import { b as HarnessRoleDefinition, c as HarnessRoleSelector } from './role-BN6KhQxx.js';
 import { HarnessSandbox } from './runner/sandbox.js';
-import { h as RunMetrics, c as HarnessSessionStorage, H as HarnessRunStorage } from './storage-DCZE_hES.js';
-import { H as HarnessHook } from './hook-CfBbhUQf.js';
+import { HarnessSessionStorage, HarnessRunStorage } from './runner/storage.js';
+import { H as HarnessHook } from './hook-DD7uuzE3.js';
+import { R as RunMetrics } from './metrics-DMN8bfY6.js';
 
 interface ModelProviderRunInput {
     runId: string;
@@ -114,6 +115,7 @@ interface AgentSessionRunnerOptions {
     resources?: JsonObject;
     approveTool?(request: ToolApprovalRequest): boolean | ToolApprovalDecision | Promise<boolean | ToolApprovalDecision>;
     logger?: AgentRuntimeLogger;
+    errorPolicy?: HarnessErrorPolicy;
 }
 interface AgentRunResult {
     runId: string;

package/dist/runner/approval.d.ts

@@ -1,9 +1,9 @@
-export { T as ToolApprovalHandle } from '../approval-D_G2w-fW.js';
-export { a2 as ToolApprovalDecision, a3 as ToolApprovalMode, a4 as ToolApprovalRequest } from '../context-BfpLqV11.js';
-import '../model-provider-Ch7tzk1x.js';
-import '../events-D4xcDi53.js';
+export { T as ToolApprovalHandle } from '../approval-Ch0LwJFM.js';
+export { af as ToolApprovalDecision, ag as ToolApprovalMode, ah as ToolApprovalRequest } from '../context-Bz9C_rL9.js';
+import '../model-provider-DGkLQJWP.js';
+import '../errors-hpkW3tfR.js';
 import '../role-BN6KhQxx.js';
 import './sandbox.js';
-import '../storage-DCZE_hES.js';
-import '../hook-CfBbhUQf.js';
-import '../types-BPmsw-mF.js';
+import './storage.js';
+import '../metrics-DMN8bfY6.js';
+import '../hook-DD7uuzE3.js';

package/dist/runner/event.d.ts

@@ -1,3 +1,4 @@
-export { H as HarnessEvent, a as HarnessEventClass, b as HarnessEventEmitOptions, d as HarnessEventQuery, e as HarnessEventRecord, f as HarnessEventSource } from '../events-D4xcDi53.js';
-export { C as ContextReadyEvent, E as ErrorEvent, M as MessageDeltaEvent, a as MessageEndEvent, b as MessageStartEvent, c as ModeChangedEvent, d as ModelAfterEvent, e as ModelBeforeEvent, R as RunEndEvent, f as RunStartEvent, S as SnapshotCreatedEvent, g as SnapshotDeletedEvent, h as SnapshotRestoredEvent, T as ToolApprovalRequestedEvent, i as ToolApprovalResolvedEvent, j as ToolEndEvent, k as ToolStartEvent, l as TranscriptCursorChangedEvent, m as TurnEndEvent, n as TurnStartEvent } from '../event-CKV4EeZ3.js';
+export { f as HarnessEvent, g as HarnessEventClass, h as HarnessEventEmitOptions, j as HarnessEventQuery, k as HarnessEventRecord, l as HarnessEventSource } from '../errors-hpkW3tfR.js';
+export { C as ContextReadyEvent, E as ErrorEvent, M as MessageDeltaEvent, a as MessageEndEvent, b as MessageStartEvent, c as ModeChangedEvent, d as ModelAfterEvent, e as ModelBeforeEvent, R as RunAbortedEvent, f as RunEndEvent, g as RunFailedEvent, h as RunStartEvent, S as SnapshotCreatedEvent, i as SnapshotDeletedEvent, j as SnapshotRestoredEvent, T as ToolApprovalRequestedEvent, k as ToolApprovalResolvedEvent, l as ToolEndEvent, m as ToolStartEvent, n as TranscriptCursorChangedEvent, o as TurnEndEvent, p as TurnStartEvent } from '../event-DMBY-R6h.js';
+import '../metrics-DMN8bfY6.js';
 import '../schema.js';

package/dist/runner/event.js

@@ -7,7 +7,9 @@ import {
   ModeChangedEvent,
   ModelAfterEvent,
   ModelBeforeEvent,
+  RunAbortedEvent,
   RunEndEvent,
+  RunFailedEvent,
   RunStartEvent,
   SnapshotCreatedEvent,
   SnapshotDeletedEvent,
@@ -19,11 +21,11 @@ import {
   TranscriptCursorChangedEvent,
   TurnEndEvent,
   TurnStartEvent
-} from "../chunk-JIJHGB6H.js";
+} from "../chunk-3QOAFCCZ.js";
 import "../chunk-OBKS4AJR.js";
 import {
   HarnessEvent
-} from "../chunk-B4Q6CPYO.js";
+} from "../chunk-TCHZYK5Y.js";
 export {
   ContextReadyEvent,
   ErrorEvent,
@@ -34,7 +36,9 @@ export {
   ModeChangedEvent,
   ModelAfterEvent,
   ModelBeforeEvent,
+  RunAbortedEvent,
   RunEndEvent,
+  RunFailedEvent,
   RunStartEvent,
   SnapshotCreatedEvent,
   SnapshotDeletedEvent,

package/dist/runner/logging.d.ts

@@ -1,6 +1,10 @@
-import { g as HarnessLogSink, k as HarnessLoggingLevel, f as HarnessLogRecord, e as HarnessLogLevel } from '../types-BPmsw-mF.js';
-export { H as HarnessLog, a as HarnessLogCategory, b as HarnessLogClass, c as HarnessLogContext, d as HarnessLogError, h as HarnessLogSource, i as HarnessLogSourceKind, j as HarnessLoggingConfig, l as HarnessRedactionConfig } from '../types-BPmsw-mF.js';
-export { T as ToolErrorCode, a as ToolErrorPayload, b as ToolInvalidField } from '../tool-errors-CygY1Nba.js';
+import { X as HarnessLogSink, $ as HarnessLoggingLevel, W as HarnessLogRecord, V as HarnessLogLevel } from '../context-Bz9C_rL9.js';
+export { Q as HarnessLog, R as HarnessLogCategory, S as HarnessLogClass, T as HarnessLogContext, U as HarnessLogError, Y as HarnessLogSource, Z as HarnessLogSourceKind, _ as HarnessLoggingConfig, a4 as HarnessRedactionConfig } from '../context-Bz9C_rL9.js';
+export { H as HarnessErrorCategory, a as HarnessErrorCode, b as HarnessErrorContext, c as HarnessErrorPolicy, d as HarnessErrorSeverity, e as HarnessErrorShape, m as HarnessRetryPolicy } from '../errors-hpkW3tfR.js';
+export { n as normalizeHarnessError, s as sanitizeHarnessError } from '../errors-DHHy8V3O.js';
+export { ToolErrorCode, ToolErrorPayload, ToolInvalidField, createToolErrorPayload, createToolErrorResult } from '../agent/tool.js';
+import '../role-BN6KhQxx.js';
+import './sandbox.js';
 
 interface ConsoleLogSinkOptions {
     format?: "pretty" | "json";

package/dist/runner/logging.js

@@ -3,13 +3,23 @@ import {
   HarnessLog,
   HarnessLogSink,
   MemoryLogSink,
+  normalizeHarnessError,
+  sanitizeHarnessError,
   shouldWriteLog
-} from "../chunk-Q44U2CMM.js";
+} from "../chunk-2NQ3JL7K.js";
+import {
+  createToolErrorPayload,
+  createToolErrorResult
+} from "../chunk-NCSQEUQC.js";
 export {
   ConsoleLogSink,
   HarnessLog,
   HarnessLogSink,
   MemoryLogSink,
+  createToolErrorPayload,
+  createToolErrorResult,
+  normalizeHarnessError,
+  sanitizeHarnessError,
   shouldWriteLog
 };
 //# sourceMappingURL=logging.js.map