aec-agent 1.0.0

package/dist/index.js

@@ -0,0 +1,73 @@
+// Runtime
+export { createAgent } from "./create-agent.js";
+export { AgentCore } from "./agent-core.js";
+export { registerProvider, listProviders, } from "./components/llm-provider-hub/providers/registry.js";
+export { AnthropicLLMModelProvider, } from "./components/llm-provider-hub/providers/anthropic-provider.js";
+export { OpenAICompatibleLLMModelProvider, } from "./components/llm-provider-hub/providers/openai-compatible-provider.js";
+export { PersistenceHub } from "./components/persistence-hub/persistence-hub.js";
+export { TraceService } from "./components/trace-service/trace-service.js";
+export { ConsoleTraceSink } from "./components/trace-service/console-trace-sink.js";
+// Built-in tools
+export { WebSearchTool } from "./components/tool-hub/built-in-tools/web/web-search-tool.js";
+export { WebExtractTool } from "./components/tool-hub/built-in-tools/web/web-extract-tool.js";
+export { DuckDuckGoSearchProvider } from "./components/tool-hub/built-in-tools/web/duckduckgo-search-provider.js";
+export { ClarifyTool } from "./components/tool-hub/built-in-tools/interaction/clarify-tool.js";
+export { DefaultToolPolicy } from "./components/tool-hub/policies/default-tool-policy.js";
+// Workspace tools (A-61) — file + terminal tools on the agent's SandboxView
+export { createWorkspaceTools, WORKSPACE_TOOL_NAMES } from "./components/tool-hub/built-in-tools/workspace/create-workspace-tools.js";
+export { ReadFileTool } from "./components/tool-hub/built-in-tools/workspace/read-file-tool.js";
+export { WriteFileTool } from "./components/tool-hub/built-in-tools/workspace/write-file-tool.js";
+export { EditFileTool } from "./components/tool-hub/built-in-tools/workspace/edit-file-tool.js";
+export { ListFilesTool } from "./components/tool-hub/built-in-tools/workspace/list-files-tool.js";
+export { SearchFilesTool } from "./components/tool-hub/built-in-tools/workspace/search-files-tool.js";
+export { TerminalTool } from "./components/tool-hub/built-in-tools/workspace/terminal-tool.js";
+export { RunCodeTool } from "./components/tool-hub/built-in-tools/workspace/run-code-tool.js";
+// Skill tools (A-66) — skill_manage is registered by the app; skill_view is added per agent automatically
+export { SkillManageTool } from "./components/tool-hub/built-in-tools/skills/skill-manage-tool.js";
+export { SkillViewTool } from "./components/tool-hub/built-in-tools/skills/skill-view-tool.js";
+export { SKILL_WORKSPACE_DIR } from "./components/tool-hub/built-in-tools/skills/skill-workspace.js";
+// Skills (A-66) — SKILL.md packages (Agent Skills format) and the essential built-in skills
+export { SkillHub } from "./components/skill-hub/skill-hub.js";
+export { ESSENTIAL_SKILLS, ESSENTIAL_SKILL_NAMES } from "./components/skill-hub/built-in-skills/essential-skills.js";
+export { parseSkillPackage, normalizeSkillPath, SKILL_LIMITS, SKILL_NAME_PATTERN } from "./components/skill-hub/skill-format.js";
+// Artifact tools (A-62) — lasting, versioned outputs on the agent's ArtifactView
+export { createArtifactTools, ARTIFACT_TOOL_NAMES } from "./components/tool-hub/built-in-tools/artifacts/create-artifact-tools.js";
+export { SaveArtifactTool } from "./components/tool-hub/built-in-tools/artifacts/save-artifact-tool.js";
+export { UpdateArtifactTool } from "./components/tool-hub/built-in-tools/artifacts/update-artifact-tool.js";
+export { ReadArtifactTool } from "./components/tool-hub/built-in-tools/artifacts/read-artifact-tool.js";
+export { ListArtifactsTool } from "./components/tool-hub/built-in-tools/artifacts/list-artifacts-tool.js";
+// Artifacts (A-62) — a metadata tracker over sandbox files
+export { ArtifactHub } from "./components/artifact-hub/artifact-hub.js";
+export { MemoryArtifactStore } from "./components/persistence-hub/default-stores/memory-artifact-store.js";
+// Sandboxes (A-47)
+export { SandboxHub } from "./components/sandbox-hub/sandbox-hub.js";
+export { defaultSandboxApprovalPolicy } from "./components/sandbox-hub/approval-policy.js";
+export { WORKSPACE_ROOT, 
+// SHARED_DIR,
+AGENTS_DIR, agentLayout, isWithinRoots, resolveLogicalPath, } from "./components/sandbox-hub/logical-path.js";
+// Docker sandboxes (A-60)
+export { DockerSandboxProvider, DOCKER_DEFAULT_LIMITS } from "./components/sandbox-hub/docker/docker-sandbox-provider.js";
+export { AEC_SANDBOX_IMAGE, AEC_SANDBOX_DOCKERFILE } from "./components/sandbox-hub/docker/aec-sandbox-image.js";
+// Host sandboxes — real folders on the server machine (not isolated)
+export { HostSandboxProvider, HOST_DEFAULT_LIMITS } from "./components/sandbox-hub/host/host-sandbox-provider.js";
+// LLM providers
+export { LLMProviderHub } from "./components/llm-provider-hub/llm-provider-hub.js";
+export { BedrockLLMModelProvider, } from "./components/llm-provider-hub/providers/bedrock-provider.js";
+export { OpenAISubscriptionProvider, } from "./components/llm-provider-hub/providers/openai-subscription-provider.js";
+export { resolveProvider } from "./components/llm-provider-hub/providers/registry.js";
+export { toLLMModelRecord } from "./components/llm-provider-hub/types.js";
+export { SDKEventType } from "./components/event-handler/events.js";
+export { SDKError } from "./kernel/errors/sdk-error.js";
+export { ModelError } from "./kernel/errors/model-error.js";
+export { ToolError } from "./kernel/errors/tool-error.js";
+export { PolicyError } from "./kernel/errors/policy-error.js";
+export { SessionError } from "./kernel/errors/session-error.js";
+export { SkillError } from "./kernel/errors/skill-error.js";
+export { SandboxError } from "./kernel/errors/sandbox-error.js";
+export { ArtifactError } from "./kernel/errors/artifact-error.js";
+// Test doubles — mock provider, stores, tools
+export { MockLLMModelProvider } from "./testing/mock-llm-model-provider.js";
+export { InMemorySessionStore } from "./testing/mock-session-store.js";
+export { ScheduleLookupTool, BudgetQueryTool, DocumentSearchTool, SendRfiTool } from "./testing/mock-tools.js";
+export { InMemorySandboxProvider } from "./testing/in-memory-sandbox.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/kernel/errors/artifact-error.d.ts

