aec-agent 1.0.3 → 1.0.4

package/dist/components/multi-agent-orchestration/agent/command-manager/command-manager.d.ts

@@ -0,0 +1,75 @@
+import type { EventBus } from "../../../event-handler/types.js";
+import type { AgentCommands, CommandAvailabilityContext, CommandInfo, CommandInvocation, CommandResult, CommandSource, CommandSpec, RegisterCommandOptions } from "./types.js";
+/** A host's commands (AgentCore.useCommand), shared by every agent of the host. */
+export interface HostCommand {
+    spec: CommandSpec;
+    options?: RegisterCommandOptions;
+}
+export interface CommandManagerDeps {
+    agentId: string;
+    eventBus: EventBus;
+    /** The built-in commands (built-in-commands.ts), made with this agent's managers. */
+    builtIns: BuiltInCommand[];
+    /** The host's commands, read on every call so a later AgentCore.useCommand applies. */
+    getHostCommands?: () => readonly HostCommand[];
+    /** A-136: is a turn running in the session? (the conversation manager's) */
+    isBusy: (sessionId: string) => boolean;
+}
+/** A built-in command; `replaceable` ones (/usage) may be replaced by a host or agent command. */
+export interface BuiltInCommand extends CommandSpec {
+    replaceable?: boolean;
+}
+/** A registered command and where it came from. */
+export interface CommandEntry {
+    spec: CommandSpec;
+    source: CommandSource;
+}
+type Entry = CommandEntry;
+/**
+ * A-136: an agent's slash commands — the registry, the parser and the dispatcher, shared by
+ * every client (the web app through the server, chat apps through the ChannelManager).
+ *
+ *  - Registry: the built-ins (built-in-commands.ts), the host's (AgentCore.useCommand) and the
+ *    agent's own (agent.commands.register). Names and aliases are unique across all three;
+ *    a clash throws CommandError "conflict" (a host or agent command may replace only a
+ *    built-in marked replaceable, with { replace: true }).
+ *  - Parsing: a command only at the start of the text ("/name args"); arguments are matched
+ *    to the spec (required ones, fixed choices, a free-text rest).
+ *  - Dispatch: availability in the client (capabilities), the busy rule (whileBusy), then
+ *    the handler — or, for a prompt command, a "send-prompt" action. User errors (unknown
+ *    command, bad arguments, unavailable, busy) come back as CommandResult.error; nothing
+ *    throws. Every run emits CommandExecuted.
+ */
+export declare class CommandManager implements AgentCommands {
+    private deps;
+    private own;
+    private ownOptions;
+    constructor(deps: CommandManagerDeps);
+    list(context?: Partial<CommandAvailabilityContext>): CommandInfo[];
+    get(name: string, context?: Partial<CommandAvailabilityContext>): CommandInfo | undefined;
+    register(spec: CommandSpec, options?: RegisterCommandOptions): void;
+    unregister(name: string): boolean;
+    isCommand(text: string): boolean;
+    run(text: string, invocation: CommandInvocation): Promise<CommandResult>;
+    private dispatch;
+    /**
+     * Every command, in order: built-ins (or what replaced them), then the host's, then the
+     * agent's. A host or agent command registered with { replace: true } takes the place of
+     * the replaceable built-in of the same name.
+     */
+    private entries;
+    private find;
+    /** The nearest command name (edit distance ≤ 2, or a prefix match), for "did you mean". */
+    private closest;
+}
+/** Checks a spec's name, aliases and handler. Throws CommandError "invalid". */
+export declare function validateSpec(spec: CommandSpec): void;
+/**
+ * Throws CommandError "conflict" when `spec`'s name or an alias is taken by one of `entries`
+ * — unless it replaces a replaceable built-in of the same name with { replace: true }.
+ */
+export declare function checkClash(spec: CommandSpec, options: RegisterCommandOptions | undefined, entries: readonly Entry[], source: CommandSource): void;
+/** e.g. "/compact [focus]", "/rename <name>", "/permissions [ask|yolo|plan]". */
+export declare function usageOf(spec: CommandSpec): string;
+export {};
+//# sourceMappingURL=command-manager.d.ts.map

