@vinhnt-sdk/core 0.1.0

package/dist/kernel/kernel.d.ts

@@ -0,0 +1,150 @@
+import type { RequestContext, RunId, AgentId, AgentConfig, AgentBehaviourMode } from "@vinhnt-sdk/schema";
+import type { MessageContentPart } from "../model.js";
+import type { RunEventStore } from "../session/store.js";
+import type { AgentRegistry } from "../agent/agent-registry.js";
+import type { ToolDefinition } from "../tool/definitions.js";
+import type { SubAgentParams } from "../agent/agent-factory.js";
+import type { DomainManifest } from "../tool/domain.js";
+import type { RunState } from "./run-state.js";
+import { PermissionGate } from "./permission-gate.js";
+import { ModelCaller } from "./model-caller.js";
+import { ToolSaga } from "./tool-saga.js";
+import { CircuitBreaker } from "./circuit-breaker.js";
+import { KernelError } from "./kernel-error.js";
+import type { KernelErrorCode } from "./kernel-error.js";
+import type { AgentKernelConfig, RunHandle } from "./kernel-types.js";
+export type { AgentKernelConfig, RunState, KernelErrorCode };
+export { CircuitBreaker, CircuitBreakerOpenError, type CircuitState, type CircuitBreakerOptions } from "./circuit-breaker.js";
+export { KernelError } from "./kernel-error.js";
+/**
+ * Core agent orchestration — run loop, permission gate, tool execution, sub-agent spawning.
+ * Composition root for all run-time services. Each call to `run()` creates a tracked
+ * run lifecycle with abort support and session integration.
+ */
+export declare class AgentKernel {
+    private readonly modelCaller;
+    private readonly permissionGate;
+    private readonly stateMachine;
+    private readonly store;
+    private readonly tools;
+    private readonly domainManifests;
+    private maxSteps;
+    private maxTokens;
+    private readonly maxToolCallsPerStep;
+    private readonly compactor;
+    private readonly systemContext;
+    private thinkingBudget;
+    private readonly selfCorrectOnFailure;
+    private readonly maxSelfCorrectAttempts;
+    private readonly maxSubAgentDepth;
+    private readonly sessionStore;
+    private readonly agentRegistry;
+    private readonly pluginManager;
+    private readonly eventBus;
+    private sessionState;
+    private readonly toolRegistry;
+    private readonly toolProviderRegistry;
+    private readonly sessionTitleGenerator;
+    private saga;
+    private readonly stepExecutor;
+    private currentAgent;
+    private currentDepth;
+    private agentChain;
+    private cachedTools;
+    private cachedToolsAgentId;
+    private stepTimeout;
+    private readonly doomLoopThreshold;
+    private compactionThreshold;
+    private readonly termination;
+    private readonly circuitBreaker;
+    private readonly sessionDeps;
+    private readonly subAgentDeps;
+    private readonly runSessionStates;
+    constructor(config: AgentKernelConfig);
+    /** Register a tool definition for the agent to call. Invalidates tool cache. */
+    registerTool(tool: ToolDefinition): void;
+    /** Register a named domain manifest (tool membership) for agent `domains` filtering. */
+    registerDomain(manifest: DomainManifest): void;
+    /** Resolve the domain a tool belongs to, or undefined if it is a core tool. */
+    private domainFor;
+    /** Resolve the manifest for a domain id, or undefined. */
+    private manifestFor;
+    private emitEvent;
+    private addSessionMessage;
+    private getAvailableTools;
+    private findTool;
+    /** Whether a tool is registered in the underlying pool (regardless of per-agent filtering). */
+    private hasTool;
+    /** Switch to a named agent from the registry. Syncs permissions. */
+    useAgent(agentId: AgentId): Promise<void>;
+    /** Directly set the active agent config (bypasses registry lookup). */
+    setCurrentAgent(agent: AgentConfig): void;
+    /** Create and register a new sub-agent from inline params. */
+    spawnAgent(params: SubAgentParams): Promise<AgentConfig>;
+    /** Current active agent config (if any). */
+    getCurrentAgent(): AgentConfig | undefined;
+    /** Switch the current agent's behaviour mode (build/plan/custom). Resets tool cache. */
+    setBehaviourMode(mode: AgentBehaviourMode): void;
+    /** Toggle auto-approval at runtime (all tools approved without prompting). */
+    setAutoApproval(enabled: boolean): void;
+    /** Get the current agent's behaviour mode (defaults to "build"). */
+    getBehaviourMode(): AgentBehaviourMode;
+    /** Underlying agent registry (for listing/searching agents). */
+    getAgentRegistry(): AgentRegistry | undefined;
+    /** Underlying run event store (for audit/event sourcing). */
+    getEventStore(): RunEventStore;
+    /** Delegate a prompt to a named sub-agent. Returns the agent's response text. */
+    runAgent(agentId: AgentId, prompt: string, ctx: RequestContext, sessionId?: string): Promise<string>;
+    /**
+     * Start a new agent run. Creates a run ID, wires abort + session, and returns
+     * a `RunHandle` (runId + completed promise + abort). The run loop executes
+     * asynchronously — the promise resolves when the run finishes (or fails).
+     */
+    run(prompt: string, ctx: RequestContext, sessionId?: string, userContentParts?: readonly MessageContentPart[], agentOverride?: AgentConfig): RunHandle;
+    private getRunSession;
+    /** Run multiple sub-agents concurrently. Returns combined output. */
+    runAgentsParallel(tasks: Array<{
+        agentId: AgentId;
+        prompt: string;
+    }>, ctx: RequestContext, sessionId?: string): Promise<string>;
+    /** Start a run with error-safe wrapper — returns `{ ok, value }` or `{ ok: false, error }`. */
+    runSafe(prompt: string, ctx: RequestContext, sessionId?: string, userContentParts?: readonly MessageContentPart[]): {
+        ok: true;
+        value: {
+            completed: Promise<void>;
+            runId: RunId;
+            abort(): void;
+        };
+        error?: undefined;
+    } | {
+        ok: false;
+        error: KernelError;
+        value?: undefined;
+    };
+    /** Get the tool saga for inspecting completed tool calls and triggering rollbacks. */
+    getSaga(): ToolSaga;
+    /** Get the circuit breaker for inspecting trip state and threshold. */
+    getCircuitBreaker(): CircuitBreaker;
+    /** Get the model caller for testing prompts against providers. */
+    getModelCaller(): ModelCaller;
+    /**
+     * Hot-reload runtime-tunable settings without rebuilding the kernel.
+     * Updates the default model, generation limits, permission rules and
+     * risk overrides. New runs pick up the values immediately.
+     */
+    reconfigure(partial: Partial<Pick<AgentKernelConfig, "model" | "maxTokens" | "maxSteps" | "stepTimeout" | "thinkingBudget" | "thinkingPrompt" | "compactionThreshold" | "globalPermissionRules" | "permissionRiskDefaults" | "topLevelPermissionRules">>): void;
+    /** Get the permission gate for evaluating permission rules. */
+    getPermissionGate(): PermissionGate;
+    /** Current state of a run (pending/running/completed/failed/cancelled). */
+    getRunState(runId: RunId): RunState | undefined;
+    /** Subscribe to run state transitions. Returns unsubscribe function. */
+    onRunStateChange(listener: (runId: RunId, state: RunState) => void): () => void;
+    /** Send a user input string to a waiting run (e.g., approval response). */
+    sendInput(runId: RunId, text: string): void;
+    /** Abort all currently running sessions. */
+    cancelCurrentRun(): void;
+    private runLoop;
+    private updateSessionOnComplete;
+    private emitFail;
+}
+//# sourceMappingURL=kernel.d.ts.map

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

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