@edwardlee5423/magi 0.1.0-alpha.0

package/dist/hooks/events.d.ts

@@ -0,0 +1,14 @@
+import { HookDefinition, HookEvent } from "../config.js";
+import { SessionStore } from "../session-store.js";
+import { HookContext, HookResult } from "./runner.js";
+export interface HookEventInput {
+    event: HookEvent;
+    hooks: HookDefinition[];
+    store: SessionStore;
+    sessionId: string;
+    jobId?: string;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    context?: Partial<HookContext>;
+}
+export declare function triggerHooks(input: HookEventInput): Promise<HookResult[]>;

package/dist/hooks/events.js

@@ -0,0 +1,37 @@
+import { executeHooks } from "./runner.js";
+export async function triggerHooks(input) {
+    const results = await executeHooks({
+        event: input.event,
+        hooks: input.hooks,
+        env: input.env,
+        context: {
+            sessionId: input.sessionId,
+            cwd: input.cwd,
+            ...input.context
+        }
+    });
+    for (const result of results) {
+        recordHookAudit(input.store, {
+            sessionId: input.sessionId,
+            jobId: input.jobId,
+            action: result.error ? "agent.hook.failed" : "agent.hook.completed",
+            target: `${input.event}:${result.hook.type}`,
+            metadata: {
+                event: input.event,
+                hookType: result.hook.type,
+                condition: result.hook.if,
+                exitCode: result.exitCode,
+                blocked: result.blocked,
+                timedOut: result.timedOut,
+                status: result.status,
+                output: result.output,
+                error: result.error
+            }
+        });
+    }
+    return results;
+}
+function recordHookAudit(store, input) {
+    store.recordAudit(input);
+}
+//# sourceMappingURL=events.js.map

package/dist/hooks/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/hooks/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAA2B,MAAM,aAAa,CAAC;AAapE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAqB;IACtD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;QACjC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE;YACP,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,KAAK,CAAC,OAAO;SACjB;KACF,CAAC,CAAC;IACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE;YAC3B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,sBAAsB;YACnE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;YAC5C,QAAQ,EAAE;gBACR,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;gBAC1B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB,EAAE,KAAkB;IAC9D,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/hooks/runner.d.ts

@@ -0,0 +1,73 @@
+import { HookDefinition, HookEvent } from "../config.js";
+import { MagiMessage } from "../providers/ir.js";
+export interface HookContext {
+    sessionId: string;
+    cwd: string;
+    jobId?: string;
+    source?: "startup" | "resume" | "clear" | "compact" | "query";
+    model?: string;
+    provider?: string;
+    permissionMode?: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolUseId?: string;
+    toolResponse?: string;
+    error?: string;
+    message?: string;
+    title?: string;
+    notificationType?: string;
+    lastAssistantMessage?: string;
+    trigger?: "manual" | "auto";
+    customInstructions?: string;
+    compactSummary?: string;
+    sourceMessageCount?: number;
+    prompt?: string;
+    reason?: string;
+    permissionSuggestions?: string[];
+    agentId?: string;
+    agentType?: string;
+    agentTranscriptPath?: string;
+    taskId?: string;
+    taskSubject?: string;
+    taskDescription?: string;
+    teammateName?: string;
+    teamName?: string;
+    mcpServerName?: string;
+    mode?: string;
+    url?: string;
+    elicitationId?: string;
+    requestedSchema?: Record<string, unknown>;
+    action?: string;
+    content?: unknown;
+    filePath?: string;
+    event?: string;
+    name?: string;
+    worktreePath?: string;
+    memoryType?: string;
+    loadReason?: string;
+    oldCwd?: string;
+    newCwd?: string;
+    errorDetails?: string;
+}
+export interface HookResult {
+    hook: HookDefinition;
+    output: string;
+    exitCode: number | null;
+    blocked: boolean;
+    timedOut?: boolean;
+    error?: string;
+    status?: number;
+}
+export declare function executeHooks(input: {
+    event: HookEvent;
+    hooks: HookDefinition[];
+    context: HookContext;
+    env?: NodeJS.ProcessEnv;
+    promptModel?: (request: {
+        model: string;
+        messages: MagiMessage[];
+    }) => Promise<{
+        text: string;
+    }>;
+}): Promise<HookResult[]>;
+export declare function matchesHookCondition(condition: string | undefined, context: HookContext): boolean;

