@harness-kernel/core 0.1.1 → 0.2.1

package/dist/{chunk-AD3BCYWU.js → chunk-ZU6ADDET.js}

@@ -34,4 +34,4 @@ export {
   NoopSandbox,
   NoopSandboxSession
 };
-//# sourceMappingURL=chunk-AD3BCYWU.js.map
+//# sourceMappingURL=chunk-ZU6ADDET.js.map

package/dist/chunk-ZU6ADDET.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/sandbox.ts"],"sourcesContent":["export interface HarnessSandboxOpenInput {\n  sessionId: string;\n  runId: string;\n  agentKey: string;\n  workDir: string;\n  outputDir?: string;\n  resources: Record<string, unknown>;\n}\n\nexport interface SandboxExecInput {\n  command: string;\n  cwd?: string;\n  timeoutMs?: number;\n  env?: Record<string, string>;\n  stdin?: string;\n}\n\nexport interface SandboxExecResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number | null;\n  signal?: string;\n  durationMs: number;\n  timedOut?: boolean;\n}\n\nexport abstract class HarnessSandbox {\n  abstract readonly id: string;\n  label?: string;\n\n  abstract open(input: HarnessSandboxOpenInput): Promise<HarnessSandboxSession> | HarnessSandboxSession;\n}\n\nexport abstract class HarnessSandboxSession {\n  abstract readonly id: string;\n  abstract readonly workDir: string;\n\n  abstract exec(input: SandboxExecInput): Promise<SandboxExecResult>;\n\n  close?(): Promise<void>;\n}\n\nexport class NoopSandbox extends HarnessSandbox {\n  readonly id = \"noop\";\n  label = \"Noop\";\n\n  open(input: HarnessSandboxOpenInput): HarnessSandboxSession {\n    return new NoopSandboxSession(input.workDir);\n  }\n}\n\nexport class NoopSandboxSession extends HarnessSandboxSession {\n  readonly id = \"noop\";\n\n  constructor(readonly workDir: string) {\n    super();\n  }\n\n  async exec(input: SandboxExecInput): Promise<SandboxExecResult> {\n    return {\n      stdout: \"\",\n      stderr: `No sandbox is configured; cannot execute: ${input.command}`,\n      exitCode: 1,\n      durationMs: 0,\n    };\n  }\n}\n"],"mappings":";AA0BO,IAAe,iBAAf,MAA8B;AAAA,EAEnC;AAGF;AAEO,IAAe,wBAAf,MAAqC;AAO5C;AAEO,IAAM,cAAN,cAA0B,eAAe;AAAA,EACrC,KAAK;AAAA,EACd,QAAQ;AAAA,EAER,KAAK,OAAuD;AAC1D,WAAO,IAAI,mBAAmB,MAAM,OAAO;AAAA,EAC7C;AACF;AAEO,IAAM,qBAAN,cAAiC,sBAAsB;AAAA,EAG5D,YAAqB,SAAiB;AACpC,UAAM;AADa;AAAA,EAErB;AAAA,EAFqB;AAAA,EAFZ,KAAK;AAAA,EAMd,MAAM,KAAK,OAAqD;AAC9D,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ,6CAA6C,MAAM,OAAO;AAAA,MAClE,UAAU;AAAA,MACV,YAAY;AAAA,IACd;AAAA,EACF;AACF;","names":[]}

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

@@ -271,13 +271,13 @@ interface AgentContextSession extends AgentContextReader {
     remove(id: string): Promise<boolean>;
     clear(filter?: ContextEntryFilter): Promise<number>;
 }
