@evalops/maestro 0.10.51 → 0.10.53

package/dist/node_modules/@evalops/contracts/dist/token-estimation.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Token estimation — single source of truth (TypeScript).
+ *
+ * Every TS surface that reasons about context-window usage (compaction gates,
+ * preflight overflow checks, context optimizers, repo maps, prompt-cache
+ * accounting, and every client renderer) MUST import from here instead of
+ * re-implementing the bytes/4 heuristic.
+ *
+ * ## Cross-language parity
+ *
+ * The constants and formulas mirror the Rust implementation in
+ * `packages/tui-rs/src/agent/token_estimation.rs` so that token budgets
+ * computed on the native side and the TS side agree. The design follows the
+ * same single-source-of-truth discipline as xai-org/grok-build's
+ * `xai-token-estimation` crate.
+ *
+ * @example
+ * ```typescript
+ * import { estimateTokens, usagePercentage } from "@evalops/contracts";
+ *
+ * const used = estimateTokens(prompt);
+ * const pct = usagePercentage(used, 200_000);
+ * ```
+ */
+/** Bytes per token under the rough character-based heuristic. */
+export const BYTES_PER_TOKEN = 4;
+/**
+ * Per-image approximate token cost when summing low-resolution image patches.
+ * Matches the Rust constant and the grok-build default.
+ */
+export const IMAGE_TOKEN_ESTIMATE = 765;
+/**
+ * Estimate the token count of a string using the shared bytes/4 heuristic.
+ *
+ * Empty input is `0`; any non-empty input is at least `1` token.
+ */
+export function estimateTokens(text) {
+    if (text.length === 0) {
+        return 0;
+    }
+    return Math.max(1, Math.ceil(text.length / BYTES_PER_TOKEN));
+}
+/**
+ * Estimate the token count of a value by serializing it to JSON first.
+ * Returns `0` if the value cannot be serialized.
+ */
+export function estimateTokensFromJson(value) {
+    let json;
+    try {
+        json = JSON.stringify(value);
+    }
+    catch {
+        return 0;
+    }
+    return estimateTokens(json);
+}
+/**
+ * Inverse of {@link estimateTokens}: convert a token budget into a character
+ * budget. Used by callers that size text passages against a model's context
+ * window.
+ */
+export function estimateChars(tokens) {
+    return Math.max(0, tokens * BYTES_PER_TOKEN);
+}
+/** Token estimate for `imageCount` images at {@link IMAGE_TOKEN_ESTIMATE} each. */
+export function estimateImageTokens(imageCount) {
+    return Math.max(0, imageCount) * IMAGE_TOKEN_ESTIMATE;
+}
+/**
+ * Usage percentage of a context window, clamped to `[0, 100]`.
+ * Returns `0` when capacity is non-positive.
+ */
+export function usagePercentage(used, capacity) {
+    if (capacity <= 0) {
+        return 0;
+    }
+    const pct = (used / capacity) * 100;
+    if (pct < 0) {
+        return 0;
+    }
+    if (pct > 100) {
+        return 100;
+    }
+    return pct;
+}
+//# sourceMappingURL=token-estimation.js.map

package/dist/node_modules/@evalops/contracts/dist/token-estimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimation.js","sourceRoot":"","sources":["../src/token-estimation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACV,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACpD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAC;IACV,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,oBAAoB,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAC7D,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC;IACV,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC;IACpC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACf,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC","sourcesContent":["/**\n * @fileoverview Token estimation — single source of truth (TypeScript).\n *\n * Every TS surface that reasons about context-window usage (compaction gates,\n * preflight overflow checks, context optimizers, repo maps, prompt-cache\n * accounting, and every client renderer) MUST import from here instead of\n * re-implementing the bytes/4 heuristic.\n *\n * ## Cross-language parity\n *\n * The constants and formulas mirror the Rust implementation in\n * `packages/tui-rs/src/agent/token_estimation.rs` so that token budgets\n * computed on the native side and the TS side agree. The design follows the\n * same single-source-of-truth discipline as xai-org/grok-build's\n * `xai-token-estimation` crate.\n *\n * @example\n * ```typescript\n * import { estimateTokens, usagePercentage } from \"@evalops/contracts\";\n *\n * const used = estimateTokens(prompt);\n * const pct = usagePercentage(used, 200_000);\n * ```\n */\n\n/** Bytes per token under the rough character-based heuristic. */\nexport const BYTES_PER_TOKEN = 4;\n\n/**\n * Per-image approximate token cost when summing low-resolution image patches.\n * Matches the Rust constant and the grok-build default.\n */\nexport const IMAGE_TOKEN_ESTIMATE = 765;\n\n/**\n * Estimate the token count of a string using the shared bytes/4 heuristic.\n *\n * Empty input is `0`; any non-empty input is at least `1` token.\n */\nexport function estimateTokens(text: string): number {\n\tif (text.length === 0) {\n\t\treturn 0;\n\t}\n\treturn Math.max(1, Math.ceil(text.length / BYTES_PER_TOKEN));\n}\n\n/**\n * Estimate the token count of a value by serializing it to JSON first.\n * Returns `0` if the value cannot be serialized.\n */\nexport function estimateTokensFromJson(value: unknown): number {\n\tlet json: string;\n\ttry {\n\t\tjson = JSON.stringify(value);\n\t} catch {\n\t\treturn 0;\n\t}\n\treturn estimateTokens(json);\n}\n\n/**\n * Inverse of {@link estimateTokens}: convert a token budget into a character\n * budget. Used by callers that size text passages against a model's context\n * window.\n */\nexport function estimateChars(tokens: number): number {\n\treturn Math.max(0, tokens * BYTES_PER_TOKEN);\n}\n\n/** Token estimate for `imageCount` images at {@link IMAGE_TOKEN_ESTIMATE} each. */\nexport function estimateImageTokens(imageCount: number): number {\n\treturn Math.max(0, imageCount) * IMAGE_TOKEN_ESTIMATE;\n}\n\n/**\n * Usage percentage of a context window, clamped to `[0, 100]`.\n * Returns `0` when capacity is non-positive.\n */\nexport function usagePercentage(used: number, capacity: number): number {\n\tif (capacity <= 0) {\n\t\treturn 0;\n\t}\n\tconst pct = (used / capacity) * 100;\n\tif (pct < 0) {\n\t\treturn 0;\n\t}\n\tif (pct > 100) {\n\t\treturn 100;\n\t}\n\treturn pct;\n}\n"]}

package/dist/node_modules/@evalops/contracts/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@evalops/contracts",
-	"version": "0.10.51",
+	"version": "0.10.53",
 	"description": "Shared Maestro contracts for frontend/backend integration",
 	"type": "module",
 	"main": "./dist/index.js",

package/dist/packages/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/packages/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAIjE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAgE7E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAMlE"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/packages/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAIjE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiE7E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAMlE"}

package/dist/packages/discovery.js