package/dist/hooks/runner.js

@@ -0,0 +1,256 @@
+import { spawn } from "node:child_process";
+export async function executeHooks(input) {
+    const results = [];
+    for (const hook of input.hooks) {
+        if (hook.event !== input.event || !matchesHookCondition(hook.if, input.context)) {
+            continue;
+        }
+        try {
+            const result = hook.type === "command"
+                ? await runCommandHook(hook, input.context, input.env)
+                : hook.type === "http"
+                    ? await runHttpHook(hook, input.context, input.env)
+                    : hook.type === "prompt"
+                        ? await runPromptHook(hook, input.context, input.promptModel)
+                        : unsupportedHookResult(hook);
+            results.push(result);
+        }
+        catch (error) {
+            results.push({
+                hook,
+                output: "",
+                exitCode: null,
+                blocked: false,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    return results;
+}
+async function runPromptHook(hook, context, promptModel) {
+    if (!hook.prompt) {
+        return {
+            hook,
+            output: "",
+            exitCode: null,
+            blocked: false,
+            error: "Prompt hook requires prompt"
+        };
+    }
+    if (!hook.model) {
+        return {
+            hook,
+            output: "",
+            exitCode: null,
+            blocked: false,
+            error: "Prompt hook requires explicit model"
+        };
+    }
+    if (!promptModel) {
+        return {
+            hook,
+            output: "",
+            exitCode: null,
+            blocked: false,
+            error: "Prompt hook requires a model runner"
+        };
+    }
+    const prompt = hook.prompt.replace(/\$ARGUMENTS/g, JSON.stringify(context));
+    const response = await promptModel({
+        model: hook.model,
+        messages: [{
+                role: "user",
+                content: [{ type: "text", text: prompt }]
+            }]
+    });
+    return {
+        hook,
+        output: response.text,
+        exitCode: 0,
+        blocked: false
+    };
+}
+export function matchesHookCondition(condition, context) {
+    if (!condition || !condition.trim()) {
+        return true;
+    }
+    const trimmed = condition.trim();
+    const equality = /^([A-Za-z][A-Za-z0-9_.]*):(.+)$/.exec(trimmed);
+    if (equality) {
+        return hookContextValue(context, equality[1]) === equality[2].trim();
+    }
+    const parsed = /^([A-Za-z0-9_]+)\((.*)\)$/.exec(trimmed);
+    if (parsed) {
+        if (parsed[1] !== context.toolName) {
+            return false;
+        }
+        const selector = parsed[2];
+        if (selector === "*") {
+            return true;
+        }
+        return globMatches(selector, toolSelectorHaystack(context));
+    }
+    return globMatches(trimmed, [
+        context.toolName,
+        context.notificationType,
+        context.source,
+        context.agentType,
+        context.taskSubject,
+        context.filePath,
+        context.event
+    ].filter((value) => typeof value === "string").join(" "));
+}
+async function runCommandHook(hook, context, env = process.env) {
+    return new Promise((resolve, reject) => {
+        let timedOut = false;
+        const child = spawn("bash", ["-lc", hook.command ?? ""], {
+            cwd: context.cwd,
+            env: {
+                ...env,
+                ARGUMENTS: JSON.stringify(context)
+            },
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, hook.timeoutMs ?? 30_000);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (exitCode) => {
+            clearTimeout(timer);
+            resolve({
+                hook,
+                output: timedOut ? `Hook timed out after ${hook.timeoutMs ?? 30_000}ms` : stdout.trimEnd() || stderr.trimEnd(),
+                exitCode,
+                blocked: exitCode === 2,
+                timedOut
+            });
+        });
+    });
+}
+async function runHttpHook(hook, context, env = process.env) {
+    if (!hook.url) {
+        return {
+            hook,
+            output: "",
+            exitCode: null,
+            blocked: false,
+            error: "HTTP hook requires url"
+        };
+    }
+    const timeoutMs = hook.timeoutMs ?? 30_000;
+    const controller = new AbortController();
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+    }, timeoutMs);
+    try {
+        const response = await fetch(hook.url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...interpolateHeaders(hook, env)
+            },
+            body: JSON.stringify(context),
+            signal: controller.signal
+        });
+        const output = await response.text();
+        return {
+            hook,
+            output,
+            exitCode: response.ok ? 0 : 1,
+            blocked: response.status === 403,
+            status: response.status
+        };
+    }
+    catch (error) {
+        if (timedOut) {
+            return {
+                hook,
+                output: `Hook timed out after ${timeoutMs}ms`,
+                exitCode: null,
+                blocked: false,
+                timedOut: true,
+                error: "HTTP hook timed out"
+            };
+        }
+        return {
+            hook,
+            output: "",
+            exitCode: null,
+            blocked: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function unsupportedHookResult(hook) {
+    return {
+        hook,
+        output: "",
+        exitCode: null,
+        blocked: false,
+        error: `Hook type ${hook.type} is not implemented`
+    };
+}
+function interpolateHeaders(hook, env) {
+    const headers = {};
+    for (const [key, value] of Object.entries(hook.headers ?? {})) {
+        headers[key] = value.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_match, name) => {
+            if (!isAllowedHeaderEnv(name, hook.allowedEnvVars)) {
+                return "";
+            }
+            return env[name] ?? "";
+        });
+    }
+    return headers;
+}
+function isAllowedHeaderEnv(name, allowedEnvVars) {
+    return name.startsWith("MAGI_") || (allowedEnvVars ?? []).includes(name);
+}
+function escapeRegExp(value) {
+    return value.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
+}
+function toolSelectorHaystack(context) {
+    return String(context.toolInput?.command
+        ?? context.toolInput?.file_path
+        ?? context.toolInput?.filePath
+        ?? context.toolInput?.pattern
+        ?? context.toolInput?.url
+        ?? context.toolInput?.setting
+        ?? context.toolInput?.skill
+        ?? context.toolInput?.query
+        ?? "");
+}
+function hookContextValue(context, key) {
+    const value = key.split(".").reduce((current, part) => {
+        if (typeof current !== "object" || current === null || Array.isArray(current)) {
+            return undefined;
+        }
+        return current[part];
+    }, context);
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return undefined;
+}
+function globMatches(pattern, value) {
+    const regex = new RegExp(`^${pattern.split("*").map(escapeRegExp).join(".*")}$`);
+    return regex.test(value);
+}
+//# sourceMappingURL=runner.js.map

package/dist/hooks/runner.js.map

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

package/dist/hooks/trigger.d.ts

@@ -0,0 +1,9 @@
+import { HookEvent, HookDefinition } from "../config.js";
+import { HookContext } from "./runner.js";
+export interface TriggerHookInput {
+    event: HookEvent;
+    hooks: HookDefinition[];
+    context: Partial<HookContext>;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function triggerHook(input: TriggerHookInput): Promise<void>;

package/dist/hooks/trigger.js

@@ -0,0 +1,18 @@
+import { executeHooks } from "./runner.js";
+export async function triggerHook(input) {
+    if (!input.hooks || input.hooks.length === 0) {
+        return;
+    }
+    const context = {
+        sessionId: input.context.sessionId ?? "",
+        cwd: input.context.cwd ?? process.cwd(),
+        ...input.context
+    };
+    await executeHooks({
+        event: input.event,
+        hooks: input.hooks,
+        context,
+        env: input.env
+    });
+}
+//# sourceMappingURL=trigger.js.map

package/dist/hooks/trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.js","sourceRoot":"","sources":["../../src/hooks/trigger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AASxD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAgB;QAC3B,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE;QACxC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACvC,GAAG,KAAK,CAAC,OAAO;KACjB,CAAC;IAEF,MAAM,YAAY,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO;QACP,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+export * from "./cli.js";
+export * from "./agents/roles.js";
+export * from "./agents/task-queue.js";
+export * from "./agent/headless-agent.js";
+export * from "./agent/local-plan.js";
+export * from "./agent/query-engine.js";
+export * from "./agent/query.js";
+export * from "./agent/system-prompt.js";
+export * from "./agent/tools.js";
+export * from "./config.js";
+export * from "./control/auth.js";
+export * from "./control/server.js";
+export * from "./context/compaction.js";
+export * from "./context/token-budget.js";
+export * from "./doctor.js";
+export * from "./events.js";
+export * from "./headless.js";
+export * from "./hooks/events.js";
+export * from "./hooks/runner.js";
+export * from "./interactions.js";
+export * from "./memory.js";
+export * from "./mcp/approval.js";
+export * from "./mcp/client.js";
+export * from "./mcp/types.js";
+export * from "./paths.js";
+export * from "./providers/errors.js";
+export * from "./providers/ir.js";
+export * from "./providers/messages-compatible.js";
+export * from "./providers/openai.js";
+export * from "./providers/registry.js";
+export * from "./plugins/manifest.js";
+export * from "./plugins/marketplace.js";
+export * from "./routing/model-alias.js";
+export * from "./routing/router.js";
+export * from "./runner/client.js";
+export * from "./rules/agents-loader.js";
+export * from "./skills/loader.js";
+export * from "./session-store.js";
+export * from "./slash.js";
+export * from "./tools/errors.js";
+export * from "./tools/config-tool.js";
+export * from "./tools/files.js";
+export * from "./tools/git.js";
+export * from "./tools/registry.js";
+export * from "./tools/search.js";
+export * from "./tools/shell.js";
+export * from "./tools/skill-tool.js";
+export * from "./tools/todo.js";
+export * from "./tools/tasks.js";
+export * from "./tools/plan-mode.js";
+export * from "./tools/worktree.js";
+export * from "./tools/github.js";
+export * from "./tools/agent-tool.js";
+export * from "./tools/notebook.js";
+export * from "./tools/tool-search.js";
+export * from "./tools/web-search.js";
+export * from "./tools/workspace-diagnostics.js";
+export * from "./tools/workspace.js";
+export * from "./tui.js";
+export * from "./version.js";
+export * from "./web/panel.js";

package/dist/index.js

@@ -0,0 +1,62 @@
+export * from "./cli.js";
+export * from "./agents/roles.js";
+export * from "./agents/task-queue.js";
+export * from "./agent/headless-agent.js";
+export * from "./agent/local-plan.js";
+export * from "./agent/query-engine.js";
+export * from "./agent/query.js";
+export * from "./agent/system-prompt.js";
+export * from "./agent/tools.js";
+export * from "./config.js";
+export * from "./control/auth.js";
+export * from "./control/server.js";
+export * from "./context/compaction.js";
+export * from "./context/token-budget.js";
+export * from "./doctor.js";
+export * from "./events.js";
+export * from "./headless.js";
+export * from "./hooks/events.js";
+export * from "./hooks/runner.js";
+export * from "./interactions.js";
+export * from "./memory.js";
+export * from "./mcp/approval.js";
+export * from "./mcp/client.js";
+export * from "./mcp/types.js";
+export * from "./paths.js";
+export * from "./providers/errors.js";
+export * from "./providers/ir.js";
+export * from "./providers/messages-compatible.js";
+export * from "./providers/openai.js";
+export * from "./providers/registry.js";
+export * from "./plugins/manifest.js";
+export * from "./plugins/marketplace.js";
+export * from "./routing/model-alias.js";
+export * from "./routing/router.js";
+export * from "./runner/client.js";
+export * from "./rules/agents-loader.js";
+export * from "./skills/loader.js";
+export * from "./session-store.js";
+export * from "./slash.js";
+export * from "./tools/errors.js";
+export * from "./tools/config-tool.js";
+export * from "./tools/files.js";
+export * from "./tools/git.js";
+export * from "./tools/registry.js";
+export * from "./tools/search.js";
+export * from "./tools/shell.js";
+export * from "./tools/skill-tool.js";
+export * from "./tools/todo.js";
+export * from "./tools/tasks.js";
+export * from "./tools/plan-mode.js";
+export * from "./tools/worktree.js";
+export * from "./tools/github.js";
+export * from "./tools/agent-tool.js";
+export * from "./tools/notebook.js";
+export * from "./tools/tool-search.js";
+export * from "./tools/web-search.js";
+export * from "./tools/workspace-diagnostics.js";
+export * from "./tools/workspace.js";
+export * from "./tui.js";
+export * from "./version.js";
+export * from "./web/panel.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,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/interactions.d.ts

@@ -0,0 +1,102 @@
+import { MagiToolUsePart } from "./providers/ir.js";
+import { AskUserQuestionAnswer, AskUserQuestionRequest } from "./tools/user-question.js";
+export type ActiveInteractionKind = "approval" | "question";
+export type ActiveInteractionStatus = "pending" | "resolved" | "timeout" | "cancelled";
+export interface ActiveInteractionView {
+    kind: ActiveInteractionKind;
+    status: ActiveInteractionStatus;
+    sessionId: string;
+    jobId: string;
+    toolUseId: string;
+    toolName: string;
+    createdAt: string;
+    updatedAt: string;
+    timeoutAt?: string;
+    reason?: string;
+    toolUse: MagiToolUsePart;
+    question?: AskUserQuestionRequest;
+    approved?: boolean;
+    answer?: AskUserQuestionAnswer;
+    cancelReason?: string;
+}
+export declare class ActiveInteractionTimeoutError extends Error {
+    readonly status: "timeout";
+    constructor(message: string);
+}
+export declare class ActiveInteractionCancelledError extends Error {
+    readonly status: "cancelled";
+    constructor(message: string);
+}
+export declare class ActiveInteractionNotFoundError extends Error {
+    constructor(message: string);
+}
+export declare class ActiveInteractionStateError extends Error {
+    constructor(message: string);
+}
+export declare class ActiveInteractionRegistry {
+    private readonly defaultTimeoutMs;
+    private readonly activeJobs;
+    private readonly interactions;
+    constructor(input?: {
+        timeoutMs?: number;
+    });
+    registerJob(input: {
+        sessionId: string;
+        jobId: string;
+    }): void;
+    unregisterJob(jobId: string, reason?: string): void;
+    isJobActive(jobId: string): boolean;
+    listInteractions(input?: {
+        jobId?: string;
+        status?: ActiveInteractionStatus;
+        kind?: ActiveInteractionKind;
+    }): ActiveInteractionView[];
+    getInteraction(input: {
+        jobId: string;
+        toolUseId: string;
+    }): ActiveInteractionView | undefined;
+    getPendingQuestion(input: {
+        jobId: string;
+        toolUseId: string;
+    }): ActiveInteractionView & {
+        kind: "question";
+        question: AskUserQuestionRequest;
+    };
+    waitForApproval(input: {
+        sessionId: string;
+        jobId: string;
+        toolUse: MagiToolUsePart;
+        reason: string;
+        timeoutMs?: number;
+    }): Promise<boolean>;
+    waitForQuestion(input: {
+        sessionId: string;
+        jobId: string;
+        toolUse: MagiToolUsePart;
+        question: AskUserQuestionRequest;
+        timeoutMs?: number;
+    }): Promise<AskUserQuestionAnswer>;
+    resolveApproval(input: {
+        jobId: string;
+        toolUseId: string;
+        approved: boolean;
+    }): ActiveInteractionView;
+    resolveQuestion(input: {
+        jobId: string;
+        toolUseId: string;
+        answer: AskUserQuestionAnswer;
+    }): ActiveInteractionView;
+    cancelInteraction(input: {
+        jobId: string;
+        toolUseId: string;
+        reason?: string;
+    }): ActiveInteractionView;
+    close(reason?: string): void;
+    private ensureJob;
+    private createTimeoutTimer;
+    private getPending;
+    private clearTimer;
+    private cancelPendingInteraction;
+    private key;
+}
+export declare function interactionErrorStatus(error: unknown): ActiveInteractionStatus | undefined;