@harness-kernel/core 0.3.0 → 0.5.0

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

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

package/dist/chunk-IWHCNKHK.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 type SandboxCloseReason = \"close\" | \"delete\";\n\nexport interface SandboxCloseInput {\n  reason: SandboxCloseReason;\n}\n\nexport interface SandboxDestroyInput {\n  sessionId: string;\n  agentKey?: string;\n  workDir?: string;\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  destroy?(input: SandboxDestroyInput): Promise<void> | void;\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?(input?: SandboxCloseInput): Promise<void> | 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":";AAsCO,IAAe,iBAAf,MAA8B;AAAA,EAEnC;AAKF;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/index.d.ts

@@ -1,7 +1,7 @@
 import { R as RunnerEventListener, J as JsonObject, j as HarnessEventQuery, k as HarnessEventRecord, h as HarnessEventEmitOptions } from './errors-hpkW3tfR.js';
 export { E as EventCursor, H as HarnessErrorCategory, a as HarnessErrorCode, b as HarnessErrorContext, c as HarnessErrorPolicy, d as HarnessErrorSeverity, e as HarnessErrorShape, f as HarnessEvent, g as HarnessEventClass, i as HarnessEventMetadata, l as HarnessEventSource, m as HarnessRetryPolicy } from './errors-hpkW3tfR.js';
-import { a as HarnessAgentManifest } from './approval-Ch0LwJFM.js';
-export { H as HarnessAgentInput, b as HarnessAppConfig, c as HarnessEventSummary, d as HarnessRunStream, e as HarnessSession, f as HarnessSessionEventListener, g as HarnessSessionListener, h as HarnessSessionPhase, i as HarnessSessionStatus, j as HarnessSessionStore, k as HarnessSessionStoreEvent, l as HarnessSessionStoreListener, m as HarnessStorageConfig, n as HarnessStreamEvent, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, T as ToolApprovalHandle, W as WaitForEventOptions } from './approval-Ch0LwJFM.js';
+import { a as HarnessAgentManifest } from './approval-7e8HD-35.js';
+export { H as HarnessAgentInput, b as HarnessAppConfig, c as HarnessEventSummary, d as HarnessRunStream, e as HarnessSession, f as HarnessSessionEventListener, g as HarnessSessionListener, h as HarnessSessionPhase, i as HarnessSessionStatus, j as HarnessSessionStore, k as HarnessSessionStoreEvent, l as HarnessSessionStoreListener, m as HarnessStorageConfig, n as HarnessStreamEvent, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, T as ToolApprovalHandle, W as WaitForEventOptions } from './approval-7e8HD-35.js';
 import { ap as TranscriptQuery, h as AgentMessage, ao as TranscriptCursor, aq as TranscriptSeekTarget, r as AgentSharedState, a7 as HarnessSnapshotInput, a5 as HarnessSnapshot, a9 as HarnessSnapshotSummary, M as ContextSnapshot, E as ContextEntryFilter, D as ContextEntry, a2 as HarnessModeSelector } from './context-Bz9C_rL9.js';
 export { A as AgentActionSession, a as AgentContextProvider, b as AgentContextReader, c as AgentContextSession, d as AgentEventReader, e as AgentEventSession, f as AgentHistorySession, g as AgentLogSession, i as AgentMessageEnqueueOptions, j as AgentMessageInput, k as AgentMessageRole, l as AgentMessageSession, m as AgentModeDefinition, n as AgentModeReader, o as AgentModeSession, p as AgentReadSession, q as AgentRuntimeLogger, s as AgentSharedStateDefinition, t as AgentStateReader, u as AgentStateSession, v as AgentToolDefinition, w as AgentToolResult, x as AgentToolSession, y as AgentToolSource, C as ContextConsume, z as ContextContribution, B as ContextContributionInput, F as ContextProviderBinding, G as ContextProviderOutput, H as ContextProviderReference, I as ContextProviderRenderResult, J as ContextProviderSummary, K as ContextRegistrationOptions, L as ContextScopes, N as HarnessContextProvider, O as HarnessContextProviderClass, P as HarnessContextProviderSelector, a0 as HarnessMode, a1 as HarnessModeClass, a3 as HarnessModeSummary, a6 as HarnessSnapshotCreator, a8 as HarnessSnapshotSession, aa as HarnessTool, ab as HarnessToolClass, ac as HarnessToolSelector, ad as HarnessTranscriptSession, ae as RunInfo, af as ToolApprovalDecision, ag as ToolApprovalMode, ah as ToolApprovalRequest, ai as ToolApprovalResolver, aj as ToolCatalogEntry, ak as ToolPermission, al as ToolRef, am as ToolRisk, an as TranscriptBranch, ar as TurnInfo } from './context-Bz9C_rL9.js';
 export { A as AssistantRole, H as HarnessRole, a as HarnessRoleClass, b as HarnessRoleDefinition, c as HarnessRoleSelector, d as HarnessRoleSummary, N as NativeRoles, R as RoleTargets, S as SystemRole, T as ToolRole, U as UserRole, e as assistantRole, s as systemRole, t as toolRole, u as userRole } from './role-BN6KhQxx.js';
