agentplane 0.3.23 → 0.3.26

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

@@ -1,160 +0,0 @@
-import { createPublicKey, verify } from "node:crypto";
-import { mkdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { fetchJson, fetchText } from "../../../cli/http.js";
-import { fileExists } from "../../../cli/fs-utils.js";
-import { invalidFieldMessage } from "../../../cli/output.js";
-import { isRecord } from "../../../shared/guards.js";
-import { writeJsonStableIfChanged, writeTextIfChanged } from "../../../shared/write-if-changed.js";
-import { DEFAULT_RECIPES_INDEX_URL, RECIPES_INDEX_PUBLIC_KEYS, RECIPES_INDEX_PUBLIC_KEYS_ENV, } from "./constants.js";
-import { resolveRecipesIndexCachePath, resolveRecipesIndexCacheSigPath } from "./paths.js";
-const DEFAULT_RECIPES_INDEX_SIGNATURE_ALGORITHM = "ed25519";
-const recipesIndexSignatureVerifiers = {
-    ed25519: verifyRecipesIndexEd25519Signature,
-};
-function loadRecipesIndexPublicKeys() {
-    const raw = process.env[RECIPES_INDEX_PUBLIC_KEYS_ENV];
-    if (!raw)
-        return { ...RECIPES_INDEX_PUBLIC_KEYS };
-    try {
-        const parsed = JSON.parse(raw);
-        const merged = { ...RECIPES_INDEX_PUBLIC_KEYS };
-        for (const [key, value] of Object.entries(parsed)) {
-            if (typeof value === "string" && value.trim())
-                merged[key] = value.trim();
-        }
-        return merged;
-    }
-    catch {
-        return { ...RECIPES_INDEX_PUBLIC_KEYS };
-    }
-}
-function validateRecipesIndexSignature(raw) {
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage("recipes index signature", "object"));
-    if (raw.schema_version !== 1) {
-        throw new Error(invalidFieldMessage("recipes index signature.schema_version", "1"));
-    }
-    const keyId = typeof raw.key_id === "string" ? raw.key_id.trim() : "";
-    const signature = typeof raw.signature === "string" ? raw.signature.trim() : "";
-    if (!keyId || !signature) {
-        throw new Error(invalidFieldMessage("recipes index signature", "key_id, signature"));
-    }
-    const algorithm = typeof raw.algorithm === "string" && raw.algorithm.trim() ? raw.algorithm.trim() : undefined;
-    return { schema_version: 1, key_id: keyId, signature, algorithm };
-}
-function verifyRecipesIndexSignature(indexText, signature) {
-    const algorithm = signature.algorithm ?? DEFAULT_RECIPES_INDEX_SIGNATURE_ALGORITHM;
-    const verifier = recipesIndexSignatureVerifiers[algorithm];
-    if (!verifier) {
-        const supportedAlgorithms = Object.keys(recipesIndexSignatureVerifiers).toSorted().join(", ");
-        throw new Error(`Unsupported recipes index signature algorithm "${algorithm}". Supported algorithms: ${supportedAlgorithms}`);
-    }
-    verifier(indexText, signature);
-}
-function verifyRecipesIndexEd25519Signature(indexText, signature) {
-    const keys = loadRecipesIndexPublicKeys();
-    const publicKey = keys[signature.key_id];
-    if (!publicKey) {
-        throw new Error(invalidFieldMessage("recipes index signature.key_id", "known key id"));
-    }
-    const key = createPublicKey(publicKey);
-    const ok = verify(null, Buffer.from(indexText), key, Buffer.from(signature.signature, "base64"));
-    if (!ok) {
-        throw new Error("Invalid signature for recipes index");
-    }
-}
-function validateRecipesIndex(raw) {
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage("recipes index", "object"));
-    if (raw.schema_version !== 1)
-        throw new Error(invalidFieldMessage("recipes index.schema_version", "1"));
-    if (!Array.isArray(raw.recipes))
-        throw new Error(invalidFieldMessage("recipes index.recipes", "array"));
-    const recipes = raw.recipes
-        .filter((entry) => isRecord(entry))
-        .map((entry) => {
-        const id = typeof entry.id === "string" ? entry.id : "";
-        const summary = typeof entry.summary === "string" ? entry.summary : "";
-        const description = typeof entry.description === "string" ? entry.description : undefined;
-        const versionsRaw = Array.isArray(entry.versions) ? entry.versions : [];
-        if (!id || !summary || versionsRaw.length === 0) {
-            throw new Error(invalidFieldMessage("recipes index.recipes[]", "id, summary, versions"));
-        }
-        const versions = versionsRaw
-            .filter((version) => isRecord(version))
-            .map((version) => {
-            const versionId = typeof version.version === "string" ? version.version : "";
-            const url = typeof version.url === "string" ? version.url : "";
-            const sha256 = typeof version.sha256 === "string" ? version.sha256 : "";
-            if (!versionId || !url || !sha256) {
-                throw new Error(invalidFieldMessage("recipes index.recipes[].versions[]", "version, url, sha256"));
-            }
-            return {
-                version: versionId,
-                url,
-                sha256,
-                min_agentplane_version: typeof version.min_agentplane_version === "string"
-                    ? version.min_agentplane_version
-                    : undefined,
-                tags: Array.isArray(version.tags)
-                    ? version.tags.filter((tag) => typeof tag === "string")
-                    : undefined,
-            };
-        });
-        return { id, summary, description, versions };
-    });
-    return { schema_version: 1, recipes };
-}
-function isHttpUrl(value) {
-    return value.startsWith("http://") || value.startsWith("https://");
-}
-async function readRecipesIndexText(source, cwd) {
-    if (isHttpUrl(source)) {
-        return await fetchText(source);
-    }
-    return await readFile(path.resolve(cwd, source), "utf8");
-}
-function signatureSourceForIndex(source) {
-    return `${source}.sig`;
-}
-async function readRecipesIndexSignature(source, cwd) {
-    const sigSource = signatureSourceForIndex(source);
-    if (isHttpUrl(sigSource)) {
-        const raw = await fetchJson(sigSource);
-        return validateRecipesIndexSignature(raw);
-    }
-    const rawText = await readFile(path.resolve(cwd, sigSource), "utf8");
-    return validateRecipesIndexSignature(JSON.parse(rawText));
-}
-export async function loadRecipesRemoteIndex(opts) {
-    const cachePath = resolveRecipesIndexCachePath();
-    const cacheSigPath = resolveRecipesIndexCacheSigPath();
-    const cacheDir = path.dirname(cachePath);
-    let rawIndex;
-    if (opts.refresh || !(await fileExists(cachePath))) {
-        const source = opts.source ?? DEFAULT_RECIPES_INDEX_URL;
-        const indexText = await readRecipesIndexText(source, opts.cwd);
-        const signature = await readRecipesIndexSignature(source, opts.cwd);
-        verifyRecipesIndexSignature(indexText, signature);
-        rawIndex = JSON.parse(indexText);
-        await mkdir(cacheDir, { recursive: true });
-        await writeTextIfChanged(cachePath, indexText);
-        await writeJsonStableIfChanged(cacheSigPath, signature);
-    }
-    else {
-        const [indexText, sigText] = await Promise.all([
-            readFile(cachePath, "utf8"),
-            readFile(cacheSigPath, "utf8"),
-        ]);
-        const signature = validateRecipesIndexSignature(JSON.parse(sigText));
-        verifyRecipesIndexSignature(indexText, signature);
-        rawIndex = JSON.parse(indexText);
-    }
-    return validateRecipesIndex(rawIndex);
-}
-export function willFetchRemoteRecipesIndex(opts) {
-    if (!isHttpUrl(opts.source))
-        return false;
-    return opts.refresh || !opts.cachePathExists;
-}

