agentplane 0.1.9 → 0.2.1

package/dist/commands/recipes/impl/scenario.js

@@ -0,0 +1,128 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists, getPathKind } from "../../../cli/fs-utils.js";
+import { invalidFieldMessage, requiredFieldMessage } from "../../../cli/output.js";
+import { isRecord } from "../../../shared/guards.js";
+import { RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME } from "./constants.js";
+import { normalizeScenarioId } from "./normalize.js";
+function validateScenarioDefinition(raw, sourcePath) {
+    if (!isRecord(raw))
+        throw new Error(invalidFieldMessage("scenario", "object", sourcePath));
+    if (raw.schema_version !== undefined && raw.schema_version !== "1") {
+        throw new Error(invalidFieldMessage("scenario.schema_version", '"1"', sourcePath));
+    }
+    const rawId = typeof raw.id === "string" ? raw.id : "";
+    const id = normalizeScenarioId(rawId);
+    const goal = typeof raw.goal === "string" ? raw.goal.trim() : "";
+    if (!goal)
+        throw new Error(requiredFieldMessage("scenario.goal", sourcePath));
+    if (!("inputs" in raw))
+        throw new Error(requiredFieldMessage("scenario.inputs", sourcePath));
+    if (!("outputs" in raw))
+        throw new Error(requiredFieldMessage("scenario.outputs", sourcePath));
+    if (!Array.isArray(raw.steps)) {
+        throw new Error(invalidFieldMessage("scenario.steps", "array", sourcePath));
+    }
+    return {
+        schema_version: "1",
+        id,
+        summary: typeof raw.summary === "string" ? raw.summary.trim() : undefined,
+        description: typeof raw.description === "string" ? raw.description.trim() : undefined,
+        goal,
+        inputs: raw.inputs,
+        outputs: raw.outputs,
+        steps: raw.steps,
+    };
+}
+export async function readScenarioDefinition(filePath) {
+    const raw = JSON.parse(await readFile(filePath, "utf8"));
+    return validateScenarioDefinition(raw, filePath);
+}
+export async function readScenarioIndex(filePath) {
+    const raw = JSON.parse(await readFile(filePath, "utf8"));
+    if (!isRecord(raw))
+        throw new Error(invalidFieldMessage("scenarios index", "object"));
+    if (raw.schema_version !== 1)
+        throw new Error(invalidFieldMessage("scenarios index.schema_version", "1"));
+    if (!Array.isArray(raw.scenarios))
+        throw new Error(invalidFieldMessage("scenarios index.scenarios", "array"));
+    const scenarios = raw.scenarios
+        .filter((entry) => isRecord(entry))
+        .map((entry) => ({
+        id: typeof entry.id === "string" ? entry.id : "",
+        summary: typeof entry.summary === "string" ? entry.summary : undefined,
+    }))
+        .filter((entry) => entry.id);
+    return { schema_version: 1, scenarios };
+}
+export async function collectRecipeScenarioDetails(recipeDir, manifest) {
+    const scenariosDir = path.join(recipeDir, RECIPES_SCENARIOS_DIR_NAME);
+    if ((await getPathKind(scenariosDir)) === "dir") {
+        const files = await readdir(scenariosDir);
+        const jsonFiles = files.filter((file) => file.toLowerCase().endsWith(".json")).toSorted();
+        const details = [];
+        for (const file of jsonFiles) {
+            const scenario = await readScenarioDefinition(path.join(scenariosDir, file));
+            details.push({
+                id: scenario.id,
+                summary: scenario.summary,
+                description: scenario.description,
+                goal: scenario.goal,
+                inputs: scenario.inputs,
+                outputs: scenario.outputs,
+                steps: scenario.steps,
+                source: "definition",
+            });
+        }
+        return details.toSorted((a, b) => a.id.localeCompare(b.id));
+    }
+    const scenariosIndexPath = path.join(recipeDir, RECIPES_SCENARIOS_INDEX_NAME);
+    if (await fileExists(scenariosIndexPath)) {
+        const index = await readScenarioIndex(scenariosIndexPath);
+        return index.scenarios
+            .map((scenario) => ({
+            id: scenario.id,
+            summary: scenario.summary,
+            source: "index",
+        }))
+            .toSorted((a, b) => a.id.localeCompare(b.id));
+    }
+    const manifestScenarios = manifest.scenarios ?? [];
+    if (manifestScenarios.length > 0) {
+        return manifestScenarios
+            .map((scenario) => ({
+            id: scenario?.id ?? "",
+            summary: scenario?.summary,
+            source: "manifest",
+        }))
+            .filter((scenario) => scenario.id)
+            .toSorted((a, b) => a.id.localeCompare(b.id));
+    }
+    return [];
+}
+export function normalizeScenarioToolStep(raw, sourcePath) {
+    if (!isRecord(raw)) {
+        throw new Error(invalidFieldMessage("scenario step", "object", sourcePath));
+    }
+    const tool = typeof raw.tool === "string" ? raw.tool.trim() : "";
+    if (!tool) {
+        throw new Error(requiredFieldMessage("scenario step.tool", sourcePath));
+    }
+    const args = Array.isArray(raw.args) ? raw.args.filter((arg) => typeof arg === "string") : [];
+    if (Array.isArray(raw.args) && args.length !== raw.args.length) {
+        throw new Error(invalidFieldMessage("scenario step.args", "string[]", sourcePath));
+    }
+    const env = {};
+    if (raw.env !== undefined) {
+        if (!isRecord(raw.env)) {
+            throw new Error(invalidFieldMessage("scenario step.env", "object", sourcePath));
+        }
+        for (const [key, value] of Object.entries(raw.env)) {
+            if (typeof value !== "string") {
+                throw new Error(invalidFieldMessage("scenario step.env", "string map", sourcePath));
+            }
+            env[key] = value;
+        }
+    }
+    return { tool, args, env };
+}

