@harness-kernel/core 0.2.0 → 0.3.0

package/dist/runner/model-provider.d.ts

@@ -1,8 +1,8 @@
-export { H as HarnessModelProvider, d as HarnessModelProviderRegistry, M as ModelInfo, e as ModelProviderInfo, f as ModelProviderPreparedContext, g as ModelProviderRunInput, h as ModelProviderRunResult, R as ResolvedModelProvider, m as modelProviderId, p as parseModelRef } from '../model-provider-Ch7tzk1x.js';
-import '../events-D4xcDi53.js';
-import '../context-BfpLqV11.js';
+export { H as HarnessModelProvider, d as HarnessModelProviderRegistry, M as ModelInfo, e as ModelProviderInfo, f as ModelProviderPreparedContext, g as ModelProviderRunInput, h as ModelProviderRunResult, R as ResolvedModelProvider, m as modelProviderId, p as parseModelRef } from '../model-provider-DGkLQJWP.js';
+import '../errors-hpkW3tfR.js';
+import '../context-Bz9C_rL9.js';
 import '../role-BN6KhQxx.js';
-import '../types-BPmsw-mF.js';
 import './sandbox.js';
-import '../storage-DCZE_hES.js';
-import '../hook-CfBbhUQf.js';
+import './storage.js';
+import '../metrics-DMN8bfY6.js';
+import '../hook-DD7uuzE3.js';

package/dist/runner/storage.d.ts

@@ -1,6 +1,183 @@
-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, k as TouchStoredSessionInput } from '../storage-DCZE_hES.js';
-import '../events-D4xcDi53.js';
-import '../context-BfpLqV11.js';
+import { k as HarnessEventRecord, E as EventCursor } from '../errors-hpkW3tfR.js';
+import { h as AgentMessage, a5 as HarnessSnapshot, ao as TranscriptCursor, an as TranscriptBranch, M as ContextSnapshot } from '../context-Bz9C_rL9.js';
+import { R as RunMetrics } from '../metrics-DMN8bfY6.js';
 import '../role-BN6KhQxx.js';
-import '../types-BPmsw-mF.js';
 import './sandbox.js';
