arcie 0.1.2

package/dist/discover/index.js

@@ -0,0 +1,133 @@
+import { readdirSync, existsSync } from "node:fs";
+import { resolve, join, basename, extname } from "node:path";
+const TOOL_SLUG = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
+const CHANNEL_SLUG = /^[a-z][a-z0-9-]{0,63}$/;
+const CONNECTION_SLUG = /^[a-z][a-z0-9-]{0,63}$/;
+const HOOK_SLUG = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
+const SUPPORTED_EXTENSIONS = new Set([".ts", ".mts", ".cts", ".js", ".mjs", ".cjs"]);
+export function discoverAgent(agentDir) {
+    const root = resolve(agentDir);
+    const diagnostics = [];
+    if (!existsSync(root)) {
+        diagnostics.push({
+            code: "AGENT_DIR_NOT_FOUND",
+            message: `Agent directory not found: ${root}`,
+            severity: "error",
+        });
+        return { agent: { root, tools: [], skills: [], hooks: [], channels: [], schedules: [], connections: [], subagents: [], lib: [] }, diagnostics };
+    }
+    const entries = readdirSync(root, { withFileTypes: true });
+    const agent = {
+        root,
+        agentConfig: discoverFlatModule(root, "agent", entries, diagnostics),
+        instructions: discoverInstructions(root, entries, diagnostics),
+        tools: discoverNamedDirectory(root, "tools", entries, TOOL_SLUG, diagnostics),
+        skills: discoverNamedDirectory(root, "skills", entries, TOOL_SLUG, diagnostics),
+        hooks: discoverNamedDirectory(root, "hooks", entries, HOOK_SLUG, diagnostics),
+        channels: discoverNamedDirectory(root, "channels", entries, CHANNEL_SLUG, diagnostics),
+        schedules: discoverNamedDirectory(root, "schedules", entries, TOOL_SLUG, diagnostics),
+        connections: discoverNamedDirectory(root, "connections", entries, CONNECTION_SLUG, diagnostics),
+        subagents: discoverNamedDirectory(root, "subagents", entries, TOOL_SLUG, diagnostics),
+        lib: discoverNamedDirectory(root, "lib", entries, TOOL_SLUG, diagnostics),
+    };
+    return { agent, diagnostics };
+}
+function discoverFlatModule(root, baseName, entries, diagnostics) {
+    const candidates = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const name = entry.name;
+        const ext = extname(name);
+        if (!SUPPORTED_EXTENSIONS.has(ext))
+            continue;
+        if (basename(name, ext) !== baseName)
+            continue;
+        candidates.push(name);
+    }
+    if (candidates.length > 1) {
+        diagnostics.push({
+            code: "MODULE_SLOT_COLLISION",
+            message: `Multiple module sources for "${baseName}": ${candidates.join(", ")}`,
+            severity: "error",
+            filePath: root,
+        });
+    }
+    if (candidates.length === 0)
+        return undefined;
+    return join(root, candidates[0]);
+}
+function discoverInstructions(root, entries, diagnostics) {
+    const mdCandidate = entries.find(e => e.isFile() && e.name.toLowerCase() === "instructions.md");
+    if (mdCandidate)
+        return join(root, mdCandidate.name);
+    const tsCandidate = entries.find(e => {
+        if (!e.isFile())
+            return false;
+        const ext = extname(e.name);
+        return SUPPORTED_EXTENSIONS.has(ext) && basename(e.name, ext) === "instructions";
+    });
+    if (tsCandidate)
+        return join(root, tsCandidate.name);
+    const legacyMdCandidate = entries.find(e => e.isFile() && e.name.toLowerCase() === "system.md");
+    if (legacyMdCandidate) {
+        diagnostics.push({
+            code: "DEPRECATED_SYSTEM_SLOT",
+            message: `"system.md" is deprecated. Rename to "instructions.md".`,
+            severity: "warning",
+            filePath: join(root, legacyMdCandidate.name),
+        });
+        return join(root, legacyMdCandidate.name);
+    }
+    return undefined;
+}
+function discoverNamedDirectory(root, dirName, entries, slugPattern, diagnostics) {
+    const dirEntry = entries.find(e => e.isDirectory() && e.name === dirName);
+    if (!dirEntry)
+        return [];
+    const dirPath = join(root, dirName);
+    const slots = [];
+    try {
+        const files = readdirSync(dirPath, { withFileTypes: true });
+        for (const file of files) {
+            if (!file.isFile())
+                continue;
+            const ext = extname(file.name);
+            const name = basename(file.name, ext);
+            if (file.name === ".gitkeep")
+                continue;
+            if (ext === ".md") {
+                if (!slugPattern.test(name)) {
+                    diagnostics.push({
+                        code: "INVALID_SLOT_NAME",
+                        message: `Invalid ${dirName} name "${name}" — does not match slug pattern.`,
+                        severity: "warning",
+                        filePath: join(dirPath, file.name),
+                    });
+                }
+                slots.push({ name, filePath: join(dirPath, file.name), type: "markdown", kind: "named" });
+                continue;
+            }
+            if (SUPPORTED_EXTENSIONS.has(ext)) {
+                if (!slugPattern.test(name)) {
+                    diagnostics.push({
+                        code: "INVALID_SLOT_NAME",
+                        message: `Invalid ${dirName} name "${name}" — does not match slug pattern.`,
+                        severity: "warning",
+                        filePath: join(dirPath, file.name),
+                    });
+                }
+                slots.push({ name, filePath: join(dirPath, file.name), type: "module", kind: "named" });
+            }
+        }
+    }
+    catch {
+        diagnostics.push({
+            code: "DIRECTORY_READ_ERROR",
+            message: `Could not read directory: ${dirPath}`,
+            severity: "error",
+        });
+    }
+    return slots.sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=index.js.map

package/dist/discover/index.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+import type { HookConfig } from "../types.js";
+export declare function defineHook(config: HookConfig): HookConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAKzD"}

package/dist/hooks/index.js

@@ -0,0 +1,7 @@
+export function defineHook(config) {
+    if (!config.name || !config.event || !config.handler) {
+        throw new Error("Hook must have name, event, and handler");
+    }
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { defineAgent } from "./agent/index.js";
+export { defineInstructions, loadInstructions } from "./instructions/index.js";
+export { defineTool } from "./tools/index.js";
+export { defineSkill, getSkill } from "./skills/index.js";
+export { defineHook } from "./hooks/index.js";
+export { defineChannel, POST, GET } from "./channels/index.js";
+export { defineSchedule } from "./schedules/index.js";
+export { getSession, getTurn, getContext, requireContext, hasContext, setContext, ensureContext } from "./context/index.js";
+export { loadAgent } from "./loader.js";
+export { runAgent, streamAgent } from "./runner/index.js";
+export { discoverAgent } from "./discover/index.js";
+export { bearer, basic } from "./auth/index.js";
+export type { OutboundAuthFn, TokenValue } from "./auth/index.js";
+export type * from "./types.js";
+export type * from "./protocol/events.js";
+export { createSessionStarted, createTurnStarted, createMessageReceived, createMessageAppended, createMessageCompleted, createStepStarted, createStepCompleted, createTurnCompleted, createSessionWaiting, createSessionCompleted, encodeEvent, encodeEvents, } from "./protocol/events.js";
+export type { StreamEvent } from "./protocol/events.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5H,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClE,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,sBAAsB,CAAC;AAC1C,OAAO,EACL,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAC9D,qBAAqB,EAAE,sBAAsB,EAAE,iBAAiB,EAChE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAC9D,sBAAsB,EAAE,WAAW,EAAE,YAAY,GAClD,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { defineAgent } from "./agent/index.js";
+export { defineInstructions, loadInstructions } from "./instructions/index.js";
+export { defineTool } from "./tools/index.js";
+export { defineSkill, getSkill } from "./skills/index.js";
+export { defineHook } from "./hooks/index.js";
+export { defineChannel, POST, GET } from "./channels/index.js";
+export { defineSchedule } from "./schedules/index.js";
+export { getSession, getTurn, getContext, requireContext, hasContext, setContext, ensureContext } from "./context/index.js";
+export { loadAgent } from "./loader.js";
+export { runAgent, streamAgent } from "./runner/index.js";
+export { discoverAgent } from "./discover/index.js";
+export { bearer, basic } from "./auth/index.js";
+export { createSessionStarted, createTurnStarted, createMessageReceived, createMessageAppended, createMessageCompleted, createStepStarted, createStepCompleted, createTurnCompleted, createSessionWaiting, createSessionCompleted, encodeEvent, encodeEvents, } from "./protocol/events.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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5H,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIhD,OAAO,EACL,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAC9D,qBAAqB,EAAE,sBAAsB,EAAE,iBAAiB,EAChE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAC9D,sBAAsB,EAAE,WAAW,EAAE,YAAY,GAClD,MAAM,sBAAsB,CAAC"}

package/dist/instructions/index.d.ts

@@ -0,0 +1,4 @@
+import type { InstructionsConfig } from "../types.js";
+export declare function defineInstructions(source: string | InstructionsConfig): InstructionsConfig;
+export declare function loadInstructions(agentDir: string): InstructionsConfig | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instructions/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAClC,kBAAkB,CAYpB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAiB3B"}

package/dist/instructions/index.js

@@ -0,0 +1,33 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+export function defineInstructions(source) {
+    if (typeof source === "string") {
+        const filePath = resolve(process.cwd(), source);
+        if (!existsSync(filePath)) {
+            throw new Error(`Instructions file not found: ${filePath}`);
+        }
+        return {
+            content: readFileSync(filePath, "utf-8"),
+            filePath,
+        };
+    }
+    return source;
+}
+export function loadInstructions(agentDir) {
+    const mdPath = resolve(agentDir, "instructions.md");
+    const tsPath = resolve(agentDir, "instructions.ts");
+    if (existsSync(mdPath)) {
+        return {
+            content: readFileSync(mdPath, "utf-8"),
+            filePath: mdPath,
+        };
+    }
+    if (existsSync(tsPath)) {
+        return {
+            content: readFileSync(tsPath, "utf-8"),
+            filePath: tsPath,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/instructions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instructions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,kBAAkB,CAChC,MAAmC;IAEnC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;YACxC,QAAQ;SACT,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC;YACtC,QAAQ,EAAE,MAAM;SACjB,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC;YACtC,QAAQ,EAAE,MAAM;SACjB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,7 @@
+import type { AgentManifest } from "./types.js";
+export interface LoadedAgent {
+    manifest: AgentManifest;
+    agentDir: string;
+}
+export declare function loadAgent(agentDir: string): Promise<LoadedAgent>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EASd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4CtE"}

package/dist/loader.js

@@ -0,0 +1,102 @@
+import { readFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { resolve, basename, extname } from "node:path";
+import { createRequire } from "node:module";
+const _require = createRequire(import.meta.url);
+export async function loadAgent(agentDir) {
+    const absDir = resolve(process.cwd(), agentDir);
+    if (!existsSync(absDir)) {
+        throw new Error(`Agent directory not found: ${absDir}`);
+    }
+    const agentFile = resolve(absDir, "agent.ts");
+    let config = { model: "gpt-4o" };
+    if (existsSync(agentFile)) {
+        try {
+            const mod = await import(agentFile);
+            if (mod.default) {
+                config = { ...config, ...mod.default };
+            }
+        }
+        catch {
+            // fall back to defaults
+        }
+    }
+    const instructions = loadInstructionsFile(absDir);
+    const tools = await loadDirectory(absDir, "tools");
+    const skills = await loadDirectory(absDir, "skills");
+    const hooks = await loadDirectory(absDir, "hooks");
+    const channels = await loadDirectory(absDir, "channels");
+    const schedules = await loadDirectory(absDir, "schedules");
+    const session = loadSessionConfig(absDir);
+    const policy = loadPolicyConfig(absDir);
+    return {
+        agentDir: absDir,
+        manifest: {
+            config,
+            instructions,
+            tools,
+            skills,
+            hooks,
+            channels,
+            schedules,
+            session: session ?? undefined,
+            policy: policy ?? undefined,
+        },
+    };
+}
+function loadInstructionsFile(agentDir) {
+    const mdPath = resolve(agentDir, "instructions.md");
+    if (existsSync(mdPath)) {
+        return readFileSync(mdPath, "utf-8");
+    }
+    return "You are a helpful AI agent.";
+}
+async function loadDirectory(agentDir, dirName) {
+    const dirPath = resolve(agentDir, dirName);
+    if (!existsSync(dirPath))
+        return {};
+    const entries = readdirSync(dirPath).filter((f) => !f.startsWith(".") && (f.endsWith(".ts") || f.endsWith(".js")));
+    const result = {};
+    for (const entry of entries) {
+        const name = basename(entry, extname(entry));
+        const filePath = resolve(dirPath, entry);
+        if (statSync(filePath).isFile()) {
+            try {
+                const mod = await import(filePath);
+                if (mod.default) {
+                    result[name] = mod.default;
+                }
+            }
+            catch {
+                // skip unloadable files
+            }
+        }
+    }
+    return result;
+}
+function loadSessionConfig(agentDir) {
+    const tsPath = resolve(agentDir, "sessions", "config.ts");
+    if (existsSync(tsPath)) {
+        try {
+            const mod = _require(tsPath);
+            return mod.default ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function loadPolicyConfig(agentDir) {
+    const tsPath = resolve(agentDir, "policies", "index.ts");
+    if (existsSync(tsPath)) {
+        try {
+            const mod = _require(tsPath);
+            return mod.default ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/protocol/events.d.ts

@@ -0,0 +1,192 @@
+export type AssistantStepFinishReason = "content-filter" | "error" | "length" | "other" | "stop" | "tool-calls";
+export type ActionResultStatus = "completed" | "failed" | "rejected";
+export interface ActionResultError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface SessionStartedEvent {
+    type: "session.started";
+    data: {
+        sessionId: string;
+        runtime?: {
+            agentId: string;
+            modelId: string;
+            elineVersion: string;
+        };
+    };
+}
+export interface TurnStartedEvent {
+    type: "turn.started";
+    data: {
+        sequence: number;
+        turnId: string;
+    };
+}
+export interface MessageReceivedEvent {
+    type: "message.received";
+    data: {
+        message: string;
+        sequence: number;
+        turnId: string;
+    };
+}
+export interface MessageAppendedEvent {
+    type: "message.appended";
+    data: {
+        delta: string;
+        textSoFar: string;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface MessageCompletedEvent {
+    type: "message.completed";
+    data: {
+        text: string | null;
+        finishReason: AssistantStepFinishReason;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface ReasoningAppendedEvent {
+    type: "reasoning.appended";
+    data: {
+        delta: string;
+        soFar: string;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface ReasoningCompletedEvent {
+    type: "reasoning.completed";
+    data: {
+        text: string;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface StepStartedEvent {
+    type: "step.started";
+    data: {
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface StepCompletedEvent {
+    type: "step.completed";
+    data: {
+        finishReason: AssistantStepFinishReason;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+        usage?: {
+            inputTokens?: number;
+            outputTokens?: number;
+        };
+    };
+}
+export interface StepFailedEvent {
+    type: "step.failed";
+    data: {
+        code: string;
+        message: string;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface ToolCallStartedEvent {
+    type: "tool.started";
+    data: {
+        name: string;
+        input: unknown;
+        callId: string;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface ToolCallCompletedEvent {
+    type: "tool.completed";
+    data: {
+        name: string;
+        output: unknown;
+        callId: string;
+        status: ActionResultStatus;
+        error?: ActionResultError;
+        sequence: number;
+        stepIndex: number;
+        turnId: string;
+    };
+}
+export interface TurnCompletedEvent {
+    type: "turn.completed";
+    data: {
+        sequence: number;
+        turnId: string;
+    };
+}
+export interface TurnFailedEvent {
+    type: "turn.failed";
+    data: {
+        code: string;
+        message: string;
+        sequence: number;
+        turnId: string;
+    };
+}
+export interface SessionWaitingEvent {
+    type: "session.waiting";
+    data: {
+        wait: "next-user-message";
+    };
+}
+export interface SessionCompletedEvent {
+    type: "session.completed";
+}
+export interface SessionFailedEvent {
+    type: "session.failed";
+    data: {
+        code: string;
+        message: string;
+        sessionId: string;
+    };
+}
+export interface SubagentCalledEvent {
+    type: "subagent.called";
+    data: {
+        name: string;
+        callId: string;
+        childSessionId: string;
+        turnId: string;
+    };
+}
+export interface SubagentCompletedEvent {
+    type: "subagent.completed";
+    data: {
+        name: string;
+        callId: string;
+        output: string;
+    };
+}
+export type StreamEvent = SessionStartedEvent | TurnStartedEvent | MessageReceivedEvent | MessageAppendedEvent | MessageCompletedEvent | ReasoningAppendedEvent | ReasoningCompletedEvent | StepStartedEvent | StepCompletedEvent | StepFailedEvent | ToolCallStartedEvent | ToolCallCompletedEvent | TurnCompletedEvent | TurnFailedEvent | SessionWaitingEvent | SessionCompletedEvent | SessionFailedEvent | SubagentCalledEvent | SubagentCompletedEvent;
+export declare function createSessionStarted(sessionId: string, runtime?: SessionStartedEvent["data"]["runtime"]): SessionStartedEvent;
+export declare function createTurnStarted(sequence: number, turnId: string): TurnStartedEvent;
+export declare function createMessageReceived(message: string, sequence: number, turnId: string): MessageReceivedEvent;
+export declare function createMessageAppended(delta: string, textSoFar: string, sequence: number, stepIndex: number, turnId: string): MessageAppendedEvent;
+export declare function createMessageCompleted(text: string | null, finishReason: AssistantStepFinishReason, sequence: number, stepIndex: number, turnId: string): MessageCompletedEvent;
+export declare function createStepStarted(sequence: number, stepIndex: number, turnId: string): StepStartedEvent;
+export declare function createStepCompleted(finishReason: AssistantStepFinishReason, sequence: number, stepIndex: number, turnId: string, usage?: StepCompletedEvent["data"]["usage"]): StepCompletedEvent;
+export declare function createTurnCompleted(sequence: number, turnId: string): TurnCompletedEvent;
+export declare function createSessionWaiting(): SessionWaitingEvent;
+export declare function createSessionCompleted(): SessionCompletedEvent;
+export declare function createToolCallStarted(name: string, input: unknown, callId: string, sequence: number, stepIndex: number, turnId: string): ToolCallStartedEvent;
+export declare function createToolCallCompleted(name: string, output: unknown, callId: string, status: ActionResultStatus, error?: ActionResultError, sequence?: number, stepIndex?: number, turnId?: string): ToolCallCompletedEvent;
+export declare function encodeEvent(event: StreamEvent): string;
+export declare function encodeEvents(events: StreamEvent[]): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/protocol/events.d.ts.map

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

package/dist/protocol/events.js

@@ -0,0 +1,46 @@
+export function createSessionStarted(sessionId, runtime) {
+    return { type: "session.started", data: { sessionId, ...(runtime ? { runtime } : {}) } };
+}
+export function createTurnStarted(sequence, turnId) {
+    return { type: "turn.started", data: { sequence, turnId } };
+}
+export function createMessageReceived(message, sequence, turnId) {
+    return { type: "message.received", data: { message, sequence, turnId } };
+}
+export function createMessageAppended(delta, textSoFar, sequence, stepIndex, turnId) {
+    return { type: "message.appended", data: { delta, textSoFar, sequence, stepIndex, turnId } };
+}
+export function createMessageCompleted(text, finishReason, sequence, stepIndex, turnId) {
+    return { type: "message.completed", data: { text, finishReason, sequence, stepIndex, turnId } };
+}
+export function createStepStarted(sequence, stepIndex, turnId) {
+    return { type: "step.started", data: { sequence, stepIndex, turnId } };
+}
+export function createStepCompleted(finishReason, sequence, stepIndex, turnId, usage) {
+    return { type: "step.completed", data: { finishReason, sequence, stepIndex, turnId, usage } };
+}
+export function createTurnCompleted(sequence, turnId) {
+    return { type: "turn.completed", data: { sequence, turnId } };
+}
+export function createSessionWaiting() {
+    return { type: "session.waiting", data: { wait: "next-user-message" } };
+}
+export function createSessionCompleted() {
+    return { type: "session.completed" };
+}
+export function createToolCallStarted(name, input, callId, sequence, stepIndex, turnId) {
+    return { type: "tool.started", data: { name, input, callId, sequence, stepIndex, turnId } };
+}
+export function createToolCallCompleted(name, output, callId, status, error, sequence, stepIndex, turnId) {
+    return {
+        type: "tool.completed",
+        data: { name, output, callId, status, ...(error ? { error } : {}), sequence: sequence ?? 1, stepIndex: stepIndex ?? 0, turnId: turnId ?? "" },
+    };
+}
+export function encodeEvent(event) {
+    return JSON.stringify(event) + "\n";
+}
+export function encodeEvents(events) {
+    return events.map(encodeEvent).join("");
+}
+//# sourceMappingURL=events.js.map

package/dist/protocol/events.js.map

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