package/dist/commands/recipes/impl/types.d.ts

@@ -0,0 +1,107 @@
+export type RecipeManifest = {
+    schema_version: "1";
+    id: string;
+    version: string;
+    name: string;
+    summary: string;
+    description: string;
+    tags?: string[];
+    agents?: {
+        id?: string;
+        summary?: string;
+        file?: string;
+    }[];
+    tools?: {
+        id?: string;
+        summary?: string;
+        runtime?: "node" | "bash";
+        entrypoint?: string;
+        permissions?: string[];
+    }[];
+    scenarios?: {
+        id?: string;
+        summary?: string;
+    }[];
+};
+export type RecipeConflictMode = "fail" | "rename" | "overwrite";
+export type InstalledRecipeEntry = {
+    id: string;
+    version: string;
+    source: string;
+    installed_at: string;
+    tags: string[];
+    manifest: RecipeManifest;
+};
+export type InstalledRecipesFile = {
+    schema_version: 1;
+    updated_at: string;
+    recipes: InstalledRecipeEntry[];
+};
+export type ScenarioDefinition = {
+    schema_version: "1";
+    id: string;
+    summary?: string;
+    description?: string;
+    goal: string;
+    inputs: unknown;
+    outputs: unknown;
+    steps: unknown[];
+};
+export type RecipeScenarioDetail = {
+    id: string;
+    summary?: string;
+    description?: string;
+    goal?: string;
+    inputs?: unknown;
+    outputs?: unknown;
+    steps?: unknown[];
+    source: "definition" | "index" | "manifest";
+};
+export type RecipesIndex = {
+    schema_version: 1;
+    recipes: {
+        id: string;
+        summary: string;
+        description?: string;
+        versions: {
+            version: string;
+            url: string;
+            sha256: string;
+            min_agentplane_version?: string;
+            tags?: string[];
+        }[];
+    }[];
+};
+export type RecipesIndexSignature = {
+    schema_version: 1;
+    key_id: string;
+    signature: string;
+    algorithm?: string;
+};
+export type RecipeInstallSource = {
+    type: "name";
+    value: string;
+} | {
+    type: "path";
+    value: string;
+} | {
+    type: "url";
+    value: string;
+} | {
+    type: "auto";
+    value: string;
+};
+export type RecipeCachePruneFlags = {
+    dryRun: boolean;
+    all: boolean;
+};
+export type RecipeListFlags = {
+    full: boolean;
+    tag?: string;
+};
+export type RecipeListRemoteFlags = {
+    refresh: boolean;
+    index?: string;
+    yes: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/recipes/impl/types.d.ts.map

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

package/dist/commands/recipes/impl/types.js

@@ -0,0 +1 @@
+export {};

package/dist/commands/recipes/info.command.d.ts

@@ -0,0 +1,7 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type RecipesInfoParsed = {
+    id: string;
+};
+export declare const recipesInfoSpec: CommandSpec<RecipesInfoParsed>;
+export declare const runRecipesInfo: CommandHandler<RecipesInfoParsed>;
+//# sourceMappingURL=info.command.d.ts.map

package/dist/commands/recipes/info.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/info.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAO1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CACoB,CAAC"}

package/dist/commands/recipes/info.command.js

@@ -0,0 +1,10 @@
+import { cmdRecipeInfoParsed } from "../recipes.js";
+export const recipesInfoSpec = {
+    id: ["recipes", "info"],
+    group: "Recipes",
+    summary: "Show installed recipe metadata.",
+    args: [{ name: "id", required: true, valueHint: "<id>" }],
+    examples: [{ cmd: "agentplane recipes info viewer", why: "Show recipe metadata." }],
+    parse: (raw) => ({ id: String(raw.args.id ?? "") }),
+};
+export const runRecipesInfo = (ctx, p) => cmdRecipeInfoParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, id: p.id });

