aec-agent 1.0.0

package/dist/components/artifact-hub/artifact-hub.js

@@ -0,0 +1,39 @@
+import { ArtifactError } from "../../kernel/errors/artifact-error.js";
+import { AgentArtifactView } from "./agent-artifact-view.js";
+/**
+ * Global hub for artifacts (A-62) — like ToolHub / SandboxHub, AgentCore owns one.
+ *
+ *   ArtifactHub (agent scoping)
+ *     └─ PersistenceHub.artifacts   the durable store (in-memory by default, Postgres on the server)
+ *
+ * The hub itself keeps no state: it hands out a per-agent ArtifactView, which is
+ * what enforces ownership on every call. The store is resolved lazily through the
+ * callback so a later `core.usePersistence(hub)` swap reaches views handed out earlier.
+ */
+export class ArtifactHub {
+    getStore;
+    name = "artifact-hub";
+    version = "1.0.0";
+    constructor(getStore) {
+        this.getStore = getStore;
+    }
+    /** The view one agent works through. `sessionId` is stamped on versions written through it. */
+    forAgent(agentId, sessionId) {
+        if (typeof agentId !== "string" || !agentId.trim()) {
+            throw new ArtifactError("An agent id is required to reach artifacts", "invalid_argument");
+        }
+        return new AgentArtifactView(agentId, () => this.store(), sessionId);
+    }
+    /** Retention: an agent's artifacts live until the agent is deleted. */
+    async releaseAgentData(agentId) {
+        await this.store().deleteByAgent(agentId);
+    }
+    store() {
+        const store = this.getStore();
+        if (!store) {
+            throw new ArtifactError("No artifact store is configured on this server", "not_configured");
+        }
+        return store;
+    }
+}
+//# sourceMappingURL=artifact-hub.js.map

package/dist/components/artifact-hub/artifact-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-hub.js","sourceRoot":"","sources":["../../../src/components/artifact-hub/artifact-hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IAIF,QAAQ;IAHnB,IAAI,GAAG,cAAc,CAAC;IACtB,OAAO,GAAG,OAAO,CAAC;IAE3B,YAAoB,QAAyC;wBAAzC,QAAQ;IAAoC,CAAC;IAEjE,+FAA+F;IAC/F,QAAQ,CAAC,OAAe,EAAE,SAAkB;QAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,aAAa,CAAC,4CAA4C,EAAE,kBAAkB,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IACvE,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,aAAa,CAAC,gDAAgD,EAAE,gBAAgB,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/components/artifact-hub/types/artifact.d.ts