@@ -0,0 +1,23 @@
+import { SDKError } from "./sdk-error.js";
+export type ArtifactErrorCode = 
+/** No artifact with that id/name for this agent. */
+"not_found"
+/** save_artifact used a name this agent already owns — update_artifact is the way to change it. */
+ | "name_conflict"
+/** Malformed name, type or reference. */
+ | "invalid_argument"
+/** expectedVersion did not match the current head — someone else wrote in between. */
+ | "conflict"
+/** The tracked (or to-be-tracked) file is not in the agent's sandbox. */
+ | "file_missing"
+/** No ArtifactStore is wired into the PersistenceHub. */
+ | "not_configured";
+export declare class ArtifactError extends SDKError {
+    readonly code: ArtifactErrorCode;
+    /** Artifact the failure is about, when one was resolved. */
+    readonly artifactId?: string | undefined;
+    constructor(message: string, code: ArtifactErrorCode, 
+    /** Artifact the failure is about, when one was resolved. */
+    artifactId?: string | undefined);
+}
+//# sourceMappingURL=artifact-error.d.ts.map

package/dist/kernel/errors/artifact-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/artifact-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,iBAAiB;AAC3B,oDAAoD;AAClD,WAAW;AACb,mGAAmG;GACjG,eAAe;AACjB,yCAAyC;GACvC,kBAAkB;AACpB,sFAAsF;GACpF,UAAU;AACZ,yEAAyE;GACvE,cAAc;AAChB,yDAAyD;GACvD,gBAAgB,CAAC;AAWrB,qBAAa,aAAc,SAAQ,QAAQ;aAGvB,IAAI,EAAE,iBAAiB;IACvC,4DAA4D;aAC5C,UAAU,CAAC,EAAE,MAAM;IAJrC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB;IACvC,4DAA4D;IAC5C,UAAU,CAAC,EAAE,MAAM,YAAA,EAIpC;CACF"}