+
+interface RunCursorState {
+    transcriptCursor: TranscriptCursor;
+    eventCursor: EventCursor;
+    branches?: TranscriptBranch[];
+}
+interface OpenRunStoreInput {
+    runId: string;
+    sessionId: string;
+    agentKey: string;
+    outputDir?: string;
+}
+interface HarnessSessionSummary {
+    sessionId: string;
+    agentKey: string;
+    createdAt: string;
+    lastActiveAt: string;
+    mode: string;
+    latestRunId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface SessionListQuery {
+    agentKey?: string;
+    active?: boolean;
+    limit?: number;
+    cursor?: string;
+}
+interface SessionListResult {
+    items: HarnessSessionSummary[];
+    nextCursor?: string;
+}
+interface StoredRunSummary {
+    runId: string;
+    sessionId: string;
+    agentKey: string;
+    createdAt: string;
+    mode: string;
+    outputDir?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreateStoredSessionInput {
+    sessionId: string;
+    agentKey: string;
+    createdAt?: string;
+    lastActiveAt?: string;
+    mode: string;
+    latestRunId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface TouchStoredSessionInput {
+    sessionId: string;
+    lastActiveAt?: string;
+    mode?: string;
+    latestRunId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreateStoredRunInput {
+    runId: string;
+    sessionId: string;
+    agentKey: string;
+    createdAt?: string;
+    mode: string;
+    outputDir?: string;
+    metadata?: Record<string, unknown>;
+}
+declare abstract class HarnessRunStorage {
+    abstract readonly id: string;
+    label?: string;
+    abstract openRun(input: OpenRunStoreInput): Promise<HarnessRunStore> | HarnessRunStore;
+}
+declare abstract class HarnessSessionStorage {
+    abstract readonly id: string;
+    label?: string;
+    init?(): Promise<void> | void;
+    abstract createSession(input: CreateStoredSessionInput): Promise<HarnessSessionSummary> | HarnessSessionSummary;
+    abstract getSession(sessionId: string): Promise<HarnessSessionSummary | undefined> | HarnessSessionSummary | undefined;
+    abstract listSessions(query?: SessionListQuery): Promise<SessionListResult> | SessionListResult;
+    abstract touchSession(input: TouchStoredSessionInput): Promise<void> | void;
+    abstract deleteSession(sessionId: string): Promise<boolean> | boolean;
+    abstract createRun(input: CreateStoredRunInput): Promise<StoredRunSummary> | StoredRunSummary;
+    abstract getLatestRun(sessionId: string): Promise<StoredRunSummary | undefined> | StoredRunSummary | undefined;
+    abstract listRuns(sessionId: string): Promise<StoredRunSummary[]> | StoredRunSummary[];
+    abstract openRun(input: OpenRunStoreInput): Promise<HarnessRunStore> | HarnessRunStore;
+}
+declare abstract class HarnessRunStore {
+    abstract readonly runId: string;
+    readonly outputDir?: string;
+    readonly runDir?: string;
+    abstract init(): Promise<void> | void;
+    abstract recordEvent(event: HarnessEventRecord): Promise<void> | void;
+    abstract loadEvents(): Promise<HarnessEventRecord[]> | HarnessEventRecord[];
+    abstract saveTranscript(messages: AgentMessage[]): Promise<void> | void;
+    abstract loadTranscript(): Promise<AgentMessage[]> | AgentMessage[];
+    abstract saveMetrics(metrics: RunMetrics): Promise<void> | void;
+    abstract saveSnapshot(snapshot: HarnessSnapshot): Promise<void> | void;
+    abstract loadSnapshots(): Promise<HarnessSnapshot[]> | HarnessSnapshot[];
+    abstract deleteSnapshot(id: string): Promise<void> | void;
+    abstract saveCursors(cursors: RunCursorState): Promise<void> | void;
+    abstract loadCursors(): Promise<RunCursorState | undefined> | RunCursorState | undefined;
+    abstract saveContextSnapshot(snapshot: ContextSnapshot): Promise<void> | void;
+    abstract loadContextSnapshots(): Promise<ContextSnapshot[]> | ContextSnapshot[];
+    close?(): Promise<void>;
+}
+declare class NoopRunStorage extends HarnessRunStorage {
+    readonly id = "noop";
+    label: string;
+    openRun(input: OpenRunStoreInput): HarnessRunStore;
+}
+declare class NoopRunStore extends HarnessRunStore {
+    readonly runId: string;
+    readonly outputDir: undefined;
+    readonly runDir: undefined;
+    constructor(runId: string);
+    init(): void;
+    recordEvent(_event: HarnessEventRecord): void;
+    loadEvents(): HarnessEventRecord[];
+    saveTranscript(_messages: AgentMessage[]): void;
+    loadTranscript(): AgentMessage[];
+    saveMetrics(_metrics: RunMetrics): void;
+    saveSnapshot(_snapshot: HarnessSnapshot): void;
+    loadSnapshots(): HarnessSnapshot[];
+    deleteSnapshot(_id: string): void;
+    saveCursors(_cursors: RunCursorState): void;
+    loadCursors(): RunCursorState | undefined;
+    saveContextSnapshot(_snapshot: ContextSnapshot): void;
+    loadContextSnapshots(): ContextSnapshot[];
+}
+interface MemoryRunState {
+    events: HarnessEventRecord[];
+    transcript: AgentMessage[];
+    metrics?: RunMetrics;
+    snapshots: Map<string, HarnessSnapshot>;
+    cursors?: RunCursorState;
+    contextSnapshots: Map<string, ContextSnapshot>;
+}
+declare class MemoryRunStorage extends HarnessRunStorage {
+    readonly id = "memory";
+    label: string;
+    private readonly runs;
+    openRun(input: OpenRunStoreInput): HarnessRunStore;
+}
+declare class MemorySessionStorage extends HarnessSessionStorage {
+    readonly id = "memory-session";
+    label: string;
+    private readonly sessions;
+    private readonly runStates;
+    createSession(input: CreateStoredSessionInput): HarnessSessionSummary;
+    getSession(sessionId: string): HarnessSessionSummary | undefined;
+    listSessions(query?: SessionListQuery): SessionListResult;
+    touchSession(input: TouchStoredSessionInput): void;
+    deleteSession(sessionId: string): boolean;
+    createRun(input: CreateStoredRunInput): StoredRunSummary;
+    getLatestRun(sessionId: string): StoredRunSummary | undefined;
+    listRuns(sessionId: string): StoredRunSummary[];
+    openRun(input: OpenRunStoreInput): HarnessRunStore;
+}
+declare class MemoryRunStore extends HarnessRunStore {
+    readonly runId: string;
+    private readonly state;
+    readonly outputDir: undefined;
+    readonly runDir: undefined;
+    constructor(runId: string, state: MemoryRunState);
+    init(): void;
+    recordEvent(event: HarnessEventRecord): void;
+    loadEvents(): HarnessEventRecord[];
+    saveTranscript(messages: AgentMessage[]): void;
+    loadTranscript(): AgentMessage[];
+    saveMetrics(metrics: RunMetrics): void;
+    saveSnapshot(snapshot: HarnessSnapshot): void;
+    loadSnapshots(): HarnessSnapshot[];
+    deleteSnapshot(id: string): void;
+    saveCursors(cursors: RunCursorState): void;
+    loadCursors(): RunCursorState | undefined;
+    saveContextSnapshot(snapshot: ContextSnapshot): void;
+    loadContextSnapshots(): ContextSnapshot[];
+}
+
+export { type CreateStoredRunInput, type CreateStoredSessionInput, HarnessRunStorage, HarnessRunStore, HarnessSessionStorage, type HarnessSessionSummary, MemoryRunStorage, MemoryRunStore, MemorySessionStorage, NoopRunStorage, NoopRunStore, type OpenRunStoreInput, type RunCursorState, type SessionListQuery, type SessionListResult, type StoredRunSummary, type TouchStoredSessionInput };

package/dist/{runner-BzEf0lAV.d.ts → runner-CZHeMHKV.d.ts}

@@ -1,8 +1,9 @@
-import { d as HarnessEventQuery, e as HarnessEventRecord, H as HarnessEvent, a as HarnessEventClass } from './events-D4xcDi53.js';
-import { a0 as HarnessTranscriptSession, X as HarnessSnapshotSession, S as HarnessModeSelector, r as AgentSharedState, M as ContextSnapshot } from './context-BfpLqV11.js';
-import { f as HarnessSession, b as HarnessAppConfig, p as HarnessUserInput, S as SendOptions, q as SendResult, r as StreamOptions, e as HarnessRunStream, j as HarnessSessionStatus, a as HarnessAgentManifest, T as ToolApprovalHandle, h as HarnessSessionListener, g as HarnessSessionEventListener, W as WaitForEventOptions, k as HarnessSessionStore, m as HarnessSessionStoreListener } from './approval-D_G2w-fW.js';
-import { A as AgentDefinition } from './model-provider-Ch7tzk1x.js';
-import { d as HarnessSessionSummary, S as SessionListQuery, i as SessionListResult } from './storage-DCZE_hES.js';
+import { j as HarnessEventQuery, k as HarnessEventRecord, f as HarnessEvent, g as HarnessEventClass } from './errors-hpkW3tfR.js';
+import { ad as HarnessTranscriptSession, a8 as HarnessSnapshotSession, a2 as HarnessModeSelector, r as AgentSharedState, M as ContextSnapshot } from './context-Bz9C_rL9.js';
+import { e as HarnessSession, b as HarnessAppConfig, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, d as HarnessRunStream, i as HarnessSessionStatus, a as HarnessAgentManifest, T as ToolApprovalHandle, g as HarnessSessionListener, f as HarnessSessionEventListener, W as WaitForEventOptions, j as HarnessSessionStore, l as HarnessSessionStoreListener } from './approval-Ch0LwJFM.js';
+import { A as AgentDefinition } from './model-provider-DGkLQJWP.js';
+import { HarnessSessionSummary, SessionListQuery, SessionListResult } from './runner/storage.js';
+import './errors-DHHy8V3O.js';
 
 interface CreateHarnessSessionInternalOptions {
     sessionId?: string;
@@ -59,6 +60,7 @@ declare class HarnessSessionImpl implements HarnessSession {
     private resolveModeSelector;
     private requestToolApproval;
     private cancelActiveRun;
+    private closeAfterFatal;
 }
 declare function createHarnessSession(config: HarnessAppConfig, options?: CreateHarnessSessionInternalOptions): Promise<HarnessSession>;
 
@@ -66,6 +68,7 @@ declare class HarnessSessionStoreImpl implements HarnessSessionStore {
     private readonly config;
     private readonly sessions;
     private readonly unsubscriptions;
+    private readonly latestRunIds;
     private readonly listeners;
     private readonly storage;
     private closed;

package/dist/runner.d.ts

@@ -1,10 +1,11 @@
-export { c as createHarnessSession, b as createHarnessSessionStore } from './runner-BzEf0lAV.js';
-export { a as HarnessAgentManifest, b as HarnessAppConfig, 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, o as HarnessStreamEvent, p as HarnessUserInput, S as SendOptions, q as SendResult, r as StreamOptions, W as WaitForEventOptions } from './approval-D_G2w-fW.js';
-export { E as EventCursor } from './events-D4xcDi53.js';
-export { U as HarnessSnapshot, V as HarnessSnapshotCreator, W as HarnessSnapshotInput, X as HarnessSnapshotSession, Y as HarnessSnapshotSummary, a0 as HarnessTranscriptSession, aa as TranscriptBranch, ab as TranscriptCursor, ac as TranscriptQuery, ad as TranscriptSeekTarget } from './context-BfpLqV11.js';
-export { d as HarnessSessionSummary, S as SessionListQuery, i as SessionListResult } from './storage-DCZE_hES.js';
-import './model-provider-Ch7tzk1x.js';
+export { c as createHarnessSession, b as createHarnessSessionStore } from './runner-CZHeMHKV.js';
+export { a as HarnessAgentManifest, b as HarnessAppConfig, 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, n as HarnessStreamEvent, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, W as WaitForEventOptions } from './approval-Ch0LwJFM.js';
+export { E as EventCursor, 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 { a5 as HarnessSnapshot, a6 as HarnessSnapshotCreator, a7 as HarnessSnapshotInput, a8 as HarnessSnapshotSession, a9 as HarnessSnapshotSummary, ad as HarnessTranscriptSession, an as TranscriptBranch, ao as TranscriptCursor, ap as TranscriptQuery, aq as TranscriptSeekTarget } from './context-Bz9C_rL9.js';
+export { HarnessSessionSummary, SessionListQuery, SessionListResult } from './runner/storage.js';
+export { n as normalizeHarnessError, s as sanitizeHarnessError } from './errors-DHHy8V3O.js';
+import './model-provider-DGkLQJWP.js';
 import './role-BN6KhQxx.js';
 import './runner/sandbox.js';
-import './hook-CfBbhUQf.js';
-import './types-BPmsw-mF.js';
+import './hook-DD7uuzE3.js';
+import './metrics-DMN8bfY6.js';

package/dist/runner.js

@@ -2,17 +2,23 @@ import {
   HarnessSessionPhase,
   createHarnessSession,
   createHarnessSessionStore
-} from "./chunk-37PIMSLG.js";
+} from "./chunk-UKXJIKED.js";
 import "./chunk-Q73WH5D7.js";
-import "./chunk-Q44U2CMM.js";
+import {
+  normalizeHarnessError,
+  sanitizeHarnessError
+} from "./chunk-2NQ3JL7K.js";
 import "./chunk-ZU6ADDET.js";
 import "./chunk-ONYDIU4X.js";
-import "./chunk-JIJHGB6H.js";
+import "./chunk-NCSQEUQC.js";
+import "./chunk-3QOAFCCZ.js";
 import "./chunk-OBKS4AJR.js";
-import "./chunk-B4Q6CPYO.js";
+import "./chunk-TCHZYK5Y.js";
 export {
   HarnessSessionPhase,
   createHarnessSession,
-  createHarnessSessionStore
+  createHarnessSessionStore,
+  normalizeHarnessError,
+  sanitizeHarnessError
 };
 //# sourceMappingURL=runner.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-kernel/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Pure runtime contracts and session kernel for Harness Kernel.",
   "license": "Apache-2.0",
@@ -103,7 +103,7 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "test": "tsx src/schema/schema.test.ts && tsx src/runtime/events-schema.test.ts && tsx src/engine/provider-registry.test.ts && tsx src/session/model-resolution.test.ts && tsx src/session/tool-approval.test.ts && tsx src/session/session-store.test.ts && tsx src/boundaries.test.ts"
+    "test": "tsx src/schema/schema.test.ts && tsx src/runtime/errors.test.ts && tsx src/runtime/events-schema.test.ts && tsx src/logging/normalize.test.ts && tsx src/engine/provider-registry.test.ts && tsx src/session/model-resolution.test.ts && tsx src/session/tool-approval.test.ts && tsx src/session/session-store.test.ts && tsx src/session/queue.test.ts && tsx src/session/error-policy.test.ts && tsx src/boundaries.test.ts"
   },
   "devDependencies": {
     "zod": "^4.4.3"