package/dist/commands/recipes/install.command.d.ts

@@ -0,0 +1,12 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import { type RecipeConflictMode, type RecipeInstallSource } from "../recipes.js";
+export type RecipesInstallParsed = {
+    source: RecipeInstallSource;
+    index?: string;
+    refresh: boolean;
+    yes: boolean;
+    onConflict: RecipeConflictMode;
+};
+export declare const recipesInstallSpec: CommandSpec<RecipesInstallParsed>;
+export declare const runRecipesInstall: CommandHandler<RecipesInstallParsed>;
+//# sourceMappingURL=install.command.d.ts.map

package/dist/commands/recipes/install.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAItF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpG,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA4IhE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkB7D,CAAC"}

package/dist/commands/recipes/install.command.js

@@ -0,0 +1,161 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { CliError } from "../../shared/errors.js";
+import { cmdRecipeInstall } from "../recipes.js";
+export const recipesInstallSpec = {
+    id: ["recipes", "install"],
+    group: "Recipes",
+    summary: "Install a recipe from remote index, local archive, or URL.",
+    synopsis: [
+        "agentplane recipes install <id|path|url> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
+        "agentplane recipes install --name <id> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
+        "agentplane recipes install --path <path> [--yes] [--on-conflict <fail|rename|overwrite>]",
+        "agentplane recipes install --url <url> [--yes] [--on-conflict <fail|rename|overwrite>]",
+    ],
+    args: [
+        {
+            name: "source",
+            required: false,
+            valueHint: "<id|path|url>",
+            description: "Auto mode: URL if http(s); else PATH if file exists; else NAME (remote index id).",
+        },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "name",
+            valueHint: "<id>",
+            description: "Install from remote index by recipe id.",
+        },
+        {
+            kind: "string",
+            name: "path",
+            valueHint: "<path>",
+            description: "Install from local recipe archive path.",
+        },
+        {
+            kind: "string",
+            name: "url",
+            valueHint: "<url>",
+            description: "Install from recipe archive URL.",
+        },
+        {
+            kind: "string",
+            name: "index",
+            valueHint: "<path|url>",
+            description: "Override recipes index location (used when installing by name / auto-name).",
+        },
+        {
+            kind: "boolean",
+            name: "refresh",
+            default: false,
+            description: "Refresh remote index cache before installing.",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Auto-approve network prompts when allowed by config.",
+        },
+        {
+            kind: "string",
+            name: "on-conflict",
+            valueHint: "<fail|rename|overwrite>",
+            choices: ["fail", "rename", "overwrite"],
+            default: "fail",
+            description: "How to handle conflicts when applying recipe agents.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const explicit = [raw.opts.name, raw.opts.path, raw.opts.url].filter(Boolean).length;
+        const hasPositional = Boolean(raw.args.source);
+        if (explicit + (hasPositional ? 1 : 0) !== 1) {
+            throw usageError({
+                spec: recipesInstallSpec,
+                message: "Exactly one source is required: <source> OR --name OR --path OR --url",
+                command: "recipes install",
+            });
+        }
+    },
+    parse: (raw) => {
+        const onConflict = (raw.opts["on-conflict"] ?? "fail");
+        const refresh = raw.opts.refresh === true;
+        const yes = raw.opts.yes === true;
+        const index = typeof raw.opts.index === "string" ? raw.opts.index : undefined;
+        if (raw.opts.name) {
+            return {
+                source: { type: "name", value: raw.opts.name },
+                index,
+                refresh,
+                yes,
+                onConflict,
+            };
+        }
+        if (raw.opts.path) {
+            return {
+                source: { type: "path", value: raw.opts.path },
+                index,
+                refresh,
+                yes,
+                onConflict,
+            };
+        }
+        if (raw.opts.url) {
+            return {
+                source: { type: "url", value: raw.opts.url },
+                index,
+                refresh,
+                yes,
+                onConflict,
+            };
+        }
+        const source = raw.args.source;
+        if (typeof source !== "string") {
+            throw usageError({
+                spec: recipesInstallSpec,
+                command: "recipes install",
+                message: "Missing source argument",
+            });
+        }
+        return {
+            source: { type: "auto", value: source },
+            index,
+            refresh,
+            yes,
+            onConflict,
+        };
+    },
+    examples: [
+        { cmd: "agentplane recipes install viewer", why: "Auto: install by id from remote index." },
+        {
+            cmd: "agentplane recipes install --name viewer --refresh",
+            why: "Install by id, forcing index refresh.",
+        },
+        {
+            cmd: "agentplane recipes install viewer --on-conflict overwrite",
+            why: "Apply recipe agents, overwriting conflicts.",
+        },
+    ],
+    notes: [
+        "Auto mode resolution matches v0.1.9: URL if http(s); else PATH if file exists; else NAME (remote index).",
+        "Network operations may require approval; use --yes to auto-approve when allowed by config.",
+    ],
+};
+export const runRecipesInstall = (ctx, p) => (async () => {
+    try {
+        return await cmdRecipeInstall({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            ...p,
+        });
+    }
+    catch (err) {
+        if (err instanceof CliError && err.code === "E_USAGE") {
+            throw usageError({
+                spec: recipesInstallSpec,
+                command: "recipes install",
+                message: err.message,
+            });
+        }
+        throw err;
+    }
+})();

