@harness-kernel/core 0.1.0 → 0.2.0

package/dist/{chunk-4A2P4QU5.js → chunk-B4Q6CPYO.js}

@@ -94,6 +94,7 @@ var HarnessTool = class {
   risk;
   permissions;
   requiresApproval;
+  approvalTimeoutMs;
   get type() {
     return constructTypeOf(this);
   }
@@ -176,4 +177,4 @@ export {
   HarnessMode,
   HarnessHook
 };
-//# sourceMappingURL=chunk-4A2P4QU5.js.map
+//# sourceMappingURL=chunk-B4Q6CPYO.js.map

package/dist/chunk-B4Q6CPYO.js.map

@@ -0,0 +1 @@
+{"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  approvalTimeoutMs?: number;\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  approvalTimeoutMs?: number;\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"]}

package/dist/{chunk-4SYLFKIX.js → chunk-JIJHGB6H.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-OBKS4AJR.js";
 import {
   HarnessEvent
-} from "./chunk-4A2P4QU5.js";
+} from "./chunk-B4Q6CPYO.js";
 
 // src/runtime/events.ts
 var RunStartEvent = class extends HarnessEvent {
@@ -204,4 +204,4 @@ export {
   TranscriptCursorChangedEvent,
   runtimeEventClasses
 };
-//# sourceMappingURL=chunk-4SYLFKIX.js.map
+//# sourceMappingURL=chunk-JIJHGB6H.js.map

package/dist/chunk-ONYDIU4X.js

@@ -0,0 +1,284 @@
+// src/runtime/storage.ts
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function cloneJSON(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function encodeSessionCursor(summary) {
+  return Buffer.from(JSON.stringify([summary.lastActiveAt, summary.sessionId]), "utf8").toString("base64url");
+}
+function decodeSessionCursor(cursor) {
+  if (!cursor) return void 0;
+  try {
+    const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    if (!Array.isArray(parsed) || typeof parsed[0] !== "string" || typeof parsed[1] !== "string") return void 0;
+    return [parsed[0], parsed[1]];
+  } catch {
+    return void 0;
+  }
+}
+function sortSessionSummaries(summaries) {
+  return [...summaries].sort((a, b) => {
+    const byLastActive = b.lastActiveAt.localeCompare(a.lastActiveAt);
+    return byLastActive || a.sessionId.localeCompare(b.sessionId);
+  });
+}
+function paginateSessionSummaries(summaries, query) {
+  const limit = Math.max(1, Math.min(query?.limit ?? 50, 100));
+  const cursor = decodeSessionCursor(query?.cursor);
+  const filtered = sortSessionSummaries(summaries).filter((summary) => !query?.agentKey || summary.agentKey === query.agentKey).filter((summary) => {
+    if (!cursor) return true;
+    const [lastActiveAt, sessionId] = cursor;
+    return summary.lastActiveAt < lastActiveAt || summary.lastActiveAt === lastActiveAt && summary.sessionId > sessionId;
+  });
+  const items = filtered.slice(0, limit);
+  const nextCursor = filtered.length > limit && items.length > 0 ? encodeSessionCursor(items[items.length - 1]) : void 0;
+  return { items: items.map((item) => cloneJSON(item)), nextCursor };
+}
+var HarnessRunStorage = class {
+  label;
+};
+var HarnessSessionStorage = class {
+  label;
+};
+var HarnessRunStore = class {
+  outputDir;
+  runDir;
+};
+var NoopRunStorage = class extends HarnessRunStorage {
+  id = "noop";
+  label = "Noop";
+  openRun(input) {
+    return new NoopRunStore(input.runId);
+  }
+};
+var NoopRunStore = class extends HarnessRunStore {
+  constructor(runId) {
+    super();
+    this.runId = runId;
+  }
+  runId;
+  outputDir = void 0;
+  runDir = void 0;
+  init() {
+  }
+  recordEvent(_event) {
+  }
+  loadEvents() {
+    return [];
+  }
+  saveTranscript(_messages) {
+  }
+  loadTranscript() {
+    return [];
+  }
+  saveMetrics(_metrics) {
+  }
+  saveSnapshot(_snapshot) {
+  }
+  loadSnapshots() {
+    return [];
+  }
+  deleteSnapshot(_id) {
+  }
+  saveCursors(_cursors) {
+  }
+  loadCursors() {
+    return void 0;
+  }
+  saveContextSnapshot(_snapshot) {
+  }
+  loadContextSnapshots() {
+    return [];
+  }
+};
+var MemoryRunStorage = class extends HarnessRunStorage {
+  id = "memory";
+  label = "Memory";
+  runs = /* @__PURE__ */ new Map();
+  openRun(input) {
+    let state = this.runs.get(input.runId);
+    if (!state) {
+      state = {
+        events: [],
+        transcript: [],
+        snapshots: /* @__PURE__ */ new Map(),
+        contextSnapshots: /* @__PURE__ */ new Map()
+      };
+      this.runs.set(input.runId, state);
+    }
+    return new MemoryRunStore(input.runId, state);
+  }
+};
+var MemorySessionStorage = class extends HarnessSessionStorage {
+  id = "memory-session";
+  label = "Memory Session";
+  sessions = /* @__PURE__ */ new Map();
+  runStates = /* @__PURE__ */ new Map();
+  createSession(input) {
+    const existing = this.sessions.get(input.sessionId)?.summary;
+    if (existing) return cloneJSON(existing);
+    const createdAt = input.createdAt ?? nowIso();
+    const summary = {
+      sessionId: input.sessionId,
+      agentKey: input.agentKey,
+      createdAt,
+      lastActiveAt: input.lastActiveAt ?? createdAt,
+      mode: input.mode,
+      latestRunId: input.latestRunId,
+      metadata: input.metadata ? cloneJSON(input.metadata) : void 0
+    };
+    this.sessions.set(summary.sessionId, { summary, runs: [] });
+    return cloneJSON(summary);
+  }
+  getSession(sessionId) {
+    const summary = this.sessions.get(sessionId)?.summary;
+    return summary ? cloneJSON(summary) : void 0;
+  }
+  listSessions(query) {
+    return paginateSessionSummaries([...this.sessions.values()].map((entry) => entry.summary), query);
+  }
+  touchSession(input) {
+    const entry = this.sessions.get(input.sessionId);
+    if (!entry) return;
+    entry.summary = {
+      ...entry.summary,
+      lastActiveAt: input.lastActiveAt ?? nowIso(),
+      mode: input.mode ?? entry.summary.mode,
+      latestRunId: input.latestRunId ?? entry.summary.latestRunId,
+      metadata: input.metadata ? cloneJSON(input.metadata) : entry.summary.metadata
+    };
+  }
+  deleteSession(sessionId) {
+    const entry = this.sessions.get(sessionId);
+    if (!entry) return false;
+    this.sessions.delete(sessionId);
+    for (const run of entry.runs) this.runStates.delete(run.runId);
+    return true;
+  }
+  createRun(input) {
+    const entry = this.sessions.get(input.sessionId);
+    if (!entry) throw new Error(`Harness session '${input.sessionId}' was not found.`);
+    const existing = entry.runs.find((run2) => run2.runId === input.runId);
+    if (existing) return cloneJSON(existing);
+    const latestRun = entry.summary.latestRunId;
+    const previousState = latestRun ? this.runStates.get(latestRun) : void 0;
+    const state = previousState ? cloneRunState(previousState) : createMemoryRunState();
+    this.runStates.set(input.runId, state);
+    const run = {
+      runId: input.runId,
+      sessionId: input.sessionId,
+      agentKey: input.agentKey,
+      createdAt: input.createdAt ?? nowIso(),
+      mode: input.mode,
+      outputDir: input.outputDir,
+      metadata: input.metadata ? cloneJSON(input.metadata) : void 0
+    };
+    entry.runs.push(run);
+    entry.summary = {
+      ...entry.summary,
+      latestRunId: run.runId,
+      lastActiveAt: run.createdAt,
+      mode: run.mode
+    };
+    return cloneJSON(run);
+  }
+  getLatestRun(sessionId) {
+    const entry = this.sessions.get(sessionId);
+    const latestRunId = entry?.summary.latestRunId;
+    if (!entry || !latestRunId) return void 0;
+    const run = entry.runs.find((candidate) => candidate.runId === latestRunId);
+    return run ? cloneJSON(run) : void 0;
+  }
+  listRuns(sessionId) {
+    return (this.sessions.get(sessionId)?.runs ?? []).map((run) => cloneJSON(run));
+  }
+  openRun(input) {
+    let state = this.runStates.get(input.runId);
+    if (!state) {
+      state = createMemoryRunState();
+      this.runStates.set(input.runId, state);
+    }
+    return new MemoryRunStore(input.runId, state);
+  }
+};
+function createMemoryRunState() {
+  return {
+    events: [],
+    transcript: [],
+    snapshots: /* @__PURE__ */ new Map(),
+    contextSnapshots: /* @__PURE__ */ new Map()
+  };
+}
+function cloneRunState(state) {
+  return {
+    events: cloneJSON(state.events),
+    transcript: cloneJSON(state.transcript),
+    metrics: state.metrics ? cloneJSON(state.metrics) : void 0,
+    snapshots: new Map([...state.snapshots.entries()].map(([id, snapshot]) => [id, cloneJSON(snapshot)])),
+    cursors: state.cursors ? cloneJSON(state.cursors) : void 0,
+    contextSnapshots: new Map([...state.contextSnapshots.entries()].map(([id, snapshot]) => [id, cloneJSON(snapshot)]))
+  };
+}
+var MemoryRunStore = class extends HarnessRunStore {
+  constructor(runId, state) {
+    super();
+    this.runId = runId;
+    this.state = state;
+  }
+  runId;
+  state;
+  outputDir = void 0;
+  runDir = void 0;
+  init() {
+  }
+  recordEvent(event) {
+    this.state.events.push(cloneJSON(event));
+  }
+  loadEvents() {
+    return cloneJSON(this.state.events);
+  }
+  saveTranscript(messages) {
+    this.state.transcript = cloneJSON(messages);
+  }
+  loadTranscript() {
+    return cloneJSON(this.state.transcript);
+  }
+  saveMetrics(metrics) {
+    this.state.metrics = cloneJSON(metrics);
+  }
+  saveSnapshot(snapshot) {
+    this.state.snapshots.set(snapshot.id, cloneJSON(snapshot));
+  }
+  loadSnapshots() {
+    return [...this.state.snapshots.values()].map((snapshot) => cloneJSON(snapshot)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  }
+  deleteSnapshot(id) {
+    this.state.snapshots.delete(id);
+  }
+  saveCursors(cursors) {
+    this.state.cursors = cloneJSON(cursors);
+  }
+  loadCursors() {
+    return this.state.cursors ? cloneJSON(this.state.cursors) : void 0;
+  }
+  saveContextSnapshot(snapshot) {
+    this.state.contextSnapshots.set(snapshot.id, cloneJSON(snapshot));
+  }
+  loadContextSnapshots() {
+    return [...this.state.contextSnapshots.values()].map((snapshot) => cloneJSON(snapshot)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  }
+};
+
+export {
+  HarnessRunStorage,
+  HarnessSessionStorage,
+  HarnessRunStore,
+  NoopRunStorage,
+  NoopRunStore,
+  MemoryRunStorage,
+  MemorySessionStorage,
+  MemoryRunStore
+};
+//# sourceMappingURL=chunk-ONYDIU4X.js.map

package/dist/chunk-ONYDIU4X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/storage.ts"],"sourcesContent":["import type {\n  AgentMessage,\n  ContextSnapshot,\n  EventCursor,\n  HarnessEventRecord,\n  HarnessSnapshot,\n  RunMetrics,\n  TranscriptBranch,\n  TranscriptCursor,\n} from \"./types.js\";\n\nexport interface RunCursorState {\n  transcriptCursor: TranscriptCursor;\n  eventCursor: EventCursor;\n  branches?: TranscriptBranch[];\n}\n\nexport interface OpenRunStoreInput {\n  runId: string;\n  sessionId: string;\n  agentKey: string;\n  outputDir?: string;\n}\n\nexport interface HarnessSessionSummary {\n  sessionId: string;\n  agentKey: string;\n  createdAt: string;\n  lastActiveAt: string;\n  mode: string;\n  latestRunId?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface SessionListQuery {\n  agentKey?: string;\n  active?: boolean;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface SessionListResult {\n  items: HarnessSessionSummary[];\n  nextCursor?: string;\n}\n\nexport interface StoredRunSummary {\n  runId: string;\n  sessionId: string;\n  agentKey: string;\n  createdAt: string;\n  mode: string;\n  outputDir?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CreateStoredSessionInput {\n  sessionId: string;\n  agentKey: string;\n  createdAt?: string;\n  lastActiveAt?: string;\n  mode: string;\n  latestRunId?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TouchStoredSessionInput {\n  sessionId: string;\n  lastActiveAt?: string;\n  mode?: string;\n  latestRunId?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CreateStoredRunInput {\n  runId: string;\n  sessionId: string;\n  agentKey: string;\n  createdAt?: string;\n  mode: string;\n  outputDir?: string;\n  metadata?: Record<string, unknown>;\n}\n\nfunction nowIso(): string {\n  return new Date().toISOString();\n}\n\nfunction cloneJSON<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction encodeSessionCursor(summary: HarnessSessionSummary): string {\n  return Buffer.from(JSON.stringify([summary.lastActiveAt, summary.sessionId]), \"utf8\").toString(\"base64url\");\n}\n\nfunction decodeSessionCursor(cursor: string | undefined): [string, string] | undefined {\n  if (!cursor) return undefined;\n  try {\n    const parsed = JSON.parse(Buffer.from(cursor, \"base64url\").toString(\"utf8\")) as unknown;\n    if (!Array.isArray(parsed) || typeof parsed[0] !== \"string\" || typeof parsed[1] !== \"string\") return undefined;\n    return [parsed[0], parsed[1]];\n  } catch {\n    return undefined;\n  }\n}\n\nfunction sortSessionSummaries(summaries: HarnessSessionSummary[]): HarnessSessionSummary[] {\n  return [...summaries].sort((a, b) => {\n    const byLastActive = b.lastActiveAt.localeCompare(a.lastActiveAt);\n    return byLastActive || a.sessionId.localeCompare(b.sessionId);\n  });\n}\n\nfunction paginateSessionSummaries(\n  summaries: HarnessSessionSummary[],\n  query: SessionListQuery | undefined,\n): SessionListResult {\n  const limit = Math.max(1, Math.min(query?.limit ?? 50, 100));\n  const cursor = decodeSessionCursor(query?.cursor);\n  const filtered = sortSessionSummaries(summaries)\n    .filter((summary) => !query?.agentKey || summary.agentKey === query.agentKey)\n    .filter((summary) => {\n      if (!cursor) return true;\n      const [lastActiveAt, sessionId] = cursor;\n      return summary.lastActiveAt < lastActiveAt\n        || (summary.lastActiveAt === lastActiveAt && summary.sessionId > sessionId);\n    });\n  const items = filtered.slice(0, limit);\n  const nextCursor = filtered.length > limit && items.length > 0\n    ? encodeSessionCursor(items[items.length - 1]!)\n    : undefined;\n  return { items: items.map((item) => cloneJSON(item)), nextCursor };\n}\n\nexport abstract class HarnessRunStorage {\n  abstract readonly id: string;\n  label?: string;\n\n  abstract openRun(input: OpenRunStoreInput): Promise<HarnessRunStore> | HarnessRunStore;\n}\n\nexport abstract class HarnessSessionStorage {\n  abstract readonly id: string;\n  label?: string;\n\n  init?(): Promise<void> | void;\n  abstract createSession(input: CreateStoredSessionInput): Promise<HarnessSessionSummary> | HarnessSessionSummary;\n  abstract getSession(sessionId: string): Promise<HarnessSessionSummary | undefined> | HarnessSessionSummary | undefined;\n  abstract listSessions(query?: SessionListQuery): Promise<SessionListResult> | SessionListResult;\n  abstract touchSession(input: TouchStoredSessionInput): Promise<void> | void;\n  abstract deleteSession(sessionId: string): Promise<boolean> | boolean;\n  abstract createRun(input: CreateStoredRunInput): Promise<StoredRunSummary> | StoredRunSummary;\n  abstract getLatestRun(sessionId: string): Promise<StoredRunSummary | undefined> | StoredRunSummary | undefined;\n  abstract listRuns(sessionId: string): Promise<StoredRunSummary[]> | StoredRunSummary[];\n  abstract openRun(input: OpenRunStoreInput): Promise<HarnessRunStore> | HarnessRunStore;\n}\n\nexport abstract class HarnessRunStore {\n  abstract readonly runId: string;\n  readonly outputDir?: string;\n  readonly runDir?: string;\n\n  abstract init(): Promise<void> | void;\n  abstract recordEvent(event: HarnessEventRecord): Promise<void> | void;\n  abstract loadEvents(): Promise<HarnessEventRecord[]> | HarnessEventRecord[];\n  abstract saveTranscript(messages: AgentMessage[]): Promise<void> | void;\n  abstract loadTranscript(): Promise<AgentMessage[]> | AgentMessage[];\n  abstract saveMetrics(metrics: RunMetrics): Promise<void> | void;\n  abstract saveSnapshot(snapshot: HarnessSnapshot): Promise<void> | void;\n  abstract loadSnapshots(): Promise<HarnessSnapshot[]> | HarnessSnapshot[];\n  abstract deleteSnapshot(id: string): Promise<void> | void;\n  abstract saveCursors(cursors: RunCursorState): Promise<void> | void;\n  abstract loadCursors(): Promise<RunCursorState | undefined> | RunCursorState | undefined;\n  abstract saveContextSnapshot(snapshot: ContextSnapshot): Promise<void> | void;\n  abstract loadContextSnapshots(): Promise<ContextSnapshot[]> | ContextSnapshot[];\n\n  close?(): Promise<void>;\n}\n\nexport class NoopRunStorage extends HarnessRunStorage {\n  readonly id = \"noop\";\n  label = \"Noop\";\n\n  openRun(input: OpenRunStoreInput): HarnessRunStore {\n    return new NoopRunStore(input.runId);\n  }\n}\n\nexport class NoopRunStore extends HarnessRunStore {\n  readonly outputDir = undefined;\n  readonly runDir = undefined;\n\n  constructor(readonly runId: string) {\n    super();\n  }\n\n  init(): void {}\n  recordEvent(_event: HarnessEventRecord): void {}\n  loadEvents(): HarnessEventRecord[] { return []; }\n  saveTranscript(_messages: AgentMessage[]): void {}\n  loadTranscript(): AgentMessage[] { return []; }\n  saveMetrics(_metrics: RunMetrics): void {}\n  saveSnapshot(_snapshot: HarnessSnapshot): void {}\n  loadSnapshots(): HarnessSnapshot[] { return []; }\n  deleteSnapshot(_id: string): void {}\n  saveCursors(_cursors: RunCursorState): void {}\n  loadCursors(): RunCursorState | undefined { return undefined; }\n  saveContextSnapshot(_snapshot: ContextSnapshot): void {}\n  loadContextSnapshots(): ContextSnapshot[] { return []; }\n}\n\ninterface MemoryRunState {\n  events: HarnessEventRecord[];\n  transcript: AgentMessage[];\n  metrics?: RunMetrics;\n  snapshots: Map<string, HarnessSnapshot>;\n  cursors?: RunCursorState;\n  contextSnapshots: Map<string, ContextSnapshot>;\n}\n\nexport class MemoryRunStorage extends HarnessRunStorage {\n  readonly id = \"memory\";\n  label = \"Memory\";\n  private readonly runs = new Map<string, MemoryRunState>();\n\n  openRun(input: OpenRunStoreInput): HarnessRunStore {\n    let state = this.runs.get(input.runId);\n    if (!state) {\n      state = {\n        events: [],\n        transcript: [],\n        snapshots: new Map(),\n        contextSnapshots: new Map(),\n      };\n      this.runs.set(input.runId, state);\n    }\n    return new MemoryRunStore(input.runId, state);\n  }\n}\n\ninterface MemoryStoredSession {\n  summary: HarnessSessionSummary;\n  runs: StoredRunSummary[];\n}\n\nexport class MemorySessionStorage extends HarnessSessionStorage {\n  readonly id = \"memory-session\";\n  label = \"Memory Session\";\n  private readonly sessions = new Map<string, MemoryStoredSession>();\n  private readonly runStates = new Map<string, MemoryRunState>();\n\n  createSession(input: CreateStoredSessionInput): HarnessSessionSummary {\n    const existing = this.sessions.get(input.sessionId)?.summary;\n    if (existing) return cloneJSON(existing);\n    const createdAt = input.createdAt ?? nowIso();\n    const summary: HarnessSessionSummary = {\n      sessionId: input.sessionId,\n      agentKey: input.agentKey,\n      createdAt,\n      lastActiveAt: input.lastActiveAt ?? createdAt,\n      mode: input.mode,\n      latestRunId: input.latestRunId,\n      metadata: input.metadata ? cloneJSON(input.metadata) : undefined,\n    };\n    this.sessions.set(summary.sessionId, { summary, runs: [] });\n    return cloneJSON(summary);\n  }\n\n  getSession(sessionId: string): HarnessSessionSummary | undefined {\n    const summary = this.sessions.get(sessionId)?.summary;\n    return summary ? cloneJSON(summary) : undefined;\n  }\n\n  listSessions(query?: SessionListQuery): SessionListResult {\n    return paginateSessionSummaries([...this.sessions.values()].map((entry) => entry.summary), query);\n  }\n\n  touchSession(input: TouchStoredSessionInput): void {\n    const entry = this.sessions.get(input.sessionId);\n    if (!entry) return;\n    entry.summary = {\n      ...entry.summary,\n      lastActiveAt: input.lastActiveAt ?? nowIso(),\n      mode: input.mode ?? entry.summary.mode,\n      latestRunId: input.latestRunId ?? entry.summary.latestRunId,\n      metadata: input.metadata ? cloneJSON(input.metadata) : entry.summary.metadata,\n    };\n  }\n\n  deleteSession(sessionId: string): boolean {\n    const entry = this.sessions.get(sessionId);\n    if (!entry) return false;\n    this.sessions.delete(sessionId);\n    for (const run of entry.runs) this.runStates.delete(run.runId);\n    return true;\n  }\n\n  createRun(input: CreateStoredRunInput): StoredRunSummary {\n    const entry = this.sessions.get(input.sessionId);\n    if (!entry) throw new Error(`Harness session '${input.sessionId}' was not found.`);\n    const existing = entry.runs.find((run) => run.runId === input.runId);\n    if (existing) return cloneJSON(existing);\n    const latestRun = entry.summary.latestRunId;\n    const previousState = latestRun ? this.runStates.get(latestRun) : undefined;\n    const state = previousState ? cloneRunState(previousState) : createMemoryRunState();\n    this.runStates.set(input.runId, state);\n    const run: StoredRunSummary = {\n      runId: input.runId,\n      sessionId: input.sessionId,\n      agentKey: input.agentKey,\n      createdAt: input.createdAt ?? nowIso(),\n      mode: input.mode,\n      outputDir: input.outputDir,\n      metadata: input.metadata ? cloneJSON(input.metadata) : undefined,\n    };\n    entry.runs.push(run);\n    entry.summary = {\n      ...entry.summary,\n      latestRunId: run.runId,\n      lastActiveAt: run.createdAt,\n      mode: run.mode,\n    };\n    return cloneJSON(run);\n  }\n\n  getLatestRun(sessionId: string): StoredRunSummary | undefined {\n    const entry = this.sessions.get(sessionId);\n    const latestRunId = entry?.summary.latestRunId;\n    if (!entry || !latestRunId) return undefined;\n    const run = entry.runs.find((candidate) => candidate.runId === latestRunId);\n    return run ? cloneJSON(run) : undefined;\n  }\n\n  listRuns(sessionId: string): StoredRunSummary[] {\n    return (this.sessions.get(sessionId)?.runs ?? []).map((run) => cloneJSON(run));\n  }\n\n  openRun(input: OpenRunStoreInput): HarnessRunStore {\n    let state = this.runStates.get(input.runId);\n    if (!state) {\n      state = createMemoryRunState();\n      this.runStates.set(input.runId, state);\n    }\n    return new MemoryRunStore(input.runId, state);\n  }\n}\n\nfunction createMemoryRunState(): MemoryRunState {\n  return {\n    events: [],\n    transcript: [],\n    snapshots: new Map(),\n    contextSnapshots: new Map(),\n  };\n}\n\nfunction cloneRunState(state: MemoryRunState): MemoryRunState {\n  return {\n    events: cloneJSON(state.events),\n    transcript: cloneJSON(state.transcript),\n    metrics: state.metrics ? cloneJSON(state.metrics) : undefined,\n    snapshots: new Map([...state.snapshots.entries()].map(([id, snapshot]) => [id, cloneJSON(snapshot)])),\n    cursors: state.cursors ? cloneJSON(state.cursors) : undefined,\n    contextSnapshots: new Map([...state.contextSnapshots.entries()].map(([id, snapshot]) => [id, cloneJSON(snapshot)])),\n  };\n}\n\nexport class MemoryRunStore extends HarnessRunStore {\n  readonly outputDir = undefined;\n  readonly runDir = undefined;\n\n  constructor(\n    readonly runId: string,\n    private readonly state: MemoryRunState,\n  ) {\n    super();\n  }\n\n  init(): void {}\n  recordEvent(event: HarnessEventRecord): void { this.state.events.push(cloneJSON(event)); }\n  loadEvents(): HarnessEventRecord[] { return cloneJSON(this.state.events); }\n  saveTranscript(messages: AgentMessage[]): void { this.state.transcript = cloneJSON(messages); }\n  loadTranscript(): AgentMessage[] { return cloneJSON(this.state.transcript); }\n  saveMetrics(metrics: RunMetrics): void { this.state.metrics = cloneJSON(metrics); }\n  saveSnapshot(snapshot: HarnessSnapshot): void { this.state.snapshots.set(snapshot.id, cloneJSON(snapshot)); }\n  loadSnapshots(): HarnessSnapshot[] {\n    return [...this.state.snapshots.values()]\n      .map((snapshot) => cloneJSON(snapshot))\n      .sort((a, b) => a.createdAt.localeCompare(b.createdAt));\n  }\n  deleteSnapshot(id: string): void { this.state.snapshots.delete(id); }\n  saveCursors(cursors: RunCursorState): void { this.state.cursors = cloneJSON(cursors); }\n  loadCursors(): RunCursorState | undefined { return this.state.cursors ? cloneJSON(this.state.cursors) : undefined; }\n  saveContextSnapshot(snapshot: ContextSnapshot): void { this.state.contextSnapshots.set(snapshot.id, cloneJSON(snapshot)); }\n  loadContextSnapshots(): ContextSnapshot[] {\n    return [...this.state.contextSnapshots.values()]\n      .map((snapshot) => cloneJSON(snapshot))\n      .sort((a, b) => a.createdAt.localeCompare(b.createdAt));\n  }\n}\n"],"mappings":"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","names":["run"]}

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-BzEf0lAV.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-37PIMSLG.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';