@@ -39,6 +39,7 @@ export function discoverPackage(packagePath) {
             const manifest = packageJson.maestro;
             // Validate that resource paths are arrays
             for (const key of [
+                "agents",
                 "extensions",
                 "skills",
                 "prompts",

package/dist/packages/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/packages/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE1D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;QAEvD,2BAA2B;QAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO;gBACN,IAAI,EAAE,WAAW;gBACjB,WAAW;gBACX,gBAAgB,EAAE,KAAK;gBACvB,MAAM,EAAE,CAAC,0BAA0B,CAAC;aACpC,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,MAAM,gBAAgB,GACrB,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC;QAE5D,uCAAuC;QACvC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;YAErC,0CAA0C;YAC1C,KAAK,MAAM,GAAG,IAAI;gBACjB,YAAY;gBACZ,QAAQ;gBACR,SAAS;gBACT,QAAQ;aACC,EAAE,CAAC;gBACZ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBAClE,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,mBAAmB,CAAC,CAAC;gBAChD,CAAC;YACF,CAAC;QACF,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;YAClC,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,gBAAgB;YAChB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO;SAClC,CAAC,CAAC;QAEH,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,WAAW;YACX,gBAAgB;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC3C,IAAI,EAAE,eAAe;YACrB,KAAK;SACL,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACxD,MAAM,UAAU,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,CACN,CAAC,UAAU,EAAE,gBAAgB,IAAI,KAAK,CAAC;QACvC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CACvC,CAAC;AACH,CAAC","sourcesContent":["/**\n * Package Discovery\n *\n * Discovers and validates maestro packages from the filesystem.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { createLogger } from \"../utils/logger.js\";\nimport type { DiscoveredPackage, PackageJson } from \"./types.js\";\n\nconst logger = createLogger(\"packages:discovery\");\n\n/**\n * Discover a maestro package at the given path\n *\n * @param packagePath - Path to package directory\n * @returns Discovered package info or null if invalid\n */\nexport function discoverPackage(packagePath: string): DiscoveredPackage | null {\n\tconst packageJsonPath = join(packagePath, \"package.json\");\n\n\tif (!existsSync(packageJsonPath)) {\n\t\tlogger.debug(\"No package.json found\", { path: packagePath });\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tconst content = readFileSync(packageJsonPath, \"utf-8\");\n\t\tconst packageJson = JSON.parse(content) as PackageJson;\n\n\t\t// Validate required fields\n\t\tif (!packageJson.name) {\n\t\t\treturn {\n\t\t\t\tpath: packagePath,\n\t\t\t\tpackageJson,\n\t\t\t\tisMaestroPackage: false,\n\t\t\t\terrors: [\"Package name is required\"],\n\t\t\t};\n\t\t}\n\n\t\t// Check for maestro-package keyword\n\t\tconst isMaestroPackage =\n\t\t\tpackageJson.keywords?.includes(\"maestro-package\") ?? false;\n\n\t\t// Validate maestro manifest if present\n\t\tconst errors: string[] = [];\n\t\tif (packageJson.maestro) {\n\t\t\tconst manifest = packageJson.maestro;\n\n\t\t\t// Validate that resource paths are arrays\n\t\t\tfor (const key of [\n\t\t\t\t\"extensions\",\n\t\t\t\t\"skills\",\n\t\t\t\t\"prompts\",\n\t\t\t\t\"themes\",\n\t\t\t] as const) {\n\t\t\t\tif (manifest[key] !== undefined && !Array.isArray(manifest[key])) {\n\t\t\t\t\terrors.push(`maestro.${key} must be an array`);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tlogger.debug(\"Discovered package\", {\n\t\t\tname: packageJson.name,\n\t\t\tversion: packageJson.version,\n\t\t\tisMaestroPackage,\n\t\t\thasManifest: !!packageJson.maestro,\n\t\t});\n\n\t\treturn {\n\t\t\tpath: packagePath,\n\t\t\tpackageJson,\n\t\t\tisMaestroPackage,\n\t\t\terrors: errors.length > 0 ? errors : undefined,\n\t\t};\n\t} catch (error) {\n\t\tlogger.warn(\"Failed to parse package.json\", {\n\t\t\tpath: packageJsonPath,\n\t\t\terror,\n\t\t});\n\t\treturn null;\n\t}\n}\n\n/**\n * Check if a directory contains a valid maestro package\n *\n * @param packagePath - Path to check\n * @returns True if valid maestro package\n */\nexport function isValidMaestroPackage(packagePath: string): boolean {\n\tconst discovered = discoverPackage(packagePath);\n\treturn (\n\t\t(discovered?.isMaestroPackage ?? false) &&\n\t\t(discovered?.errors?.length ?? 0) === 0\n\t);\n}\n"]}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/packages/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE1D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;QAEvD,2BAA2B;QAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO;gBACN,IAAI,EAAE,WAAW;gBACjB,WAAW;gBACX,gBAAgB,EAAE,KAAK;gBACvB,MAAM,EAAE,CAAC,0BAA0B,CAAC;aACpC,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,MAAM,gBAAgB,GACrB,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC;QAE5D,uCAAuC;QACvC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;YAErC,0CAA0C;YAC1C,KAAK,MAAM,GAAG,IAAI;gBACjB,QAAQ;gBACR,YAAY;gBACZ,QAAQ;gBACR,SAAS;gBACT,QAAQ;aACC,EAAE,CAAC;gBACZ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBAClE,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,mBAAmB,CAAC,CAAC;gBAChD,CAAC;YACF,CAAC;QACF,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;YAClC,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,gBAAgB;YAChB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO;SAClC,CAAC,CAAC;QAEH,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,WAAW;YACX,gBAAgB;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC3C,IAAI,EAAE,eAAe;YACrB,KAAK;SACL,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACxD,MAAM,UAAU,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,CACN,CAAC,UAAU,EAAE,gBAAgB,IAAI,KAAK,CAAC;QACvC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CACvC,CAAC;AACH,CAAC","sourcesContent":["/**\n * Package Discovery\n *\n * Discovers and validates maestro packages from the filesystem.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { createLogger } from \"../utils/logger.js\";\nimport type { DiscoveredPackage, PackageJson } from \"./types.js\";\n\nconst logger = createLogger(\"packages:discovery\");\n\n/**\n * Discover a maestro package at the given path\n *\n * @param packagePath - Path to package directory\n * @returns Discovered package info or null if invalid\n */\nexport function discoverPackage(packagePath: string): DiscoveredPackage | null {\n\tconst packageJsonPath = join(packagePath, \"package.json\");\n\n\tif (!existsSync(packageJsonPath)) {\n\t\tlogger.debug(\"No package.json found\", { path: packagePath });\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tconst content = readFileSync(packageJsonPath, \"utf-8\");\n\t\tconst packageJson = JSON.parse(content) as PackageJson;\n\n\t\t// Validate required fields\n\t\tif (!packageJson.name) {\n\t\t\treturn {\n\t\t\t\tpath: packagePath,\n\t\t\t\tpackageJson,\n\t\t\t\tisMaestroPackage: false,\n\t\t\t\terrors: [\"Package name is required\"],\n\t\t\t};\n\t\t}\n\n\t\t// Check for maestro-package keyword\n\t\tconst isMaestroPackage =\n\t\t\tpackageJson.keywords?.includes(\"maestro-package\") ?? false;\n\n\t\t// Validate maestro manifest if present\n\t\tconst errors: string[] = [];\n\t\tif (packageJson.maestro) {\n\t\t\tconst manifest = packageJson.maestro;\n\n\t\t\t// Validate that resource paths are arrays\n\t\t\tfor (const key of [\n\t\t\t\t\"agents\",\n\t\t\t\t\"extensions\",\n\t\t\t\t\"skills\",\n\t\t\t\t\"prompts\",\n\t\t\t\t\"themes\",\n\t\t\t] as const) {\n\t\t\t\tif (manifest[key] !== undefined && !Array.isArray(manifest[key])) {\n\t\t\t\t\terrors.push(`maestro.${key} must be an array`);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tlogger.debug(\"Discovered package\", {\n\t\t\tname: packageJson.name,\n\t\t\tversion: packageJson.version,\n\t\t\tisMaestroPackage,\n\t\t\thasManifest: !!packageJson.maestro,\n\t\t});\n\n\t\treturn {\n\t\t\tpath: packagePath,\n\t\t\tpackageJson,\n\t\t\tisMaestroPackage,\n\t\t\terrors: errors.length > 0 ? errors : undefined,\n\t\t};\n\t} catch (error) {\n\t\tlogger.warn(\"Failed to parse package.json\", {\n\t\t\tpath: packageJsonPath,\n\t\t\terror,\n\t\t});\n\t\treturn null;\n\t}\n}\n\n/**\n * Check if a directory contains a valid maestro package\n *\n * @param packagePath - Path to check\n * @returns True if valid maestro package\n */\nexport function isValidMaestroPackage(packagePath: string): boolean {\n\tconst discovered = discoverPackage(packagePath);\n\treturn (\n\t\t(discovered?.isMaestroPackage ?? false) &&\n\t\t(discovered?.errors?.length ?? 0) === 0\n\t);\n}\n"]}

package/dist/packages/inspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAE1B,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EACX,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACvC;AAED,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED,wBAAgB,8BAA8B,CAC7C,SAAS,EAAE,gBAAgB,GACzB,MAAM,EAAE,CAsBV;AA4BD,wBAAsB,4BAA4B,CACjD,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,8BAAmC,GAC1C,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA8BpC"}
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAE1B,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EACX,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACvC;AAED,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED,wBAAgB,8BAA8B,CAC7C,SAAS,EAAE,gBAAgB,GACzB,MAAM,EAAE,CAsBV;AAkCD,wBAAsB,4BAA4B,CACjD,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,8BAAmC,GAC1C,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA8BpC"}

package/dist/packages/inspection.js

@@ -44,7 +44,13 @@ export function collectPackageValidationIssues(inspected) {
 }
 function collectManifestPathIssues(packagePath, manifest) {
     const issues = [];
-    for (const key of ["extensions", "skills", "prompts", "themes"]) {
+    for (const key of [
+        "agents",
+        "extensions",
+        "skills",
+        "prompts",
+        "themes",
+    ]) {
         const manifestPaths = manifest[key];
         if (!Array.isArray(manifestPaths)) {
             continue;

package/dist/packages/inspection.js.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.js","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n\ttype ComposerConfig,\n\ttype ConfiguredPackageSpec,\n\tloadConfiguredPackageSpecs,\n} from \"../config/toml-config.js\";\nimport { MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE } from \"./constants.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport {\n\tloadPackage,\n\tloadPackageResources,\n\tparsePackageSpec,\n} from \"./loader.js\";\nimport { parsePackageSource, resolvePackageSource } from \"./sources.js\";\nimport type {\n\tDiscoveredPackage,\n\tMaestroManifest,\n\tPackageResources,\n\tPackageSource,\n\tResourceFilters,\n} from \"./types.js\";\n\nexport interface InspectedPackage {\n\tsourceSpec: string;\n\tsource: PackageSource;\n\tresolvedPath: string;\n\tdiscovered: DiscoveredPackage | null;\n\tresources?: PackageResources;\n}\n\nexport interface ConfiguredPackageReport {\n\tentry: ConfiguredPackageSpec;\n\tsourceSpec: string;\n\tfilters?: ResourceFilters;\n\tinspected?: InspectedPackage;\n\terror?: string;\n}\n\nexport interface ConfiguredPackageReportOptions {\n\tprofileName?: string;\n\tcliOverrides?: Partial<ComposerConfig>;\n}\n\nexport async function inspectPackageSource(\n\tsourceSpec: string,\n\tcwd: string,\n): Promise<InspectedPackage> {\n\tconst source = parsePackageSource(sourceSpec, cwd);\n\tconst resolvedPath = await resolvePackageSource(source);\n\tconst discovered = discoverPackage(resolvedPath);\n\tconst inspected: InspectedPackage = {\n\t\tsourceSpec,\n\t\tsource,\n\t\tresolvedPath,\n\t\tdiscovered,\n\t};\n\n\tif (\n\t\tdiscovered?.isMaestroPackage &&\n\t\t(discovered.errors?.length ?? 0) === 0 &&\n\t\tdiscovered.packageJson.maestro\n\t) {\n\t\tconst loadedPackage = await loadPackage(sourceSpec, { cwd });\n\t\tinspected.resources = loadPackageResources(loadedPackage);\n\t}\n\n\treturn inspected;\n}\n\nexport function collectPackageValidationIssues(\n\tinspected: InspectedPackage,\n): string[] {\n\tif (!inspected.discovered) {\n\t\treturn [`No valid package.json found at ${inspected.resolvedPath}.`];\n\t}\n\n\tconst issues: string[] = [];\n\tif (!inspected.discovered.isMaestroPackage) {\n\t\tissues.push(MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE);\n\t}\n\n\tfor (const error of inspected.discovered.errors ?? []) {\n\t\tissues.push(error);\n\t}\n\n\tconst manifest = inspected.discovered.packageJson.maestro;\n\tif (!manifest) {\n\t\tissues.push('Missing \"maestro\" section in package.json.');\n\t\treturn issues;\n\t}\n\n\tissues.push(...collectManifestPathIssues(inspected.resolvedPath, manifest));\n\treturn issues;\n}\n\nfunction collectManifestPathIssues(\n\tpackagePath: string,\n\tmanifest: MaestroManifest,\n): string[] {\n\tconst issues: string[] = [];\n\tfor (const key of [\"extensions\", \"skills\", \"prompts\", \"themes\"] as const) {\n\t\tconst manifestPaths = manifest[key];\n\t\tif (!Array.isArray(manifestPaths)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const manifestPath of manifestPaths) {\n\t\t\tconst absolutePath = join(packagePath, manifestPath);\n\t\t\tif (!existsSync(absolutePath)) {\n\t\t\t\tissues.push(`${key} path does not exist: ${manifestPath}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!statSync(absolutePath).isDirectory()) {\n\t\t\t\tissues.push(`${key} path is not a directory: ${manifestPath}`);\n\t\t\t}\n\t\t}\n\t}\n\treturn issues;\n}\n\nexport async function listConfiguredPackageReports(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageReportOptions = {},\n): Promise<ConfiguredPackageReport[]> {\n\tconst configured = loadConfiguredPackageSpecs(\n\t\tworkspaceDir,\n\t\toptions.profileName,\n\t\toptions.cliOverrides,\n\t);\n\tconst reports: ConfiguredPackageReport[] = [];\n\tfor (const entry of configured) {\n\t\tconst [sourceSpec, filters] = parsePackageSpec(entry.spec, entry.cwd);\n\t\ttry {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\tinspected: await inspectPackageSource(sourceSpec, entry.cwd),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\terror:\n\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t? error.message\n\t\t\t\t\t\t: \"Failed to inspect configured package.\",\n\t\t\t});\n\t\t}\n\t}\n\n\treturn reports;\n}\n"]}
+{"version":3,"file":"inspection.js","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n\ttype ComposerConfig,\n\ttype ConfiguredPackageSpec,\n\tloadConfiguredPackageSpecs,\n} from \"../config/toml-config.js\";\nimport { MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE } from \"./constants.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport {\n\tloadPackage,\n\tloadPackageResources,\n\tparsePackageSpec,\n} from \"./loader.js\";\nimport { parsePackageSource, resolvePackageSource } from \"./sources.js\";\nimport type {\n\tDiscoveredPackage,\n\tMaestroManifest,\n\tPackageResources,\n\tPackageSource,\n\tResourceFilters,\n} from \"./types.js\";\n\nexport interface InspectedPackage {\n\tsourceSpec: string;\n\tsource: PackageSource;\n\tresolvedPath: string;\n\tdiscovered: DiscoveredPackage | null;\n\tresources?: PackageResources;\n}\n\nexport interface ConfiguredPackageReport {\n\tentry: ConfiguredPackageSpec;\n\tsourceSpec: string;\n\tfilters?: ResourceFilters;\n\tinspected?: InspectedPackage;\n\terror?: string;\n}\n\nexport interface ConfiguredPackageReportOptions {\n\tprofileName?: string;\n\tcliOverrides?: Partial<ComposerConfig>;\n}\n\nexport async function inspectPackageSource(\n\tsourceSpec: string,\n\tcwd: string,\n): Promise<InspectedPackage> {\n\tconst source = parsePackageSource(sourceSpec, cwd);\n\tconst resolvedPath = await resolvePackageSource(source);\n\tconst discovered = discoverPackage(resolvedPath);\n\tconst inspected: InspectedPackage = {\n\t\tsourceSpec,\n\t\tsource,\n\t\tresolvedPath,\n\t\tdiscovered,\n\t};\n\n\tif (\n\t\tdiscovered?.isMaestroPackage &&\n\t\t(discovered.errors?.length ?? 0) === 0 &&\n\t\tdiscovered.packageJson.maestro\n\t) {\n\t\tconst loadedPackage = await loadPackage(sourceSpec, { cwd });\n\t\tinspected.resources = loadPackageResources(loadedPackage);\n\t}\n\n\treturn inspected;\n}\n\nexport function collectPackageValidationIssues(\n\tinspected: InspectedPackage,\n): string[] {\n\tif (!inspected.discovered) {\n\t\treturn [`No valid package.json found at ${inspected.resolvedPath}.`];\n\t}\n\n\tconst issues: string[] = [];\n\tif (!inspected.discovered.isMaestroPackage) {\n\t\tissues.push(MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE);\n\t}\n\n\tfor (const error of inspected.discovered.errors ?? []) {\n\t\tissues.push(error);\n\t}\n\n\tconst manifest = inspected.discovered.packageJson.maestro;\n\tif (!manifest) {\n\t\tissues.push('Missing \"maestro\" section in package.json.');\n\t\treturn issues;\n\t}\n\n\tissues.push(...collectManifestPathIssues(inspected.resolvedPath, manifest));\n\treturn issues;\n}\n\nfunction collectManifestPathIssues(\n\tpackagePath: string,\n\tmanifest: MaestroManifest,\n): string[] {\n\tconst issues: string[] = [];\n\tfor (const key of [\n\t\t\"agents\",\n\t\t\"extensions\",\n\t\t\"skills\",\n\t\t\"prompts\",\n\t\t\"themes\",\n\t] as const) {\n\t\tconst manifestPaths = manifest[key];\n\t\tif (!Array.isArray(manifestPaths)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const manifestPath of manifestPaths) {\n\t\t\tconst absolutePath = join(packagePath, manifestPath);\n\t\t\tif (!existsSync(absolutePath)) {\n\t\t\t\tissues.push(`${key} path does not exist: ${manifestPath}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!statSync(absolutePath).isDirectory()) {\n\t\t\t\tissues.push(`${key} path is not a directory: ${manifestPath}`);\n\t\t\t}\n\t\t}\n\t}\n\treturn issues;\n}\n\nexport async function listConfiguredPackageReports(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageReportOptions = {},\n): Promise<ConfiguredPackageReport[]> {\n\tconst configured = loadConfiguredPackageSpecs(\n\t\tworkspaceDir,\n\t\toptions.profileName,\n\t\toptions.cliOverrides,\n\t);\n\tconst reports: ConfiguredPackageReport[] = [];\n\tfor (const entry of configured) {\n\t\tconst [sourceSpec, filters] = parsePackageSpec(entry.spec, entry.cwd);\n\t\ttry {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\tinspected: await inspectPackageSource(sourceSpec, entry.cwd),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\terror:\n\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t? error.message\n\t\t\t\t\t\t: \"Failed to inspect configured package.\",\n\t\t\t});\n\t\t}\n\t}\n\n\treturn reports;\n}\n"]}

package/dist/packages/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/packages/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,WAAW,EACjB,GAAG,CAAC,EAAE,MAAM,GACV,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAevC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA8CxB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,CAmDzE;AA8DD;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkB7B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,WAAW,EAAE,EAC1B,YAAY,EAAE,WAAW,EAAE,GACzB,WAAW,EAAE,CA2Bf"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/packages/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,WAAW,EACjB,GAAG,CAAC,EAAE,MAAM,GACV,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAgBvC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA8CxB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,CA6DzE;AA8DD;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkB7B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,WAAW,EAAE,EAC1B,YAAY,EAAE,WAAW,EAAE,GACzB,WAAW,EAAE,CA2Bf"}

package/dist/packages/loader.js

@@ -22,8 +22,10 @@ export function parsePackageSpec(spec, cwd) {
         return [spec, undefined];
     }
     // Object form with filters
-    const { source, extensions, skills, prompts, themes } = spec;
+    const { source, agents, extensions, skills, prompts, themes } = spec;
     const filters = {};
+    if (agents)
+        filters.agents = agents;
     if (extensions)
         filters.extensions = extensions;
     if (skills)
@@ -84,11 +86,15 @@ export async function loadPackage(spec, options) {
 export function loadPackageResources(pkg) {
     const resources = {
         package: pkg,
+        agents: [],
         extensions: [],
         skills: [],
         prompts: [],
         themes: [],
     };
+    if (pkg.manifest.agents) {
+        resources.agents = loadResourcePaths(pkg.path, pkg.manifest.agents, pkg.filters?.agents);
+    }
     // Load each resource type
     if (pkg.manifest.extensions) {
         resources.extensions = loadResourcePaths(pkg.path, pkg.manifest.extensions, pkg.filters?.extensions);
@@ -104,6 +110,7 @@ export function loadPackageResources(pkg) {
     }
     logger.debug("Loaded package resources", {
         package: pkg.name,
+        agents: resources.agents.length,
         extensions: resources.extensions.length,
         skills: resources.skills.length,
         prompts: resources.prompts.length,

package/dist/packages/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/packages/loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Package Loader\n *\n * Loads maestro packages from various sources and extracts resources.\n */\n\nimport { existsSync, readdirSync, statSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport { filterResources } from \"./filters.js\";\nimport {\n\tformatPackageSource,\n\tparsePackageSource,\n\tresolvePackageSource,\n} from \"./sources.js\";\nimport type {\n\tLoadedPackage,\n\tPackageLoaderOptions,\n\tPackageResources,\n\tPackageSpec,\n\tResourceFilters,\n} from \"./types.js\";\n\nconst logger = createLogger(\"packages:loader\");\n\n/**\n * Parse a package specification into source and filters\n *\n * @param spec - Package specification (string or object)\n * @param cwd - Working directory\n * @returns Tuple of [source string, filters]\n */\nexport function parsePackageSpec(\n\tspec: PackageSpec,\n\tcwd?: string,\n): [string, ResourceFilters | undefined] {\n\tif (typeof spec === \"string\") {\n\t\treturn [spec, undefined];\n\t}\n\n\t// Object form with filters\n\tconst { source, extensions, skills, prompts, themes } = spec;\n\n\tconst filters: ResourceFilters = {};\n\tif (extensions) filters.extensions = extensions;\n\tif (skills) filters.skills = skills;\n\tif (prompts) filters.prompts = prompts;\n\tif (themes) filters.themes = themes;\n\n\treturn [source, Object.keys(filters).length > 0 ? filters : undefined];\n}\n\n/**\n * Load a package from a specification\n *\n * @param spec - Package specification\n * @param options - Loader options\n * @returns Loaded package metadata\n */\nexport async function loadPackage(\n\tspec: PackageSpec,\n\toptions?: PackageLoaderOptions,\n): Promise<LoadedPackage> {\n\tconst cwd = options?.cwd ?? process.cwd();\n\tconst [sourceSpec, filters] = parsePackageSpec(spec, cwd);\n\n\t// Parse and resolve source\n\tconst source = parsePackageSource(sourceSpec, cwd);\n\tconst packagePath = await resolvePackageSource(source, options?.cacheDir);\n\n\t// Discover package\n\tconst discovered = discoverPackage(packagePath);\n\tif (!discovered) {\n\t\tthrow new Error(`No valid package found at: ${packagePath}`);\n\t}\n\n\tif (!discovered.isMaestroPackage) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro-package' keyword`,\n\t\t);\n\t}\n\n\tif (discovered.errors && discovered.errors.length > 0) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} has validation errors: ${discovered.errors.join(\", \")}`,\n\t\t);\n\t}\n\n\tif (!discovered.packageJson.maestro) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro' section in package.json`,\n\t\t);\n\t}\n\n\tlogger.info(\"Loaded package\", {\n\t\tname: discovered.packageJson.name,\n\t\tversion: discovered.packageJson.version,\n\t\tsource: formatPackageSource(source),\n\t});\n\n\treturn {\n\t\tname: discovered.packageJson.name,\n\t\tversion: discovered.packageJson.version,\n\t\tsource,\n\t\tpath: packagePath,\n\t\tmanifest: discovered.packageJson.maestro,\n\t\tfilters,\n\t};\n}\n\n/**\n * Load resources from a package\n *\n * @param pkg - Loaded package metadata\n * @returns Package resources with filtered paths\n */\nexport function loadPackageResources(pkg: LoadedPackage): PackageResources {\n\tconst resources: PackageResources = {\n\t\tpackage: pkg,\n\t\textensions: [],\n\t\tskills: [],\n\t\tprompts: [],\n\t\tthemes: [],\n\t};\n\n\t// Load each resource type\n\tif (pkg.manifest.extensions) {\n\t\tresources.extensions = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.extensions,\n\t\t\tpkg.filters?.extensions,\n\t\t);\n\t}\n\n\tif (pkg.manifest.skills) {\n\t\tresources.skills = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.skills,\n\t\t\tpkg.filters?.skills,\n\t\t);\n\t}\n\n\tif (pkg.manifest.prompts) {\n\t\tresources.prompts = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.prompts,\n\t\t\tpkg.filters?.prompts,\n\t\t);\n\t}\n\n\tif (pkg.manifest.themes) {\n\t\tresources.themes = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.themes,\n\t\t\tpkg.filters?.themes,\n\t\t);\n\t}\n\n\tlogger.debug(\"Loaded package resources\", {\n\t\tpackage: pkg.name,\n\t\textensions: resources.extensions.length,\n\t\tskills: resources.skills.length,\n\t\tprompts: resources.prompts.length,\n\t\tthemes: resources.themes.length,\n\t});\n\n\treturn resources;\n}\n\n/**\n * Load resource paths from manifest directories\n *\n * @param packagePath - Package root directory\n * @param manifestPaths - Paths from manifest (e.g., [\"./extensions\"])\n * @param filters - Glob patterns to filter resources\n * @returns Absolute paths to resources\n */\nfunction loadResourcePaths(\n\tpackagePath: string,\n\tmanifestPaths: string[],\n\tfilters?: string[],\n): string[] {\n\tconst allPaths: string[] = [];\n\n\tfor (const manifestPath of manifestPaths) {\n\t\tconst absolutePath = join(packagePath, manifestPath);\n\n\t\tif (!existsSync(absolutePath)) {\n\t\t\tlogger.warn(\"Resource path does not exist\", {\n\t\t\t\tpath: absolutePath,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst stat = statSync(absolutePath);\n\t\tif (!stat.isDirectory()) {\n\t\t\tlogger.warn(\"Resource path is not a directory\", {\n\t\t\t\tpath: absolutePath,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\t// List all items in the directory\n\t\tconst items = readdirSync(absolutePath);\n\n\t\tfor (const item of items) {\n\t\t\tconst itemPath = join(absolutePath, item);\n\t\t\tconst itemStat = statSync(itemPath);\n\n\t\t\t// Only include directories (each resource is a directory)\n\t\t\tif (itemStat.isDirectory()) {\n\t\t\t\tallPaths.push(itemPath);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Apply filters\n\tif (filters && filters.length > 0) {\n\t\t// Get base names for filtering\n\t\tconst baseNames = allPaths.map((p) => basename(p));\n\t\tconst filteredNames = filterResources(baseNames, filters);\n\n\t\t// Map back to full paths\n\t\treturn allPaths.filter((p) => filteredNames.includes(basename(p)));\n\t}\n\n\treturn allPaths;\n}\n\n/**\n * Load multiple packages\n *\n * @param specs - Package specifications\n * @param options - Loader options\n * @returns Loaded package resources\n */\nexport async function loadPackages(\n\tspecs: PackageSpec[],\n\toptions?: PackageLoaderOptions,\n): Promise<PackageResources[]> {\n\tconst results: PackageResources[] = [];\n\n\tfor (const spec of specs) {\n\t\ttry {\n\t\t\tconst pkg = await loadPackage(spec, options);\n\t\t\tconst resources = loadPackageResources(pkg);\n\t\t\tresults.push(resources);\n\t\t} catch (error) {\n\t\t\tlogger.error(\"Failed to load package\", undefined, {\n\t\t\t\tspec,\n\t\t\t\terror,\n\t\t\t});\n\t\t\t// Continue with other packages\n\t\t}\n\t}\n\n\treturn results;\n}\n\n/**\n * Deduplicate packages by name (project scope overrides global scope)\n *\n * @param globalSpecs - Global package specs\n * @param projectSpecs - Project package specs\n * @returns Deduplicated package specs\n */\nexport function deduplicatePackages(\n\tglobalSpecs: PackageSpec[],\n\tprojectSpecs: PackageSpec[],\n): PackageSpec[] {\n\t// Track package names from project scope\n\tconst projectNames = new Set<string>();\n\n\tfor (const spec of projectSpecs) {\n\t\t// Extract package name from source\n\t\t// This is a simplified version - real implementation would need\n\t\t// to handle all source types properly\n\t\tif (typeof spec === \"string\") {\n\t\t\tprojectNames.add(spec);\n\t\t} else {\n\t\t\tprojectNames.add(spec.source);\n\t\t}\n\t}\n\n\t// Filter global specs to exclude those overridden by project\n\tconst deduplicated = [...projectSpecs];\n\n\tfor (const spec of globalSpecs) {\n\t\tconst specKey = typeof spec === \"string\" ? spec : spec.source;\n\n\t\tif (!projectNames.has(specKey)) {\n\t\t\tdeduplicated.push(spec);\n\t\t}\n\t}\n\n\treturn deduplicated;\n}\n"]}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/packages/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACN,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,cAAc,CAAC;AAStB,MAAM,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC/B,IAAiB,EACjB,GAAY;IAEZ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,2BAA2B;IAC3B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAErE,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,UAAU;QAAE,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IAChD,IAAI,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IACvC,IAAI,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAEpC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,IAAiB,EACjB,OAA8B;IAE9B,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE1D,2BAA2B;IAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE1E,mBAAmB;IACnB,MAAM,UAAU,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACd,WAAW,UAAU,CAAC,WAAW,CAAC,IAAI,uCAAuC,CAC7E,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACd,WAAW,UAAU,CAAC,WAAW,CAAC,IAAI,2BAA2B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/F,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACd,WAAW,UAAU,CAAC,WAAW,CAAC,IAAI,+CAA+C,CACrF,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC7B,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI;QACjC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,OAAO;QACvC,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC;KACnC,CAAC,CAAC;IAEH,OAAO;QACN,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI;QACjC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,OAAO;QACvC,MAAM;QACN,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,OAAO;QACxC,OAAO;KACP,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAkB;IACtD,MAAM,SAAS,GAAqB;QACnC,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;KACV,CAAC;IAEF,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,GAAG,iBAAiB,CACnC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,QAAQ,CAAC,MAAM,EACnB,GAAG,CAAC,OAAO,EAAE,MAAM,CACnB,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,GAAG,iBAAiB,CACvC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,QAAQ,CAAC,UAAU,EACvB,GAAG,CAAC,OAAO,EAAE,UAAU,CACvB,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,GAAG,iBAAiB,CACnC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,QAAQ,CAAC,MAAM,EACnB,GAAG,CAAC,OAAO,EAAE,MAAM,CACnB,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1B,SAAS,CAAC,OAAO,GAAG,iBAAiB,CACpC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,QAAQ,CAAC,OAAO,EACpB,GAAG,CAAC,OAAO,EAAE,OAAO,CACpB,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,GAAG,iBAAiB,CACnC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,QAAQ,CAAC,MAAM,EACnB,GAAG,CAAC,OAAO,EAAE,MAAM,CACnB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;QACxC,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;QAC/B,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,MAAM;QACvC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;QAC/B,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;QACjC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;KAC/B,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CACzB,WAAmB,EACnB,aAAuB,EACvB,OAAkB;IAElB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAErD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC3C,IAAI,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBAC/C,IAAI,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,kCAAkC;QAClC,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEpC,0DAA0D;YAC1D,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACF,CAAC;IACF,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,+BAA+B;QAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE1D,yBAAyB;QACzB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,KAAoB,EACpB,OAA8B;IAE9B,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,SAAS,EAAE;gBACjD,IAAI;gBACJ,KAAK;aACL,CAAC,CAAC;YACH,+BAA+B;QAChC,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAClC,WAA0B,EAC1B,YAA2B;IAE3B,yCAAyC;IACzC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QACjC,mCAAmC;QACnC,gEAAgE;QAChE,sCAAsC;QACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACP,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACF,CAAC;IAED,6DAA6D;IAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAE9D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;IAED,OAAO,YAAY,CAAC;AACrB,CAAC","sourcesContent":["/**\n * Package Loader\n *\n * Loads maestro packages from various sources and extracts resources.\n */\n\nimport { existsSync, readdirSync, statSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport { filterResources } from \"./filters.js\";\nimport {\n\tformatPackageSource,\n\tparsePackageSource,\n\tresolvePackageSource,\n} from \"./sources.js\";\nimport type {\n\tLoadedPackage,\n\tPackageLoaderOptions,\n\tPackageResources,\n\tPackageSpec,\n\tResourceFilters,\n} from \"./types.js\";\n\nconst logger = createLogger(\"packages:loader\");\n\n/**\n * Parse a package specification into source and filters\n *\n * @param spec - Package specification (string or object)\n * @param cwd - Working directory\n * @returns Tuple of [source string, filters]\n */\nexport function parsePackageSpec(\n\tspec: PackageSpec,\n\tcwd?: string,\n): [string, ResourceFilters | undefined] {\n\tif (typeof spec === \"string\") {\n\t\treturn [spec, undefined];\n\t}\n\n\t// Object form with filters\n\tconst { source, agents, extensions, skills, prompts, themes } = spec;\n\n\tconst filters: ResourceFilters = {};\n\tif (agents) filters.agents = agents;\n\tif (extensions) filters.extensions = extensions;\n\tif (skills) filters.skills = skills;\n\tif (prompts) filters.prompts = prompts;\n\tif (themes) filters.themes = themes;\n\n\treturn [source, Object.keys(filters).length > 0 ? filters : undefined];\n}\n\n/**\n * Load a package from a specification\n *\n * @param spec - Package specification\n * @param options - Loader options\n * @returns Loaded package metadata\n */\nexport async function loadPackage(\n\tspec: PackageSpec,\n\toptions?: PackageLoaderOptions,\n): Promise<LoadedPackage> {\n\tconst cwd = options?.cwd ?? process.cwd();\n\tconst [sourceSpec, filters] = parsePackageSpec(spec, cwd);\n\n\t// Parse and resolve source\n\tconst source = parsePackageSource(sourceSpec, cwd);\n\tconst packagePath = await resolvePackageSource(source, options?.cacheDir);\n\n\t// Discover package\n\tconst discovered = discoverPackage(packagePath);\n\tif (!discovered) {\n\t\tthrow new Error(`No valid package found at: ${packagePath}`);\n\t}\n\n\tif (!discovered.isMaestroPackage) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro-package' keyword`,\n\t\t);\n\t}\n\n\tif (discovered.errors && discovered.errors.length > 0) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} has validation errors: ${discovered.errors.join(\", \")}`,\n\t\t);\n\t}\n\n\tif (!discovered.packageJson.maestro) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro' section in package.json`,\n\t\t);\n\t}\n\n\tlogger.info(\"Loaded package\", {\n\t\tname: discovered.packageJson.name,\n\t\tversion: discovered.packageJson.version,\n\t\tsource: formatPackageSource(source),\n\t});\n\n\treturn {\n\t\tname: discovered.packageJson.name,\n\t\tversion: discovered.packageJson.version,\n\t\tsource,\n\t\tpath: packagePath,\n\t\tmanifest: discovered.packageJson.maestro,\n\t\tfilters,\n\t};\n}\n\n/**\n * Load resources from a package\n *\n * @param pkg - Loaded package metadata\n * @returns Package resources with filtered paths\n */\nexport function loadPackageResources(pkg: LoadedPackage): PackageResources {\n\tconst resources: PackageResources = {\n\t\tpackage: pkg,\n\t\tagents: [],\n\t\textensions: [],\n\t\tskills: [],\n\t\tprompts: [],\n\t\tthemes: [],\n\t};\n\n\tif (pkg.manifest.agents) {\n\t\tresources.agents = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.agents,\n\t\t\tpkg.filters?.agents,\n\t\t);\n\t}\n\n\t// Load each resource type\n\tif (pkg.manifest.extensions) {\n\t\tresources.extensions = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.extensions,\n\t\t\tpkg.filters?.extensions,\n\t\t);\n\t}\n\n\tif (pkg.manifest.skills) {\n\t\tresources.skills = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.skills,\n\t\t\tpkg.filters?.skills,\n\t\t);\n\t}\n\n\tif (pkg.manifest.prompts) {\n\t\tresources.prompts = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.prompts,\n\t\t\tpkg.filters?.prompts,\n\t\t);\n\t}\n\n\tif (pkg.manifest.themes) {\n\t\tresources.themes = loadResourcePaths(\n\t\t\tpkg.path,\n\t\t\tpkg.manifest.themes,\n\t\t\tpkg.filters?.themes,\n\t\t);\n\t}\n\n\tlogger.debug(\"Loaded package resources\", {\n\t\tpackage: pkg.name,\n\t\tagents: resources.agents.length,\n\t\textensions: resources.extensions.length,\n\t\tskills: resources.skills.length,\n\t\tprompts: resources.prompts.length,\n\t\tthemes: resources.themes.length,\n\t});\n\n\treturn resources;\n}\n\n/**\n * Load resource paths from manifest directories\n *\n * @param packagePath - Package root directory\n * @param manifestPaths - Paths from manifest (e.g., [\"./extensions\"])\n * @param filters - Glob patterns to filter resources\n * @returns Absolute paths to resources\n */\nfunction loadResourcePaths(\n\tpackagePath: string,\n\tmanifestPaths: string[],\n\tfilters?: string[],\n): string[] {\n\tconst allPaths: string[] = [];\n\n\tfor (const manifestPath of manifestPaths) {\n\t\tconst absolutePath = join(packagePath, manifestPath);\n\n\t\tif (!existsSync(absolutePath)) {\n\t\t\tlogger.warn(\"Resource path does not exist\", {\n\t\t\t\tpath: absolutePath,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst stat = statSync(absolutePath);\n\t\tif (!stat.isDirectory()) {\n\t\t\tlogger.warn(\"Resource path is not a directory\", {\n\t\t\t\tpath: absolutePath,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\t// List all items in the directory\n\t\tconst items = readdirSync(absolutePath);\n\n\t\tfor (const item of items) {\n\t\t\tconst itemPath = join(absolutePath, item);\n\t\t\tconst itemStat = statSync(itemPath);\n\n\t\t\t// Only include directories (each resource is a directory)\n\t\t\tif (itemStat.isDirectory()) {\n\t\t\t\tallPaths.push(itemPath);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Apply filters\n\tif (filters && filters.length > 0) {\n\t\t// Get base names for filtering\n\t\tconst baseNames = allPaths.map((p) => basename(p));\n\t\tconst filteredNames = filterResources(baseNames, filters);\n\n\t\t// Map back to full paths\n\t\treturn allPaths.filter((p) => filteredNames.includes(basename(p)));\n\t}\n\n\treturn allPaths;\n}\n\n/**\n * Load multiple packages\n *\n * @param specs - Package specifications\n * @param options - Loader options\n * @returns Loaded package resources\n */\nexport async function loadPackages(\n\tspecs: PackageSpec[],\n\toptions?: PackageLoaderOptions,\n): Promise<PackageResources[]> {\n\tconst results: PackageResources[] = [];\n\n\tfor (const spec of specs) {\n\t\ttry {\n\t\t\tconst pkg = await loadPackage(spec, options);\n\t\t\tconst resources = loadPackageResources(pkg);\n\t\t\tresults.push(resources);\n\t\t} catch (error) {\n\t\t\tlogger.error(\"Failed to load package\", undefined, {\n\t\t\t\tspec,\n\t\t\t\terror,\n\t\t\t});\n\t\t\t// Continue with other packages\n\t\t}\n\t}\n\n\treturn results;\n}\n\n/**\n * Deduplicate packages by name (project scope overrides global scope)\n *\n * @param globalSpecs - Global package specs\n * @param projectSpecs - Project package specs\n * @returns Deduplicated package specs\n */\nexport function deduplicatePackages(\n\tglobalSpecs: PackageSpec[],\n\tprojectSpecs: PackageSpec[],\n): PackageSpec[] {\n\t// Track package names from project scope\n\tconst projectNames = new Set<string>();\n\n\tfor (const spec of projectSpecs) {\n\t\t// Extract package name from source\n\t\t// This is a simplified version - real implementation would need\n\t\t// to handle all source types properly\n\t\tif (typeof spec === \"string\") {\n\t\t\tprojectNames.add(spec);\n\t\t} else {\n\t\t\tprojectNames.add(spec.source);\n\t\t}\n\t}\n\n\t// Filter global specs to exclude those overridden by project\n\tconst deduplicated = [...projectSpecs];\n\n\tfor (const spec of globalSpecs) {\n\t\tconst specKey = typeof spec === \"string\" ? spec : spec.source;\n\n\t\tif (!projectNames.has(specKey)) {\n\t\t\tdeduplicated.push(spec);\n\t\t}\n\t}\n\n\treturn deduplicated;\n}\n"]}

package/dist/packages/runtime.d.ts

@@ -4,6 +4,7 @@ export interface ScopedPackageResourceDirectories {
     project: string[];
 }
 export interface ConfiguredPackageRuntimeResources {
+    agents: ScopedPackageResourceDirectories;
     extensions: ScopedPackageResourceDirectories;
     skills: ScopedPackageResourceDirectories;
     prompts: ScopedPackageResourceDirectories;

package/dist/packages/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/packages/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,cAAc,EAMnB,MAAM,0BAA0B,CAAC;AAgBlC,MAAM,WAAW,gCAAgC;IAChD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IACjD,UAAU,EAAE,gCAAgC,CAAC;IAC7C,MAAM,EAAE,gCAAgC,CAAC;IACzC,OAAO,EAAE,gCAAgC,CAAC;IAC1C,MAAM,EAAE,gCAAgC,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACvC;AAID,wBAAgB,kCAAkC,CACjD,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,+BAAoC,GAC3C,IAAI,CAEN;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAqGD,wBAAgB,8BAA8B,CAC7C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,+BAAoC,GAC3C,iCAAiC,CA4CnC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/packages/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,cAAc,EAMnB,MAAM,0BAA0B,CAAC;AAsBlC,MAAM,WAAW,gCAAgC;IAChD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IACjD,MAAM,EAAE,gCAAgC,CAAC;IACzC,UAAU,EAAE,gCAAgC,CAAC;IAC7C,MAAM,EAAE,gCAAgC,CAAC;IACzC,OAAO,EAAE,gCAAgC,CAAC;IAC1C,MAAM,EAAE,gCAAgC,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACvC;AAID,wBAAgB,kCAAkC,CACjD,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,+BAAoC,GAC3C,IAAI,CAEN;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAsGD,wBAAgB,8BAA8B,CAC7C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,+BAAoC,GAC3C,iCAAiC,CA6CnC"}

package/dist/packages/runtime.js

@@ -6,7 +6,13 @@ import { loadPackageResources, parsePackageSpec } from "./loader.js";
 import { scheduleConfiguredRemotePackageAutoSync } from "./maintenance.js";
 import { parsePackageSource, resolvePackageSourceSync } from "./sources.js";
 const logger = createLogger("packages:runtime");
-const RESOURCE_KINDS = ["extensions", "skills", "prompts", "themes"];
+const RESOURCE_KINDS = [
+    "agents",
+    "extensions",
+    "skills",
+    "prompts",
+    "themes",
+];
 const reportedRuntimePackageErrors = new Set();
 export function setConfiguredPackageRuntimeContext(workspaceDir, options = {}) {
     setRuntimeConfigResolutionContext(workspaceDir, options);
@@ -19,6 +25,7 @@ function createScopedDirectories() {
 }
 function createConfiguredPackageRuntimeResources() {
     return {
+        agents: createScopedDirectories(),
         extensions: createScopedDirectories(),
         skills: createScopedDirectories(),
         prompts: createScopedDirectories(),
@@ -94,6 +101,7 @@ export function loadConfiguredPackageResources(workspaceDir, options = {}) {
     });
     const resources = createConfiguredPackageRuntimeResources();
     const seen = {
+        agents: { user: new Set(), project: new Set() },
         extensions: { user: new Set(), project: new Set() },
         skills: { user: new Set(), project: new Set() },
         prompts: { user: new Set(), project: new Set() },

package/dist/packages/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/packages/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from \"node:path\";\nimport {\n\ttype ComposerConfig,\n\ttype ConfiguredPackageSpec,\n\tclearRuntimeConfigResolutionContext,\n\tloadConfiguredPackageSpecs,\n\tresolveRuntimeConfigResolutionOptions,\n\tsetRuntimeConfigResolutionContext,\n} from \"../config/toml-config.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport { loadPackageResources, parsePackageSpec } from \"./loader.js\";\nimport { scheduleConfiguredRemotePackageAutoSync } from \"./maintenance.js\";\nimport { parsePackageSource, resolvePackageSourceSync } from \"./sources.js\";\nimport type { LoadedPackage, PackageResources } from \"./types.js\";\n\nconst logger = createLogger(\"packages:runtime\");\n\nconst RESOURCE_KINDS = [\"extensions\", \"skills\", \"prompts\", \"themes\"] as const;\n\ntype ResourceKind = (typeof RESOURCE_KINDS)[number];\ntype PackageScope = ConfiguredPackageSpec[\"scope\"];\ntype RuntimePackageScope = Exclude<PackageScope, \"local\"> | \"project\";\n\nexport interface ScopedPackageResourceDirectories {\n\tuser: string[];\n\tproject: string[];\n}\n\nexport interface ConfiguredPackageRuntimeResources {\n\textensions: ScopedPackageResourceDirectories;\n\tskills: ScopedPackageResourceDirectories;\n\tprompts: ScopedPackageResourceDirectories;\n\tthemes: ScopedPackageResourceDirectories;\n\terrors: string[];\n}\n\nexport interface ConfiguredPackageRuntimeOptions {\n\tprofileName?: string;\n\tcliOverrides?: Partial<ComposerConfig>;\n}\n\nconst reportedRuntimePackageErrors = new Set<string>();\n\nexport function setConfiguredPackageRuntimeContext(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageRuntimeOptions = {},\n): void {\n\tsetRuntimeConfigResolutionContext(workspaceDir, options);\n}\n\nexport function clearConfiguredPackageRuntimeContext(): void {\n\tclearRuntimeConfigResolutionContext();\n}\n\nfunction createScopedDirectories(): ScopedPackageResourceDirectories {\n\treturn { user: [], project: [] };\n}\n\nfunction createConfiguredPackageRuntimeResources(): ConfiguredPackageRuntimeResources {\n\treturn {\n\t\textensions: createScopedDirectories(),\n\t\tskills: createScopedDirectories(),\n\t\tprompts: createScopedDirectories(),\n\t\tthemes: createScopedDirectories(),\n\t\terrors: [],\n\t};\n}\n\nfunction reportConfiguredPackageErrorOnce(\n\tentry: ConfiguredPackageSpec,\n\terror: Error,\n): void {\n\tconst source =\n\t\ttypeof entry.spec === \"string\" ? entry.spec : entry.spec.source;\n\tconst message = `[${entry.scope}] ${entry.configPath} :: ${source} :: ${error.message}`;\n\tif (reportedRuntimePackageErrors.has(message)) {\n\t\treturn;\n\t}\n\treportedRuntimePackageErrors.add(message);\n\tlogger.warn(\"Failed to load configured runtime package\", {\n\t\tscope: entry.scope,\n\t\tconfigPath: entry.configPath,\n\t\tsource,\n\t\terror: error.message,\n\t});\n}\n\nfunction loadConfiguredPackageResourcesEntry(\n\tentry: ConfiguredPackageSpec,\n): PackageResources {\n\tconst [sourceSpec, filters] = parsePackageSpec(entry.spec, entry.cwd);\n\tconst source = parsePackageSource(sourceSpec, entry.cwd);\n\tconst packagePath = resolvePackageSourceSync(source);\n\n\tconst discovered = discoverPackage(packagePath);\n\tif (!discovered) {\n\t\tthrow new Error(`No valid package found at: ${packagePath}`);\n\t}\n\n\tif (!discovered.isMaestroPackage) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro-package' keyword`,\n\t\t);\n\t}\n\n\tif (discovered.errors && discovered.errors.length > 0) {\n\t\tthrow new Error(discovered.errors.join(\", \"));\n\t}\n\n\tif (!discovered.packageJson.maestro) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro' section in package.json`,\n\t\t);\n\t}\n\n\tconst loadedPackage: LoadedPackage = {\n\t\tname: discovered.packageJson.name,\n\t\tversion: discovered.packageJson.version,\n\t\tsource,\n\t\tpath: packagePath,\n\t\tmanifest: discovered.packageJson.maestro,\n\t\tfilters,\n\t};\n\n\treturn loadPackageResources(loadedPackage);\n}\n\nfunction addScopedDirectories(\n\ttarget: string[],\n\tseen: Set<string>,\n\tdirectories: string[],\n): void {\n\tfor (const directory of directories) {\n\t\tconst normalized = resolve(directory);\n\t\tif (seen.has(normalized)) {\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(normalized);\n\t\ttarget.push(normalized);\n\t}\n}\n\nfunction getRuntimePackageScope(scope: PackageScope): RuntimePackageScope {\n\treturn scope === \"user\" ? \"user\" : \"project\";\n}\n\nfunction resolveConfiguredPackageRuntimeOptions(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageRuntimeOptions,\n): ConfiguredPackageRuntimeOptions {\n\treturn resolveRuntimeConfigResolutionOptions(workspaceDir, options);\n}\n\nexport function loadConfiguredPackageResources(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageRuntimeOptions = {},\n): ConfiguredPackageRuntimeResources {\n\tconst resolvedOptions = resolveConfiguredPackageRuntimeOptions(\n\t\tworkspaceDir,\n\t\toptions,\n\t);\n\t// Auto-sync must use the same trust context as the load below, otherwise a\n\t// remote refresh/prune could fetch and cache sources from untrusted\n\t// project/local package entries that the gated load skips.\n\tvoid scheduleConfiguredRemotePackageAutoSync(workspaceDir, {\n\t\tprofileName: resolvedOptions.profileName,\n\t\tcliOverrides: resolvedOptions.cliOverrides,\n\t});\n\tconst resources = createConfiguredPackageRuntimeResources();\n\tconst seen: Record<ResourceKind, Record<RuntimePackageScope, Set<string>>> = {\n\t\textensions: { user: new Set(), project: new Set() },\n\t\tskills: { user: new Set(), project: new Set() },\n\t\tprompts: { user: new Set(), project: new Set() },\n\t\tthemes: { user: new Set(), project: new Set() },\n\t};\n\n\tfor (const entry of loadConfiguredPackageSpecs(\n\t\tworkspaceDir,\n\t\tresolvedOptions.profileName,\n\t\tresolvedOptions.cliOverrides,\n\t)) {\n\t\ttry {\n\t\t\tconst packageResources = loadConfiguredPackageResourcesEntry(entry);\n\t\t\tconst runtimeScope = getRuntimePackageScope(entry.scope);\n\t\t\tfor (const kind of RESOURCE_KINDS) {\n\t\t\t\taddScopedDirectories(\n\t\t\t\t\tresources[kind][runtimeScope],\n\t\t\t\t\tseen[kind][runtimeScope],\n\t\t\t\t\tpackageResources[kind],\n\t\t\t\t);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst resolvedError =\n\t\t\t\terror instanceof Error ? error : new Error(String(error));\n\t\t\treportConfiguredPackageErrorOnce(entry, resolvedError);\n\t\t\tresources.errors.push(`${entry.configPath}: ${resolvedError.message}`);\n\t\t}\n\t}\n\n\treturn resources;\n}\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/packages/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from \"node:path\";\nimport {\n\ttype ComposerConfig,\n\ttype ConfiguredPackageSpec,\n\tclearRuntimeConfigResolutionContext,\n\tloadConfiguredPackageSpecs,\n\tresolveRuntimeConfigResolutionOptions,\n\tsetRuntimeConfigResolutionContext,\n} from \"../config/toml-config.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport { loadPackageResources, parsePackageSpec } from \"./loader.js\";\nimport { scheduleConfiguredRemotePackageAutoSync } from \"./maintenance.js\";\nimport { parsePackageSource, resolvePackageSourceSync } from \"./sources.js\";\nimport type { LoadedPackage, PackageResources } from \"./types.js\";\n\nconst logger = createLogger(\"packages:runtime\");\n\nconst RESOURCE_KINDS = [\n\t\"agents\",\n\t\"extensions\",\n\t\"skills\",\n\t\"prompts\",\n\t\"themes\",\n] as const;\n\ntype ResourceKind = (typeof RESOURCE_KINDS)[number];\ntype PackageScope = ConfiguredPackageSpec[\"scope\"];\ntype RuntimePackageScope = Exclude<PackageScope, \"local\"> | \"project\";\n\nexport interface ScopedPackageResourceDirectories {\n\tuser: string[];\n\tproject: string[];\n}\n\nexport interface ConfiguredPackageRuntimeResources {\n\tagents: ScopedPackageResourceDirectories;\n\textensions: ScopedPackageResourceDirectories;\n\tskills: ScopedPackageResourceDirectories;\n\tprompts: ScopedPackageResourceDirectories;\n\tthemes: ScopedPackageResourceDirectories;\n\terrors: string[];\n}\n\nexport interface ConfiguredPackageRuntimeOptions {\n\tprofileName?: string;\n\tcliOverrides?: Partial<ComposerConfig>;\n}\n\nconst reportedRuntimePackageErrors = new Set<string>();\n\nexport function setConfiguredPackageRuntimeContext(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageRuntimeOptions = {},\n): void {\n\tsetRuntimeConfigResolutionContext(workspaceDir, options);\n}\n\nexport function clearConfiguredPackageRuntimeContext(): void {\n\tclearRuntimeConfigResolutionContext();\n}\n\nfunction createScopedDirectories(): ScopedPackageResourceDirectories {\n\treturn { user: [], project: [] };\n}\n\nfunction createConfiguredPackageRuntimeResources(): ConfiguredPackageRuntimeResources {\n\treturn {\n\t\tagents: createScopedDirectories(),\n\t\textensions: createScopedDirectories(),\n\t\tskills: createScopedDirectories(),\n\t\tprompts: createScopedDirectories(),\n\t\tthemes: createScopedDirectories(),\n\t\terrors: [],\n\t};\n}\n\nfunction reportConfiguredPackageErrorOnce(\n\tentry: ConfiguredPackageSpec,\n\terror: Error,\n): void {\n\tconst source =\n\t\ttypeof entry.spec === \"string\" ? entry.spec : entry.spec.source;\n\tconst message = `[${entry.scope}] ${entry.configPath} :: ${source} :: ${error.message}`;\n\tif (reportedRuntimePackageErrors.has(message)) {\n\t\treturn;\n\t}\n\treportedRuntimePackageErrors.add(message);\n\tlogger.warn(\"Failed to load configured runtime package\", {\n\t\tscope: entry.scope,\n\t\tconfigPath: entry.configPath,\n\t\tsource,\n\t\terror: error.message,\n\t});\n}\n\nfunction loadConfiguredPackageResourcesEntry(\n\tentry: ConfiguredPackageSpec,\n): PackageResources {\n\tconst [sourceSpec, filters] = parsePackageSpec(entry.spec, entry.cwd);\n\tconst source = parsePackageSource(sourceSpec, entry.cwd);\n\tconst packagePath = resolvePackageSourceSync(source);\n\n\tconst discovered = discoverPackage(packagePath);\n\tif (!discovered) {\n\t\tthrow new Error(`No valid package found at: ${packagePath}`);\n\t}\n\n\tif (!discovered.isMaestroPackage) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro-package' keyword`,\n\t\t);\n\t}\n\n\tif (discovered.errors && discovered.errors.length > 0) {\n\t\tthrow new Error(discovered.errors.join(\", \"));\n\t}\n\n\tif (!discovered.packageJson.maestro) {\n\t\tthrow new Error(\n\t\t\t`Package ${discovered.packageJson.name} is missing 'maestro' section in package.json`,\n\t\t);\n\t}\n\n\tconst loadedPackage: LoadedPackage = {\n\t\tname: discovered.packageJson.name,\n\t\tversion: discovered.packageJson.version,\n\t\tsource,\n\t\tpath: packagePath,\n\t\tmanifest: discovered.packageJson.maestro,\n\t\tfilters,\n\t};\n\n\treturn loadPackageResources(loadedPackage);\n}\n\nfunction addScopedDirectories(\n\ttarget: string[],\n\tseen: Set<string>,\n\tdirectories: string[],\n): void {\n\tfor (const directory of directories) {\n\t\tconst normalized = resolve(directory);\n\t\tif (seen.has(normalized)) {\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(normalized);\n\t\ttarget.push(normalized);\n\t}\n}\n\nfunction getRuntimePackageScope(scope: PackageScope): RuntimePackageScope {\n\treturn scope === \"user\" ? \"user\" : \"project\";\n}\n\nfunction resolveConfiguredPackageRuntimeOptions(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageRuntimeOptions,\n): ConfiguredPackageRuntimeOptions {\n\treturn resolveRuntimeConfigResolutionOptions(workspaceDir, options);\n}\n\nexport function loadConfiguredPackageResources(\n\tworkspaceDir: string,\n\toptions: ConfiguredPackageRuntimeOptions = {},\n): ConfiguredPackageRuntimeResources {\n\tconst resolvedOptions = resolveConfiguredPackageRuntimeOptions(\n\t\tworkspaceDir,\n\t\toptions,\n\t);\n\t// Auto-sync must use the same trust context as the load below, otherwise a\n\t// remote refresh/prune could fetch and cache sources from untrusted\n\t// project/local package entries that the gated load skips.\n\tvoid scheduleConfiguredRemotePackageAutoSync(workspaceDir, {\n\t\tprofileName: resolvedOptions.profileName,\n\t\tcliOverrides: resolvedOptions.cliOverrides,\n\t});\n\tconst resources = createConfiguredPackageRuntimeResources();\n\tconst seen: Record<ResourceKind, Record<RuntimePackageScope, Set<string>>> = {\n\t\tagents: { user: new Set(), project: new Set() },\n\t\textensions: { user: new Set(), project: new Set() },\n\t\tskills: { user: new Set(), project: new Set() },\n\t\tprompts: { user: new Set(), project: new Set() },\n\t\tthemes: { user: new Set(), project: new Set() },\n\t};\n\n\tfor (const entry of loadConfiguredPackageSpecs(\n\t\tworkspaceDir,\n\t\tresolvedOptions.profileName,\n\t\tresolvedOptions.cliOverrides,\n\t)) {\n\t\ttry {\n\t\t\tconst packageResources = loadConfiguredPackageResourcesEntry(entry);\n\t\t\tconst runtimeScope = getRuntimePackageScope(entry.scope);\n\t\t\tfor (const kind of RESOURCE_KINDS) {\n\t\t\t\taddScopedDirectories(\n\t\t\t\t\tresources[kind][runtimeScope],\n\t\t\t\t\tseen[kind][runtimeScope],\n\t\t\t\t\tpackageResources[kind],\n\t\t\t\t);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst resolvedError =\n\t\t\t\terror instanceof Error ? error : new Error(String(error));\n\t\t\treportConfiguredPackageErrorOnce(entry, resolvedError);\n\t\t\tresources.errors.push(`${entry.configPath}: ${resolvedError.message}`);\n\t\t}\n\t}\n\n\treturn resources;\n}\n"]}

package/dist/packages/types.d.ts

@@ -8,6 +8,8 @@
  * Package manifest (maestro section in package.json)
  */
 export interface MaestroManifest {
+    /** Paths to custom agent directories */
+    agents?: string[];
     /** Paths to extension directories */
     extensions?: string[];
     /** Paths to skill directories */
@@ -61,6 +63,8 @@ export type PackageSource = GitSource | LocalSource | NpmSource;
  * Resource filter patterns
  */
 export interface ResourceFilters {
+    /** Glob patterns for custom agents */
+    agents?: string[];
     /** Glob patterns for extensions (supports ! for exclusion) */
     extensions?: string[];
     /** Glob patterns for skills */
@@ -99,6 +103,8 @@ export interface LoadedPackage {
 export interface PackageResources {
     /** Package metadata */
     package: LoadedPackage;
+    /** Loaded custom agent paths */
+    agents: string[];
     /** Loaded extension paths */
     extensions: string[];
     /** Loaded skill paths */

package/dist/packages/types.d.ts.map

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

package/dist/packages/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/packages/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Maestro Package System Types\n *\n * Defines types for distributable extension bundles that can be loaded\n * from local filesystem, git repositories, or npm packages.\n */\n\n/**\n * Package manifest (maestro section in package.json)\n */\nexport interface MaestroManifest {\n\t/** Paths to extension directories */\n\textensions?: string[];\n\t/** Paths to skill directories */\n\tskills?: string[];\n\t/** Paths to prompt template directories */\n\tprompts?: string[];\n\t/** Paths to theme directories */\n\tthemes?: string[];\n}\n\n/**\n * Package.json structure for maestro packages\n */\nexport interface PackageJson {\n\tname: string;\n\tversion?: string;\n\tkeywords?: string[];\n\tmaestro?: MaestroManifest;\n}\n\n/**\n * Package source types\n */\nexport type PackageSourceType = \"local\" | \"git\" | \"npm\";\n\n/**\n * Git source with optional reference\n */\nexport interface GitSource {\n\ttype: \"git\";\n\turl: string;\n\tref?: string; // branch, tag, or commit\n}\n\n/**\n * Local filesystem source\n */\nexport interface LocalSource {\n\ttype: \"local\";\n\tpath: string;\n}\n\n/**\n * npm registry source\n */\nexport interface NpmSource {\n\ttype: \"npm\";\n\tname: string;\n\tversion?: string;\n}\n\n/**\n * Union of all source types\n */\nexport type PackageSource = GitSource | LocalSource | NpmSource;\n\n/**\n * Resource filter patterns\n */\nexport interface ResourceFilters {\n\t/** Glob patterns for extensions (supports ! for exclusion) */\n\textensions?: string[];\n\t/** Glob patterns for skills */\n\tskills?: string[];\n\t/** Glob patterns for prompts */\n\tprompts?: string[];\n\t/** Glob patterns for themes */\n\tthemes?: string[];\n}\n\n/**\n * Package specification - string or object form\n */\nexport type PackageSpec =\n\t| string // \"local:./path\" or \"git:url\" or \"npm:name@version\"\n\t| (ResourceFilters & { source: string });\n\n/**\n * Loaded package metadata\n */\nexport interface LoadedPackage {\n\t/** Package name from package.json */\n\tname: string;\n\t/** Package version */\n\tversion?: string;\n\t/** Resolved source information */\n\tsource: PackageSource;\n\t/** Absolute path to package directory */\n\tpath: string;\n\t/** Package manifest */\n\tmanifest: MaestroManifest;\n\t/** Applied filters */\n\tfilters?: ResourceFilters;\n}\n\n/**\n * Loaded resources from a package\n */\nexport interface PackageResources {\n\t/** Package metadata */\n\tpackage: LoadedPackage;\n\t/** Loaded extension paths */\n\textensions: string[];\n\t/** Loaded skill paths */\n\tskills: string[];\n\t/** Loaded prompt paths */\n\tprompts: string[];\n\t/** Loaded theme paths */\n\tthemes: string[];\n}\n\n/**\n * Package discovery result\n */\nexport interface DiscoveredPackage {\n\t/** Package directory path */\n\tpath: string;\n\t/** Parsed package.json */\n\tpackageJson: PackageJson;\n\t/** Whether package has maestro-package keyword */\n\tisMaestroPackage: boolean;\n\t/** Validation errors if any */\n\terrors?: string[];\n}\n\n/**\n * Package loader options\n */\nexport interface PackageLoaderOptions {\n\t/** Working directory for resolving relative paths */\n\tcwd?: string;\n\t/** Whether to validate package contents */\n\tvalidate?: boolean;\n\t/** Custom cache directory for git/npm packages */\n\tcacheDir?: string;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/packages/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Maestro Package System Types\n *\n * Defines types for distributable extension bundles that can be loaded\n * from local filesystem, git repositories, or npm packages.\n */\n\n/**\n * Package manifest (maestro section in package.json)\n */\nexport interface MaestroManifest {\n\t/** Paths to custom agent directories */\n\tagents?: string[];\n\t/** Paths to extension directories */\n\textensions?: string[];\n\t/** Paths to skill directories */\n\tskills?: string[];\n\t/** Paths to prompt template directories */\n\tprompts?: string[];\n\t/** Paths to theme directories */\n\tthemes?: string[];\n}\n\n/**\n * Package.json structure for maestro packages\n */\nexport interface PackageJson {\n\tname: string;\n\tversion?: string;\n\tkeywords?: string[];\n\tmaestro?: MaestroManifest;\n}\n\n/**\n * Package source types\n */\nexport type PackageSourceType = \"local\" | \"git\" | \"npm\";\n\n/**\n * Git source with optional reference\n */\nexport interface GitSource {\n\ttype: \"git\";\n\turl: string;\n\tref?: string; // branch, tag, or commit\n}\n\n/**\n * Local filesystem source\n */\nexport interface LocalSource {\n\ttype: \"local\";\n\tpath: string;\n}\n\n/**\n * npm registry source\n */\nexport interface NpmSource {\n\ttype: \"npm\";\n\tname: string;\n\tversion?: string;\n}\n\n/**\n * Union of all source types\n */\nexport type PackageSource = GitSource | LocalSource | NpmSource;\n\n/**\n * Resource filter patterns\n */\nexport interface ResourceFilters {\n\t/** Glob patterns for custom agents */\n\tagents?: string[];\n\t/** Glob patterns for extensions (supports ! for exclusion) */\n\textensions?: string[];\n\t/** Glob patterns for skills */\n\tskills?: string[];\n\t/** Glob patterns for prompts */\n\tprompts?: string[];\n\t/** Glob patterns for themes */\n\tthemes?: string[];\n}\n\n/**\n * Package specification - string or object form\n */\nexport type PackageSpec =\n\t| string // \"local:./path\" or \"git:url\" or \"npm:name@version\"\n\t| (ResourceFilters & { source: string });\n\n/**\n * Loaded package metadata\n */\nexport interface LoadedPackage {\n\t/** Package name from package.json */\n\tname: string;\n\t/** Package version */\n\tversion?: string;\n\t/** Resolved source information */\n\tsource: PackageSource;\n\t/** Absolute path to package directory */\n\tpath: string;\n\t/** Package manifest */\n\tmanifest: MaestroManifest;\n\t/** Applied filters */\n\tfilters?: ResourceFilters;\n}\n\n/**\n * Loaded resources from a package\n */\nexport interface PackageResources {\n\t/** Package metadata */\n\tpackage: LoadedPackage;\n\t/** Loaded custom agent paths */\n\tagents: string[];\n\t/** Loaded extension paths */\n\textensions: string[];\n\t/** Loaded skill paths */\n\tskills: string[];\n\t/** Loaded prompt paths */\n\tprompts: string[];\n\t/** Loaded theme paths */\n\tthemes: string[];\n}\n\n/**\n * Package discovery result\n */\nexport interface DiscoveredPackage {\n\t/** Package directory path */\n\tpath: string;\n\t/** Parsed package.json */\n\tpackageJson: PackageJson;\n\t/** Whether package has maestro-package keyword */\n\tisMaestroPackage: boolean;\n\t/** Validation errors if any */\n\terrors?: string[];\n}\n\n/**\n * Package loader options\n */\nexport interface PackageLoaderOptions {\n\t/** Working directory for resolving relative paths */\n\tcwd?: string;\n\t/** Whether to validate package contents */\n\tvalidate?: boolean;\n\t/** Custom cache directory for git/npm packages */\n\tcacheDir?: string;\n}\n"]}

package/dist/runtime/agent-runtime.d.ts

@@ -1,9 +1,8 @@
 import type { Agent } from "../agent/agent.js";
-import type { AppMessage } from "../agent/types.js";
-import { type PromptPayload } from "../cli-tui/prompt-queue.js";
-import type { TuiRenderer } from "../cli-tui/tui-renderer.js";
+import type { AgentState, AppMessage } from "../agent/types.js";
 import type { ComposerConfig } from "../config/index.js";
 import type { SessionManager } from "../session/manager.js";
+import { type PromptPayload } from "./prompt-queue.js";
 export interface InterruptOptions {
     /** If true, preserve the partial response in message history */
     keepPartial?: boolean;
@@ -12,12 +11,29 @@ export interface InterruptResult {
     /** The partial message that was saved, if keepPartial was true */
     partialMessage?: AppMessage | null;
 }
+/**
+ * Structural contract the runtime needs from a UI renderer. Any renderer
+ * (interactive terminal UI, headless, future bridge shim, etc.) that satisfies
+ * this shape can be attached. The interactive TypeScript terminal renderer
+ * implements this contract. Kept intentionally minimal and UI-agnostic so this
+ * runtime module never needs to import terminal-UI packages or the interactive
+ * terminal renderer module tree.
+ */
+export interface AgentRuntimeRenderer {
+    ensureContextBudgetBeforePrompt?(): Promise<void>;
+    collectActiveSkillMessagesForCompaction?(preservedMessages?: AppMessage[]): AppMessage[];
+    showInfo(message: string): void;
+    renderInitialMessages(state: AgentState): void;
+    refreshFooterHint(): void;
+    setInterruptCallback(callback: (options?: InterruptOptions) => InterruptResult | undefined): void;
+    getUserInput(): Promise<PromptPayload>;
+}
 interface AgentRuntimeControllerOptions {
     agent: Agent;
     sessionManager: SessionManager;
     profileName?: string;
     cliOverrides?: Partial<ComposerConfig>;
-    renderer?: TuiRenderer;
+    renderer?: AgentRuntimeRenderer;
     onError?: (error: unknown) => void;
 }
 export declare class AgentRuntimeController {
@@ -26,7 +42,7 @@ export declare class AgentRuntimeController {
     private running;
     private renderer?;
     constructor(options: AgentRuntimeControllerOptions);
-    attachRenderer(renderer: TuiRenderer): void;
+    attachRenderer(renderer: AgentRuntimeRenderer): void;
     enqueue(payload: PromptPayload): void;
     /**
      * Interrupt the current agent operation.
@@ -36,7 +52,7 @@ export declare class AgentRuntimeController {
      */
     interrupt(options?: InterruptOptions): InterruptResult;
     stop(): void;
-    runInteractiveLoop(renderer: TuiRenderer): Promise<void>;
+    runInteractiveLoop(renderer: AgentRuntimeRenderer): Promise<void>;
 }
 export {};
 //# sourceMappingURL=agent-runtime.d.ts.map

package/dist/runtime/agent-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,kEAAkE;IAClE,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC;AAED,UAAU,6BAA6B;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,sBAAsB;IAKtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAc;gBAEF,OAAO,EAAE,6BAA6B;IA6FnE,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAK3C,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe;IAatD,IAAI,IAAI,IAAI;IAIN,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAS9D"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,mBAAmB,CAAC;AAIpE,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,kEAAkE;IAClE,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACpC,+BAA+B,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,uCAAuC,CAAC,CACvC,iBAAiB,CAAC,EAAE,UAAU,EAAE,GAC9B,UAAU,EAAE,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/C,iBAAiB,IAAI,IAAI,CAAC;IAC1B,oBAAoB,CACnB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,eAAe,GAAG,SAAS,GACnE,IAAI,CAAC;IACR,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACvC;AAED,UAAU,6BAA6B;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,sBAAsB;IAKtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAuB;gBAEX,OAAO,EAAE,6BAA6B;IA6FnE,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAKpD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe;IAatD,IAAI,IAAI,IAAI;IAIN,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CASvE"}

package/dist/runtime/agent-runtime.js

@@ -1,9 +1,9 @@
 import { buildCompactionEvent } from "../agent/prompt-recovery.js";
 import { runUserPromptWithRecovery } from "../agent/user-prompt-runtime.js";
-import { PromptQueue } from "../cli-tui/prompt-queue.js";
 import { composerManager } from "../composers/index.js";
 import { withMcpPostKeepMessages } from "../mcp/prompt-recovery.js";
 import { createLogger } from "../utils/logger.js";
+import { PromptQueue } from "./prompt-queue.js";
 const logger = createLogger("agent-runtime");
 export class AgentRuntimeController {
     constructor(options) {