@lumenflow/kernel 3.0.0

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sCAAsC;AAEtC,cAAc,qBAAqB,CAAC"}

package/dist/runtime/kernel-runtime.d.ts

@@ -0,0 +1,170 @@
+import { KERNEL_EVENT_KINDS } from '../event-kinds.js';
+import { EventStore } from '../event-store/index.js';
+import { EvidenceStore } from '../evidence/evidence-store.js';
+import { type ExecutionContext, type KernelEvent, type PolicyDecision, type Run, type TaskSpec, type TaskState, type ToolCapability, type ToolOutput, type ToolTraceEntry, type WorkspaceSpec } from '../kernel.schemas.js';
+import { type LoadedDomainPack } from '../pack/index.js';
+import { PolicyEngine, type PolicyEvaluationResult, type PolicyLayer } from '../policy/index.js';
+import { type SandboxSubprocessDispatcherOptions } from '../sandbox/index.js';
+import { type TaskStateAliases } from '../state-machine/index.js';
+import { ToolHost } from '../tool-host/tool-host.js';
+import type { SubprocessDispatcher } from '../tool-host/subprocess-dispatcher.js';
+type TaskCreatedEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.TASK_CREATED;
+}>;
+type TaskClaimedEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.TASK_CLAIMED;
+}>;
+type TaskBlockedEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.TASK_BLOCKED;
+}>;
+type TaskUnblockedEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.TASK_UNBLOCKED;
+}>;
+type RunStartedEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.RUN_STARTED;
+}>;
+type RunSucceededEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.RUN_SUCCEEDED;
+}>;
+type TaskCompletedEvent = Extract<KernelEvent, {
+    kind: typeof KERNEL_EVENT_KINDS.TASK_COMPLETED;
+}>;
+export interface RuntimeToolCapabilityResolverInput {
+    workspaceSpec: WorkspaceSpec;
+    loadedPack: LoadedDomainPack;
+    tool: LoadedDomainPack['manifest']['tools'][number];
+}
+export type RuntimeToolCapabilityResolver = (input: RuntimeToolCapabilityResolverInput) => Promise<ToolCapability | null>;
+export interface InitializeKernelRuntimeOptions {
+    workspaceRoot: string;
+    workspaceFilePath?: string;
+    workspaceFileName?: string;
+    packsRoot?: string;
+    taskSpecRoot?: string;
+    eventsFilePath?: string;
+    eventLockFilePath?: string;
+    evidenceRoot?: string;
+    runtimeVersion?: string;
+    policyLayers?: PolicyLayer[];
+    toolCapabilityResolver?: RuntimeToolCapabilityResolver;
+    subprocessDispatcher?: SubprocessDispatcher;
+    sandboxSubprocessDispatcherOptions?: Omit<SandboxSubprocessDispatcherOptions, 'workspaceRoot'>;
+    includeBuiltinTools?: boolean;
+    now?: () => Date;
+    runIdFactory?: (taskId: string, nextRunNumber: number) => string;
+}
+export interface KernelRuntime {
+    createTask(taskSpec: TaskSpec): Promise<CreateTaskResult>;
+    claimTask(input: ClaimTaskInput): Promise<ClaimTaskResult>;
+    blockTask(input: BlockTaskInput): Promise<BlockTaskResult>;
+    unblockTask(input: UnblockTaskInput): Promise<UnblockTaskResult>;
+    completeTask(input: CompleteTaskInput): Promise<CompleteTaskResult>;
+    inspectTask(taskId: string): Promise<TaskInspection>;
+    executeTool(name: string, input: unknown, ctx: ExecutionContext): Promise<ToolOutput>;
+    getToolHost(): ToolHost;
+    getPolicyEngine(): PolicyEngine;
+}
+export interface KernelRuntimeOptions {
+    workspace_spec: WorkspaceSpec;
+    workspace_file_path: string;
+    workspace_config_hash: string;
+    loaded_packs: LoadedDomainPack[];
+    task_spec_root: string;
+    event_store: EventStore;
+    evidence_store: EvidenceStore;
+    tool_host: ToolHost;
+    policy_engine: PolicyEngine;
+    state_aliases?: TaskStateAliases;
+    now?: () => Date;
+    run_id_factory?: (taskId: string, nextRunNumber: number) => string;
+}
+export interface CreateTaskResult {
+    task: TaskSpec;
+    task_spec_path: string;
+    event: TaskCreatedEvent;
+}
+export interface ClaimTaskInput {
+    task_id: string;
+    by: string;
+    session_id: string;
+    timestamp?: string;
+    domain_data?: Record<string, unknown>;
+}
+export interface ClaimTaskResult {
+    task_id: string;
+    run: Run;
+    events: [TaskClaimedEvent, RunStartedEvent];
+    policy: PolicyEvaluationResult;
+}
+export interface CompleteTaskInput {
+    task_id: string;
+    run_id?: string;
+    timestamp?: string;
+    evidence_refs?: string[];
+}
+export interface BlockTaskInput {
+    task_id: string;
+    reason: string;
+    timestamp?: string;
+}
+export interface BlockTaskResult {
+    task_id: string;
+    event: TaskBlockedEvent;
+}
+export interface UnblockTaskInput {
+    task_id: string;
+    timestamp?: string;
+}
+export interface UnblockTaskResult {
+    task_id: string;
+    event: TaskUnblockedEvent;
+}
+export interface CompleteTaskResult {
+    task_id: string;
+    run_id: string;
+    events: [RunSucceededEvent, TaskCompletedEvent];
+    policy: PolicyEvaluationResult;
+}
+export interface TaskInspection {
+    task_id: string;
+    task: TaskSpec;
+    state: TaskState;
+    run_history: Run[];
+    receipts: ToolTraceEntry[];
+    policy_decisions: PolicyDecision[];
+    events: KernelEvent[];
+}
+export declare function defaultRunIdFactory(taskId: string, nextRunNumber: number): string;
+export declare function defaultRuntimeToolCapabilityResolver(input: RuntimeToolCapabilityResolverInput): Promise<ToolCapability | null>;
+export declare class DefaultKernelRuntime implements KernelRuntime {
+    private readonly workspaceSpec;
+    private readonly workspaceFilePath;
+    private readonly workspaceConfigHash;
+    private readonly loadedPacks;
+    private readonly taskSpecRoot;
+    private readonly eventStore;
+    private readonly evidenceStore;
+    private readonly toolHost;
+    private readonly policyEngine;
+    private readonly stateAliases;
+    private readonly now;
+    private readonly runIdFactory;
+    constructor(options: KernelRuntimeOptions);
+    getToolHost(): ToolHost;
+    getPolicyEngine(): PolicyEngine;
+    executeTool(name: string, input: unknown, ctx: ExecutionContext): Promise<ToolOutput>;
+    createTask(taskSpec: TaskSpec): Promise<CreateTaskResult>;
+    claimTask(input: ClaimTaskInput): Promise<ClaimTaskResult>;
+    blockTask(input: BlockTaskInput): Promise<BlockTaskResult>;
+    unblockTask(input: UnblockTaskInput): Promise<UnblockTaskResult>;
+    completeTask(input: CompleteTaskInput): Promise<CompleteTaskResult>;
+    inspectTask(taskId: string): Promise<TaskInspection>;
+    private requireTaskSpec;
+    private projectTaskState;
+    private evaluateCompletionPolicy;
+    private computeWorkspaceConfigHash;
+    private readReceiptsForTask;
+}
+export declare function initializeKernelRuntime(options: InitializeKernelRuntimeOptions): Promise<DefaultKernelRuntime>;
+export {};
+//# sourceMappingURL=kernel-runtime.d.ts.map

package/dist/runtime/kernel-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/kernel-runtime.ts"],"names":[],"mappings":"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"}