package/dist/components/multi-agent-orchestration/agent/command-manager/command-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/command-manager/command-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE,OAAO,KAAK,EACV,aAAa,EACb,0BAA0B,EAE1B,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,WAAW,EACX,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,qFAAqF;IACrF,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,SAAS,WAAW,EAAE,CAAC;IAC/C,4EAA4E;IAC5E,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED,kGAAkG;AAClG,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;CACvB;AACD,KAAK,KAAK,GAAG,YAAY,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,aAAa;IAItC,OAAO,CAAC,IAAI;IAHxB,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,UAAU,CAAyD;IAE3E,YAAoB,IAAI,EAAE,kBAAkB,EAE3C;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,WAAW,EAAE,CAGjE;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,WAAW,GAAG,SAAS,CAGxF;IAED,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CASlE;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhC;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/B;IAEK,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmB7E;YAEa,QAAQ;IAqDtB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,IAAI;IAKZ,2FAA2F;IAC3F,OAAO,CAAC,OAAO;CAUhB;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAgBpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAAG,SAAS,EAC3C,OAAO,EAAE,SAAS,KAAK,EAAE,EACzB,MAAM,EAAE,aAAa,GACpB,IAAI,CAoBN;AAkCD,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAMjD"}

package/dist/components/multi-agent-orchestration/agent/command-manager/command-manager.js