package/dist/kernel/errors/artifact-error.js

@@ -0,0 +1,22 @@
+import { SDKError } from "./sdk-error.js";
+/**
+ * Codes where retrying the same call cannot succeed — tools map these to `retryable: false`.
+ * Every artifact failure is deterministic today; the set is explicit so a future
+ * transient code (e.g. a store timeout) is retryable by default.
+ */
+const NON_RETRYABLE = new Set([
+    "not_found", "name_conflict", "invalid_argument", "conflict", "file_missing", "not_configured",
+]);
+export class ArtifactError extends SDKError {
+    code;
+    artifactId;
+    constructor(message, code, 
+    /** Artifact the failure is about, when one was resolved. */
+    artifactId) {
+        super(message, !NON_RETRYABLE.has(code));
+        this.code = code;
+        this.artifactId = artifactId;
+        this.name = "ArtifactError";
+    }
+}
+//# sourceMappingURL=artifact-error.js.map

package/dist/kernel/errors/artifact-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/artifact-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgB1C;;;;GAIG;AACH,MAAM,aAAa,GAAmC,IAAI,GAAG,CAAC;IAC5D,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB;CAC/F,CAAC,CAAC;AAEH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAGvB,IAAI;IAEJ,UAAU;IAJ5B,YACE,OAAe,EACC,IAAuB;IACvC,4DAA4D;IAC5C,UAAmB;QAEnC,KAAK,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;oBAJzB,IAAI;0BAEJ,UAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/kernel/errors/model-error.d.ts

@@ -0,0 +1,7 @@
+import { SDKError } from "./sdk-error.js";
+export type ModelErrorCode = "auth" | "rate_limit" | "timeout" | "invalid_request" | "provider";
+export declare class ModelError extends SDKError {
+    readonly code: ModelErrorCode;
+    constructor(message: string, code: ModelErrorCode, retryable: boolean);
+}
+//# sourceMappingURL=model-error.d.ts.map

package/dist/kernel/errors/model-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/model-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,YAAY,GACZ,SAAS,GACT,iBAAiB,GACjB,UAAU,CAAC;AAEf,qBAAa,UAAW,SAAQ,QAAQ;aAGpB,IAAI,EAAE,cAAc;IAFtC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,cAAc,EACpC,SAAS,EAAE,OAAO,EAInB;CACF"}

package/dist/kernel/errors/model-error.js

@@ -0,0 +1,10 @@
+import { SDKError } from "./sdk-error.js";
+export class ModelError extends SDKError {
+    code;
+    constructor(message, code, retryable) {
+        super(message, retryable);
+        this.code = code;
+        this.name = "ModelError";
+    }
+}
+//# sourceMappingURL=model-error.js.map

package/dist/kernel/errors/model-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/model-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS1C,MAAM,OAAO,UAAW,SAAQ,QAAQ;IAGpB,IAAI;IAFtB,YACE,OAAe,EACC,IAAoB,EACpC,SAAkB;QAElB,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBAHV,IAAI;QAIpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/kernel/errors/policy-error.d.ts

@@ -0,0 +1,8 @@
+import { SDKError } from "./sdk-error.js";
+export type PolicyErrorCode = "not_in_allowlist" | "invalid_args" | "authorization_denied";
+export declare class PolicyError extends SDKError {
+    readonly code: PolicyErrorCode;
+    readonly toolName: string;
+    constructor(message: string, code: PolicyErrorCode, toolName: string);
+}
+//# sourceMappingURL=policy-error.d.ts.map

package/dist/kernel/errors/policy-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/policy-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,CAAC;AAE3B,qBAAa,WAAY,SAAQ,QAAQ;aAGrB,IAAI,EAAE,eAAe;aACrB,QAAQ,EAAE,MAAM;IAHlC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,EAIjC;CACF"}

package/dist/kernel/errors/policy-error.js

@@ -0,0 +1,12 @@
+import { SDKError } from "./sdk-error.js";
+export class PolicyError extends SDKError {
+    code;
+    toolName;
+    constructor(message, code, toolName) {
+        super(message, false);
+        this.code = code;
+        this.toolName = toolName;
+        this.name = "PolicyError";
+    }
+}
+//# sourceMappingURL=policy-error.js.map

