@a5c-ai/babysitter-sdk 5.0.0 → 5.0.1-staging.04a3db697

package/dist/mcp/tools/tasks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTaskTools(server: McpServer): void;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/mcp/tools/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqFpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0KzD"}

package/dist/mcp/tools/tasks.js

@@ -0,0 +1,230 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTaskTools = registerTaskTools;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const commitEffectResult_1 = require("../../runtime/commitEffectResult");
+const storage_1 = require("../../storage");
+const tasks_1 = require("../../storage/tasks");
+const errors_1 = require("../util/errors");
+const resolve_run_dir_1 = require("../util/resolve-run-dir");
+/**
+ * Build a task list from journal events by tracking EFFECT_REQUESTED and
+ * EFFECT_RESOLVED events.
+ */
+function buildTaskList(events) {
+    const requested = new Map();
+    const resolved = new Map();
+    for (const event of events) {
+        if (event.type === "EFFECT_REQUESTED") {
+            const data = event.data;
+            if (data.effectId) {
+                requested.set(data.effectId, {
+                    effectId: data.effectId,
+                    kind: data.kind ?? "unknown",
+                    label: data.label,
+                    taskId: data.taskId,
+                    requestedAt: event.recordedAt,
+                });
+            }
+        }
+        else if (event.type === "EFFECT_RESOLVED") {
+            const data = event.data;
+            if (data.effectId) {
+                resolved.set(data.effectId, { resolvedAt: event.recordedAt });
+            }
+        }
+    }
+    const tasks = [];
+    for (const [effectId, info] of requested) {
+        const resolvedInfo = resolved.get(effectId);
+        tasks.push({
+            effectId,
+            kind: info.kind,
+            status: resolvedInfo ? "resolved" : "pending",
+            label: info.label,
+            taskId: info.taskId,
+            requestedAt: info.requestedAt,
+            resolvedAt: resolvedInfo?.resolvedAt,
+        });
+    }
+    return tasks.sort((a, b) => a.effectId.localeCompare(b.effectId));
+}
+function registerTaskTools(server) {
+    // ── task_post ───────────────────────────────────────────────────────
+    server.tool("task_post", "Post a result for a pending task effect", {
+        runId: zod_1.z.string().describe("The run ID the task belongs to"),
+        effectId: zod_1.z.string().describe("The effect ID of the task to resolve"),
+        status: zod_1.z
+            .enum(["ok", "error"])
+            .describe("Result status: ok for success, error for failure"),
+        value: zod_1.z
+            .string()
+            .optional()
+            .describe("JSON-encoded result value (when status=ok)"),
+        error: zod_1.z
+            .string()
+            .optional()
+            .describe("JSON-encoded error payload (when status=error)"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            let value;
+            let errorPayload;
+            if (args.status === "ok" && args.value) {
+                try {
+                    value = JSON.parse(args.value);
+                }
+                catch {
+                    return (0, errors_1.toolError)("Invalid JSON in value parameter");
+                }
+            }
+            if (args.status === "error") {
+                if (args.error) {
+                    try {
+                        errorPayload = JSON.parse(args.error);
+                    }
+                    catch {
+                        return (0, errors_1.toolError)("Invalid JSON in error parameter");
+                    }
+                }
+                else {
+                    errorPayload = { name: "Error", message: "Task reported failure" };
+                }
+            }
+            const nowIso = new Date().toISOString();
+            const committed = await (0, commitEffectResult_1.commitEffectResult)({
+                runDir,
+                effectId: args.effectId,
+                result: args.status === "ok"
+                    ? {
+                        status: "ok",
+                        value,
+                        startedAt: nowIso,
+                        finishedAt: nowIso,
+                    }
+                    : {
+                        status: "error",
+                        error: errorPayload,
+                        startedAt: nowIso,
+                        finishedAt: nowIso,
+                    },
+            });
+            return (0, errors_1.toolResult)({
+                status: args.status,
+                effectId: args.effectId,
+                resultRef: committed.resultRef ?? null,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── task_list ───────────────────────────────────────────────────────
+    server.tool("task_list", "List all tasks for a run, optionally showing only pending tasks", {
+        runId: zod_1.z.string().describe("The run ID to list tasks for"),
+        pendingOnly: zod_1.z
+            .boolean()
+            .optional()
+            .describe("If true, only show pending (unresolved) tasks"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const journal = await (0, storage_1.loadJournal)(runDir);
+            const allTasks = buildTaskList(journal);
+            const tasks = args.pendingOnly
+                ? allTasks.filter((t) => t.status === "pending")
+                : allTasks;
+            return (0, errors_1.toolResult)({
+                total: allTasks.length,
+                showing: tasks.length,
+                pendingCount: allTasks.filter((t) => t.status === "pending").length,
+                tasks,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── task_show ───────────────────────────────────────────────────────
+    server.tool("task_show", "Show details of a specific task including its definition and result", {
+        runId: zod_1.z.string().describe("The run ID the task belongs to"),
+        effectId: zod_1.z.string().describe("The effect ID of the task"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            // Get task status from journal
+            const journal = await (0, storage_1.loadJournal)(runDir);
+            const allTasks = buildTaskList(journal);
+            const taskEntry = allTasks.find((t) => t.effectId === args.effectId);
+            if (!taskEntry) {
+                return (0, errors_1.toolError)(`Effect ${args.effectId} not found in run ${args.runId}`);
+            }
+            // Read task definition
+            let taskDef = null;
+            try {
+                taskDef = await (0, tasks_1.readTaskDefinition)(runDir, args.effectId);
+            }
+            catch {
+                // Task definition might not exist yet
+            }
+            // Read task result if resolved
+            let taskResultData = null;
+            if (taskEntry.status === "resolved") {
+                try {
+                    taskResultData = await (0, tasks_1.readTaskResult)(runDir, args.effectId);
+                }
+                catch {
+                    // Result file might not be readable
+                }
+            }
+            return (0, errors_1.toolResult)({
+                effect: taskEntry,
+                task: taskDef,
+                result: taskResultData,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+}

package/dist/mcp/transport/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/index.ts"],"names":[],"mappings":""}

package/dist/mcp/transport/index.js

@@ -0,0 +1,2 @@
+"use strict";
+// WebSocket transport moved to @a5c-ai/babysitter-agent (GAP-REMOTE-003)

package/dist/mcp/util/errors.d.ts

@@ -0,0 +1,14 @@
+export declare function toolError(message: string): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+export declare function toolResult(data: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/mcp/util/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mcp/util/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAE5G;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F"}

package/dist/mcp/util/errors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolError = toolError;
+exports.toolResult = toolResult;
+function toolError(message) {
+    return { content: [{ type: "text", text: JSON.stringify({ error: message }) }], isError: true };
+}
+function toolResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}

package/dist/mcp/util/resolve-run-dir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves the runs directory using the shared SDK policy.
+ * Accepts an optional override (e.g. from tool args or env).
+ */
+export declare function resolveRunDir(overridePath?: string): string;
+//# sourceMappingURL=resolve-run-dir.d.ts.map

package/dist/mcp/util/resolve-run-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-run-dir.d.ts","sourceRoot":"","sources":["../../../src/mcp/util/resolve-run-dir.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/mcp/util/resolve-run-dir.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunDir = resolveRunDir;
+const config_1 = require("../../config");
+/**
+ * Resolves the runs directory using the shared SDK policy.
+ * Accepts an optional override (e.g. from tool args or env).
+ */
+function resolveRunDir(overridePath) {
+    return (0, config_1.resolveRunsDir)({ override: overridePath });
+}

package/dist/plugins/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Plugin Management Module
+ *
+ * Re-exports all public APIs for plugin registry management,
+ * marketplace operations, package reading, and migration resolution.
+ */
+export { PLUGIN_REGISTRY_SCHEMA_VERSION, PLUGIN_REGISTRY_FILENAME, MARKETPLACE_MANIFEST_FILENAME, MANIFEST_PATH_FILENAME, } from "./types";
+export type { PluginScope, PluginRegistryEntry, PluginRegistry, MarketplaceManifest, MarketplacePluginEntry, MigrationDescriptor, PluginPackageInfo, } from "./types";
+export { getRegistryPath, getMarketplacesDir, getMarketplaceDir, } from "./paths";
+export { readPluginRegistry, writePluginRegistry, getPluginEntry, upsertPluginEntry, removePluginEntry, listPluginEntries, } from "./registry";
+export { cloneMarketplace, updateMarketplace, readMarketplaceManifest, listMarketplacePlugins, resolvePluginPackagePath, deriveMarketplaceName, listMarketplaces, } from "./marketplace";
+export { readPluginPackage, readInstallInstructions, readUninstallInstructions, readConfigureInstructions, listMigrations, readMigration, } from "./packageReader";
+export { parseMigrationFilename, buildMigrationGraph, findMigrationPath, resolveMigrationChain, } from "./migrations";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Plugin Management Module
+ *
+ * Re-exports all public APIs for plugin registry management,
+ * marketplace operations, package reading, and migration resolution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMigrationChain = exports.findMigrationPath = exports.buildMigrationGraph = exports.parseMigrationFilename = exports.readMigration = exports.listMigrations = exports.readConfigureInstructions = exports.readUninstallInstructions = exports.readInstallInstructions = exports.readPluginPackage = exports.listMarketplaces = exports.deriveMarketplaceName = exports.resolvePluginPackagePath = exports.listMarketplacePlugins = exports.readMarketplaceManifest = exports.updateMarketplace = exports.cloneMarketplace = exports.listPluginEntries = exports.removePluginEntry = exports.upsertPluginEntry = exports.getPluginEntry = exports.writePluginRegistry = exports.readPluginRegistry = exports.getMarketplaceDir = exports.getMarketplacesDir = exports.getRegistryPath = exports.MANIFEST_PATH_FILENAME = exports.MARKETPLACE_MANIFEST_FILENAME = exports.PLUGIN_REGISTRY_FILENAME = exports.PLUGIN_REGISTRY_SCHEMA_VERSION = void 0;
+// Types
+var types_1 = require("./types");
+Object.defineProperty(exports, "PLUGIN_REGISTRY_SCHEMA_VERSION", { enumerable: true, get: function () { return types_1.PLUGIN_REGISTRY_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "PLUGIN_REGISTRY_FILENAME", { enumerable: true, get: function () { return types_1.PLUGIN_REGISTRY_FILENAME; } });
+Object.defineProperty(exports, "MARKETPLACE_MANIFEST_FILENAME", { enumerable: true, get: function () { return types_1.MARKETPLACE_MANIFEST_FILENAME; } });
+Object.defineProperty(exports, "MANIFEST_PATH_FILENAME", { enumerable: true, get: function () { return types_1.MANIFEST_PATH_FILENAME; } });
+// Path resolution
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "getRegistryPath", { enumerable: true, get: function () { return paths_1.getRegistryPath; } });
+Object.defineProperty(exports, "getMarketplacesDir", { enumerable: true, get: function () { return paths_1.getMarketplacesDir; } });
+Object.defineProperty(exports, "getMarketplaceDir", { enumerable: true, get: function () { return paths_1.getMarketplaceDir; } });
+// Registry CRUD
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "readPluginRegistry", { enumerable: true, get: function () { return registry_1.readPluginRegistry; } });
+Object.defineProperty(exports, "writePluginRegistry", { enumerable: true, get: function () { return registry_1.writePluginRegistry; } });
+Object.defineProperty(exports, "getPluginEntry", { enumerable: true, get: function () { return registry_1.getPluginEntry; } });
+Object.defineProperty(exports, "upsertPluginEntry", { enumerable: true, get: function () { return registry_1.upsertPluginEntry; } });
+Object.defineProperty(exports, "removePluginEntry", { enumerable: true, get: function () { return registry_1.removePluginEntry; } });
+Object.defineProperty(exports, "listPluginEntries", { enumerable: true, get: function () { return registry_1.listPluginEntries; } });
+// Marketplace management
+var marketplace_1 = require("./marketplace");
+Object.defineProperty(exports, "cloneMarketplace", { enumerable: true, get: function () { return marketplace_1.cloneMarketplace; } });
+Object.defineProperty(exports, "updateMarketplace", { enumerable: true, get: function () { return marketplace_1.updateMarketplace; } });
+Object.defineProperty(exports, "readMarketplaceManifest", { enumerable: true, get: function () { return marketplace_1.readMarketplaceManifest; } });
+Object.defineProperty(exports, "listMarketplacePlugins", { enumerable: true, get: function () { return marketplace_1.listMarketplacePlugins; } });
+Object.defineProperty(exports, "resolvePluginPackagePath", { enumerable: true, get: function () { return marketplace_1.resolvePluginPackagePath; } });
+Object.defineProperty(exports, "deriveMarketplaceName", { enumerable: true, get: function () { return marketplace_1.deriveMarketplaceName; } });
+Object.defineProperty(exports, "listMarketplaces", { enumerable: true, get: function () { return marketplace_1.listMarketplaces; } });
+// Package reading
+var packageReader_1 = require("./packageReader");
+Object.defineProperty(exports, "readPluginPackage", { enumerable: true, get: function () { return packageReader_1.readPluginPackage; } });
+Object.defineProperty(exports, "readInstallInstructions", { enumerable: true, get: function () { return packageReader_1.readInstallInstructions; } });
+Object.defineProperty(exports, "readUninstallInstructions", { enumerable: true, get: function () { return packageReader_1.readUninstallInstructions; } });
+Object.defineProperty(exports, "readConfigureInstructions", { enumerable: true, get: function () { return packageReader_1.readConfigureInstructions; } });
+Object.defineProperty(exports, "listMigrations", { enumerable: true, get: function () { return packageReader_1.listMigrations; } });
+Object.defineProperty(exports, "readMigration", { enumerable: true, get: function () { return packageReader_1.readMigration; } });
+// Migration resolution
+var migrations_1 = require("./migrations");
+Object.defineProperty(exports, "parseMigrationFilename", { enumerable: true, get: function () { return migrations_1.parseMigrationFilename; } });
+Object.defineProperty(exports, "buildMigrationGraph", { enumerable: true, get: function () { return migrations_1.buildMigrationGraph; } });
+Object.defineProperty(exports, "findMigrationPath", { enumerable: true, get: function () { return migrations_1.findMigrationPath; } });
+Object.defineProperty(exports, "resolveMigrationChain", { enumerable: true, get: function () { return migrations_1.resolveMigrationChain; } });

package/dist/plugins/marketplace.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Marketplace Management
+ *
+ * Manages marketplace repositories (clone, update, read manifests)
+ * using git operations executed via child_process.execFile.
+ */
+import { MarketplaceManifest, MarketplacePluginEntry, PluginScope } from "./types";
+/**
+ * Derives a short marketplace name from a git URL.
+ */
+export declare function deriveMarketplaceName(url: string): string;
+/**
+ * Clones a marketplace repository with --depth 1 for minimal footprint.
+ */
+export declare function cloneMarketplace(url: string, scope: PluginScope, projectDir?: string, manifestPath?: string, branch?: string, force?: boolean): Promise<string>;
+/**
+ * Updates a previously cloned marketplace by pulling latest changes.
+ */
+export declare function updateMarketplace(marketplaceName: string, scope: PluginScope, projectDir?: string, branch?: string): Promise<void>;
+/**
+ * Reads and parses the marketplace manifest from a cloned marketplace.
+ */
+export declare function readMarketplaceManifest(marketplaceName: string, scope: PluginScope, projectDir?: string): Promise<MarketplaceManifest>;
+/**
+ * Lists all plugins available in a marketplace manifest.
+ */
+export declare function listMarketplacePlugins(marketplaceName: string, scope: PluginScope, projectDir?: string): Promise<MarketplacePluginEntry[]>;
+/**
+ * Resolves the full filesystem path to a plugin's package directory.
+ */
+export declare function resolvePluginPackagePath(marketplaceName: string, pluginName: string, scope: PluginScope, projectDir?: string): Promise<string>;
+/**
+ * Lists all cloned marketplace directories for the given scope.
+ */
+export declare function listMarketplaces(scope: PluginScope, projectDir?: string): Promise<string[]>;
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/plugins/marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/plugins/marketplace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EAGZ,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAsBf;AAkBD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAGnC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB"}

package/dist/plugins/marketplace.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Marketplace Management
+ *
+ * Manages marketplace repositories (clone, update, read manifests)
+ * using git operations executed via child_process.execFile.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveMarketplaceName = deriveMarketplaceName;
+exports.cloneMarketplace = cloneMarketplace;
+exports.updateMarketplace = updateMarketplace;
+exports.readMarketplaceManifest = readMarketplaceManifest;
+exports.listMarketplacePlugins = listMarketplacePlugins;
+exports.resolvePluginPackagePath = resolvePluginPackagePath;
+exports.listMarketplaces = listMarketplaces;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const paths_1 = require("./paths");
+const types_1 = require("./types");
+const marketplaceHelpers_1 = require("./marketplaceHelpers");
+const execFile = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Derives a short marketplace name from a git URL.
+ */
+function deriveMarketplaceName(url) {
+    const cleaned = url.replace(/\.git\s*$/, "").replace(/\/+$/, "");
+    const lastSegment = cleaned.split("/").pop() ?? "";
+    const afterColon = lastSegment.split(":").pop() ?? lastSegment;
+    if (!afterColon) {
+        throw new Error(`Unable to derive marketplace name from URL: ${url}`);
+    }
+    return afterColon;
+}
+/**
+ * Clones a marketplace repository with --depth 1 for minimal footprint.
+ */
+async function cloneMarketplace(url, scope, projectDir, manifestPath, branch, force) {
+    const name = deriveMarketplaceName(url);
+    const marketplacesDir = (0, paths_1.getMarketplacesDir)(scope, projectDir);
+    const targetDir = node_path_1.default.join(marketplacesDir, name);
+    await node_fs_1.promises.mkdir(marketplacesDir, { recursive: true });
+    try {
+        await node_fs_1.promises.access(targetDir);
+        if (force) {
+            await node_fs_1.promises.rm(targetDir, { recursive: true, force: true });
+        }
+        else {
+            throw new Error(`Marketplace "${name}" already exists at ${targetDir}. Use --force to replace or plugin:update-marketplace to refresh.`);
+        }
+    }
+    catch (error) {
+        if (!(0, types_1.isNodeError)(error) || error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    try {
+        const cloneArgs = ["clone", "--depth", "1"];
+        if (branch) {
+            cloneArgs.push("--branch", branch);
+        }
+        cloneArgs.push(url, targetDir);
+        await execFile("git", cloneArgs);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to clone marketplace from ${url}: ${message}`);
+    }
+    if (manifestPath) {
+        await node_fs_1.promises.writeFile(node_path_1.default.join(targetDir, types_1.MANIFEST_PATH_FILENAME), manifestPath.replace(/\\/g, "/"), "utf8");
+    }
+    return targetDir;
+}
+/**
+ * Updates a previously cloned marketplace by pulling latest changes.
+ */
+async function updateMarketplace(marketplaceName, scope, projectDir, branch) {
+    const dir = (0, paths_1.getMarketplaceDir)(marketplaceName, scope, projectDir);
+    try {
+        await node_fs_1.promises.access(dir);
+    }
+    catch {
+        throw new Error(`Marketplace "${marketplaceName}" not found at ${dir}. Clone it first.`);
+    }
+    try {
+        if (branch) {
+            await execFile("git", ["-C", dir, "fetch", "--depth", "1", "origin", branch]);
+            try {
+                await execFile("git", ["-C", dir, "checkout", branch]);
+            }
+            catch {
+                try {
+                    await execFile("git", ["-C", dir, "stash"]);
+                }
+                catch { /* Nothing to stash */ }
+                await execFile("git", ["-C", dir, "checkout", "-B", branch, "FETCH_HEAD"]);
+            }
+        }
+        await execFile("git", ["-C", dir, "pull", "--ff-only"]);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to update marketplace "${marketplaceName}": ${message}`);
+    }
+}
+/**
+ * Internal helper that reads the manifest and returns both the parsed
+ * manifest and the resolved manifest file path.
+ */
+async function readManifestWithPath(marketplaceName, scope, projectDir) {
+    const dir = (0, paths_1.getMarketplaceDir)(marketplaceName, scope, projectDir);
+    const manifestPath = await (0, marketplaceHelpers_1.resolveManifestPath)(dir);
+    const raw = await node_fs_1.promises.readFile(manifestPath, "utf8");
+    const manifest = (0, marketplaceHelpers_1.normalizeManifest)(JSON.parse(raw));
+    return { manifest, manifestPath };
+}
+/**
+ * Reads and parses the marketplace manifest from a cloned marketplace.
+ */
+async function readMarketplaceManifest(marketplaceName, scope, projectDir) {
+    const { manifest } = await readManifestWithPath(marketplaceName, scope, projectDir);
+    return manifest;
+}
+/**
+ * Lists all plugins available in a marketplace manifest.
+ */
+async function listMarketplacePlugins(marketplaceName, scope, projectDir) {
+    const manifest = await readMarketplaceManifest(marketplaceName, scope, projectDir);
+    return Object.values(manifest.plugins).sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Resolves the full filesystem path to a plugin's package directory.
+ */
+async function resolvePluginPackagePath(marketplaceName, pluginName, scope, projectDir) {
+    const { manifest, manifestPath } = await readManifestWithPath(marketplaceName, scope, projectDir);
+    const entry = manifest.plugins[pluginName];
+    if (!entry) {
+        throw new Error(`Plugin "${pluginName}" not found in marketplace "${marketplaceName}"`);
+    }
+    const manifestDir = node_path_1.default.dirname(manifestPath);
+    return node_path_1.default.join(manifestDir, entry.packagePath);
+}
+/**
+ * Lists all cloned marketplace directories for the given scope.
+ */
+async function listMarketplaces(scope, projectDir) {
+    const dir = (0, paths_1.getMarketplacesDir)(scope, projectDir);
+    try {
+        const entries = await node_fs_1.promises.readdir(dir, { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+    }
+    catch (error) {
+        if ((0, types_1.isNodeError)(error) && error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+}

package/dist/plugins/marketplaceHelpers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Marketplace manifest normalization helpers.
+ * Extracted from marketplace.ts for max-lines compliance.
+ */
+import type { MarketplaceManifest } from "./types";
+/**
+ * Resolves the marketplace manifest path within a cloned marketplace directory.
+ */
+export declare function resolveManifestPath(dir: string): Promise<string>;
+/**
+ * Normalizes a marketplace manifest that may use the legacy array format
+ * (with `source` field) into the standard Record format (with `packagePath`).
+ */
+export declare function normalizeManifest(raw: Record<string, unknown>): MarketplaceManifest;
+//# sourceMappingURL=marketplaceHelpers.d.ts.map

package/dist/plugins/marketplaceHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplaceHelpers.d.ts","sourceRoot":"","sources":["../../src/plugins/marketplaceHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAoEnF"}