-interface AgentReadSession<TState extends AgentSharedState = AgentSharedState, TServices extends Record<string, unknown> = Record<string, unknown>> {
+interface AgentReadSession<TState extends AgentSharedState = AgentSharedState, TResources extends Record<string, unknown> = Record<string, unknown>> {
     runId: string;
     turnId?: string;
     agentKey: string;
     workDir: string;
     outputDir?: string;
-    services: TServices;
+    resources: TResources;
     state: AgentStateReader<TState>;
     history: AgentHistorySession;
     events: AgentEventReader;
@@ -285,7 +285,7 @@ interface AgentReadSession<TState extends AgentSharedState = AgentSharedState, T
     context: AgentContextReader;
     log: AgentLogSession;
 }
-interface AgentActionSession<TState extends AgentSharedState = AgentSharedState, TServices extends Record<string, unknown> = Record<string, unknown>> extends AgentReadSession<TState, TServices> {
+interface AgentActionSession<TState extends AgentSharedState = AgentSharedState, TResources extends Record<string, unknown> = Record<string, unknown>> extends AgentReadSession<TState, TResources> {
     sandbox: HarnessSandboxSession;
     state: AgentStateSession<TState>;
     events: AgentEventSession;
@@ -374,6 +374,7 @@ declare abstract class HarnessTool<TInput = unknown, TData = unknown> {
     risk?: ToolRisk;
     permissions?: ToolPermission[];
     requiresApproval?: boolean | ToolApprovalResolver;
+    approvalTimeoutMs?: number;
     get type(): string;
     get inputSchema(): unknown;
     abstract execute(args: TInput, session: AgentActionSession): AgentToolResult<TData> | Promise<AgentToolResult<TData>>;
@@ -389,6 +390,7 @@ interface ToolApprovalRequest {
     modeId: string;
     risk?: ToolRisk;
     permissions?: ToolPermission[];
+    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 };

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

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

package/dist/index.d.ts

@@ -1,19 +1,19 @@
 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-DfvjpbFs.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-DfvjpbFs.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-75mlon5x.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-75mlon5x.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';
 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-DMb9fw9Z.js';
-import { d as RunMetrics } from './storage-BmOEwW-p.js';
-export { H as HarnessRunStorage, a as HarnessRunStore, M as MemoryRunStorage, b as MemoryRunStore, N as NoopRunStorage, c as NoopRunStore, O as OpenRunStoreInput, R as RunCursorState, T as ToolCallMetric } from './storage-BmOEwW-p.js';
-import { N as NormalizedAgentDefinition, c as AgentSessionRunnerOptions, b as AgentRunnerRunOptions, a as AgentRunResult, e as ModelProviderInfo } from './model-provider-BrZ2RRmS.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-BrZ2RRmS.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 { 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-Dxo7ALtp.js';
+export { C as CreateHarnessSessionInternalOptions, H as HarnessSessionImpl, a as HarnessSessionStoreImpl, c as createHarnessSession, b as createHarnessSessionStore } from './runner-B41JEovO.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';
@@ -33,7 +33,7 @@ declare class AgentSessionRunner {
     private readonly snapshotManager;
     private readonly toolExecutor;
     private readonly modelPipeline;
-    private readonly services;
+    private readonly resources;
     private readonly roles;
     private readonly roleResolver;
     private readonly providerRegistry;
@@ -51,6 +51,7 @@ declare class AgentSessionRunner {
     private providerStack;
     private hookDepth;
     private turnHandoffRequested;
+    private restoredFromRun;
     constructor(options: AgentSessionRunnerOptions);
     private logSource;
     private logContext;
@@ -70,6 +71,7 @@ declare class AgentSessionRunner {
     private beginNewRun;
     run(message: string, options?: AgentRunnerRunOptions): Promise<AgentRunResult>;
     prompt(message: string, options?: AgentRunnerRunOptions): Promise<AgentRunResult>;
+    hydrate(): Promise<void>;
     close(): Promise<void>;
     getTranscript(options?: TranscriptQuery): AgentMessage[];
     getMetrics(): RunMetrics;

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   createHarnessSession,
   createHarnessSessionStore,
   createToolErrorPayload
-} from "./chunk-4WWSQAWA.js";
+} from "./chunk-QEVKKJ7N.js";
 import {
   HarnessModelProviderRegistry,
   modelProviderId,
@@ -18,15 +18,17 @@ import {
   HarnessSandboxSession,
   NoopSandbox,
   NoopSandboxSession
-} from "./chunk-AD3BCYWU.js";
+} from "./chunk-ZU6ADDET.js";
 import {
   HarnessRunStorage,
   HarnessRunStore,
+  HarnessSessionStorage,
   MemoryRunStorage,
   MemoryRunStore,
+  MemorySessionStorage,
   NoopRunStorage,
   NoopRunStore
-} from "./chunk-AZVA22HW.js";
+} from "./chunk-ONYDIU4X.js";
 import {
   defineAgent
 } from "./chunk-RRWJUHJG.js";
@@ -52,7 +54,7 @@ import {
   TurnEndEvent,
   TurnStartEvent,
   runtimeEventClasses
-} from "./chunk-4SYLFKIX.js";
+} from "./chunk-JIJHGB6H.js";
 import {
   ArraySchema,
   BooleanSchema,
@@ -91,7 +93,7 @@ import {
   systemRole,
   toolRole,
   userRole
-} from "./chunk-4A2P4QU5.js";
+} from "./chunk-B4Q6CPYO.js";
 export {
   AgentSessionRunner,
   ArraySchema,
@@ -115,11 +117,13 @@ export {
   HarnessSandboxSession,
   HarnessSessionImpl,
   HarnessSessionPhase,
+  HarnessSessionStorage,
   HarnessSessionStoreImpl,
   HarnessTool,
   LiteralSchema,
   MemoryRunStorage,
   MemoryRunStore,
+  MemorySessionStorage,
   MessageDeltaEvent,
   MessageEndEvent,
   MessageStartEvent,

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

@@ -1,9 +1,9 @@
 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, a3 as ToolApprovalMode, a4 as ToolApprovalRequest, a2 as ToolApprovalDecision, q as AgentRuntimeLogger } from './context-75mlon5x.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 { b as HarnessRoleDefinition, c as HarnessRoleSelector } from './role-BN6KhQxx.js';
 import { HarnessSandbox } from './runner/sandbox.js';
-import { d as RunMetrics, H as HarnessRunStorage } from './storage-BmOEwW-p.js';
-import { H as HarnessHook } from './hook-DMb9fw9Z.js';
+import { h as RunMetrics, c as HarnessSessionStorage, H as HarnessRunStorage } from './storage-DCZE_hES.js';
+import { H as HarnessHook } from './hook-CfBbhUQf.js';
 
 interface ModelProviderRunInput {
     runId: string;
@@ -109,11 +109,9 @@ interface AgentSessionRunnerOptions {
     roles?: HarnessRoleDefinition[];
     workDir?: string;
     outputDir?: string;
-    storage?: HarnessRunStorage;
-    initialMode?: HarnessModeSelector;
-    toolApproval?: ToolApprovalMode;
-    maxTurns?: number;
-    services?: JsonObject;
+    storage?: HarnessSessionStorage | HarnessRunStorage;
+    initialRunId?: string;
+    resources?: JsonObject;
     approveTool?(request: ToolApprovalRequest): boolean | ToolApprovalDecision | Promise<boolean | ToolApprovalDecision>;
     logger?: AgentRuntimeLogger;
 }

package/dist/runner/approval.d.ts

@@ -1,9 +1,9 @@
-export { T as ToolApprovalHandle } from '../approval-DfvjpbFs.js';
-export { a2 as ToolApprovalDecision, a3 as ToolApprovalMode, a4 as ToolApprovalRequest } from '../context-75mlon5x.js';
-import '../model-provider-BrZ2RRmS.js';
+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';
 import '../role-BN6KhQxx.js';
 import './sandbox.js';
-import '../storage-BmOEwW-p.js';
-import '../hook-DMb9fw9Z.js';
+import '../storage-DCZE_hES.js';
+import '../hook-CfBbhUQf.js';
 import '../types-BPmsw-mF.js';

package/dist/runner/event.js

@@ -19,11 +19,11 @@ import {
   TranscriptCursorChangedEvent,
   TurnEndEvent,
   TurnStartEvent
-} from "../chunk-4SYLFKIX.js";
+} from "../chunk-JIJHGB6H.js";
 import "../chunk-OBKS4AJR.js";
 import {
   HarnessEvent
-} from "../chunk-4A2P4QU5.js";
+} from "../chunk-B4Q6CPYO.js";
 export {
   ContextReadyEvent,
   ErrorEvent,

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-BrZ2RRmS.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-Ch7tzk1x.js';
 import '../events-D4xcDi53.js';
-import '../context-75mlon5x.js';
+import '../context-BfpLqV11.js';
 import '../role-BN6KhQxx.js';
 import '../types-BPmsw-mF.js';
 import './sandbox.js';
-import '../storage-BmOEwW-p.js';
-import '../hook-DMb9fw9Z.js';
+import '../storage-DCZE_hES.js';
+import '../hook-CfBbhUQf.js';

package/dist/runner/sandbox.d.ts

@@ -4,7 +4,7 @@ interface HarnessSandboxOpenInput {
     agentKey: string;
     workDir: string;
     outputDir?: string;
-    services: Record<string, unknown>;
+    resources: Record<string, unknown>;
 }
 interface SandboxExecInput {
     command: string;

package/dist/runner/sandbox.js

@@ -3,7 +3,7 @@ import {
   HarnessSandboxSession,
   NoopSandbox,
   NoopSandboxSession
-} from "../chunk-AD3BCYWU.js";
+} from "../chunk-ZU6ADDET.js";
 export {
   HarnessSandbox,
   HarnessSandboxSession,

package/dist/runner/storage.d.ts

@@ -1,6 +1,6 @@
-export { H as HarnessRunStorage, a as HarnessRunStore, M as MemoryRunStorage, b as MemoryRunStore, N as NoopRunStorage, c as NoopRunStore, O as OpenRunStoreInput, R as RunCursorState } from '../storage-BmOEwW-p.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, k as TouchStoredSessionInput } from '../storage-DCZE_hES.js';
 import '../events-D4xcDi53.js';
-import '../context-75mlon5x.js';
+import '../context-BfpLqV11.js';
 import '../role-BN6KhQxx.js';
 import '../types-BPmsw-mF.js';
 import './sandbox.js';

package/dist/runner/storage.js

@@ -1,16 +1,20 @@
 import {
   HarnessRunStorage,
   HarnessRunStore,
+  HarnessSessionStorage,
   MemoryRunStorage,
   MemoryRunStore,
+  MemorySessionStorage,
   NoopRunStorage,
   NoopRunStore
-} from "../chunk-AZVA22HW.js";
+} from "../chunk-ONYDIU4X.js";
 export {
   HarnessRunStorage,
   HarnessRunStore,
+  HarnessSessionStorage,
   MemoryRunStorage,
   MemoryRunStore,
+  MemorySessionStorage,
   NoopRunStorage,
   NoopRunStore
 };

package/dist/{runner-Dxo7ALtp.d.ts → runner-B41JEovO.d.ts}

@@ -1,10 +1,12 @@
 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-75mlon5x.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-DfvjpbFs.js';
-import { A as AgentDefinition } from './model-provider-BrZ2RRmS.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';
 
 interface CreateHarnessSessionInternalOptions {
     sessionId?: string;
+    restoredSession?: HarnessSessionSummary;
 }
 declare class HarnessSessionImpl implements HarnessSession {
     private readonly config;
@@ -16,7 +18,7 @@ declare class HarnessSessionImpl implements HarnessSession {
     private readonly approvals;
     private readonly queue;
     private readonly status;
-    private readonly createdAt;
+    private createdAt;
     private readonly logger;
     private lastActiveAt;
     private closed;
@@ -26,7 +28,7 @@ declare class HarnessSessionImpl implements HarnessSession {
     constructor(config: HarnessAppConfig, input: {
         sessionId?: string;
         agent: AgentDefinition;
-        workDir: string;
+        restoredSession?: HarnessSessionSummary;
     });
     send(input: string | HarnessUserInput, options?: SendOptions): Promise<SendResult>;
     stream(input: string | HarnessUserInput, options?: StreamOptions): HarnessRunStream;
@@ -49,6 +51,7 @@ declare class HarnessSessionImpl implements HarnessSession {
     onEvent<TPayload, TEvent extends HarnessEvent<TPayload>>(eventClass: HarnessEventClass<TPayload, TEvent>, listener: HarnessSessionEventListener<TEvent>): () => void;
     waitForEvent<TPayload, TEvent extends HarnessEvent<TPayload>>(eventClass: HarnessEventClass<TPayload, TEvent>, options?: WaitForEventOptions): Promise<TEvent>;
     close(): Promise<void>;
+    hydrate(): Promise<void>;
     private notify;
     private notifyStatus;
     private assertSnapshotRestoreAllowed;
@@ -63,14 +66,20 @@ 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;
     constructor(config: HarnessAppConfig);
+    init(): Promise<void>;
     getOrCreate(sessionId?: string, overrides?: Partial<HarnessAppConfig>): Promise<HarnessSession>;
     get(sessionId: string): HarnessSession | undefined;
-    list(): HarnessSessionStatus[];
+    list(query?: SessionListQuery): Promise<SessionListResult>;
+    close(sessionId: string): Promise<boolean>;
+    close(): Promise<void>;
     delete(sessionId: string): Promise<boolean>;
-    clear(): Promise<void>;
+    clearActive(): Promise<void>;
+    closeAll(): Promise<void>;
     send(sessionId: string | undefined, input: string | HarnessUserInput, options?: SendOptions): Promise<SendResult>;
     stream(sessionId: string | undefined, input: string | HarnessUserInput, options?: StreamOptions): Promise<HarnessRunStream>;
     getPendingApprovals(sessionId?: string): ToolApprovalHandle[];
@@ -78,9 +87,7 @@ declare class HarnessSessionStoreImpl implements HarnessSessionStore {
     denyTool(sessionId: string, approvalId: string, reason?: string): Promise<void>;
     getAgentManifest(sessionId: string): HarnessAgentManifest | undefined;
     on(listener: HarnessSessionStoreListener): () => void;
-    close(): Promise<void>;
     private notify;
-    private cleanupExpired;
 }
 declare function createHarnessSessionStore(config: HarnessAppConfig): Promise<HarnessSessionStore>;
 

package/dist/runner.d.ts

@@ -1,10 +1,10 @@
-export { c as createHarnessSession, b as createHarnessSessionStore } from './runner-Dxo7ALtp.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-DfvjpbFs.js';
+export { c as createHarnessSession, b as createHarnessSessionStore } from './runner-B41JEovO.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-75mlon5x.js';
-import './model-provider-BrZ2RRmS.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';
 import './role-BN6KhQxx.js';
 import './runner/sandbox.js';
-import './storage-BmOEwW-p.js';
-import './hook-DMb9fw9Z.js';
+import './hook-CfBbhUQf.js';
 import './types-BPmsw-mF.js';

package/dist/runner.js

@@ -2,14 +2,14 @@ import {
   HarnessSessionPhase,
   createHarnessSession,
   createHarnessSessionStore
-} from "./chunk-4WWSQAWA.js";
+} from "./chunk-QEVKKJ7N.js";
 import "./chunk-Q73WH5D7.js";
 import "./chunk-Q44U2CMM.js";
-import "./chunk-AD3BCYWU.js";
-import "./chunk-AZVA22HW.js";
-import "./chunk-4SYLFKIX.js";
+import "./chunk-ZU6ADDET.js";
+import "./chunk-ONYDIU4X.js";
+import "./chunk-JIJHGB6H.js";
 import "./chunk-OBKS4AJR.js";
-import "./chunk-4A2P4QU5.js";
+import "./chunk-B4Q6CPYO.js";
 export {
   HarnessSessionPhase,
   createHarnessSession,

package/dist/{storage-BmOEwW-p.d.ts → storage-DCZE_hES.d.ts}

@@ -1,5 +1,5 @@
 import { e as HarnessEventRecord, E as EventCursor } from './events-D4xcDi53.js';
-import { h as AgentMessage, U as HarnessSnapshot, ab as TranscriptCursor, aa as TranscriptBranch, M as ContextSnapshot } from './context-75mlon5x.js';
+import { h as AgentMessage, U as HarnessSnapshot, ab as TranscriptCursor, aa as TranscriptBranch, M as ContextSnapshot } from './context-BfpLqV11.js';
 
 interface ToolCallMetric {
     name: string;
@@ -32,11 +32,78 @@ interface OpenRunStoreInput {
     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;
@@ -94,6 +161,21 @@ declare class MemoryRunStorage extends HarnessRunStorage {
     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;
@@ -115,4 +197,4 @@ declare class MemoryRunStore extends HarnessRunStore {
     loadContextSnapshots(): ContextSnapshot[];
 }
 
-export { HarnessRunStorage as H, MemoryRunStorage as M, NoopRunStorage as N, type OpenRunStoreInput as O, type RunCursorState as R, type ToolCallMetric as T, HarnessRunStore as a, MemoryRunStore as b, NoopRunStore as c, type RunMetrics as d };
+export { type CreateStoredRunInput as C, HarnessRunStorage as H, MemoryRunStorage as M, NoopRunStorage as N, type OpenRunStoreInput as O, type RunCursorState as R, type SessionListQuery as S, type ToolCallMetric as T, type CreateStoredSessionInput as a, HarnessRunStore as b, HarnessSessionStorage as c, type HarnessSessionSummary as d, MemoryRunStore as e, MemorySessionStorage as f, NoopRunStore as g, type RunMetrics as h, type SessionListResult as i, type StoredRunSummary as j, type TouchStoredSessionInput as k };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-kernel/core",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "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/boundaries.test.ts"
+    "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"
   },
   "devDependencies": {
     "zod": "^4.4.3"

package/dist/chunk-4A2P4QU5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runtime/types/events.ts","../src/runtime/types/naming.ts","../src/runtime/types/roles.ts","../src/runtime/types/tools.ts","../src/runtime/types/context.ts","../src/runtime/types/modes.ts","../src/runtime/types/hooks.ts"],"sourcesContent":["import type { JsonObject } from \"./json.js\";\n\nexport interface HarnessEventMetadata extends JsonObject {\n  label?: string;\n}\n\nexport interface HarnessEventSource {\n  kind: \"runtime\" | \"model_provider\" | \"tool\" | \"hook\" | \"context_provider\" | \"mode\" | \"user\" | \"custom\";\n  id?: string;\n  name?: string;\n}\n\nexport interface HarnessEventRecord<TPayload = unknown> {\n  id: string;\n  seq: number;\n  branchId: string;\n  type: string;\n  eventClassId: string;\n  at: string;\n  source: HarnessEventSource;\n  payload: TPayload;\n  runId: string;\n  turnId?: string;\n  modeId?: string;\n  correlationId?: string;\n  causationId?: string;\n  hidden: true;\n  metadata?: HarnessEventMetadata;\n}\n\nexport abstract class HarnessEvent<TPayload = unknown> {\n  static type?: string;\n  static schema?: unknown;\n\n  constructor(readonly record: HarnessEventRecord<TPayload>) {}\n\n  get id(): string {\n    return this.record.id;\n  }\n\n  get type(): string {\n    return this.record.type;\n  }\n\n  get payload(): TPayload {\n    return this.record.payload;\n  }\n\n  get at(): string {\n    return this.record.at;\n  }\n}\n\nexport type HarnessEventClass<\n  TPayload = unknown,\n  TEvent extends HarnessEvent<TPayload> = HarnessEvent<TPayload>,\n> = {\n  readonly type?: string;\n  readonly schema?: unknown;\n  new (record: HarnessEventRecord<any>): TEvent;\n};\n\nexport interface HarnessEventEmitOptions {\n  source?: HarnessEventSource;\n  correlationId?: string;\n  causationId?: string;\n  metadata?: HarnessEventMetadata;\n  hiddenTranscript?: boolean;\n  skipHooks?: boolean;\n}\n\nexport interface HarnessEventQuery<TPayload = unknown> {\n  event?: HarnessEventClass<TPayload>;\n  type?: string;\n  sourceKind?: HarnessEventSource[\"kind\"];\n  limit?: number;\n  since?: string;\n  until?: string;\n  includeInactive?: boolean;\n}\n\nexport interface EventCursor {\n  id: string;\n  branchId: string;\n  headEventId?: string;\n  seq: number;\n  updatedAt: string;\n}\n\nexport type RunnerEventListener = (event: HarnessEventRecord) => void | Promise<void>;\n","function constructorOf(value: object): { readonly type?: string; readonly label?: string; readonly name?: string } {\n  return value.constructor as { readonly type?: string; readonly label?: string; readonly name?: string };\n}\n\nexport function constructTypeOf(value: object): string {\n  const ctor = constructorOf(value);\n  return ctor.type ?? ctor.name ?? \"AnonymousConstruct\";\n}\n\nfunction stripConstructSuffix(name: string): string {\n  return name.replace(/(Tool|Mode|Provider|ContextProvider|Hook|Role|Event)$/u, \"\");\n}\n\nfunction wordsFromName(name: string): string[] {\n  const spaced = name\n    .replace(/[_:-]+/gu, \" \")\n    .replace(/([a-z0-9])([A-Z])/gu, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/gu, \"$1 $2\")\n    .trim();\n  return spaced ? spaced.split(/\\s+/u) : [name];\n}\n\nexport function labelFromType(type: string): string {\n  return wordsFromName(stripConstructSuffix(type))\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n}\n\nexport function snakeFromType(type: string): string {\n  return wordsFromName(stripConstructSuffix(type))\n    .map((word) => word.toLowerCase())\n    .join(\"_\");\n}\n","import { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessRoleSummary {\n  type: string;\n  name: string;\n  label?: string;\n  target: string;\n  nativeRole?: string;\n  default?: boolean;\n  description?: string;\n}\n\nexport enum RoleTargets {\n  System = \"system\",\n  Messages = \"messages\",\n  Hidden = \"hidden\",\n}\n\nexport enum NativeRoles {\n  System = \"system\",\n  User = \"user\",\n  Assistant = \"assistant\",\n  Tool = \"tool\",\n}\n\nexport abstract class HarnessRole {\n  protected declare readonly __harnessRoleBrand: true;\n\n  label?: string;\n  name?: string;\n  abstract target: RoleTargets | (string & {});\n  nativeRole?: NativeRoles | (string & {});\n  default?: boolean;\n  description?: string;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n}\n\nexport type HarnessRoleClass<TRole extends HarnessRole = HarnessRole> = abstract new (...args: any[]) => TRole;\nexport type HarnessRoleDefinition = HarnessRole;\nexport type HarnessRoleSelector<TRole extends HarnessRole = HarnessRole> = TRole | HarnessRoleClass<TRole>;\n\nexport class SystemRole extends HarnessRole {\n  static type = \"system\";\n  label = \"System\";\n  name = \"system\";\n  target = RoleTargets.System;\n  nativeRole = NativeRoles.System;\n  default = true;\n}\n\nexport class UserRole extends HarnessRole {\n  static type = \"user\";\n  label = \"User\";\n  name = \"user\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.User;\n}\n\nexport class AssistantRole extends HarnessRole {\n  static type = \"assistant\";\n  label = \"Assistant\";\n  name = \"assistant\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.Assistant;\n}\n\nexport class ToolRole extends HarnessRole {\n  static type = \"tool\";\n  label = \"Tool\";\n  name = \"tool\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.Tool;\n}\n\nexport const systemRole = new SystemRole();\nexport const userRole = new UserRole();\nexport const assistantRole = new AssistantRole();\nexport const toolRole = new ToolRole();\n","import type { AgentActionSession } from \"./sessions.js\";\nimport type { JsonObject } from \"./json.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport type ToolApprovalMode = \"auto\" | \"ask\" | \"deny\" | \"tool-default\";\nexport type ToolApprovalDecision = \"approved\" | \"denied\";\nexport type ToolRisk = \"safe\" | \"read\" | \"write\" | \"execute\" | \"network\" | \"destructive\";\n\nexport interface ToolPermission {\n  kind: \"filesystem\" | \"shell\" | \"network\" | \"custom\";\n  access?: \"read\" | \"write\" | \"execute\";\n  path?: string;\n  description?: string;\n}\n\nexport type ToolRef =\n  | { kind: \"file\"; path: string; role?: \"created\" | \"modified\" | \"read\" | \"evidence\" }\n  | { kind: \"url\"; url: string; role?: string }\n  | { kind: \"command\"; command: string; exitCode?: number; role?: string }\n  | { kind: \"tool_call\"; toolName: string; callId?: string; role?: string }\n  | { kind: \"session\"; sessionId: string; role?: string }\n  | { kind: \"external\"; label: string; uri?: string; role?: string };\n\nexport interface ToolCatalogEntry {\n  name: string;\n  description: string;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  requiresApproval?: boolean;\n}\n\nexport type ToolApprovalResolver = (\n  args: unknown,\n  session: AgentActionSession,\n) => boolean | Promise<boolean>;\n\nexport interface AgentToolResult<TData = unknown> {\n  content: string;\n  data?: TData;\n  refs?: ToolRef[];\n  metadata?: JsonObject;\n  isError?: boolean;\n}\n\nexport abstract class HarnessTool<TInput = unknown, TData = unknown> {\n  protected declare readonly __harnessToolBrand: true;\n\n  label?: string;\n  abstract name: string;\n  abstract description: string;\n  schema?: unknown;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  requiresApproval?: boolean | ToolApprovalResolver;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  get inputSchema(): unknown {\n    return this.schema;\n  }\n\n  abstract execute(args: TInput, session: AgentActionSession): AgentToolResult<TData> | Promise<AgentToolResult<TData>>;\n}\n\nexport type HarnessToolClass<TTool extends HarnessTool = HarnessTool> = abstract new (...args: any[]) => TTool;\nexport type HarnessToolSelector<TTool extends HarnessTool = HarnessTool> = TTool | HarnessToolClass<TTool>;\nexport type AgentToolDefinition<TInput = unknown, TData = unknown> = HarnessTool<TInput, TData>;\nexport type AgentToolSource = HarnessTool;\n\nexport interface ToolApprovalRequest {\n  id: string;\n  name: string;\n  args: unknown;\n  modeId: string;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n}\n","import type { AgentReadSession } from \"./sessions.js\";\nimport type { AgentMessage } from \"./messages.js\";\nimport type { HarnessEventClass } from \"./events.js\";\nimport type { HarnessRoleSelector } from \"./roles.js\";\nimport type { JsonObject } from \"./json.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport type HarnessContextProviderClass<\n  TProvider extends HarnessContextProvider = HarnessContextProvider,\n> = abstract new (...args: any[]) => TProvider;\n\nexport type HarnessContextProviderSelector<TOptions extends JsonObject = JsonObject> =\n  | HarnessContextProvider<TOptions>\n  | HarnessContextProviderClass<HarnessContextProvider<TOptions>>;\n\nexport interface ContextProviderBinding<TOptions extends JsonObject = JsonObject> {\n  provider: HarnessContextProviderSelector<TOptions>;\n  options?: TOptions;\n}\n\nexport type ContextProviderReference<TOptions extends JsonObject = JsonObject> =\n  | HarnessContextProviderSelector<TOptions>\n  | ContextProviderBinding<TOptions>;\n\nexport interface ContextProviderSummary {\n  type: string;\n  label?: string;\n  options?: JsonObject;\n}\n\nexport interface ContextContribution {\n  providerId?: string;\n  providerLabel?: string;\n  role: string;\n  authorRole?: string;\n  roleType?: string;\n  content: unknown;\n  metadata?: JsonObject;\n}\n\nexport enum ContextScopes {\n  Turn = \"turn\",\n  Run = \"run\",\n  Session = \"session\",\n}\n\nexport enum ContextConsume {\n  Once = \"once\",\n  WhileActive = \"while_active\",\n}\n\nexport interface ContextRegistrationOptions {\n  scope?: ContextScopes;\n  on?: HarnessEventClass;\n  consume?: ContextConsume;\n  id?: string;\n  replace?: boolean;\n  metadata?: JsonObject;\n}\n\nexport interface ContextEntry {\n  id: string;\n  scope: ContextScopes;\n  on: string;\n  consume: ContextConsume;\n  createdAt: string;\n  activatedAt?: string;\n  activatedByEventId?: string;\n  activatedByEventType?: string;\n  runId: string;\n  turnId?: string;\n  modeId: string;\n  contribution: ContextContribution;\n  metadata?: JsonObject;\n}\n\nexport interface ContextEntryFilter {\n  id?: string;\n  scope?: ContextScopes;\n  consume?: ContextConsume;\n  providerId?: string;\n  role?: string;\n  on?: HarnessEventClass;\n}\n\nexport type ContextProviderOutput =\n  | string\n  | ContextContributionInput\n  | Array<string | ContextContributionInput>\n  | null\n  | undefined;\n\nexport interface ContextContributionInput {\n  role?: HarnessRoleSelector;\n  content: unknown;\n  metadata?: JsonObject;\n}\n\nexport interface ContextProviderRenderResult {\n  providerId: string;\n  providerLabel?: string;\n  binding: ContextProviderSummary;\n  contributions: ContextContribution[];\n}\n\nexport interface ContextSnapshot {\n  id: string;\n  turnId?: string;\n  modeId: string;\n  createdAt: string;\n  providers: ContextProviderRenderResult[];\n  contributions: ContextContribution[];\n  systemPrompt: string;\n  messages: AgentMessage[];\n}\n\nexport abstract class HarnessContextProvider<TOptions extends JsonObject = JsonObject> {\n  protected declare readonly __harnessContextProviderBrand: true;\n\n  label?: string;\n  priority?: number;\n  role?: HarnessRoleSelector;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  with(options: TOptions): ContextProviderBinding<TOptions> {\n    return { provider: this, options };\n  }\n\n  abstract render(session: AgentReadSession, options?: TOptions): ContextProviderOutput | Promise<ContextProviderOutput>;\n}\n\nexport type AgentContextProvider<TOptions extends JsonObject = JsonObject> = HarnessContextProvider<TOptions>;\n","import type { AgentActionSession, AgentReadSession } from \"./sessions.js\";\nimport type { AgentToolSource, ToolApprovalMode } from \"./tools.js\";\nimport type { ContextProviderReference } from \"./context.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessModeSummary {\n  type: string;\n  label: string;\n}\n\nexport abstract class HarnessMode {\n  protected declare readonly __harnessModeBrand: true;\n\n  label?: string;\n  model?: string;\n  prompt?: string | ((session: AgentReadSession) => string | Promise<string>);\n  providers?: \"all\" | ContextProviderReference[];\n  excludeProviders?: string[];\n  tools?: AgentToolSource[];\n  maxTurns?: number;\n  toolApproval?: ToolApprovalMode;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  getPrompt?(session: AgentReadSession): string | Promise<string>;\n  onEnter?(session: AgentActionSession, input?: unknown): void | Promise<void>;\n  onExit?(session: AgentActionSession, nextMode: HarnessModeSummary): void | Promise<void>;\n}\n\nexport type HarnessModeClass<TMode extends HarnessMode = HarnessMode> = abstract new (...args: any[]) => TMode;\nexport type HarnessModeSelector<TMode extends HarnessMode = HarnessMode> = TMode | HarnessModeClass<TMode>;\nexport type AgentModeDefinition = HarnessMode;\n","import type { AgentActionSession } from \"./sessions.js\";\nimport type { HarnessEvent, HarnessEventClass } from \"./events.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessHookSummary {\n  type: string;\n  label: string;\n  eventType: string;\n  eventClassId: string;\n}\n\nexport abstract class HarnessHook<TEvent extends HarnessEvent = HarnessEvent> {\n  protected declare readonly __harnessHookBrand: true;\n\n  label?: string;\n  readonly eventClass?: HarnessEventClass<any, TEvent>;\n\n  static for<TPayload, TEvent extends HarnessEvent<TPayload>>(\n    eventClass: HarnessEventClass<TPayload, TEvent>,\n  ): abstract new () => HarnessHook<TEvent> {\n    abstract class BoundHarnessHook extends HarnessHook<TEvent> {\n      override readonly eventClass: HarnessEventClass<any, TEvent> = eventClass;\n    }\n    return BoundHarnessHook;\n  }\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  abstract onActive(session: AgentActionSession, event: TEvent): void | Promise<void>;\n}\n\nexport type HarnessHookEventClass<TEvent extends HarnessEvent = HarnessEvent> = abstract new () => HarnessHook<TEvent>;\n"],"mappings":"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","names":["RoleTargets","NativeRoles","ContextScopes","ContextConsume"]}