package/dist/commands/recipes/impl/installed-recipes.d.ts

@@ -1,9 +0,0 @@
-import { type InstalledRecipesFile } from "@agentplaneorg/recipes";
-type ValidateInstalledRecipesFileOptions = {
-    dropInvalidEntries?: boolean;
-};
-export declare function readInstalledRecipesFile(filePath: string): Promise<InstalledRecipesFile>;
-export declare function readAndMigrateInstalledRecipesFile(filePath: string, opts?: ValidateInstalledRecipesFileOptions): Promise<InstalledRecipesFile>;
-export declare function writeInstalledRecipesFile(filePath: string, file: InstalledRecipesFile): Promise<void>;
-export {};
-//# sourceMappingURL=installed-recipes.d.ts.map

package/dist/commands/recipes/impl/installed-recipes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/installed-recipes.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAMhC,KAAK,mCAAmC,GAAG;IACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAgEF,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F;AAED,wBAAsB,kCAAkC,CACtD,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,mCAAmC,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/commands/recipes/impl/installed-recipes.js

@@ -1,100 +0,0 @@
-import { mkdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { canonicalizeJson } from "@agentplaneorg/core/tasks";
-import { normalizeRecipeTags, validateRecipeManifest, } from "@agentplaneorg/recipes";
-import { invalidFieldMessage } from "../../../cli/output.js";
-import { isRecord } from "../../../shared/guards.js";
-import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
-function normalizeInstalledRecipeEntry(entry, opts) {
-    if (!isRecord(entry)) {
-        if (opts?.dropInvalidEntries)
-            return null;
-        throw new Error(invalidFieldMessage("recipes.json.recipes[]", "object"));
-    }
-    let manifest;
-    try {
-        manifest = validateRecipeManifest(entry.manifest);
-    }
-    catch (error) {
-        if (opts?.dropInvalidEntries)
-            return null;
-        throw error;
-    }
-    const id = typeof entry.id === "string" ? entry.id.trim() : manifest.id;
-    const version = typeof entry.version === "string" ? entry.version.trim() : manifest.version;
-    const source = typeof entry.source === "string" ? entry.source.trim() : "";
-    const installedAt = typeof entry.installed_at === "string" ? entry.installed_at.trim() : "";
-    if (!id || !version || !source || !installedAt) {
-        if (opts?.dropInvalidEntries)
-            return null;
-        throw new Error(invalidFieldMessage("recipes.json.recipes[]", "id, version, source, installed_at"));
-    }
-    if (id !== manifest.id || version !== manifest.version) {
-        if (opts?.dropInvalidEntries)
-            return null;
-        throw new Error(invalidFieldMessage("recipes.json.recipes[]", "id/version match manifest"));
-    }
-    const tags = normalizeRecipeTags(entry.tags ?? manifest.tags ?? []);
-    return { id, version, source, installed_at: installedAt, tags, manifest };
-}
-function validateInstalledRecipesFile(raw, opts) {
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage("recipes.json", "object"));
-    if (raw.schema_version !== 1)
-        throw new Error(invalidFieldMessage("recipes.json.schema_version", "1"));
-    if (!Array.isArray(raw.recipes))
-        throw new Error(invalidFieldMessage("recipes.json.recipes", "array"));
-    const updatedAt = typeof raw.updated_at === "string" ? raw.updated_at : "";
-    const recipes = raw.recipes.flatMap((entry) => {
-        const normalized = normalizeInstalledRecipeEntry(entry, opts);
-        return normalized ? [normalized] : [];
-    });
-    return { schema_version: 1, updated_at: updatedAt, recipes };
-}
-function sortInstalledRecipes(file) {
-    const recipes = [...file.recipes].toSorted((a, b) => a.id.localeCompare(b.id));
-    return { schema_version: 1, updated_at: file.updated_at, recipes };
-}
-function canonicalJsonText(value) {
-    return JSON.stringify(canonicalizeJson(value));
-}
-function installedRecipesNeedMigration(raw, normalized) {
-    return canonicalJsonText(raw) !== canonicalJsonText(normalized);
-}
-export async function readInstalledRecipesFile(filePath) {
-    try {
-        const raw = JSON.parse(await readFile(filePath, "utf8"));
-        return sortInstalledRecipes(validateInstalledRecipesFile(raw));
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return { schema_version: 1, updated_at: "", recipes: [] };
-        throw err;
-    }
-}
-export async function readAndMigrateInstalledRecipesFile(filePath, opts) {
-    try {
-        const raw = JSON.parse(await readFile(filePath, "utf8"));
-        const normalized = sortInstalledRecipes(validateInstalledRecipesFile(raw, opts));
-        if (installedRecipesNeedMigration(raw, normalized)) {
-            await mkdir(path.dirname(filePath), { recursive: true });
-            await writeJsonStableIfChanged(filePath, normalized);
-        }
-        return normalized;
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return { schema_version: 1, updated_at: "", recipes: [] };
-        throw err;
-    }
-}
-export async function writeInstalledRecipesFile(filePath, file) {
-    const sorted = sortInstalledRecipes({
-        ...file,
-        updated_at: new Date().toISOString(),
-    });
-    await mkdir(path.dirname(filePath), { recursive: true });
-    await writeJsonStableIfChanged(filePath, sorted);
-}

