@harness-kernel/core 0.1.0 → 0.2.0

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-BzEf0lAV.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;
@@ -64,13 +67,18 @@ declare class HarnessSessionStoreImpl implements HarnessSessionStore {
     private readonly sessions;
     private readonly unsubscriptions;
     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 +86,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-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-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-37PIMSLG.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.0",
+  "version": "0.2.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/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"]}