package/dist/commands/recipes/list-remote.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import { type RecipeListRemoteFlags } from "../recipes.js";
+export type RecipesListRemoteParsed = RecipeListRemoteFlags;
+export declare const recipesListRemoteSpec: CommandSpec<RecipesListRemoteParsed>;
+export declare const runRecipesListRemote: CommandHandler<RecipesListRemoteParsed>;
+//# sourceMappingURL=list-remote.command.d.ts.map

package/dist/commands/recipes/list-remote.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-remote.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/list-remote.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAA6B,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtF,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,uBAAuB,CA2CtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,uBAAuB,CACW,CAAC"}

package/dist/commands/recipes/list-remote.command.js

@@ -0,0 +1,46 @@
+import { cmdRecipeListRemoteParsed } from "../recipes.js";
+export const recipesListRemoteSpec = {
+    id: ["recipes", "list-remote"],
+    group: "Recipes",
+    summary: "List recipes from the remote index (or cache).",
+    options: [
+        {
+            kind: "boolean",
+            name: "refresh",
+            default: false,
+            description: "Refresh remote index cache before listing.",
+        },
+        {
+            kind: "string",
+            name: "index",
+            valueHint: "<path|url>",
+            description: "Override recipes index location (path or http(s) URL).",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Auto-approve network access prompts (subject to config approvals).",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane recipes list-remote",
+            why: "List remote recipes using cached index when available.",
+        },
+        {
+            cmd: "agentplane recipes list-remote --refresh",
+            why: "Force refresh of the remote index cache.",
+        },
+        {
+            cmd: "agentplane recipes list-remote --index ./index.json --refresh",
+            why: "Refresh from a local index file.",
+        },
+    ],
+    parse: (raw) => ({
+        refresh: raw.opts.refresh === true,
+        index: raw.opts.index,
+        yes: raw.opts.yes === true,
+    }),
+};
+export const runRecipesListRemote = (ctx, flags) => cmdRecipeListRemoteParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });

package/dist/commands/recipes/list.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import { type RecipeListFlags } from "../recipes.js";
+export type RecipesListParsed = RecipeListFlags;
+export declare const recipesListSpec: CommandSpec<RecipesListParsed>;
+export declare const runRecipesList: CommandHandler<RecipesListParsed>;
+//# sourceMappingURL=list.command.d.ts.map

package/dist/commands/recipes/list.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/list.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAkC1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CACiB,CAAC"}