@@ -0,0 +1,158 @@
+import type { SandboxView } from "../../sandbox-hub/types/sandbox.js";
+/** Where one version came from — agent, session, tool, and the sandbox file it tracked. */
+export interface ArtifactOrigin {
+    agentId: string;
+    /** Session the version was written in, when it was written during a chat turn. */
+    sessionId?: string;
+    /** Tool that produced it, e.g. "save_artifact". Absent when written through the SDK directly. */
+    tool?: string;
+    /** Logical sandbox path of the file this version tracked. */
+    sandboxPath: string;
+    /** Id of the sandbox the file lived in, e.g. "docker:shared". */
+    sandboxId: string;
+}
+/**
+ * An artifact's head record — metadata plus the tracked file's last-known
+ * size and hash. The content lives only in the sandbox file at sandboxPath;
+ * nothing here, or in any version, is a copy of it.
+ */
+export interface Artifact {
+    id: string;
+    /** Owning agent (AgentProfile.id). Every read path is filtered by it. */
+    agentId: string;
+    /** Stable name, unique per agent — what the agent refers to the artifact by. */
+    name: string;
+    /** MIME type ("text/markdown") or a domain type ("aec/takeoff"). */
+    type: string;
+    description?: string;
+    tags?: string[];
+    /** Session the artifact was first created in (provenance only — artifacts outlive sessions). */
+    sessionId?: string;
+    /** Head version number. Versions are 1-based and contiguous. */
+    version: number;
+    /** Canonical logical path of the tracked file. */
+    sandboxPath: string;
+    /** Id of the sandbox the tracked file lives in, e.g. "docker:shared". */
+    sandboxId: string;
+    /** Bytes of the tracked file as of the last save/update/re-track. */
+    bytes: number;
+    /** sha256 (hex) of the tracked file as of the last save/update/re-track. */
+    sha256: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** One entry of an artifact's content-less history log. */
+export interface ArtifactVersion {
+    artifactId: string;
+    /** 1-based, contiguous. */
+    version: number;
+    bytes: number;
+    sha256: string;
+    createdAt: string;
+    /** The agent's own note on why this version exists ("added cost column"). */
+    note?: string;
+    origin: ArtifactOrigin;
+}
+export type ArtifactFileStatus = "current" | "changed" | "missing";
+/** The tracked file's live state, read straight from the sandbox — never stored. */
+export type ArtifactFile = {
+    status: "current" | "changed";
+    /** Canonical logical path the content was read from. */
+    path: string;
+    sandboxId: string;
+    content: string;
+    /** Size of the whole file in bytes (before any maxBytes truncation). */
+    size: number;
+    /** sha256 (hex) of the whole file. */
+    sha256: string;
+    /** true when maxBytes cut the content returned here — the file itself is untouched. */
+    truncated: boolean;
+} | {
+    status: "missing";
+    path: string;
+    sandboxId: string;
+    /** Why the file could not be read (not found, wrong sandbox, no sandbox at all). */
+    reason: string;
+};
+/** An artifact plus its tracked file's live state — what read returns. */
+export interface ArtifactRead {
+    artifact: Artifact;
+    file: ArtifactFile;
+}
+/** An artifact plus the version just written — what save/update return. */
+export interface ArtifactWrite {
+    artifact: Artifact;
+    version: ArtifactVersion;
+}
+export interface ArtifactReadOptions {
+    /** Most bytes of the file's content to return. Omitted = the sandbox's own limits.maxReadBytes. */
+    maxBytes?: number;
+}
+/** How a caller points at an artifact: by id or by name. Old versions cannot be opened (D-02). */
+export interface ArtifactRef {
+    id?: string;
+    name?: string;
+}
+export interface SaveArtifactInput {
+    name: string;
+    type: string;
+    /** Sandbox path to write (when content is given) or to track (when it is not). Default when writing: `artifacts/<name>`. */
+    path?: string;
+    /** Inline text: written to the sandbox first, then tracked. Omit to track the existing file at `path` instead. */
+    content?: string;
+    description?: string;
+    tags?: string[];
+    note?: string;
+    /** Tool that is saving, for ArtifactOrigin.tool. */
+    tool?: string;
+}
+export interface UpdateArtifactInput extends ArtifactRef {
+    path?: string;
+    content?: string;
+    /** Replaces the description when given; omitted leaves it as it is. */
+    description?: string;
+    /** Replaces the tag list when given; omitted leaves it as it is. */
+    tags?: string[];
+    note?: string;
+    /** Optimistic concurrency: fail with "conflict" unless the head is still this version. */
+    expectedVersion?: number;
+    tool?: string;
+}
+/** Filter for an agent's artifacts. The agent scope is applied by the view, not the caller. */
+export interface ArtifactQuery {
+    /** Only artifacts first created in this session. */
+    sessionId?: string;
+    types?: string[];
+    /** Exact name match. */
+    name?: string;
+    /** Matches an artifact carrying any of these tags. */
+    tags?: string[];
+    /** ISO timestamps on updatedAt. */
+    since?: string;
+    before?: string;
+    limit?: number;
+}
+/**
+ * One agent's view of the artifact store — the only thing tools, routes and the
+ * SDK ever touch. Every call is scoped to `agentId`, so one agent can never read
+ * or overwrite another agent's artifacts. Fails closed with ArtifactError.
+ */
+export interface ArtifactView {
+    readonly agentId: string;
+    /** Session stamped on versions written through this view (provenance). */
+    readonly sessionId?: string;
+    /** Create a new artifact at version 1. Throws "name_conflict" if the name is taken. */
+    save(input: SaveArtifactInput, sandbox: SandboxView): Promise<ArtifactWrite>;
+    /** Append a version to an existing artifact, re-tracking (or rewriting) its file. */
+    update(input: UpdateArtifactInput, sandbox: SandboxView): Promise<ArtifactWrite>;
+    /** Metadata only — no sandbox needed. */
+    get(ref: ArtifactRef): Promise<Artifact>;
+    /** Read the tracked file live through `sandbox`. Content is bounded only by opts.maxBytes. */
+    read(ref: ArtifactRef, sandbox: SandboxView, opts?: ArtifactReadOptions): Promise<ArtifactRead>;
+    list(query?: ArtifactQuery): Promise<Artifact[]>;
+    /** Every version of an artifact, newest first, content-less. */
+    versions(ref: ArtifactRef): Promise<ArtifactVersion[]>;
+    /** Delete the artifact record and its history. The sandbox file is left untouched. */
+    delete(ref: ArtifactRef): Promise<void>;
+}
+//# sourceMappingURL=artifact.d.ts.map

package/dist/components/artifact-hub/types/artifact.d.ts.map

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

package/dist/components/artifact-hub/types/artifact.js

@@ -0,0 +1,14 @@
+// ---------------------------------------------------------------------------
+// Artifacts (A-62) — a metadata tracker over one file in the owning agent's
+// sandbox: a report, a spec section, a CSV takeoff, a clash report.
+//
+// An artifact stores no content of its own. It tracks a file that lives in
+// the agent's SandboxView — the file IS the deliverable, with an id, a type,
+// versions and provenance layered on top so later turns, other agents and the
+// UI can refer to it by name instead of re-pasting its content into the
+// prompt. Reading an artifact reads that file live: current when its sha256
+// still matches the last tracked one, changed when it does not (a notice,
+// not an error), missing when the file (or the sandbox itself) is gone.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=artifact.js.map

package/dist/components/artifact-hub/types/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../../../src/components/artifact-hub/types/artifact.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,oEAAoE;AACpE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,8EAA8E"}

package/dist/components/event-handler/event-dispatcher.d.ts

@@ -0,0 +1,17 @@
+import type { Event } from "../../kernel/types.js";
+import type { EventBus, EventHandler, Unsubscribe } from "./types.js";
+/**
+ * Pub-sub event to decouple between services (like MediatR in .Net)
+ */
+export declare class EventDispatcher implements EventBus {
+    readonly name = "event-dispatcher";
+    readonly version = "1.0.0";
+    private handlers;
+    private log;
+    constructor(backing?: Event[]);
+    initialize(): Promise<void>;
+    emit<T>(partial: Omit<Event<T>, "id" | "timestamp">): Event<T>;
+    on<T>(type: string, handler: EventHandler<T>): Unsubscribe;
+    replay(sessionId: string, fromTimestamp?: number): AsyncIterable<Event>;
+}
+//# sourceMappingURL=event-dispatcher.d.ts.map

package/dist/components/event-handler/event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/components/event-handler/event-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtE;;GAEG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,GAAG,CAAU;IAErB,YAAY,OAAO,CAAC,EAAE,KAAK,EAAE,EAE5B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEpC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAe7D;IAED,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAQzD;IAEM,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,aAAa,CAAC,KAAK,CAAC,CAMtB;CACF"}

package/dist/components/event-handler/event-dispatcher.js

@@ -0,0 +1,47 @@
+/**
+ * Pub-sub event to decouple between services (like MediatR in .Net)
+ */
+export class EventDispatcher {
+    name = "event-dispatcher";
+    version = "1.0.0";
+    handlers = new Map();
+    log;
+    constructor(backing) {
+        this.log = backing ?? [];
+    }
+    async initialize() { }
+    emit(partial) {
+        const event = {
+            ...partial,
+            id: crypto.randomUUID(),
+            timestamp: Date.now(),
+        };
+        this.log.push(event);
+        const set = this.handlers.get(event.type);
+        if (set) {
+            for (const handler of set) {
+                handler(event);
+            }
+        }
+        return event;
+    }
+    on(type, handler) {
+        let set = this.handlers.get(type);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(type, set);
+        }
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+    async *replay(sessionId, fromTimestamp) {
+        for (const event of this.log) {
+            if (event.sessionId !== sessionId)
+                continue;
+            if (fromTimestamp && event.timestamp < fromTimestamp)
+                continue;
+            yield event;
+        }
+    }
+}
+//# sourceMappingURL=event-dispatcher.js.map

package/dist/components/event-handler/event-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-dispatcher.js","sourceRoot":"","sources":["../../../src/components/event-handler/event-dispatcher.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,kBAAkB,CAAC;IAC1B,OAAO,GAAG,OAAO,CAAC;IAEnB,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAChD,GAAG,CAAU;IAErB,YAAY,OAAiB;QAC3B,IAAI,CAAC,GAAG,GAAG,OAAO,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,IAAI,CAAI,OAA2C;QACjD,MAAM,KAAK,GAAa;YACtB,GAAG,OAAO;YACV,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC;QAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,EAAE,CAAI,IAAY,EAAE,OAAwB;QAC1C,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAuB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CACX,SAAiB,EACjB,aAAsB;QAEtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAAE,SAAS;YAC5C,IAAI,aAAa,IAAI,KAAK,CAAC,SAAS,GAAG,aAAa;gBAAE,SAAS;YAC/D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/components/event-handler/events.d.ts

@@ -0,0 +1,154 @@
+import type { TokenUsage } from "../../kernel/types.js";
+export declare const SDKEventType: {
+    readonly UserMessage: "agent-loop:message";
+    readonly Iteration: "agent-loop:iteration";
+    readonly ModelRequested: "agent-loop:model-request";
+    readonly ModelResponded: "agent-loop:model-response";
+    readonly ToolDispatched: "agent-loop:tool-start";
+    readonly ToolCompleted: "agent-loop:tool-end";
+    readonly ToolRetry: "agent-loop:tool-retry";
+    readonly ToolFailed: "agent-loop:tool-error";
+    readonly ToolDenied: "agent-loop:tool-denied";
+    readonly ToolApprovalRequested: "agent-loop:tool-approval-request";
+    readonly ToolApprovalResolved: "agent-loop:tool-approval-result";
+    readonly SkillDispatched: "agent-loop:skill-start";
+    readonly SkillCompleted: "agent-loop:skill-end";
+    readonly SkillRetry: "agent-loop:skill-retry";
+    readonly SkillFailed: "agent-loop:skill-error";
+    readonly RunCompleted: "agent-loop:complete";
+    readonly MaxIterationsReached: "agent-loop:max-iterations";
+    readonly ArtifactSaved: "artifact:saved";
+    readonly ArtifactUpdated: "artifact:updated";
+    readonly ArtifactDeleted: "artifact:deleted";
+    readonly JobCompleted: "scheduled-job:completed";
+    readonly JobFailed: "scheduled-job:error";
+};
+export type SDKEventTypeValue = typeof SDKEventType[keyof typeof SDKEventType];
+export interface UserMessagePayload {
+    agentId: string;
+    role: string;
+    content: string;
+}
+export interface IterationPayload {
+    agentId: string;
+    iteration: number;
+    maxIterations: number;
+}
+export interface ModelRequestedPayload {
+    agentId: string;
+    iteration: number;
+    toolCount: number;
+}
+export interface ModelRespondedPayload {
+    agentId: string;
+    stopReason: string;
+    usage?: TokenUsage;
+    hasToolCalls: boolean;
+}
+export interface DispatchStartPayload {
+    agentId: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface DispatchEndPayload {
+    agentId: string;
+    name: string;
+    isError: boolean;
+    attempt: number;
+}
+export interface DispatchRetryPayload {
+    agentId: string;
+    name: string;
+    attempt: number;
+    reason: string;
+}
+export interface DispatchFailedPayload {
+    agentId: string;
+    name: string;
+    error: string;
+}
+export interface ToolDeniedPayload {
+    agentId: string;
+    name: string;
+    reason?: string;
+}
+export interface ToolApprovalRequestedPayload {
+    agentId: string;
+    name: string;
+    toolCallId: string;
+    risk: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolApprovalResolvedPayload {
+    agentId: string;
+    name: string;
+    toolCallId: string;
+    approved: boolean;
+    reason?: string;
+    waitedMs: number;
+}
+export interface RunCompletedPayload {
+    agentId: string;
+    iterations: number;
+    totalUsage: TokenUsage;
+    /** True when the run was stopped through RunOptions.signal instead of ending naturally (A-65). */
+    aborted?: boolean;
+}
+export interface MaxIterationsPayload {
+    agentId: string;
+    iterations: number;
+    totalUsage: TokenUsage;
+}
+export interface JobCompletedPayload {
+    agentId: string;
+    jobName: string;
+    output: unknown;
+}
+export interface JobFailedPayload {
+    agentId: string;
+    jobName: string;
+    error: string;
+}
+/** An artifact version was written (A-62). Emitted for both the first version and later ones. */
+export interface ArtifactWrittenPayload {
+    agentId: string;
+    artifactId: string;
+    name: string;
+    type: string;
+    version: number;
+    bytes: number;
+    /** Sandbox path of the file this version tracks. */
+    sandboxPath: string;
+    /** Id of the sandbox the tracked file lives in. */
+    sandboxId: string;
+}
+export interface ArtifactDeletedPayload {
+    agentId: string;
+    artifactId: string;
+    name: string;
+}
+export interface SDKEventPayloadMap {
+    [SDKEventType.UserMessage]: UserMessagePayload;
+    [SDKEventType.Iteration]: IterationPayload;
+    [SDKEventType.ModelRequested]: ModelRequestedPayload;
+    [SDKEventType.ModelResponded]: ModelRespondedPayload;
+    [SDKEventType.ToolDispatched]: DispatchStartPayload;
+    [SDKEventType.ToolCompleted]: DispatchEndPayload;
+    [SDKEventType.ToolRetry]: DispatchRetryPayload;
+    [SDKEventType.ToolFailed]: DispatchFailedPayload;
+    [SDKEventType.ToolDenied]: ToolDeniedPayload;
+    [SDKEventType.ToolApprovalRequested]: ToolApprovalRequestedPayload;
+    [SDKEventType.ToolApprovalResolved]: ToolApprovalResolvedPayload;
+    [SDKEventType.SkillDispatched]: DispatchStartPayload;
+    [SDKEventType.SkillCompleted]: DispatchEndPayload;
+    [SDKEventType.SkillRetry]: DispatchRetryPayload;
+    [SDKEventType.SkillFailed]: DispatchFailedPayload;
+    [SDKEventType.RunCompleted]: RunCompletedPayload;
+    [SDKEventType.MaxIterationsReached]: MaxIterationsPayload;
+    [SDKEventType.ArtifactSaved]: ArtifactWrittenPayload;
+    [SDKEventType.ArtifactUpdated]: ArtifactWrittenPayload;
+    [SDKEventType.ArtifactDeleted]: ArtifactDeletedPayload;
+    [SDKEventType.JobCompleted]: JobCompletedPayload;
+    [SDKEventType.JobFailed]: JobFailedPayload;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/components/event-handler/events.d.ts.map

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

package/dist/components/event-handler/events.js

@@ -0,0 +1,28 @@
+// ---------------------------------------------------------------------------
+// SDK event type constants — single source of truth for all event type strings
+// ---------------------------------------------------------------------------
+export const SDKEventType = {
+    UserMessage: "agent-loop:message",
+    Iteration: "agent-loop:iteration",
+    ModelRequested: "agent-loop:model-request",
+    ModelResponded: "agent-loop:model-response",
+    ToolDispatched: "agent-loop:tool-start",
+    ToolCompleted: "agent-loop:tool-end",
+    ToolRetry: "agent-loop:tool-retry",
+    ToolFailed: "agent-loop:tool-error",
+    ToolDenied: "agent-loop:tool-denied",
+    ToolApprovalRequested: "agent-loop:tool-approval-request",
+    ToolApprovalResolved: "agent-loop:tool-approval-result",
+    SkillDispatched: "agent-loop:skill-start",
+    SkillCompleted: "agent-loop:skill-end",
+    SkillRetry: "agent-loop:skill-retry",
+    SkillFailed: "agent-loop:skill-error",
+    RunCompleted: "agent-loop:complete",
+    MaxIterationsReached: "agent-loop:max-iterations",
+    ArtifactSaved: "artifact:saved",
+    ArtifactUpdated: "artifact:updated",
+    ArtifactDeleted: "artifact:deleted",
+    JobCompleted: "scheduled-job:completed",
+    JobFailed: "scheduled-job:error",
+};
+//# sourceMappingURL=events.js.map

package/dist/components/event-handler/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/components/event-handler/events.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAW,oBAAoB;IAC1C,SAAS,EAAa,sBAAsB;IAC5C,cAAc,EAAQ,0BAA0B;IAChD,cAAc,EAAQ,2BAA2B;IACjD,cAAc,EAAQ,uBAAuB;IAC7C,aAAa,EAAS,qBAAqB;IAC3C,SAAS,EAAa,uBAAuB;IAC7C,UAAU,EAAY,uBAAuB;IAC7C,UAAU,EAAY,wBAAwB;IAC9C,qBAAqB,EAAE,kCAAkC;IACzD,oBAAoB,EAAE,iCAAiC;IACvD,eAAe,EAAO,wBAAwB;IAC9C,cAAc,EAAQ,sBAAsB;IAC5C,UAAU,EAAY,wBAAwB;IAC9C,WAAW,EAAW,wBAAwB;IAC9C,YAAY,EAAU,qBAAqB;IAC3C,oBAAoB,EAAE,2BAA2B;IACjD,aAAa,EAAS,gBAAgB;IACtC,eAAe,EAAO,kBAAkB;IACxC,eAAe,EAAO,kBAAkB;IACxC,YAAY,EAAU,yBAAyB;IAC/C,SAAS,EAAa,qBAAqB;CACnC,CAAC"}

package/dist/components/event-handler/types.d.ts

@@ -0,0 +1,10 @@
+import type { Event } from "../../kernel/types.js";
+import type { Plugin } from "../../kernel/interfaces/plugin.js";
+export interface EventBus extends Plugin {
+    emit<T>(event: Omit<Event<T>, "id" | "timestamp">): Event<T>;
+    on<T>(type: string, handler: EventHandler<T>): Unsubscribe;
+    replay(sessionId: string, fromTimestamp?: number): AsyncIterable<Event>;
+}
+export type EventHandler<T = unknown> = (event: Event<T>) => void | Promise<void>;
+export type Unsubscribe = () => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/event-handler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/event-handler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAMhE,MAAM,WAAW,QAAS,SAAQ,MAAM;IACtC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;CACzE;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAClF,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}

package/dist/components/event-handler/types.js

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

package/dist/components/event-handler/types.js.map

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

package/dist/components/llm-provider-hub/llm-provider-hub.d.ts

@@ -0,0 +1,14 @@
+import type { LLMModelProvider } from "./types.js";
+/**
+ * Global hub for LLM Provider, during using users can switch between models when they hit session's limit.
+ */
+export declare class LLMProviderHub {
+    private adapters;
+    private primaryName;
+    register(adapter: LLMModelProvider): void;
+    get(name: string): LLMModelProvider | undefined;
+    getPrimary(): LLMModelProvider;
+    setPrimary(name: string): void;
+    list(): LLMModelProvider[];
+}
+//# sourceMappingURL=llm-provider-hub.d.ts.map

package/dist/components/llm-provider-hub/llm-provider-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-hub.d.ts","sourceRoot":"","sources":["../../../src/components/llm-provider-hub/llm-provider-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,WAAW,CAAuB;IAE1C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAKxC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9C;IAED,UAAU,IAAI,gBAAgB,CAK7B;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK7B;IAED,IAAI,IAAI,gBAAgB,EAAE,CAEzB;CACF"}

package/dist/components/llm-provider-hub/llm-provider-hub.js

@@ -0,0 +1,34 @@
+/**
+ * Global hub for LLM Provider, during using users can switch between models when they hit session's limit.
+ */
+export class LLMProviderHub {
+    adapters = new Map();
+    primaryName = null;
+    register(adapter) {
+        this.adapters.set(adapter.name, adapter);
+        if (!this.primaryName) {
+            this.primaryName = adapter.name;
+        }
+    }
+    get(name) {
+        return this.adapters.get(name);
+    }
+    getPrimary() {
+        if (!this.primaryName)
+            throw new Error("No LLMModelProvider registered");
+        const adapter = this.adapters.get(this.primaryName);
+        if (!adapter)
+            throw new Error("Primary LLMModelProvider not found");
+        return adapter;
+    }
+    setPrimary(name) {
+        if (!this.adapters.has(name)) {
+            throw new Error(`LLMModelProvider "${name}" not registered`);
+        }
+        this.primaryName = name;
+    }
+    list() {
+        return [...this.adapters.values()];
+    }
+}
+//# sourceMappingURL=llm-provider-hub.js.map

package/dist/components/llm-provider-hub/llm-provider-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-hub.js","sourceRoot":"","sources":["../../../src/components/llm-provider-hub/llm-provider-hub.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC/C,WAAW,GAAkB,IAAI,CAAC;IAE1C,QAAQ,CAAC,OAAyB;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,kBAAkB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/components/llm-provider-hub/providers/anthropic-provider.d.ts

@@ -0,0 +1,22 @@
+import type { Message, ModelResponse, StreamChunk } from "../../../kernel/types.js";
+import type { LLMModelInfo, LLMModelProvider, ModelOptions } from "../types.js";
+import type { ProviderConfig } from "./types.js";
+export declare class AnthropicLLMModelProvider implements LLMModelProvider {
+    readonly name: string;
+    readonly version = "1.0.0";
+    private client;
+    private defaultModel;
+    constructor(config: ProviderConfig);
+    initialize(): Promise<void>;
+    dispose(): Promise<void>;
+    chat(messages: Message[], options?: ModelOptions): Promise<ModelResponse>;
+    stream(messages: Message[], options?: ModelOptions): AsyncIterable<StreamChunk>;
+    countTokens(messages: Message[]): Promise<number>;
+    listModels(): Promise<LLMModelInfo[]>;
+    private mapMessages;
+    private mapResponse;
+    private mapStopReason;
+    private mapTools;
+    private mapError;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/components/llm-provider-hub/providers/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../../src/components/llm-provider-hub/providers/anthropic-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,WAAW,EAEZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,YAAY,CAAS;IAE7B,YAAY,MAAM,EAAE,cAAc,EAIjC;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE3B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAqB9E;IAEM,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,CA8ErF;IAEK,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQtD;IAEK,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAU1C;IAED,OAAO,CAAC,WAAW;IAmDnB,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,QAAQ;CAWjB"}