package/dist/commands/recipes/impl/mutation-transaction.d.ts

@@ -1,7 +0,0 @@
-export declare function runVendoredRecipeMutation<T>(opts: {
-    targetDir: string;
-    mode: "create" | "replace" | "remove";
-    materialize?: (targetDir: string) => Promise<void>;
-    commit: () => Promise<T>;
-}): Promise<T>;
-//# sourceMappingURL=mutation-transaction.d.ts.map

package/dist/commands/recipes/impl/mutation-transaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mutation-transaction.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/mutation-transaction.ts"],"names":[],"mappings":"AAmBA,wBAAsB,yBAAyB,CAAC,CAAC,EAAE,IAAI,EAAE;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1B,GAAG,OAAO,CAAC,CAAC,CAAC,CA8Bb"}

package/dist/commands/recipes/impl/mutation-transaction.js

@@ -1,47 +0,0 @@
-import { lstat, rename, rm } from "node:fs/promises";
-let recipeMutationNonce = 0;
-async function pathExists(filePath) {
-    try {
-        await lstat(filePath);
-        return true;
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return false;
-        throw err;
-    }
-}
-function backupPath(targetDir) {
-    return `${targetDir}.agentplane-backup-${process.pid}-${Date.now()}-${recipeMutationNonce++}`;
-}
-export async function runVendoredRecipeMutation(opts) {
-    const existed = await pathExists(opts.targetDir);
-    const backupDir = existed && (opts.mode === "replace" || opts.mode === "remove")
-        ? backupPath(opts.targetDir)
-        : null;
-    if (backupDir) {
-        await rename(opts.targetDir, backupDir);
-    }
-    try {
-        if (opts.mode !== "remove") {
-            if (!opts.materialize)
-                throw new Error("materialize callback is required for create/replace");
-            await opts.materialize(opts.targetDir);
-        }
-        const result = await opts.commit();
-        if (backupDir) {
-            await rm(backupDir, { recursive: true, force: true });
-        }
-        return result;
-    }
-    catch (err) {
-        if (opts.mode !== "remove") {
-            await rm(opts.targetDir, { recursive: true, force: true }).catch((_error) => null);
-        }
-        if (backupDir) {
-            await rename(backupDir, opts.targetDir).catch((_error) => null);
-        }
-        throw err;
-    }
-}