package/dist/commands/recipes/list.command.js

@@ -0,0 +1,39 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdRecipeListParsed } from "../recipes.js";
+export const recipesListSpec = {
+    id: ["recipes", "list"],
+    group: "Recipes",
+    summary: "List installed recipes.",
+    options: [
+        { kind: "boolean", name: "full", default: false, description: "Print full JSON payload." },
+        {
+            kind: "string",
+            name: "tag",
+            valueHint: "<tag>",
+            description: "Filter installed recipes by tag.",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane recipes list", why: "List installed recipes." },
+        { cmd: "agentplane recipes list --tag cli", why: "List installed recipes with a tag." },
+        { cmd: "agentplane recipes list --full", why: "Print full JSON payload." },
+    ],
+    parse: (raw) => ({
+        full: raw.opts.full === true,
+        tag: (() => {
+            const rawTag = raw.opts.tag;
+            if (rawTag === undefined)
+                return;
+            const trimmed = rawTag.trim();
+            if (!trimmed) {
+                throw usageError({
+                    spec: recipesListSpec,
+                    command: "recipes list",
+                    message: "Option --tag must not be empty.",
+                });
+            }
+            return trimmed;
+        })(),
+    }),
+};
+export const runRecipesList = (ctx, flags) => cmdRecipeListParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });

package/dist/commands/recipes/recipes.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+type RecipesParsed = Record<string, never>;
+export declare const recipesSpec: CommandSpec<RecipesParsed>;
+export declare const runRecipes: CommandHandler<RecipesParsed>;
+export {};
+//# sourceMappingURL=recipes.command.d.ts.map

package/dist/commands/recipes/recipes.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/recipes.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAItF,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAY3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAyBlD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CAOpD,CAAC"}

package/dist/commands/recipes/recipes.command.js

@@ -0,0 +1,45 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { suggestOne } from "../../cli/spec/suggest.js";
+const RECIPES_SUBCOMMANDS = [
+    "list",
+    "list-remote",
+    "info",
+    "explain",
+    "install",
+    "remove",
+    "cache",
+];
+export const recipesSpec = {
+    id: ["recipes"],
+    group: "Recipes",
+    summary: "Recipe management commands.",
+    synopsis: ["agentplane recipes <subcommand> [options]"],
+    args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
+    parse: () => ({}),
+    validateRaw: (raw) => {
+        const rest = Array.isArray(raw.args.subcommand) ? raw.args.subcommand : [];
+        const sub = rest[0];
+        if (!sub) {
+            throw usageError({
+                spec: recipesSpec,
+                command: "recipes",
+                message: "Missing recipes subcommand.",
+            });
+        }
+        const suggestion = suggestOne(String(sub), [...RECIPES_SUBCOMMANDS]);
+        const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
+        throw usageError({
+            spec: recipesSpec,
+            command: "recipes",
+            message: `Unknown recipes subcommand: ${String(sub)}.${suffix}`,
+        });
+    },
+};
+export const runRecipes = (_ctx) => {
+    // Should be unreachable because validateRaw always throws.
+    throw usageError({
+        spec: recipesSpec,
+        command: "recipes",
+        message: "Missing recipes subcommand.",
+    });
+};

package/dist/commands/recipes/remove.command.d.ts

@@ -0,0 +1,7 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type RecipesRemoveParsed = {
+    id: string;
+};
+export declare const recipesRemoveSpec: CommandSpec<RecipesRemoveParsed>;
+export declare const runRecipesRemove: CommandHandler<RecipesRemoveParsed>;
+//# sourceMappingURL=remove.command.d.ts.map

package/dist/commands/recipes/remove.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/remove.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CAO9D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,mBAAmB,CACkB,CAAC"}

package/dist/commands/recipes/remove.command.js

@@ -0,0 +1,10 @@
+import { cmdRecipeRemoveParsed } from "../recipes.js";
+export const recipesRemoveSpec = {
+    id: ["recipes", "remove"],
+    group: "Recipes",
+    summary: "Remove an installed recipe.",
+    args: [{ name: "id", required: true, valueHint: "<id>" }],
+    examples: [{ cmd: "agentplane recipes remove viewer", why: "Remove a recipe by id." }],
+    parse: (raw) => ({ id: String(raw.args.id ?? "") }),
+};
+export const runRecipesRemove = (ctx, p) => cmdRecipeRemoveParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, id: p.id });