@@ -0,0 +1,299 @@
+import { CommandError } from "../../../../kernel/errors/command-error.js";
+import { SDKEventType } from "../../../event-handler/events.js";
+import { COMMAND_NAME_RE, parseCommand } from "./parse.js";
+/**
+ * A-136: an agent's slash commands — the registry, the parser and the dispatcher, shared by
+ * every client (the web app through the server, chat apps through the ChannelManager).
+ *
+ *  - Registry: the built-ins (built-in-commands.ts), the host's (AgentCore.useCommand) and the
+ *    agent's own (agent.commands.register). Names and aliases are unique across all three;
+ *    a clash throws CommandError "conflict" (a host or agent command may replace only a
+ *    built-in marked replaceable, with { replace: true }).
+ *  - Parsing: a command only at the start of the text ("/name args"); arguments are matched
+ *    to the spec (required ones, fixed choices, a free-text rest).
+ *  - Dispatch: availability in the client (capabilities), the busy rule (whileBusy), then
+ *    the handler — or, for a prompt command, a "send-prompt" action. User errors (unknown
+ *    command, bad arguments, unavailable, busy) come back as CommandResult.error; nothing
+ *    throws. Every run emits CommandExecuted.
+ */
+export class CommandManager {
+    deps;
+    own = new Map();
+    ownOptions = new Map();
+    constructor(deps) {
+        this.deps = deps;
+        for (const spec of deps.builtIns)
+            validateSpec(spec);
+    }
+    list(context) {
+        const ctx = availabilityContext(context);
+        return this.entries().map((e) => info(e, ctx));
+    }
+    get(name, context) {
+        const entry = this.find(name.replace(/^\//, "").toLowerCase());
+        return entry ? info(entry, availabilityContext(context)) : undefined;
+    }
+    register(spec, options) {
+        validateSpec(spec);
+        if (this.own.has(spec.name)) {
+            throw new CommandError(`The agent already has a command "/${spec.name}"`, "conflict");
+        }
+        // Checked against everything registered so far, the agent's own commands included.
+        checkClash(spec, options, this.entries(), "agent");
+        this.own.set(spec.name, { spec, source: "agent" });
+        this.ownOptions.set(spec.name, options);
+    }
+    unregister(name) {
+        this.ownOptions.delete(name);
+        return this.own.delete(name);
+    }
+    isCommand(text) {
+        const parsed = parseCommand(text);
+        return parsed !== null && this.find(parsed.name) !== undefined;
+    }
+    async run(text, invocation) {
+        const parsed = parseCommand(text);
+        if (!parsed) {
+            return { text: "Commands start with \"/\", e.g. /help.", error: "not_a_command" };
+        }
+        const result = await this.dispatch(parsed.name, parsed.args, invocation);
+        this.deps.eventBus.emit({
+            type: SDKEventType.CommandExecuted,
+            sessionId: invocation.sessionId,
+            payload: {
+                agentId: this.deps.agentId,
+                sessionId: invocation.sessionId,
+                name: this.find(parsed.name)?.spec.name ?? parsed.name,
+                client: invocation.client,
+                ok: result.error === undefined,
+                ...(result.error ? { error: result.error } : {}),
+            },
+        });
+        return result;
+    }
+    async dispatch(name, args, invocation) {
+        const entry = this.find(name);
+        if (!entry) {
+            const near = this.closest(name);
+            return {
+                text: `There is no command /${name}.${near ? ` Did you mean /${near}?` : ""} Send /help to see the commands.`,
+                error: "unknown_command",
+            };
+        }
+        const { spec } = entry;
+        const ctx = availabilityContext(invocation);
+        const unavailable = unavailableReason(spec, ctx);
+        if (unavailable)
+            return { text: `/${spec.name} isn't available here: ${unavailable}.`, error: "unavailable" };
+        const argv = matchArguments(spec, args);
+        if (typeof argv === "string")
+            return { text: `${argv} Usage: ${usageOf(spec)}`, error: "invalid_arguments" };
+        if (spec.whileBusy === "refuse" && this.deps.isBusy(invocation.sessionId)) {
+            return {
+                text: `A reply is running in this conversation. Send /${spec.name} again when it has finished, or stop it first.`,
+                error: "busy",
+            };
+        }
+        if (spec.prompt !== undefined) {
+            return {
+                text: `Running /${spec.name}…`,
+                action: {
+                    type: "send-prompt",
+                    prompt: spec.prompt.split("$ARGUMENTS").join(args),
+                    ...(spec.readOnly ? { readOnly: true } : {}),
+                },
+            };
+        }
+        const context = {
+            ...ctx,
+            agentId: this.deps.agentId,
+            sessionId: invocation.sessionId,
+            name: spec.name,
+            args,
+            argv,
+            confirmed: invocation.confirmed === true,
+            ...(invocation.sessionScope ? { sessionScope: invocation.sessionScope } : {}),
+            ...(invocation.signal ? { signal: invocation.signal } : {}),
+        };
+        try {
+            return await spec.run(context);
+        }
+        catch (err) {
+            return { text: `/${spec.name} failed: ${err instanceof Error ? err.message : String(err)}`, error: "failed" };
+        }
+    }
+    /**
+     * Every command, in order: built-ins (or what replaced them), then the host's, then the
+     * agent's. A host or agent command registered with { replace: true } takes the place of
+     * the replaceable built-in of the same name.
+     */
+    entries() {
+        const host = this.deps.getHostCommands?.() ?? [];
+        const replacing = new Map();
+        for (const h of host)
+            if (h.options?.replace)
+                replacing.set(h.spec.name, { spec: h.spec, source: "host" });
+        for (const [name, e] of this.own)
+            if (this.ownOptions.get(name)?.replace)
+                replacing.set(name, e);
+        const out = [];
+        for (const spec of this.deps.builtIns) {
+            out.push(spec.replaceable && replacing.has(spec.name) ? replacing.get(spec.name) : { spec, source: "built-in" });
+        }
+        const builtInNames = new Set(this.deps.builtIns.map((b) => b.name));
+        for (const h of host)
+            if (!builtInNames.has(h.spec.name))
+                out.push({ spec: h.spec, source: "host" });
+        for (const e of this.own.values()) {
+            if (!builtInNames.has(e.spec.name) && !host.some((h) => h.spec.name === e.spec.name))
+                out.push(e);
+        }
+        return out;
+    }
+    find(name) {
+        const entries = this.entries();
+        return entries.find((e) => e.spec.name === name) ?? entries.find((e) => e.spec.aliases?.includes(name));
+    }
+    /** The nearest command name (edit distance ≤ 2, or a prefix match), for "did you mean". */
+    closest(name) {
+        let best;
+        for (const e of this.entries()) {
+            for (const n of [e.spec.name, ...(e.spec.aliases ?? [])]) {
+                const d = n.startsWith(name) ? 1 : distance(name, n);
+                if (d <= 2 && (!best || d < best.d))
+                    best = { name: e.spec.name, d };
+            }
+        }
+        return best?.name;
+    }
+}
+/** Checks a spec's name, aliases and handler. Throws CommandError "invalid". */
+export function validateSpec(spec) {
+    for (const n of [spec.name, ...(spec.aliases ?? [])]) {
+        if (typeof n !== "string" || !COMMAND_NAME_RE.test(n)) {
+            throw new CommandError(`Invalid command name "${n}": use lower-case letters, digits, "_" and "-" (at most 32, starting with a letter or digit)`, "invalid");
+        }
+    }
+    if ((spec.run === undefined) === (spec.prompt === undefined)) {
+        throw new CommandError(`Command "/${spec.name}" needs exactly one of run and prompt`, "invalid");
+    }
+    const args = spec.arguments ?? [];
+    if (args.slice(0, -1).some((a) => a.rest)) {
+        throw new CommandError(`Command "/${spec.name}": only the last argument can take the rest of the line`, "invalid");
+    }
+}
+/**
+ * Throws CommandError "conflict" when `spec`'s name or an alias is taken by one of `entries`
+ * — unless it replaces a replaceable built-in of the same name with { replace: true }.
+ */
+export function checkClash(spec, options, entries, source) {
+    const names = [spec.name, ...(spec.aliases ?? [])];
+    for (const e of entries) {
+        const taken = [e.spec.name, ...(e.spec.aliases ?? [])];
+        const clash = names.find((n) => taken.includes(n));
+        if (!clash)
+            continue;
+        const replaces = options?.replace === true &&
+            e.source === "built-in" &&
+            e.spec.replaceable === true &&
+            e.spec.name === spec.name;
+        if (replaces)
+            continue;
+        if (options?.replace && e.spec.name === spec.name) {
+            throw new CommandError(`/${spec.name} can't be replaced`, "conflict");
+        }
+        throw new CommandError(`/${clash} is already a ${e.source === "built-in" ? "built-in" : e.source === "host" ? "host" : "agent"} command${e.spec.name !== clash ? ` (an alias of /${e.spec.name})` : ""}; ${source} commands need their own names`, "conflict");
+    }
+}
+function availabilityContext(context) {
+    return { client: context?.client ?? "api", capabilities: context?.capabilities ?? [] };
+}
+function unavailableReason(spec, ctx) {
+    const missing = (spec.requires ?? []).filter((c) => !ctx.capabilities.includes(c));
+    if (missing.length > 0) {
+        return missing.includes("clipboard")
+            ? "this app can't copy to your clipboard"
+            : missing.includes("exit")
+                ? "there is nothing to exit in this app — close it, or start a new conversation with /clear"
+                : `it needs ${missing.join(", ")}`;
+    }
+    return spec.available?.(ctx);
+}
+function info(entry, ctx) {
+    const { spec, source } = entry;
+    const reason = unavailableReason(spec, ctx);
+    return {
+        name: spec.name,
+        aliases: spec.aliases ?? [],
+        description: spec.description,
+        usage: usageOf(spec),
+        arguments: spec.arguments ?? [],
+        safety: spec.safety,
+        source,
+        available: reason === undefined,
+        ...(reason ? { unavailableReason: reason } : {}),
+    };
+}
+/** e.g. "/compact [focus]", "/rename <name>", "/permissions [ask|yolo|plan]". */
+export function usageOf(spec) {
+    const parts = (spec.arguments ?? []).map((a) => {
+        const label = a.choices?.length ? a.choices.join("|") : a.name;
+        return a.required ? `<${label}>` : `[${label}]`;
+    });
+    return [`/${spec.name}`, ...parts].join(" ");
+}
+/** The text after the command matched to the spec's arguments, or why it does not fit. */
+function matchArguments(spec, args) {
+    // No declared arguments: any text goes to the command as it is.
+    if (spec.arguments === undefined)
+        return {};
+    const defs = spec.arguments;
+    const argv = {};
+    let rest = args.trim();
+    for (const def of defs) {
+        if (!rest) {
+            if (def.required)
+                return `/${spec.name} needs ${article(def.name)} ${def.name}.`;
+            continue;
+        }
+        let value;
+        if (def.rest) {
+            value = rest;
+            rest = "";
+        }
+        else {
+            const m = /^(\S+)\s*([\s\S]*)$/.exec(rest);
+            value = m[1];
+            rest = m[2];
+        }
+        if (def.choices?.length) {
+            const choice = def.choices.find((c) => c.toLowerCase() === value.toLowerCase());
+            if (!choice)
+                return `"${value}" isn't one of ${def.choices.join(", ")}.`;
+            value = choice;
+        }
+        argv[def.name] = value;
+    }
+    if (rest) {
+        return defs.length === 0 ? `/${spec.name} takes no arguments.` : `Unexpected "${rest}".`;
+    }
+    return argv;
+}
+function article(word) {
+    return /^[aeiou]/i.test(word) ? "an" : "a";
+}
+/** Levenshtein distance (short names only). */
+function distance(a, b) {
+    const row = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        let prev = row[0];
+        row[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const cur = row[j];
+            row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+            prev = cur;
+        }
+    }
+    return row[b.length];
+}
+//# sourceMappingURL=command-manager.js.map

package/dist/components/multi-agent-orchestration/agent/command-manager/command-manager.js.map

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

package/dist/components/multi-agent-orchestration/agent/command-manager/parse.d.ts

@@ -0,0 +1,17 @@
+export interface ParsedCommand {
+    /** Lower-case, without "/". */
+    name: string;
+    /** Text after the command, trimmed. */
+    args: string;
+    /** "@bot" the command was addressed to ("/new@my_bot"), without "@". */
+    target?: string;
+}
+/** A command or alias name: lower-case letters, digits, "_" and "-", starting with a letter or digit, at most 32. */
+export declare const COMMAND_NAME_RE: RegExp;
+/**
+ * Read "/name[@bot] args" — only at the start of the text. Null when `text` is not a
+ * command ("/path/to/file" is not: the name must end at a space or the end).
+ * A-136: names may contain "-" (custom commands, skills such as /web-research).
+ */
+export declare function parseCommand(text: string): ParsedCommand | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/components/multi-agent-orchestration/agent/command-manager/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/command-manager/parse.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qHAAqH;AACrH,eAAO,MAAM,eAAe,QAA+B,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQ/D"}

package/dist/components/multi-agent-orchestration/agent/command-manager/parse.js

@@ -0,0 +1,19 @@
+// A-136: reading slash commands — shared by the CommandManager and the chat-app channels.
+/** A command or alias name: lower-case letters, digits, "_" and "-", starting with a letter or digit, at most 32. */
+export const COMMAND_NAME_RE = /^[a-z0-9][a-z0-9_-]{0,31}$/;
+/**
+ * Read "/name[@bot] args" — only at the start of the text. Null when `text` is not a
+ * command ("/path/to/file" is not: the name must end at a space or the end).
+ * A-136: names may contain "-" (custom commands, skills such as /web-research).
+ */
+export function parseCommand(text) {
+    const match = /^\/([A-Za-z0-9][A-Za-z0-9_-]{0,31})(?:@([A-Za-z0-9_]+))?(?:\s+([\s\S]*))?$/.exec(text.trim());
+    if (!match)
+        return null;
+    return {
+        name: match[1].toLowerCase(),
+        args: (match[3] ?? "").trim(),
+        ...(match[2] ? { target: match[2] } : {}),
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/components/multi-agent-orchestration/agent/command-manager/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/command-manager/parse.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAW1F,qHAAqH;AACrH,MAAM,CAAC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,4EAA4E,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7G,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE;QAC7B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC7B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/components/multi-agent-orchestration/agent/command-manager/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * What running a command can do, for confirmation and access checks:
+ *  - "read-only": only reads (/help, /status, /context, /usage, /diff). Never changes
+ *    files or session data.
+ *  - "session": changes this conversation (/clear, /compact, /rename, /model, /resume).
+ *  - "privileged": can widen what the agent may do without asking (/permissions yolo).
+ *    A client confirms it first (CommandInvocation.confirmed); a chat app lets only the
+ *    bot's owners run it.
+ */
+export type CommandSafety = "read-only" | "session" | "privileged";
+/**
+ * A-136: what a client can do itself — a command that needs one is offered only where
+ * the client says it has it (CommandInvocation.capabilities).
+ *  - "clipboard": copy text for the user (/copy).
+ *  - "exit": close the client (/exit).
+ */
+export type ClientCapability = "clipboard" | "exit";
+/** One argument of a command — for usage text, autocomplete and validation. */
+export interface CommandArgument {
+    name: string;
+    description?: string;
+    /** Default false. A missing required argument is an "invalid_arguments" error. */
+    required?: boolean;
+    /** The only accepted values (matched case-insensitively), when there is a fixed set. */
+    choices?: string[];
+    /** Takes the rest of the line (free text, e.g. /compact <focus>). Only the last argument. */
+    rest?: boolean;
+}
+/** A command: its metadata (help, autocomplete) and either a handler or a prompt template. */
+export interface CommandSpec {
+    /** Lower-case letters, digits, "_" and "-", at most 32; without "/". */
+    name: string;
+    /** Other names that run it (/new and /reset for /clear). Same rules as name. */
+    aliases?: string[];
+    /** One line, for /help and the "/" menu. */
+    description: string;
+    /**
+     * The arguments, checked before the command runs. Omitted = any text is accepted as it is
+     * (CommandContext.args, a prompt command's $ARGUMENTS); [] = the command takes none.
+     */
+    arguments?: CommandArgument[];
+    /** Required: a command that changes anything must say so. */
+    safety: CommandSafety;
+    /**
+     * What to do when a turn is running in the conversation: "run" (default) runs it at once;
+     * "refuse" answers that the conversation is busy (/compact must not change the working
+     * set under a running turn).
+     */
+    whileBusy?: "run" | "refuse";
+    /** Client capabilities it needs; it is unavailable in a client without them. */
+    requires?: ClientCapability[];
+    /** Further availability check; return why it is unavailable, or undefined when it is. */
+    available?: (context: CommandAvailabilityContext) => string | undefined;
+    /**
+     * Run the command. Exactly one of run and prompt. A thrown error becomes a "failed" result
+     * with the error's message.
+     */
+    run?: (context: CommandContext) => Promise<CommandResult> | CommandResult;
+    /**
+     * A prompt command: running it sends this text as the user's next message (CommandResult
+     * action "send-prompt"). "$ARGUMENTS" is replaced with the text after the command.
+     */
+    prompt?: string;
+    /** For a prompt command: run the turn read-only (plan mode). */
+    readOnly?: boolean;
+}
+export interface CommandAvailabilityContext {
+    /** The client running it ("web", "channel", "api"...). */
+    client: string;
+    capabilities: readonly ClientCapability[];
+}
+/** One command run: what the user typed and where. */
+export interface CommandInvocation {
+    /** The conversation the command was typed in. */
+    sessionId: string;
+    /** The client running it, e.g. "web" or "channel" (reported in CommandExecuted, checked by `available`). */
+    client: string;
+    /** What the client can do itself (default none). */
+    capabilities?: readonly ClientCapability[];
+    /**
+     * The user confirmed a privileged action (a dialog in the web app). Without it a
+     * privileged action answers with a "confirm" result instead of running.
+     */
+    confirmed?: boolean;
+    /**
+     * Metadata the sessions of this client share (web: { agentId }, a chat: its channel and
+     * chat key) — /resume lists only those. Absent = every session of the agent.
+     */
+    sessionScope?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+/** What a command's handler gets. */
+export interface CommandContext extends CommandAvailabilityContext {
+    agentId: string;
+    sessionId: string;
+    /** The canonical name (an alias resolved). */
+    name: string;
+    /** The text after the command, trimmed. */
+    args: string;
+    /** `args` matched to the spec's arguments (validated: required ones are there, choices hold). */
+    argv: Record<string, string>;
+    confirmed: boolean;
+    sessionScope?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+/** What the client should do after showing a command's text. */
+export type CommandAction = 
+/** Switch to this conversation (/clear made it, /resume picked it). */
+{
+    type: "open-session";
+    sessionId: string;
+}
+/** Send this as the user's next message in the conversation (/init, /review, /plan <prompt>). */
+ | {
+    type: "send-prompt";
+    prompt: string;
+    readOnly?: boolean;
+}
+/** Copy this text (/copy). */
+ | {
+    type: "copy";
+    text: string;
+}
+/** Close the client (/exit). */
+ | {
+    type: "exit";
+}
+/**
+ * Ask the user, then run the same command again with CommandInvocation.confirmed
+ * (a privileged action). `text` of the result is the question.
+ */
+ | {
+    type: "confirm";
+    command: string;
+};
+export type CommandErrorCode = 
+/** Not a command at all (no leading "/"). */
+"not_a_command" | "unknown_command" | "invalid_arguments"
+/** Not available in this client (needs a capability it lacks) or for this agent. */
+ | "unavailable"
+/** A turn is running in the conversation and the command can't run under it. */
+ | "busy" | "not_allowed" | "not_found"
+/** The handler threw. */
+ | "failed";
+/** The outcome of a command: text for the user, and maybe something for the client to do. */
+export interface CommandResult {
+    /** Plain text (light Markdown) to show the user. */
+    text: string;
+    action?: CommandAction;
+    /** Set when the command did not do what was asked. */
+    error?: CommandErrorCode;
+}
+/** A command as listed for help and autocomplete. */
+export interface CommandInfo {
+    name: string;
+    aliases: string[];
+    description: string;
+    /** e.g. "/compact [focus]". */
+    usage: string;
+    arguments: CommandArgument[];
+    safety: CommandSafety;
+    /** "built-in", "host" (AgentCore.useCommand) or "agent" (agent.commands.register). */
+    source: CommandSource;
+    /** Can it run in the client that asked (CommandAvailabilityContext)? */
+    available: boolean;
+    /** Why not, when unavailable. */
+    unavailableReason?: string;
+}
+export type CommandSource = "built-in" | "host" | "agent";
+/** Options for registering a command. */
+export interface RegisterCommandOptions {
+    /**
+     * Replace a built-in command of the same name (only those marked replaceable, e.g. /usage,
+     * so a host with token accounting can report it). Default false: a clash throws.
+     */
+    replace?: boolean;
+}
+/** An agent's slash commands (agent.commands). */
+export interface AgentCommands {
+    /** The commands, with their availability in the given client (default: no capabilities). */
+    list(context?: Partial<CommandAvailabilityContext>): CommandInfo[];
+    /** One command by name or alias. */
+    get(name: string, context?: Partial<CommandAvailabilityContext>): CommandInfo | undefined;
+    /**
+     * Add a command to this agent. Throws CommandError "conflict" when its name or an alias
+     * is taken (by a built-in, a host command or another of the agent's), "invalid" for a
+     * bad name or a spec without exactly one of run / prompt.
+     */
+    register(spec: CommandSpec, options?: RegisterCommandOptions): void;
+    /** Remove one of the agent's own commands. False when there is none by that name. */
+    unregister(name: string): boolean;
+    /** Is `text` a command this agent has ("/name ...", a name or alias)? */
+    isCommand(text: string): boolean;
+    /** Run "/name args". Never throws for user errors: they come back as CommandResult.error. */
+    run(text: string, invocation: CommandInvocation): Promise<CommandResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/multi-agent-orchestration/agent/command-manager/types.d.ts.map

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