package/dist/kernel/errors/policy-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/policy-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO1C,MAAM,OAAO,WAAY,SAAQ,QAAQ;IAGrB,IAAI;IACJ,QAAQ;IAH1B,YACE,OAAe,EACC,IAAqB,EACrB,QAAgB;QAEhC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;oBAHN,IAAI;wBACJ,QAAQ;QAGxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/kernel/errors/sandbox-error.d.ts

@@ -0,0 +1,35 @@
+import { SDKError } from "./sdk-error.js";
+export type SandboxErrorCode = 
+/** The agent uses the shared sandbox but none is configured on the SandboxHub. */
+"not_configured"
+/** The agent's profile selects `sandbox: "none"`. */
+ | "disabled"
+/** No SandboxProvider is registered for the sandbox kind. */
+ | "provider_unavailable"
+/** The sandbox does not offer the requested operation (e.g. exec, shell). */
+ | "capability_unsupported"
+/** A path resolves outside the roots the agent may use (traversal, absolute, symlink). */
+ | "path_escape" | "not_found"
+/** Input or content above the sandbox's limits. */
+ | "too_large"
+/** writeFile's expectedSha256 did not match the current file. */
+ | "conflict" | "timeout" | "cancelled"
+/** Selection or configuration rejected by the hub policy (image, network, named env). */
+ | "policy_denied"
+/** The sandbox exists but cannot serve requests (container down, runner offline). */
+ | "environment_unavailable"
+/** The path is malformed or the wrong type (e.g. reading a directory). */
+ | "invalid_path"
+/** Any other malformed request (bad regex, non-positive timeout, empty command). */
+ | "invalid_argument";
+export declare class SandboxError extends SDKError {
+    readonly code: SandboxErrorCode;
+    /** Sandbox the failure came from, when one was resolved. */
+    readonly sandboxId?: string | undefined;
+    constructor(message: string, code: SandboxErrorCode, 
+    /** Sandbox the failure came from, when one was resolved. */
+    sandboxId?: string | undefined);
+}
+/** Wrap an unknown failure from a sandbox as a retryable "environment_unavailable" SandboxError. */
+export declare function asSandboxError(error: unknown, sandboxId: string): SandboxError;
+//# sourceMappingURL=sandbox-error.d.ts.map

package/dist/kernel/errors/sandbox-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/sandbox-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,gBAAgB;AAC1B,kFAAkF;AAChF,gBAAgB;AAClB,qDAAqD;GACnD,UAAU;AACZ,6DAA6D;GAC3D,sBAAsB;AACxB,6EAA6E;GAC3E,wBAAwB;AAC1B,0FAA0F;GACxF,aAAa,GACb,WAAW;AACb,mDAAmD;GACjD,WAAW;AACb,iEAAiE;GAC/D,UAAU,GACV,SAAS,GACT,WAAW;AACb,yFAAyF;GACvF,eAAe;AACjB,qFAAqF;GACnF,yBAAyB;AAC3B,0EAA0E;GACxE,cAAc;AAChB,oFAAoF;GAClF,kBAAkB,CAAC;AAQvB,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,IAAI,EAAE,gBAAgB;IACtC,4DAA4D;aAC5C,SAAS,CAAC,EAAE,MAAM;IAJpC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB;IACtC,4DAA4D;IAC5C,SAAS,CAAC,EAAE,MAAM,YAAA,EAInC;CACF;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAI9E"}

package/dist/kernel/errors/sandbox-error.js