package/dist/commands/recipes/impl/overlay-project.d.ts

@@ -1,48 +0,0 @@
-import { type CompiledRecipeAssetRegistry, type CompiledOverlayBundle } from "@agentplaneorg/recipes";
-import type { ProjectRecipesRegistryFile } from "./types.js";
-export declare function readActiveRecipeIds(project: {
-    agentplaneDir: string;
-}): Promise<string[]>;
-export declare function readActiveRecipeIdsFromRegistry(registry: ProjectRecipesRegistryFile): string[];
-export declare function setRecipeActive(opts: {
-    project: {
-        agentplaneDir: string;
-    };
-    recipeId: string;
-    active: boolean;
-}): Promise<string[]>;
-export declare function compileProjectOverlayArtifactsFromRegistry(project: {
-    agentplaneDir: string;
-}, registry: ProjectRecipesRegistryFile): Promise<{
-    bundle: CompiledOverlayBundle;
-    assets: CompiledRecipeAssetRegistry;
-}>;
-export declare function compileProjectOverlayArtifacts(project: {
-    agentplaneDir: string;
-}): Promise<{
-    bundle: CompiledOverlayBundle;
-    assets: CompiledRecipeAssetRegistry;
-}>;
-export declare function publishProjectRecipesState(opts: {
-    project: {
-        agentplaneDir: string;
-    };
-    registry: ProjectRecipesRegistryFile;
-}): Promise<{
-    registry: ProjectRecipesRegistryFile;
-    bundle: CompiledOverlayBundle;
-    assets: CompiledRecipeAssetRegistry;
-}>;
-export declare function refreshProjectOverlayArtifacts(project: {
-    agentplaneDir: string;
-}): Promise<{
-    bundle: CompiledOverlayBundle;
-    assets: CompiledRecipeAssetRegistry;
-}>;
-export declare function readProjectOverlayBundle(project: {
-    agentplaneDir: string;
-}): Promise<CompiledOverlayBundle | null>;
-export declare function readProjectRecipeAssetRegistry(project: {
-    agentplaneDir: string;
-}): Promise<CompiledRecipeAssetRegistry | null>;
-//# sourceMappingURL=overlay-project.d.ts.map

package/dist/commands/recipes/impl/overlay-project.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"overlay-project.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/overlay-project.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAG3B,MAAM,wBAAwB,CAAC;AAqBhC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAmL7D,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG/F;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,EAAE,CAK9F;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKpB;AAED,wBAAsB,0CAA0C,CAC9D,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,EAClC,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAAC;IACT,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CAqGD;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAChG,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CAGD;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,EAAE,0BAA0B,CAAC;CACtC,GAAG,OAAO,CAAC;IACV,QAAQ,EAAE,0BAA0B,CAAC;IACrC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CASD;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAChG,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CAQD;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAUxC;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAU9C"}