@@ -13,9 +13,10 @@ export { A as AgentDefinition, H as HarnessModelProvider, d as HarnessModelProvi
 export { C as ContextReadyEvent, E as ErrorEvent, M as MessageDeltaEvent, a as MessageEndEvent, b as MessageStartEvent, c as ModeChangedEvent, d as ModelAfterEvent, e as ModelBeforeEvent, R as RunAbortedEvent, f as RunEndEvent, g as RunFailedEvent, h as RunStartEvent, S as SnapshotCreatedEvent, i as SnapshotDeletedEvent, j as SnapshotRestoredEvent, T as ToolApprovalRequestedEvent, k as ToolApprovalResolvedEvent, l as ToolEndEvent, m as ToolStartEvent, n as TranscriptCursorChangedEvent, o as TurnEndEvent, p as TurnStartEvent, r as runtimeEventClasses } from './event-DMBY-R6h.js';
 export { n as normalizeHarnessError, s as sanitizeHarnessError } from './errors-DHHy8V3O.js';
 export { defineAgent } from './agent.js';
-export { HarnessSandbox, HarnessSandboxOpenInput, HarnessSandboxSession, NoopSandbox, NoopSandboxSession, SandboxExecInput, SandboxExecResult } from './runner/sandbox.js';
+import { SandboxCloseInput } from './runner/sandbox.js';
+export { HarnessSandbox, HarnessSandboxOpenInput, HarnessSandboxSession, NoopSandbox, NoopSandboxSession, SandboxCloseReason, SandboxDestroyInput, SandboxExecInput, SandboxExecResult } from './runner/sandbox.js';
 export { CreateStoredRunInput, CreateStoredSessionInput, HarnessRunStorage, HarnessRunStore, HarnessSessionStorage, HarnessSessionSummary, MemoryRunStorage, MemoryRunStore, MemorySessionStorage, NoopRunStorage, NoopRunStore, OpenRunStoreInput, RunCursorState, SessionListQuery, SessionListResult, StoredRunSummary, TouchStoredSessionInput } from './runner/storage.js';
-export { C as CreateHarnessSessionInternalOptions, H as HarnessSessionImpl, a as HarnessSessionStoreImpl, c as createHarnessSession, b as createHarnessSessionStore } from './runner-CZHeMHKV.js';
+export { C as CreateHarnessSessionInternalOptions, H as HarnessSessionImpl, a as HarnessSessionStoreImpl, c as createHarnessSession, b as createHarnessSessionStore } from './runner-BYG9ARAV.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 { ToolErrorCode, ToolErrorPayload, ToolInvalidField, createToolErrorPayload, createToolErrorResult } from './agent/tool.js';
 
@@ -77,7 +78,7 @@ declare class AgentSessionRunner {
     private finalizeMetrics;
     private tryFailureWrite;
     hydrate(): Promise<void>;
-    close(): Promise<void>;
+    close(input?: SandboxCloseInput): Promise<void>;
     getTranscript(options?: TranscriptQuery): AgentMessage[];
     getMetrics(): RunMetrics;
     getRunInfo(): {
@@ -169,4 +170,4 @@ declare class AgentSessionRunner {
     private dispatchHooks;
 }
 
-export { AgentMessage, AgentRunResult, AgentRunnerRunOptions, AgentSessionRunner, AgentSessionRunnerOptions, AgentSharedState, ContextEntry, ContextEntryFilter, ContextSnapshot, HarnessAgentManifest, HarnessEventEmitOptions, HarnessEventQuery, HarnessEventRecord, HarnessModeSelector, HarnessSnapshot, HarnessSnapshotInput, HarnessSnapshotSummary, JsonObject, ModelProviderInfo, NormalizedAgentDefinition, RunMetrics, RunnerEventListener, TranscriptCursor, TranscriptQuery, TranscriptSeekTarget };
+export { AgentMessage, AgentRunResult, AgentRunnerRunOptions, AgentSessionRunner, AgentSessionRunnerOptions, AgentSharedState, ContextEntry, ContextEntryFilter, ContextSnapshot, HarnessAgentManifest, HarnessEventEmitOptions, HarnessEventQuery, HarnessEventRecord, HarnessModeSelector, HarnessSnapshot, HarnessSnapshotInput, HarnessSnapshotSummary, JsonObject, ModelProviderInfo, NormalizedAgentDefinition, RunMetrics, RunnerEventListener, SandboxCloseInput, TranscriptCursor, TranscriptQuery, TranscriptSeekTarget };

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   HarnessSessionStoreImpl,
   createHarnessSession,
   createHarnessSessionStore
-} from "./chunk-UKXJIKED.js";
+} from "./chunk-BLLQSHQI.js";
 import {
   HarnessModelProviderRegistry,
   modelProviderId,
@@ -20,7 +20,7 @@ import {
   HarnessSandboxSession,
   NoopSandbox,
   NoopSandboxSession
-} from "./chunk-ZU6ADDET.js";
+} from "./chunk-IWHCNKHK.js";
 import {
   HarnessRunStorage,
   HarnessRunStore,

package/dist/runner/approval.d.ts

@@ -1,4 +1,4 @@
-export { T as ToolApprovalHandle } from '../approval-Ch0LwJFM.js';
+export { T as ToolApprovalHandle } from '../approval-7e8HD-35.js';
 export { af as ToolApprovalDecision, ag as ToolApprovalMode, ah as ToolApprovalRequest } from '../context-Bz9C_rL9.js';
 import '../model-provider-DGkLQJWP.js';
 import '../errors-hpkW3tfR.js';

package/dist/runner/sandbox.d.ts

@@ -21,16 +21,26 @@ interface SandboxExecResult {
     durationMs: number;
     timedOut?: boolean;
 }
+type SandboxCloseReason = "close" | "delete";
+interface SandboxCloseInput {
+    reason: SandboxCloseReason;
+}
+interface SandboxDestroyInput {
+    sessionId: string;
+    agentKey?: string;
+    workDir?: string;
+}
 declare abstract class HarnessSandbox {
     abstract readonly id: string;
     label?: string;
     abstract open(input: HarnessSandboxOpenInput): Promise<HarnessSandboxSession> | HarnessSandboxSession;
+    destroy?(input: SandboxDestroyInput): Promise<void> | void;
 }
 declare abstract class HarnessSandboxSession {
     abstract readonly id: string;
     abstract readonly workDir: string;
     abstract exec(input: SandboxExecInput): Promise<SandboxExecResult>;
-    close?(): Promise<void>;
+    close?(input?: SandboxCloseInput): Promise<void> | void;
 }
 declare class NoopSandbox extends HarnessSandbox {
     readonly id = "noop";
@@ -44,4 +54,4 @@ declare class NoopSandboxSession extends HarnessSandboxSession {
     exec(input: SandboxExecInput): Promise<SandboxExecResult>;
 }
 
-export { HarnessSandbox, type HarnessSandboxOpenInput, HarnessSandboxSession, NoopSandbox, NoopSandboxSession, type SandboxExecInput, type SandboxExecResult };
+export { HarnessSandbox, type HarnessSandboxOpenInput, HarnessSandboxSession, NoopSandbox, NoopSandboxSession, type SandboxCloseInput, type SandboxCloseReason, type SandboxDestroyInput, type SandboxExecInput, type SandboxExecResult };

package/dist/runner/sandbox.js

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

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

@@ -1,7 +1,8 @@
 import { j as HarnessEventQuery, k as HarnessEventRecord, f as HarnessEvent, g as HarnessEventClass } from './errors-hpkW3tfR.js';
 import { ad as HarnessTranscriptSession, a8 as HarnessSnapshotSession, a2 as HarnessModeSelector, r as AgentSharedState, M as ContextSnapshot } from './context-Bz9C_rL9.js';
-import { e as HarnessSession, b as HarnessAppConfig, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, d as HarnessRunStream, i as HarnessSessionStatus, a as HarnessAgentManifest, T as ToolApprovalHandle, g as HarnessSessionListener, f as HarnessSessionEventListener, W as WaitForEventOptions, j as HarnessSessionStore, l as HarnessSessionStoreListener } from './approval-Ch0LwJFM.js';
+import { e as HarnessSession, b as HarnessAppConfig, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, d as HarnessRunStream, i as HarnessSessionStatus, a as HarnessAgentManifest, T as ToolApprovalHandle, g as HarnessSessionListener, f as HarnessSessionEventListener, W as WaitForEventOptions, j as HarnessSessionStore, l as HarnessSessionStoreListener } from './approval-7e8HD-35.js';
 import { A as AgentDefinition } from './model-provider-DGkLQJWP.js';
+import { SandboxCloseInput } from './runner/sandbox.js';
 import { HarnessSessionSummary, SessionListQuery, SessionListResult } from './runner/storage.js';
 import './errors-DHHy8V3O.js';
 
@@ -51,7 +52,7 @@ declare class HarnessSessionImpl implements HarnessSession {
     on(listener: HarnessSessionListener): () => void;
     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>;
+    close(input?: SandboxCloseInput): Promise<void>;
     hydrate(): Promise<void>;
     private notify;
     private notifyStatus;
@@ -69,6 +70,7 @@ declare class HarnessSessionStoreImpl implements HarnessSessionStore {
     private readonly sessions;
     private readonly unsubscriptions;
     private readonly latestRunIds;
+    private readonly sessionSandboxes;
     private readonly listeners;
     private readonly storage;
     private closed;
@@ -90,6 +92,7 @@ declare class HarnessSessionStoreImpl implements HarnessSessionStore {
     getAgentManifest(sessionId: string): HarnessAgentManifest | undefined;
     on(listener: HarnessSessionStoreListener): () => void;
     private notify;
+    private closeTrackedSession;
 }
 declare function createHarnessSessionStore(config: HarnessAppConfig): Promise<HarnessSessionStore>;
 

package/dist/runner.d.ts

@@ -1,5 +1,5 @@
-export { c as createHarnessSession, b as createHarnessSessionStore } from './runner-CZHeMHKV.js';
-export { a as HarnessAgentManifest, b as HarnessAppConfig, d as HarnessRunStream, e as HarnessSession, f as HarnessSessionEventListener, g as HarnessSessionListener, h as HarnessSessionPhase, i as HarnessSessionStatus, j as HarnessSessionStore, k as HarnessSessionStoreEvent, l as HarnessSessionStoreListener, n as HarnessStreamEvent, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, W as WaitForEventOptions } from './approval-Ch0LwJFM.js';
+export { c as createHarnessSession, b as createHarnessSessionStore } from './runner-BYG9ARAV.js';
+export { a as HarnessAgentManifest, b as HarnessAppConfig, d as HarnessRunStream, e as HarnessSession, f as HarnessSessionEventListener, g as HarnessSessionListener, h as HarnessSessionPhase, i as HarnessSessionStatus, j as HarnessSessionStore, k as HarnessSessionStoreEvent, l as HarnessSessionStoreListener, n as HarnessStreamEvent, o as HarnessUserInput, S as SendOptions, p as SendResult, q as StreamOptions, W as WaitForEventOptions } from './approval-7e8HD-35.js';
 export { E as EventCursor, H as HarnessErrorCategory, a as HarnessErrorCode, b as HarnessErrorContext, c as HarnessErrorPolicy, d as HarnessErrorSeverity, e as HarnessErrorShape, m as HarnessRetryPolicy } from './errors-hpkW3tfR.js';
 export { a5 as HarnessSnapshot, a6 as HarnessSnapshotCreator, a7 as HarnessSnapshotInput, a8 as HarnessSnapshotSession, a9 as HarnessSnapshotSummary, ad as HarnessTranscriptSession, an as TranscriptBranch, ao as TranscriptCursor, ap as TranscriptQuery, aq as TranscriptSeekTarget } from './context-Bz9C_rL9.js';
 export { HarnessSessionSummary, SessionListQuery, SessionListResult } from './runner/storage.js';

package/dist/runner.js

@@ -2,13 +2,13 @@ import {
   HarnessSessionPhase,
   createHarnessSession,
   createHarnessSessionStore
-} from "./chunk-UKXJIKED.js";
+} from "./chunk-BLLQSHQI.js";
 import "./chunk-Q73WH5D7.js";
 import {
   normalizeHarnessError,
   sanitizeHarnessError
 } from "./chunk-2NQ3JL7K.js";
-import "./chunk-ZU6ADDET.js";
+import "./chunk-IWHCNKHK.js";
 import "./chunk-ONYDIU4X.js";
 import "./chunk-NCSQEUQC.js";
 import "./chunk-3QOAFCCZ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-kernel/core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Pure runtime contracts and session kernel for Harness Kernel.",
   "license": "Apache-2.0",