@@ -0,0 +1,26 @@
+import { SDKError } from "./sdk-error.js";
+/** Codes where retrying the same call cannot succeed — tools map these to `retryable: false`. */
+const NON_RETRYABLE = new Set([
+    "not_configured", "disabled", "provider_unavailable", "capability_unsupported", "path_escape",
+    "not_found", "too_large", "conflict", "policy_denied", "invalid_path", "invalid_argument",
+]);
+export class SandboxError extends SDKError {
+    code;
+    sandboxId;
+    constructor(message, code, 
+    /** Sandbox the failure came from, when one was resolved. */
+    sandboxId) {
+        super(message, !NON_RETRYABLE.has(code));
+        this.code = code;
+        this.sandboxId = sandboxId;
+        this.name = "SandboxError";
+    }
+}
+/** Wrap an unknown failure from a sandbox as a retryable "environment_unavailable" SandboxError. */
+export function asSandboxError(error, sandboxId) {
+    if (error instanceof SandboxError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    return new SandboxError(`Sandbox "${sandboxId}" is unavailable: ${message}`, "environment_unavailable", sandboxId);
+}
+//# sourceMappingURL=sandbox-error.js.map

package/dist/kernel/errors/sandbox-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/sandbox-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA6B1C,iGAAiG;AACjG,MAAM,aAAa,GAAkC,IAAI,GAAG,CAAC;IAC3D,gBAAgB,EAAE,UAAU,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,aAAa;IAC7F,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB;CAC1F,CAAC,CAAC;AAEH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAGtB,IAAI;IAEJ,SAAS;IAJ3B,YACE,OAAe,EACC,IAAsB;IACtC,4DAA4D;IAC5C,SAAkB;QAElC,KAAK,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;oBAJzB,IAAI;yBAEJ,SAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,SAAiB;IAC9D,IAAI,KAAK,YAAY,YAAY;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,IAAI,YAAY,CAAC,YAAY,SAAS,qBAAqB,OAAO,EAAE,EAAE,yBAAyB,EAAE,SAAS,CAAC,CAAC;AACrH,CAAC"}

package/dist/kernel/errors/sdk-error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Base error class for all SDK errors.
+ * Every SDK error extends this so consumers can catch broadly or narrowly.
+ */
+export declare class SDKError extends Error {
+    readonly retryable: boolean;
+    constructor(message: string, retryable?: boolean);
+}
+//# sourceMappingURL=sdk-error.d.ts.map

package/dist/kernel/errors/sdk-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/sdk-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,SAAS,EAAE,OAAO;IAFpC,YACE,OAAO,EAAE,MAAM,EACC,SAAS,GAAE,OAAe,EAI3C;CACF"}

package/dist/kernel/errors/sdk-error.js

@@ -0,0 +1,13 @@
+/**
+ * Base error class for all SDK errors.
+ * Every SDK error extends this so consumers can catch broadly or narrowly.
+ */
+export class SDKError extends Error {
+    retryable;
+    constructor(message, retryable = false) {
+        super(message);
+        this.retryable = retryable;
+        this.name = "SDKError";
+    }
+}
+//# sourceMappingURL=sdk-error.js.map

package/dist/kernel/errors/sdk-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/sdk-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf,SAAS;IAF3B,YACE,OAAe,EACC,SAAS,GAAY,KAAK;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;yBAFC,SAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/kernel/errors/session-error.d.ts

@@ -0,0 +1,7 @@
+import { SDKError } from "./sdk-error.js";
+export type SessionErrorCode = "not_found" | "already_exists" | "store_unavailable" | "corrupted";
+export declare class SessionError extends SDKError {
+    readonly code: SessionErrorCode;
+    constructor(message: string, code: SessionErrorCode, retryable?: boolean);
+}
+//# sourceMappingURL=session-error.d.ts.map

package/dist/kernel/errors/session-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/session-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,WAAW,CAAC;AAEhB,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,IAAI,EAAE,gBAAgB;IAFxC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB,EACtC,SAAS,GAAE,OAAe,EAI3B;CACF"}

package/dist/kernel/errors/session-error.js

@@ -0,0 +1,10 @@
+import { SDKError } from "./sdk-error.js";
+export class SessionError extends SDKError {
+    code;
+    constructor(message, code, retryable = false) {
+        super(message, retryable);
+        this.code = code;
+        this.name = "SessionError";
+    }
+}
+//# sourceMappingURL=session-error.js.map

package/dist/kernel/errors/session-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/session-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ1C,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAGtB,IAAI;IAFtB,YACE,OAAe,EACC,IAAsB,EACtC,SAAS,GAAY,KAAK;QAE1B,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBAHV,IAAI;QAIpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/kernel/errors/skill-error.d.ts

@@ -0,0 +1,14 @@
+import { SDKError } from "./sdk-error.js";
+export type SkillErrorCode = "not_found" | "not_allowed"
+/** SKILL.md or a file breaks the format rules; the message lists every problem. */
+ | "invalid"
+/** A skill with this name is already in the library. */
+ | "already_exists"
+/** Built-in and app skills cannot be changed at runtime. */
+ | "read_only";
+export declare class SkillError extends SDKError {
+    readonly code: SkillErrorCode;
+    readonly skillName: string;
+    constructor(message: string, code: SkillErrorCode, skillName: string, retryable?: boolean);
+}
+//# sourceMappingURL=skill-error.d.ts.map

package/dist/kernel/errors/skill-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/skill-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,aAAa;AACf,mFAAmF;GACjF,SAAS;AACX,wDAAwD;GACtD,gBAAgB;AAClB,4DAA4D;GAC1D,WAAW,CAAC;AAEhB,qBAAa,UAAW,SAAQ,QAAQ;aAGpB,IAAI,EAAE,cAAc;aACpB,SAAS,EAAE,MAAM;IAHnC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjC,SAAS,GAAE,OAAe,EAI3B;CACF"}

package/dist/kernel/errors/skill-error.js

@@ -0,0 +1,12 @@
+import { SDKError } from "./sdk-error.js";
+export class SkillError extends SDKError {
+    code;
+    skillName;
+    constructor(message, code, skillName, retryable = false) {
+        super(message, retryable);
+        this.code = code;
+        this.skillName = skillName;
+        this.name = "SkillError";
+    }
+}
+//# sourceMappingURL=skill-error.js.map

package/dist/kernel/errors/skill-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/skill-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAY1C,MAAM,OAAO,UAAW,SAAQ,QAAQ;IAGpB,IAAI;IACJ,SAAS;IAH3B,YACE,OAAe,EACC,IAAoB,EACpB,SAAiB,EACjC,SAAS,GAAY,KAAK;QAE1B,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBAJV,IAAI;yBACJ,SAAS;QAIzB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/kernel/errors/tool-error.d.ts

@@ -0,0 +1,8 @@
+import { SDKError } from "./sdk-error.js";
+export type ToolErrorCode = "not_found" | "not_allowed" | "invalid_args" | "execution_failed" | "timeout";
+export declare class ToolError extends SDKError {
+    readonly code: ToolErrorCode;
+    readonly toolName: string;
+    constructor(message: string, code: ToolErrorCode, toolName: string, retryable?: boolean);
+}
+//# sourceMappingURL=tool-error.d.ts.map

package/dist/kernel/errors/tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.ts","sourceRoot":"","sources":["../../../src/kernel/errors/tool-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,SAAS,CAAC;AAEd,qBAAa,SAAU,SAAQ,QAAQ;aAGnB,IAAI,EAAE,aAAa;aACnB,QAAQ,EAAE,MAAM;IAHlC,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,MAAM,EAChC,SAAS,GAAE,OAAe,EAI3B;CACF"}

package/dist/kernel/errors/tool-error.js

@@ -0,0 +1,12 @@
+import { SDKError } from "./sdk-error.js";
+export class ToolError extends SDKError {
+    code;
+    toolName;
+    constructor(message, code, toolName, retryable = false) {
+        super(message, retryable);
+        this.code = code;
+        this.toolName = toolName;
+        this.name = "ToolError";
+    }
+}
+//# sourceMappingURL=tool-error.js.map

package/dist/kernel/errors/tool-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.js","sourceRoot":"","sources":["../../../src/kernel/errors/tool-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS1C,MAAM,OAAO,SAAU,SAAQ,QAAQ;IAGnB,IAAI;IACJ,QAAQ;IAH1B,YACE,OAAe,EACC,IAAmB,EACnB,QAAgB,EAChC,SAAS,GAAY,KAAK;QAE1B,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBAJV,IAAI;wBACJ,QAAQ;QAIxB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/kernel/interfaces/kernel.d.ts

@@ -0,0 +1,23 @@
+import type { LLMModelProvider } from "../../components/llm-provider-hub/types.js";
+import type { ToolHandler } from "../../components/tool-hub/types.js";
+import type { Skill, SkillPackage } from "../../components/skill-hub/types/skill.js";
+import type { SandboxProvider } from "../../components/sandbox-hub/types/provider.js";
+import type { AgentProfile } from "../../components/multi-agent-orchestration/agent/types.js";
+import type { PersistenceHub } from "../../components/persistence-hub/persistence-hub.js";
+export interface Kernel {
+    usePersistence(hub: PersistenceHub): void;
+    useLLMProvider(adapter: LLMModelProvider): void;
+    useTool(tool: ToolHandler): void;
+    useSkill(skill: SkillPackage): void;
+    useSandboxProvider(provider: SandboxProvider): void;
+    getLLMModelProvider(name?: string): LLMModelProvider;
+    getLLMModelProviders(): LLMModelProvider[];
+    getTool(name: string): ToolHandler | undefined;
+    getTools(): ToolHandler[];
+    getSkill(name: string): Promise<Skill | undefined>;
+    getSkills(): Promise<Skill[]>;
+    spawnAgent(profile: AgentProfile): unknown;
+    initialize(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=kernel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../../src/kernel/interfaces/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AAM1F,MAAM,WAAW,MAAM;IAErB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAEpD,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACrD,oBAAoB,IAAI,gBAAgB,EAAE,CAAC;IAC3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC/C,QAAQ,IAAI,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACnD,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE9B,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAC3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/kernel/interfaces/kernel.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kernel.js.map

package/dist/kernel/interfaces/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../../../src/kernel/interfaces/kernel.ts"],"names":[],"mappings":""}

package/dist/kernel/interfaces/plugin.d.ts

@@ -0,0 +1,7 @@
+export interface Plugin {
+    readonly name: string;
+    readonly version: string;
+    initialize?(): Promise<void>;
+    dispose?(): Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/kernel/interfaces/plugin.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/kernel/interfaces/plugin.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Plugin lifecycle — every plugin implements this
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/kernel/interfaces/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/kernel/interfaces/plugin.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E"}

package/dist/kernel/types.d.ts

@@ -0,0 +1,103 @@
+export interface Event<T = unknown> {
+    id: string;
+    type: string;
+    timestamp: number;
+    sessionId: string;
+    payload: T;
+}
+export interface Message {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    timestamp?: string;
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface StreamChunk {
+    type: "text" | "tool_call_start" | "tool_call_delta" | "tool_call" | "tool_result" | "done" | "error";
+    content?: string;
+    toolCall?: ToolCall;
+    /** Present on "tool_call_start" / "tool_call_delta" chunks — a tool call the model is still writing. */
+    toolCallProgress?: ToolCallProgress;
+    toolResult?: ToolResult;
+    error?: string;
+    usage?: TokenUsage;
+    /** Set on the final "done" chunk when the run was stopped through RunOptions.signal (A-65). */
+    aborted?: boolean;
+}
+/**
+ * A tool call the model is still generating, streamed so consumers can show
+ * progress while long arguments (e.g. a file body) are being written.
+ *
+ * "tool_call_start" carries the id and name as soon as the provider knows
+ * them; each "tool_call_delta" carries the next slice of the raw JSON
+ * arguments text. Slices are not valid JSON on their own. The complete,
+ * parsed arguments always follow in a "tool_call" chunk with the same id —
+ * that chunk is the only one the agent loop executes.
+ */
+export interface ToolCallProgress {
+    id: string;
+    name: string;
+    /** Next slice of the raw JSON arguments text ("tool_call_delta" only). */
+    argumentsDelta?: string;
+}
+export interface ModelResponse {
+    message: Message;
+    usage: TokenUsage;
+    stopReason: "end_turn" | "tool_use" | "max_tokens" | "error";
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface Session {
+    id: string;
+    metadata: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+    /**
+     * every session has it's own model, if Agent switch back to another provider just fallback to default llmModel in AgentProfile
+     */
+    llmModel?: string;
+    /**
+     * Token usage from the most recent model response in this session.
+     * inputTokens = full conversation sent to the model (= current context size).
+     * outputTokens = what the model generated (added to context for next turn).
+     * Together they represent the current context window usage.
+     */
+    currentTokenUsage?: TokenUsage;
+    /**
+     * Learned chars-per-token ratio from the Counter's calibration.
+     * Persisted so the next run starts with an accurate estimator
+     * instead of the default 4:1 guess.
+     */
+    counterCalibration?: {
+        charsPerToken: number;
+        samples: number;
+    };
+    /**
+     * Memory consolidation checkpoint — how many of this session's messages
+     * (in MessageStore order) the memory system has already processed.
+     * Persisted so consolidation resumes from here after a restart instead of
+     * reprocessing the whole session. Messages are append-only, so this value
+     * only ever grows: SessionStore.update() must never decrease it
+     * (other components write back cached Session copies that may hold an
+     * older value).
+     */
+    consolidatedMessageCount?: number;
+}
+export interface SessionFilter {
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernel/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,OAAO;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EACA,MAAM,GACN,iBAAiB,GACjB,iBAAiB,GACjB,WAAW,GACX,aAAa,GACb,MAAM,GACN,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,wGAAwG;IACxG,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAC,MAAM,CAAC;IACjB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/kernel/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/kernel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kernel/types.ts"],"names":[],"mappings":""}