@evalops/maestro 0.10.18 → 0.10.21

package/dist/skills/runtime-activation.js

@@ -0,0 +1,228 @@
+import { constants, accessSync, existsSync, readFileSync, readdirSync, statSync, } from "node:fs";
+import { join } from "node:path";
+import { isWindowsRunnableToolboxEntry } from "./linter.js";
+const MAX_MCP_JSON_BYTES = 1024 * 1024;
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function isDirectory(path) {
+    if (!path || !existsSync(path)) {
+        return false;
+    }
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function isFile(path) {
+    if (!path || !existsSync(path)) {
+        return false;
+    }
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : undefined;
+}
+function nonEmptyStringList(value) {
+    if (!Array.isArray(value)) {
+        return { status: "missing", values: [] };
+    }
+    const values = [];
+    for (const entry of value) {
+        const normalized = nonEmptyString(entry);
+        if (!normalized) {
+            return { status: "invalid", values: [] };
+        }
+        values.push(normalized);
+    }
+    return { status: "valid", values };
+}
+function isRunnableFile(path, platform = process.platform) {
+    if (!isFile(path)) {
+        return false;
+    }
+    if (platform === "win32") {
+        return isWindowsRunnableToolboxEntry(path);
+    }
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function buildResourceDirectories(skill) {
+    return {
+        ...(skill.resourceDirs.scriptsDir
+            ? { scripts: skill.resourceDirs.scriptsDir }
+            : {}),
+        ...(skill.resourceDirs.referenceDir
+            ? { reference: skill.resourceDirs.referenceDir }
+            : {}),
+        ...(skill.resourceDirs.referencesDir
+            ? { references: skill.resourceDirs.referencesDir }
+            : {}),
+        ...(skill.resourceDirs.assetsDir
+            ? { assets: skill.resourceDirs.assetsDir }
+            : {}),
+        ...(skill.resourceDirs.toolboxDir
+            ? { toolbox: skill.resourceDirs.toolboxDir }
+            : {}),
+    };
+}
+function buildToolboxActivation(toolboxDir, options = {}) {
+    if (!isDirectory(toolboxDir)) {
+        return undefined;
+    }
+    let directoryEntries;
+    try {
+        directoryEntries = readdirSync(toolboxDir);
+    }
+    catch (error) {
+        return {
+            directory: toolboxDir,
+            entries: [],
+            warnings: [`toolbox directory could not be read: ${errorMessage(error)}`],
+        };
+    }
+    const entries = directoryEntries
+        .filter((entry) => !entry.startsWith(".") && entry.toLowerCase() !== "readme.md")
+        .map((entry) => ({ name: entry, path: join(toolboxDir, entry) }))
+        .filter((entry) => isRunnableFile(entry.path, options.platform ?? process.platform))
+        .sort((left, right) => left.name.localeCompare(right.name));
+    return {
+        directory: toolboxDir,
+        entries,
+    };
+}
+function buildMcpActivation(mcpJsonPath) {
+    if (!isFile(mcpJsonPath)) {
+        return undefined;
+    }
+    const warnings = [];
+    let stats;
+    try {
+        stats = statSync(mcpJsonPath);
+    }
+    catch (error) {
+        warnings.push(`mcp.json could not be inspected: ${errorMessage(error)}`);
+        return { configPath: mcpJsonPath, servers: [], warnings };
+    }
+    if (stats.size > MAX_MCP_JSON_BYTES) {
+        warnings.push(`mcp.json is too large to load: ${stats.size} bytes exceeds ${MAX_MCP_JSON_BYTES} byte limit.`);
+        return { configPath: mcpJsonPath, servers: [], warnings };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(mcpJsonPath, "utf8"));
+    }
+    catch (error) {
+        warnings.push(`mcp.json could not be parsed: ${errorMessage(error)}`);
+        return { configPath: mcpJsonPath, servers: [], warnings };
+    }
+    if (!isRecord(parsed)) {
+        return {
+            configPath: mcpJsonPath,
+            servers: [],
+            warnings: ["mcp.json must be an object keyed by server name."],
+        };
+    }
+    const servers = [];
+    for (const [name, server] of Object.entries(parsed).sort(([left], [right]) => left.localeCompare(right))) {
+        if (!isRecord(server)) {
+            warnings.push(`MCP server '${name}' must be an object.`);
+            continue;
+        }
+        const command = nonEmptyString(server.command);
+        if (!command) {
+            warnings.push(`MCP server '${name}' requires a non-empty command.`);
+            continue;
+        }
+        const includeTools = nonEmptyStringList(server.includeTools);
+        if (includeTools.status === "invalid") {
+            warnings.push(`MCP server '${name}' includeTools entries must be non-empty strings.`);
+            continue;
+        }
+        if (includeTools.status === "missing" || includeTools.values.length === 0) {
+            warnings.push(`MCP server '${name}' does not declare bounded includeTools.`);
+            continue;
+        }
+        if (server.args !== undefined &&
+            (!Array.isArray(server.args) ||
+                server.args.some((arg) => typeof arg !== "string"))) {
+            warnings.push(`MCP server '${name}' args entries must be strings.`);
+            continue;
+        }
+        if (server.env !== undefined &&
+            (!isRecord(server.env) ||
+                Object.values(server.env).some((value) => typeof value !== "string"))) {
+            warnings.push(`MCP server '${name}' env values must be strings.`);
+            continue;
+        }
+        servers.push({
+            name,
+            command,
+            includeTools: includeTools.values,
+        });
+    }
+    return {
+        configPath: mcpJsonPath,
+        servers,
+        ...(warnings.length > 0 ? { warnings } : {}),
+    };
+}
+/**
+ * Build the runtime-facing activation contract for a loaded skill.
+ *
+ * This intentionally exposes only scoped resource paths and MCP tool bounds. The
+ * raw MCP config remains on disk so runtimes can activate it without copying env
+ * values or credentials into agent-visible telemetry.
+ */
+export function buildSkillRuntimeActivation(skill, options = {}) {
+    const toolbox = buildToolboxActivation(skill.resourceDirs.toolboxDir, options);
+    const mcp = buildMcpActivation(skill.resourceDirs.mcpJsonPath);
+    return {
+        name: skill.name,
+        source: skill.sourceType,
+        ...(skill.sourcePath ? { sourcePath: skill.sourcePath } : {}),
+        profile: {
+            ...(skill.argumentHint ? { argumentHint: skill.argumentHint } : {}),
+            ...(skill.compatibility ? { compatibility: skill.compatibility } : {}),
+            ...(skill.isolatedContext !== undefined
+                ? { isolatedContext: skill.isolatedContext }
+                : {}),
+            ...(skill.mode ? { mode: skill.mode } : {}),
+            ...(skill.model ? { model: skill.model } : {}),
+        },
+        tools: {
+            allowed: [...(skill.allowedTools ?? [])],
+            builtin: [...(skill.builtinTools ?? [])],
+        },
+        resources: {
+            files: skill.resources.map((resource) => ({
+                name: resource.name,
+                path: resource.path,
+                type: resource.type,
+            })),
+            directories: buildResourceDirectories(skill),
+        },
+        toolPackage: {
+            ...(toolbox ? { toolbox } : {}),
+            ...(mcp ? { mcp } : {}),
+        },
+    };
+}
+//# sourceMappingURL=runtime-activation.js.map

package/dist/skills/runtime-activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-activation.js","sourceRoot":"","sources":["../../src/skills/runtime-activation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tconstants,\n\taccessSync,\n\texistsSync,\n\treadFileSync,\n\treaddirSync,\n\tstatSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isWindowsRunnableToolboxEntry } from \"./linter.js\";\nimport type { LoadedSkill, SkillResource } from \"./loader.js\";\n\nconst MAX_MCP_JSON_BYTES = 1024 * 1024;\n\nexport interface SkillRuntimeActivation {\n\tname: string;\n\tsource: LoadedSkill[\"sourceType\"];\n\tsourcePath?: string;\n\tprofile: {\n\t\targumentHint?: string;\n\t\tcompatibility?: string;\n\t\tisolatedContext?: boolean;\n\t\tmode?: string;\n\t\tmodel?: string;\n\t};\n\ttools: {\n\t\tallowed: string[];\n\t\tbuiltin: string[];\n\t};\n\tresources: {\n\t\tfiles: SkillRuntimeResource[];\n\t\tdirectories: SkillRuntimeResourceDirectories;\n\t};\n\ttoolPackage: {\n\t\ttoolbox?: SkillRuntimeToolboxActivation;\n\t\tmcp?: SkillRuntimeMcpActivation;\n\t};\n}\n\nexport interface SkillRuntimeResource {\n\tname: string;\n\tpath: string;\n\ttype: SkillResource[\"type\"];\n}\n\nexport interface SkillRuntimeResourceDirectories {\n\tscripts?: string;\n\treference?: string;\n\treferences?: string;\n\tassets?: string;\n\ttoolbox?: string;\n}\n\nexport interface SkillRuntimeToolboxActivation {\n\tdirectory: string;\n\tentries: SkillRuntimeToolboxEntry[];\n\twarnings?: string[];\n}\n\nexport interface SkillRuntimeToolboxEntry {\n\tname: string;\n\tpath: string;\n}\n\nexport interface SkillRuntimeMcpActivation {\n\tconfigPath: string;\n\tservers: SkillRuntimeMcpServer[];\n\twarnings?: string[];\n}\n\nexport interface SkillRuntimeMcpServer {\n\tname: string;\n\tcommand: string;\n\tincludeTools: string[];\n}\n\nexport interface SkillRuntimeActivationOptions {\n\tplatform?: NodeJS.Platform;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn Boolean(value && typeof value === \"object\" && !Array.isArray(value));\n}\n\nfunction isDirectory(path: string | undefined): path is string {\n\tif (!path || !existsSync(path)) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isFile(path: string | undefined): path is string {\n\tif (!path || !existsSync(path)) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n\treturn typeof value === \"string\" && value.trim().length > 0\n\t\t? value.trim()\n\t\t: undefined;\n}\n\ntype StringListParseResult =\n\t| { status: \"valid\"; values: string[] }\n\t| { status: \"missing\"; values: [] }\n\t| { status: \"invalid\"; values: [] };\n\nfunction nonEmptyStringList(value: unknown): StringListParseResult {\n\tif (!Array.isArray(value)) {\n\t\treturn { status: \"missing\", values: [] };\n\t}\n\tconst values: string[] = [];\n\tfor (const entry of value) {\n\t\tconst normalized = nonEmptyString(entry);\n\t\tif (!normalized) {\n\t\t\treturn { status: \"invalid\", values: [] };\n\t\t}\n\t\tvalues.push(normalized);\n\t}\n\treturn { status: \"valid\", values };\n}\n\nfunction isRunnableFile(\n\tpath: string | undefined,\n\tplatform: NodeJS.Platform = process.platform,\n): path is string {\n\tif (!isFile(path)) {\n\t\treturn false;\n\t}\n\tif (platform === \"win32\") {\n\t\treturn isWindowsRunnableToolboxEntry(path);\n\t}\n\ttry {\n\t\taccessSync(path, constants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction errorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction buildResourceDirectories(\n\tskill: LoadedSkill,\n): SkillRuntimeResourceDirectories {\n\treturn {\n\t\t...(skill.resourceDirs.scriptsDir\n\t\t\t? { scripts: skill.resourceDirs.scriptsDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.referenceDir\n\t\t\t? { reference: skill.resourceDirs.referenceDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.referencesDir\n\t\t\t? { references: skill.resourceDirs.referencesDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.assetsDir\n\t\t\t? { assets: skill.resourceDirs.assetsDir }\n\t\t\t: {}),\n\t\t...(skill.resourceDirs.toolboxDir\n\t\t\t? { toolbox: skill.resourceDirs.toolboxDir }\n\t\t\t: {}),\n\t};\n}\n\nfunction buildToolboxActivation(\n\ttoolboxDir: string | undefined,\n\toptions: SkillRuntimeActivationOptions = {},\n): SkillRuntimeToolboxActivation | undefined {\n\tif (!isDirectory(toolboxDir)) {\n\t\treturn undefined;\n\t}\n\tlet directoryEntries: string[];\n\ttry {\n\t\tdirectoryEntries = readdirSync(toolboxDir);\n\t} catch (error) {\n\t\treturn {\n\t\t\tdirectory: toolboxDir,\n\t\t\tentries: [],\n\t\t\twarnings: [`toolbox directory could not be read: ${errorMessage(error)}`],\n\t\t};\n\t}\n\tconst entries = directoryEntries\n\t\t.filter(\n\t\t\t(entry) => !entry.startsWith(\".\") && entry.toLowerCase() !== \"readme.md\",\n\t\t)\n\t\t.map((entry) => ({ name: entry, path: join(toolboxDir, entry) }))\n\t\t.filter((entry) =>\n\t\t\tisRunnableFile(entry.path, options.platform ?? process.platform),\n\t\t)\n\t\t.sort((left, right) => left.name.localeCompare(right.name));\n\n\treturn {\n\t\tdirectory: toolboxDir,\n\t\tentries,\n\t};\n}\n\nfunction buildMcpActivation(\n\tmcpJsonPath: string | undefined,\n): SkillRuntimeMcpActivation | undefined {\n\tif (!isFile(mcpJsonPath)) {\n\t\treturn undefined;\n\t}\n\n\tconst warnings: string[] = [];\n\tlet stats: ReturnType<typeof statSync>;\n\ttry {\n\t\tstats = statSync(mcpJsonPath);\n\t} catch (error) {\n\t\twarnings.push(`mcp.json could not be inspected: ${errorMessage(error)}`);\n\t\treturn { configPath: mcpJsonPath, servers: [], warnings };\n\t}\n\tif (stats.size > MAX_MCP_JSON_BYTES) {\n\t\twarnings.push(\n\t\t\t`mcp.json is too large to load: ${stats.size} bytes exceeds ${MAX_MCP_JSON_BYTES} byte limit.`,\n\t\t);\n\t\treturn { configPath: mcpJsonPath, servers: [], warnings };\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(readFileSync(mcpJsonPath, \"utf8\"));\n\t} catch (error) {\n\t\twarnings.push(`mcp.json could not be parsed: ${errorMessage(error)}`);\n\t\treturn { configPath: mcpJsonPath, servers: [], warnings };\n\t}\n\n\tif (!isRecord(parsed)) {\n\t\treturn {\n\t\t\tconfigPath: mcpJsonPath,\n\t\t\tservers: [],\n\t\t\twarnings: [\"mcp.json must be an object keyed by server name.\"],\n\t\t};\n\t}\n\n\tconst servers: SkillRuntimeMcpServer[] = [];\n\tfor (const [name, server] of Object.entries(parsed).sort(([left], [right]) =>\n\t\tleft.localeCompare(right),\n\t)) {\n\t\tif (!isRecord(server)) {\n\t\t\twarnings.push(`MCP server '${name}' must be an object.`);\n\t\t\tcontinue;\n\t\t}\n\t\tconst command = nonEmptyString(server.command);\n\t\tif (!command) {\n\t\t\twarnings.push(`MCP server '${name}' requires a non-empty command.`);\n\t\t\tcontinue;\n\t\t}\n\t\tconst includeTools = nonEmptyStringList(server.includeTools);\n\t\tif (includeTools.status === \"invalid\") {\n\t\t\twarnings.push(\n\t\t\t\t`MCP server '${name}' includeTools entries must be non-empty strings.`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (includeTools.status === \"missing\" || includeTools.values.length === 0) {\n\t\t\twarnings.push(\n\t\t\t\t`MCP server '${name}' does not declare bounded includeTools.`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tserver.args !== undefined &&\n\t\t\t(!Array.isArray(server.args) ||\n\t\t\t\tserver.args.some((arg) => typeof arg !== \"string\"))\n\t\t) {\n\t\t\twarnings.push(`MCP server '${name}' args entries must be strings.`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tserver.env !== undefined &&\n\t\t\t(!isRecord(server.env) ||\n\t\t\t\tObject.values(server.env).some((value) => typeof value !== \"string\"))\n\t\t) {\n\t\t\twarnings.push(`MCP server '${name}' env values must be strings.`);\n\t\t\tcontinue;\n\t\t}\n\t\tservers.push({\n\t\t\tname,\n\t\t\tcommand,\n\t\t\tincludeTools: includeTools.values,\n\t\t});\n\t}\n\n\treturn {\n\t\tconfigPath: mcpJsonPath,\n\t\tservers,\n\t\t...(warnings.length > 0 ? { warnings } : {}),\n\t};\n}\n\n/**\n * Build the runtime-facing activation contract for a loaded skill.\n *\n * This intentionally exposes only scoped resource paths and MCP tool bounds. The\n * raw MCP config remains on disk so runtimes can activate it without copying env\n * values or credentials into agent-visible telemetry.\n */\nexport function buildSkillRuntimeActivation(\n\tskill: LoadedSkill,\n\toptions: SkillRuntimeActivationOptions = {},\n): SkillRuntimeActivation {\n\tconst toolbox = buildToolboxActivation(\n\t\tskill.resourceDirs.toolboxDir,\n\t\toptions,\n\t);\n\tconst mcp = buildMcpActivation(skill.resourceDirs.mcpJsonPath);\n\n\treturn {\n\t\tname: skill.name,\n\t\tsource: skill.sourceType,\n\t\t...(skill.sourcePath ? { sourcePath: skill.sourcePath } : {}),\n\t\tprofile: {\n\t\t\t...(skill.argumentHint ? { argumentHint: skill.argumentHint } : {}),\n\t\t\t...(skill.compatibility ? { compatibility: skill.compatibility } : {}),\n\t\t\t...(skill.isolatedContext !== undefined\n\t\t\t\t? { isolatedContext: skill.isolatedContext }\n\t\t\t\t: {}),\n\t\t\t...(skill.mode ? { mode: skill.mode } : {}),\n\t\t\t...(skill.model ? { model: skill.model } : {}),\n\t\t},\n\t\ttools: {\n\t\t\tallowed: [...(skill.allowedTools ?? [])],\n\t\t\tbuiltin: [...(skill.builtinTools ?? [])],\n\t\t},\n\t\tresources: {\n\t\t\tfiles: skill.resources.map((resource) => ({\n\t\t\t\tname: resource.name,\n\t\t\t\tpath: resource.path,\n\t\t\t\ttype: resource.type,\n\t\t\t})),\n\t\t\tdirectories: buildResourceDirectories(skill),\n\t\t},\n\t\ttoolPackage: {\n\t\t\t...(toolbox ? { toolbox } : {}),\n\t\t\t...(mcp ? { mcp } : {}),\n\t\t},\n\t};\n}\n"]}

package/dist/skills/service-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../../src/skills/service-client.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,qBAAqB,IAAI,yBAAyB,EAEvD,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS/C,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAC;AAIX,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,yBAAyB,CAAC;CACvC;AA8ED,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,mBAAmB,GAAG,KAAK,GAAG,SAAS,GAC7C,2BAA2B,GAAG,IAAI,CAkGpC;AAmHD,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAChC,OAAO,CAAC,WAAW,EAAE,CAAC,CAyCxB;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}
+{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../../src/skills/service-client.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,KAAK,qBAAqB,IAAI,yBAAyB,EAEvD,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS/C,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAC;AAIX,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,yBAAyB,CAAC;CACvC;AA4ED,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,mBAAmB,GAAG,KAAK,GAAG,SAAS,GAC7C,2BAA2B,GAAG,IAAI,CAkGpC;AAmHD,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAChC,OAAO,CAAC,WAAW,EAAE,CAAC,CAyCxB;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/skills/service-client.js

@@ -1,3 +1,4 @@
+import { EVALOPS_ACCESS_TOKEN_ENV_VARS, EVALOPS_ORGANIZATION_ID_ENV_VARS, } from "../evalops/env-aliases.js";
 import { loadOAuthCredentials } from "../oauth/storage.js";
 import { fetchDownstream, } from "../utils/downstream-http.js";
 import * as downstream from "../utils/downstream.js";
@@ -45,9 +46,7 @@ function resolveWorkspaceId(config) {
     const envWorkspaceId = getEnvValue([
         "SKILLS_SERVICE_WORKSPACE_ID",
         "MAESTRO_SKILLS_WORKSPACE_ID",
-        "MAESTRO_EVALOPS_ORG_ID",
-        "EVALOPS_ORGANIZATION_ID",
-        "MAESTRO_ENTERPRISE_ORG_ID",
+        ...EVALOPS_ORGANIZATION_ID_ENV_VARS,
     ]);
     if (configuredWorkspaceId ?? envWorkspaceId) {
         return configuredWorkspaceId ?? envWorkspaceId;
@@ -81,7 +80,7 @@ export function resolveSkillsServiceConfig(config) {
         getEnvValue([
             "SKILLS_SERVICE_TOKEN",
             "MAESTRO_SKILLS_SERVICE_TOKEN",
-            "MAESTRO_EVALOPS_ACCESS_TOKEN",
+            ...EVALOPS_ACCESS_TOKEN_ENV_VARS,
         ]) ??
         storedToken;
     const required = config?.required ??

package/dist/skills/service-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-client.js","sourceRoot":"","sources":["../../src/skills/service-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { loadOAuthCredentials } from \"../oauth/storage.js\";\nimport {\n\ttype DownstreamFailureMode as DownstreamHttpFailureMode,\n\tfetchDownstream,\n} from \"../utils/downstream-http.js\";\nimport * as downstream from \"../utils/downstream.js\";\nimport type { LoadedSkill } from \"./loader.js\";\n\nconst CONNECT_PROTOCOL_VERSION = \"1\";\nconst DEFAULT_LIMIT = 100;\nconst DEFAULT_MAX_ATTEMPTS = 2;\nconst DEFAULT_SURFACE = \"maestro\";\nconst DEFAULT_TIMEOUT_MS = 2_000;\nconst LIST_SKILLS_PATH = \"/skills.v1.SkillService/List\";\n\nexport const SKILLS_CALL_FAILURE_MODES = {\n\tlistSkills: {\n\t\toptional: downstream.FailOpen,\n\t\trequired: downstream.FailClosed,\n\t},\n} as const;\n\ntype SkillsCall = keyof typeof SKILLS_CALL_FAILURE_MODES;\n\nexport interface SkillsServiceConfig {\n\tbaseUrl?: string;\n\ttoken?: string;\n\tworkspaceId?: string;\n\tsurface?: string;\n\tentityId?: string;\n\tlimit?: number;\n\ttimeoutMs?: number;\n\tmaxAttempts?: number;\n\tcircuitFailureThreshold?: number;\n\tcircuitResetTimeoutMs?: number;\n\tcircuitSuccessThreshold?: number;\n\trequired?: boolean;\n}\n\nexport interface ResolvedSkillsServiceConfig {\n\tbaseUrl: string;\n\ttoken?: string;\n\tworkspaceId: string;\n\tsurface: string;\n\tentityId?: string;\n\tlimit: number;\n\ttimeoutMs: number;\n\tmaxAttempts: number;\n\tcircuitFailureThreshold: number;\n\tcircuitResetTimeoutMs: number;\n\tcircuitSuccessThreshold: number;\n\tfailureMode: DownstreamHttpFailureMode;\n}\n\ninterface SkillsServiceSkill {\n\tid?: string;\n\tworkspaceId?: string;\n\townerId?: string;\n\tname?: string;\n\tdescription?: string;\n\tscope?: string | number;\n\tcontent?: string;\n\tcurrentVersion?: number;\n\ttags?: string[];\n}\n\ninterface ListSkillsResponse {\n\tskills?: SkillsServiceSkill[];\n\ttotal?: number;\n}\n\nconst downstreamClients = new Map<string, downstream.DownstreamClient>();\n\nfunction trimString(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction getEnvValue(names: string[]): string | undefined {\n\tfor (const name of names) {\n\t\tconst value = trimString(process.env[name]);\n\t\tif (value) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction parsePositiveInt(value: string | undefined, fallback: number): number {\n\tconst parsed = Number.parseInt(value ?? \"\", 10);\n\treturn Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n\tlet normalized = baseUrl.trim();\n\tfor (const suffix of [LIST_SKILLS_PATH, \"/skills.v1.SkillService\"]) {\n\t\tif (normalized.endsWith(suffix)) {\n\t\t\tnormalized = normalized.slice(0, -suffix.length);\n\t\t}\n\t}\n\treturn normalized.replace(/\\/+$/, \"\");\n}\n\nfunction resolveWorkspaceId(\n\tconfig: SkillsServiceConfig | undefined,\n): string | undefined {\n\tconst configuredWorkspaceId = trimString(config?.workspaceId);\n\tconst envWorkspaceId = getEnvValue([\n\t\t\"SKILLS_SERVICE_WORKSPACE_ID\",\n\t\t\"MAESTRO_SKILLS_WORKSPACE_ID\",\n\t\t\"MAESTRO_EVALOPS_ORG_ID\",\n\t\t\"EVALOPS_ORGANIZATION_ID\",\n\t\t\"MAESTRO_ENTERPRISE_ORG_ID\",\n\t]);\n\tif (configuredWorkspaceId ?? envWorkspaceId) {\n\t\treturn configuredWorkspaceId ?? envWorkspaceId;\n\t}\n\tconst stored = loadOAuthCredentials(\"evalops\")?.metadata?.organizationId;\n\treturn typeof stored === \"string\" && stored.trim().length > 0\n\t\t? stored.trim()\n\t\t: undefined;\n}\n\nfunction normalizeLimit(value: number | undefined): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\treturn DEFAULT_LIMIT;\n\t}\n\treturn Math.max(1, Math.min(500, Math.trunc(value)));\n}\n\nexport function resolveSkillsServiceConfig(\n\tconfig: SkillsServiceConfig | false | undefined,\n): ResolvedSkillsServiceConfig | null {\n\tif (config === false) {\n\t\treturn null;\n\t}\n\n\tconst baseUrl =\n\t\ttrimString(config?.baseUrl) ??\n\t\tgetEnvValue([\"SKILLS_SERVICE_URL\", \"MAESTRO_SKILLS_SERVICE_URL\"]);\n\tif (!baseUrl) {\n\t\treturn null;\n\t}\n\n\tconst workspaceId = resolveWorkspaceId(config);\n\tif (!workspaceId) {\n\t\treturn null;\n\t}\n\n\tconst storedToken = trimString(loadOAuthCredentials(\"evalops\")?.access);\n\tconst token =\n\t\ttrimString(config?.token) ??\n\t\tgetEnvValue([\n\t\t\t\"SKILLS_SERVICE_TOKEN\",\n\t\t\t\"MAESTRO_SKILLS_SERVICE_TOKEN\",\n\t\t\t\"MAESTRO_EVALOPS_ACCESS_TOKEN\",\n\t\t]) ??\n\t\tstoredToken;\n\n\tconst required =\n\t\tconfig?.required ??\n\t\tgetEnvValue([\n\t\t\t\"SKILLS_SERVICE_REQUIRED\",\n\t\t\t\"MAESTRO_SKILLS_SERVICE_REQUIRED\",\n\t\t]) === \"1\";\n\n\treturn {\n\t\tbaseUrl: normalizeBaseUrl(baseUrl),\n\t\tcircuitFailureThreshold:\n\t\t\tconfig?.circuitFailureThreshold ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_CIRCUIT_FAILURE_THRESHOLD\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_CIRCUIT_FAILURE_THRESHOLD\",\n\t\t\t\t]),\n\t\t\t\t5,\n\t\t\t),\n\t\tcircuitResetTimeoutMs:\n\t\t\tconfig?.circuitResetTimeoutMs ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_CIRCUIT_RESET_TIMEOUT_MS\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_CIRCUIT_RESET_TIMEOUT_MS\",\n\t\t\t\t]),\n\t\t\t\t30_000,\n\t\t\t),\n\t\tcircuitSuccessThreshold:\n\t\t\tconfig?.circuitSuccessThreshold ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_CIRCUIT_SUCCESS_THRESHOLD\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_CIRCUIT_SUCCESS_THRESHOLD\",\n\t\t\t\t]),\n\t\t\t\t2,\n\t\t\t),\n\t\tentityId:\n\t\t\ttrimString(config?.entityId) ??\n\t\t\tgetEnvValue([\"SKILLS_SERVICE_ENTITY_ID\", \"MAESTRO_SKILLS_ENTITY_ID\"]),\n\t\tfailureMode: required ? \"required\" : \"optional\",\n\t\tlimit:\n\t\t\tconfig?.limit ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\"SKILLS_SERVICE_LIMIT\", \"MAESTRO_SKILLS_SERVICE_LIMIT\"]),\n\t\t\t\tDEFAULT_LIMIT,\n\t\t\t),\n\t\tmaxAttempts:\n\t\t\tconfig?.maxAttempts ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_MAX_ATTEMPTS\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_MAX_ATTEMPTS\",\n\t\t\t\t]),\n\t\t\t\tDEFAULT_MAX_ATTEMPTS,\n\t\t\t),\n\t\tsurface:\n\t\t\ttrimString(config?.surface) ??\n\t\t\tgetEnvValue([\"SKILLS_SERVICE_SURFACE\"]) ??\n\t\t\tDEFAULT_SURFACE,\n\t\ttimeoutMs:\n\t\t\tconfig?.timeoutMs ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_TIMEOUT_MS\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_TIMEOUT_MS\",\n\t\t\t\t]),\n\t\t\t\tDEFAULT_TIMEOUT_MS,\n\t\t\t),\n\t\ttoken,\n\t\tworkspaceId,\n\t};\n}\n\nfunction getDownstreamClient(\n\tconfig: ResolvedSkillsServiceConfig,\n\top: SkillsCall,\n): downstream.DownstreamClient {\n\tconst failureMode = SKILLS_CALL_FAILURE_MODES[op][config.failureMode];\n\tconst key = JSON.stringify({\n\t\tbaseUrl: config.baseUrl,\n\t\tfailureMode,\n\t\top,\n\t\treset: config.circuitResetTimeoutMs,\n\t\tsuccess: config.circuitSuccessThreshold,\n\t\tthreshold: config.circuitFailureThreshold,\n\t});\n\tconst cached = downstreamClients.get(key);\n\tif (cached) {\n\t\treturn cached;\n\t}\n\tconst client = downstream.New(`skills.${op}`, {\n\t\tfailureMode,\n\t\tbreaker: {\n\t\t\tfailureThreshold: config.circuitFailureThreshold,\n\t\t\tresetTimeoutMs: config.circuitResetTimeoutMs,\n\t\t\tsuccessThreshold: config.circuitSuccessThreshold,\n\t\t\ttoolName: `skills.${op}`,\n\t\t},\n\t});\n\tdownstreamClients.set(key, client);\n\treturn client;\n}\n\nfunction toHttpFailureMode(\n\tclient: downstream.DownstreamClient,\n): DownstreamHttpFailureMode {\n\treturn client.failureMode === downstream.FailClosed ? \"required\" : \"optional\";\n}\n\nfunction buildHeaders(\n\tconfig: ResolvedSkillsServiceConfig,\n): Record<string, string> {\n\treturn {\n\t\t...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n\t\t\"Connect-Protocol-Version\": CONNECT_PROTOCOL_VERSION,\n\t\t\"Content-Type\": \"application/json\",\n\t\t\"X-Surface\": config.surface,\n\t\t...(config.entityId ? { \"X-Entity-ID\": config.entityId } : {}),\n\t};\n}\n\nfunction normalizeScope(\n\tscope: string | number | undefined,\n): string | undefined {\n\tswitch (scope) {\n\t\tcase \"SKILL_SCOPE_GLOBAL\":\n\t\tcase \"global\":\n\t\tcase 1:\n\t\t\treturn \"global\";\n\t\tcase \"SKILL_SCOPE_WORKSPACE\":\n\t\tcase \"workspace\":\n\t\tcase 2:\n\t\t\treturn \"workspace\";\n\t\tcase \"SKILL_SCOPE_PERSONAL\":\n\t\tcase \"personal\":\n\t\tcase 3:\n\t\t\treturn \"personal\";\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nfunction normalizeTags(tags: string[] | undefined): string[] | undefined {\n\tconst normalized = Array.isArray(tags)\n\t\t? tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0)\n\t\t: [];\n\treturn normalized.length > 0 ? normalized : undefined;\n}\n\nfunction toLoadedSkill(skill: SkillsServiceSkill): LoadedSkill | null {\n\tconst id = trimString(skill.id);\n\tconst name = trimString(skill.name);\n\tconst content = trimString(skill.content);\n\tif (!id || !name || !content) {\n\t\treturn null;\n\t}\n\n\tconst scope = normalizeScope(skill.scope);\n\tconst metadata: Record<string, string> = {\n\t\tskillServiceId: id,\n\t\t...(trimString(skill.workspaceId)\n\t\t\t? { workspaceId: trimString(skill.workspaceId)! }\n\t\t\t: {}),\n\t\t...(trimString(skill.ownerId)\n\t\t\t? { ownerId: trimString(skill.ownerId)! }\n\t\t\t: {}),\n\t\t...(typeof skill.currentVersion === \"number\" &&\n\t\tNumber.isFinite(skill.currentVersion)\n\t\t\t? { currentVersion: String(Math.trunc(skill.currentVersion)) }\n\t\t\t: {}),\n\t\t...(scope ? { scope } : {}),\n\t};\n\n\treturn {\n\t\tname,\n\t\tdescription: trimString(skill.description) ?? \"Skill from skills service\",\n\t\tcontent,\n\t\tmetadata,\n\t\ttags: normalizeTags(skill.tags),\n\t\tsourcePath: `skills-service://${id}`,\n\t\tsourceType: \"service\",\n\t\tresources: [],\n\t\tresourceDirs: {},\n\t};\n}\n\nexport async function loadSkillsFromService(\n\tconfig: ResolvedSkillsServiceConfig,\n\toptions?: { signal?: AbortSignal },\n): Promise<LoadedSkill[]> {\n\tconst client = getDownstreamClient(config, \"listSkills\");\n\treturn downstream.CallOp(\n\t\tclient,\n\t\t\"listSkills\",\n\t\tasync () => {\n\t\t\tconst response = await fetchDownstream(\n\t\t\t\t`${config.baseUrl}${LIST_SKILLS_PATH}`,\n\t\t\t\t{\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\theaders: buildHeaders(config),\n\t\t\t\t\tsignal: options?.signal,\n\t\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\t\tworkspaceId: config.workspaceId,\n\t\t\t\t\t\tlimit: normalizeLimit(config.limit),\n\t\t\t\t\t\toffset: 0,\n\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tserviceName: \"skills service\",\n\t\t\t\t\tfailureMode: toHttpFailureMode(client),\n\t\t\t\t\ttimeoutMs: config.timeoutMs,\n\t\t\t\t\tmaxAttempts: config.maxAttempts,\n\t\t\t\t},\n\t\t\t);\n\t\t\tif (!response.ok) {\n\t\t\t\tconst text = await response.text();\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`skills service returned ${response.status}: ${\n\t\t\t\t\t\ttext || response.statusText\n\t\t\t\t\t}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst payload = (await response.json()) as ListSkillsResponse;\n\t\t\treturn (payload.skills ?? [])\n\t\t\t\t.map(toLoadedSkill)\n\t\t\t\t.filter((skill): skill is LoadedSkill => skill !== null);\n\t\t},\n\t\t() => [],\n\t);\n}\n\nexport function resetSkillsDownstreamForTests(): void {\n\tdownstreamClients.clear();\n}\n"]}
+{"version":3,"file":"service-client.js","sourceRoot":"","sources":["../../src/skills/service-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tEVALOPS_ACCESS_TOKEN_ENV_VARS,\n\tEVALOPS_ORGANIZATION_ID_ENV_VARS,\n} from \"../evalops/env-aliases.js\";\nimport { loadOAuthCredentials } from \"../oauth/storage.js\";\nimport {\n\ttype DownstreamFailureMode as DownstreamHttpFailureMode,\n\tfetchDownstream,\n} from \"../utils/downstream-http.js\";\nimport * as downstream from \"../utils/downstream.js\";\nimport type { LoadedSkill } from \"./loader.js\";\n\nconst CONNECT_PROTOCOL_VERSION = \"1\";\nconst DEFAULT_LIMIT = 100;\nconst DEFAULT_MAX_ATTEMPTS = 2;\nconst DEFAULT_SURFACE = \"maestro\";\nconst DEFAULT_TIMEOUT_MS = 2_000;\nconst LIST_SKILLS_PATH = \"/skills.v1.SkillService/List\";\n\nexport const SKILLS_CALL_FAILURE_MODES = {\n\tlistSkills: {\n\t\toptional: downstream.FailOpen,\n\t\trequired: downstream.FailClosed,\n\t},\n} as const;\n\ntype SkillsCall = keyof typeof SKILLS_CALL_FAILURE_MODES;\n\nexport interface SkillsServiceConfig {\n\tbaseUrl?: string;\n\ttoken?: string;\n\tworkspaceId?: string;\n\tsurface?: string;\n\tentityId?: string;\n\tlimit?: number;\n\ttimeoutMs?: number;\n\tmaxAttempts?: number;\n\tcircuitFailureThreshold?: number;\n\tcircuitResetTimeoutMs?: number;\n\tcircuitSuccessThreshold?: number;\n\trequired?: boolean;\n}\n\nexport interface ResolvedSkillsServiceConfig {\n\tbaseUrl: string;\n\ttoken?: string;\n\tworkspaceId: string;\n\tsurface: string;\n\tentityId?: string;\n\tlimit: number;\n\ttimeoutMs: number;\n\tmaxAttempts: number;\n\tcircuitFailureThreshold: number;\n\tcircuitResetTimeoutMs: number;\n\tcircuitSuccessThreshold: number;\n\tfailureMode: DownstreamHttpFailureMode;\n}\n\ninterface SkillsServiceSkill {\n\tid?: string;\n\tworkspaceId?: string;\n\townerId?: string;\n\tname?: string;\n\tdescription?: string;\n\tscope?: string | number;\n\tcontent?: string;\n\tcurrentVersion?: number;\n\ttags?: string[];\n}\n\ninterface ListSkillsResponse {\n\tskills?: SkillsServiceSkill[];\n\ttotal?: number;\n}\n\nconst downstreamClients = new Map<string, downstream.DownstreamClient>();\n\nfunction trimString(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction getEnvValue(names: string[]): string | undefined {\n\tfor (const name of names) {\n\t\tconst value = trimString(process.env[name]);\n\t\tif (value) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction parsePositiveInt(value: string | undefined, fallback: number): number {\n\tconst parsed = Number.parseInt(value ?? \"\", 10);\n\treturn Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n\tlet normalized = baseUrl.trim();\n\tfor (const suffix of [LIST_SKILLS_PATH, \"/skills.v1.SkillService\"]) {\n\t\tif (normalized.endsWith(suffix)) {\n\t\t\tnormalized = normalized.slice(0, -suffix.length);\n\t\t}\n\t}\n\treturn normalized.replace(/\\/+$/, \"\");\n}\n\nfunction resolveWorkspaceId(\n\tconfig: SkillsServiceConfig | undefined,\n): string | undefined {\n\tconst configuredWorkspaceId = trimString(config?.workspaceId);\n\tconst envWorkspaceId = getEnvValue([\n\t\t\"SKILLS_SERVICE_WORKSPACE_ID\",\n\t\t\"MAESTRO_SKILLS_WORKSPACE_ID\",\n\t\t...EVALOPS_ORGANIZATION_ID_ENV_VARS,\n\t]);\n\tif (configuredWorkspaceId ?? envWorkspaceId) {\n\t\treturn configuredWorkspaceId ?? envWorkspaceId;\n\t}\n\tconst stored = loadOAuthCredentials(\"evalops\")?.metadata?.organizationId;\n\treturn typeof stored === \"string\" && stored.trim().length > 0\n\t\t? stored.trim()\n\t\t: undefined;\n}\n\nfunction normalizeLimit(value: number | undefined): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\treturn DEFAULT_LIMIT;\n\t}\n\treturn Math.max(1, Math.min(500, Math.trunc(value)));\n}\n\nexport function resolveSkillsServiceConfig(\n\tconfig: SkillsServiceConfig | false | undefined,\n): ResolvedSkillsServiceConfig | null {\n\tif (config === false) {\n\t\treturn null;\n\t}\n\n\tconst baseUrl =\n\t\ttrimString(config?.baseUrl) ??\n\t\tgetEnvValue([\"SKILLS_SERVICE_URL\", \"MAESTRO_SKILLS_SERVICE_URL\"]);\n\tif (!baseUrl) {\n\t\treturn null;\n\t}\n\n\tconst workspaceId = resolveWorkspaceId(config);\n\tif (!workspaceId) {\n\t\treturn null;\n\t}\n\n\tconst storedToken = trimString(loadOAuthCredentials(\"evalops\")?.access);\n\tconst token =\n\t\ttrimString(config?.token) ??\n\t\tgetEnvValue([\n\t\t\t\"SKILLS_SERVICE_TOKEN\",\n\t\t\t\"MAESTRO_SKILLS_SERVICE_TOKEN\",\n\t\t\t...EVALOPS_ACCESS_TOKEN_ENV_VARS,\n\t\t]) ??\n\t\tstoredToken;\n\n\tconst required =\n\t\tconfig?.required ??\n\t\tgetEnvValue([\n\t\t\t\"SKILLS_SERVICE_REQUIRED\",\n\t\t\t\"MAESTRO_SKILLS_SERVICE_REQUIRED\",\n\t\t]) === \"1\";\n\n\treturn {\n\t\tbaseUrl: normalizeBaseUrl(baseUrl),\n\t\tcircuitFailureThreshold:\n\t\t\tconfig?.circuitFailureThreshold ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_CIRCUIT_FAILURE_THRESHOLD\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_CIRCUIT_FAILURE_THRESHOLD\",\n\t\t\t\t]),\n\t\t\t\t5,\n\t\t\t),\n\t\tcircuitResetTimeoutMs:\n\t\t\tconfig?.circuitResetTimeoutMs ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_CIRCUIT_RESET_TIMEOUT_MS\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_CIRCUIT_RESET_TIMEOUT_MS\",\n\t\t\t\t]),\n\t\t\t\t30_000,\n\t\t\t),\n\t\tcircuitSuccessThreshold:\n\t\t\tconfig?.circuitSuccessThreshold ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_CIRCUIT_SUCCESS_THRESHOLD\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_CIRCUIT_SUCCESS_THRESHOLD\",\n\t\t\t\t]),\n\t\t\t\t2,\n\t\t\t),\n\t\tentityId:\n\t\t\ttrimString(config?.entityId) ??\n\t\t\tgetEnvValue([\"SKILLS_SERVICE_ENTITY_ID\", \"MAESTRO_SKILLS_ENTITY_ID\"]),\n\t\tfailureMode: required ? \"required\" : \"optional\",\n\t\tlimit:\n\t\t\tconfig?.limit ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\"SKILLS_SERVICE_LIMIT\", \"MAESTRO_SKILLS_SERVICE_LIMIT\"]),\n\t\t\t\tDEFAULT_LIMIT,\n\t\t\t),\n\t\tmaxAttempts:\n\t\t\tconfig?.maxAttempts ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_MAX_ATTEMPTS\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_MAX_ATTEMPTS\",\n\t\t\t\t]),\n\t\t\t\tDEFAULT_MAX_ATTEMPTS,\n\t\t\t),\n\t\tsurface:\n\t\t\ttrimString(config?.surface) ??\n\t\t\tgetEnvValue([\"SKILLS_SERVICE_SURFACE\"]) ??\n\t\t\tDEFAULT_SURFACE,\n\t\ttimeoutMs:\n\t\t\tconfig?.timeoutMs ??\n\t\t\tparsePositiveInt(\n\t\t\t\tgetEnvValue([\n\t\t\t\t\t\"SKILLS_SERVICE_TIMEOUT_MS\",\n\t\t\t\t\t\"MAESTRO_SKILLS_SERVICE_TIMEOUT_MS\",\n\t\t\t\t]),\n\t\t\t\tDEFAULT_TIMEOUT_MS,\n\t\t\t),\n\t\ttoken,\n\t\tworkspaceId,\n\t};\n}\n\nfunction getDownstreamClient(\n\tconfig: ResolvedSkillsServiceConfig,\n\top: SkillsCall,\n): downstream.DownstreamClient {\n\tconst failureMode = SKILLS_CALL_FAILURE_MODES[op][config.failureMode];\n\tconst key = JSON.stringify({\n\t\tbaseUrl: config.baseUrl,\n\t\tfailureMode,\n\t\top,\n\t\treset: config.circuitResetTimeoutMs,\n\t\tsuccess: config.circuitSuccessThreshold,\n\t\tthreshold: config.circuitFailureThreshold,\n\t});\n\tconst cached = downstreamClients.get(key);\n\tif (cached) {\n\t\treturn cached;\n\t}\n\tconst client = downstream.New(`skills.${op}`, {\n\t\tfailureMode,\n\t\tbreaker: {\n\t\t\tfailureThreshold: config.circuitFailureThreshold,\n\t\t\tresetTimeoutMs: config.circuitResetTimeoutMs,\n\t\t\tsuccessThreshold: config.circuitSuccessThreshold,\n\t\t\ttoolName: `skills.${op}`,\n\t\t},\n\t});\n\tdownstreamClients.set(key, client);\n\treturn client;\n}\n\nfunction toHttpFailureMode(\n\tclient: downstream.DownstreamClient,\n): DownstreamHttpFailureMode {\n\treturn client.failureMode === downstream.FailClosed ? \"required\" : \"optional\";\n}\n\nfunction buildHeaders(\n\tconfig: ResolvedSkillsServiceConfig,\n): Record<string, string> {\n\treturn {\n\t\t...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n\t\t\"Connect-Protocol-Version\": CONNECT_PROTOCOL_VERSION,\n\t\t\"Content-Type\": \"application/json\",\n\t\t\"X-Surface\": config.surface,\n\t\t...(config.entityId ? { \"X-Entity-ID\": config.entityId } : {}),\n\t};\n}\n\nfunction normalizeScope(\n\tscope: string | number | undefined,\n): string | undefined {\n\tswitch (scope) {\n\t\tcase \"SKILL_SCOPE_GLOBAL\":\n\t\tcase \"global\":\n\t\tcase 1:\n\t\t\treturn \"global\";\n\t\tcase \"SKILL_SCOPE_WORKSPACE\":\n\t\tcase \"workspace\":\n\t\tcase 2:\n\t\t\treturn \"workspace\";\n\t\tcase \"SKILL_SCOPE_PERSONAL\":\n\t\tcase \"personal\":\n\t\tcase 3:\n\t\t\treturn \"personal\";\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nfunction normalizeTags(tags: string[] | undefined): string[] | undefined {\n\tconst normalized = Array.isArray(tags)\n\t\t? tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0)\n\t\t: [];\n\treturn normalized.length > 0 ? normalized : undefined;\n}\n\nfunction toLoadedSkill(skill: SkillsServiceSkill): LoadedSkill | null {\n\tconst id = trimString(skill.id);\n\tconst name = trimString(skill.name);\n\tconst content = trimString(skill.content);\n\tif (!id || !name || !content) {\n\t\treturn null;\n\t}\n\n\tconst scope = normalizeScope(skill.scope);\n\tconst metadata: Record<string, string> = {\n\t\tskillServiceId: id,\n\t\t...(trimString(skill.workspaceId)\n\t\t\t? { workspaceId: trimString(skill.workspaceId)! }\n\t\t\t: {}),\n\t\t...(trimString(skill.ownerId)\n\t\t\t? { ownerId: trimString(skill.ownerId)! }\n\t\t\t: {}),\n\t\t...(typeof skill.currentVersion === \"number\" &&\n\t\tNumber.isFinite(skill.currentVersion)\n\t\t\t? { currentVersion: String(Math.trunc(skill.currentVersion)) }\n\t\t\t: {}),\n\t\t...(scope ? { scope } : {}),\n\t};\n\n\treturn {\n\t\tname,\n\t\tdescription: trimString(skill.description) ?? \"Skill from skills service\",\n\t\tcontent,\n\t\tmetadata,\n\t\ttags: normalizeTags(skill.tags),\n\t\tsourcePath: `skills-service://${id}`,\n\t\tsourceType: \"service\",\n\t\tresources: [],\n\t\tresourceDirs: {},\n\t};\n}\n\nexport async function loadSkillsFromService(\n\tconfig: ResolvedSkillsServiceConfig,\n\toptions?: { signal?: AbortSignal },\n): Promise<LoadedSkill[]> {\n\tconst client = getDownstreamClient(config, \"listSkills\");\n\treturn downstream.CallOp(\n\t\tclient,\n\t\t\"listSkills\",\n\t\tasync () => {\n\t\t\tconst response = await fetchDownstream(\n\t\t\t\t`${config.baseUrl}${LIST_SKILLS_PATH}`,\n\t\t\t\t{\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\theaders: buildHeaders(config),\n\t\t\t\t\tsignal: options?.signal,\n\t\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\t\tworkspaceId: config.workspaceId,\n\t\t\t\t\t\tlimit: normalizeLimit(config.limit),\n\t\t\t\t\t\toffset: 0,\n\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tserviceName: \"skills service\",\n\t\t\t\t\tfailureMode: toHttpFailureMode(client),\n\t\t\t\t\ttimeoutMs: config.timeoutMs,\n\t\t\t\t\tmaxAttempts: config.maxAttempts,\n\t\t\t\t},\n\t\t\t);\n\t\t\tif (!response.ok) {\n\t\t\t\tconst text = await response.text();\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`skills service returned ${response.status}: ${\n\t\t\t\t\t\ttext || response.statusText\n\t\t\t\t\t}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst payload = (await response.json()) as ListSkillsResponse;\n\t\t\treturn (payload.skills ?? [])\n\t\t\t\t.map(toLoadedSkill)\n\t\t\t\t.filter((skill): skill is LoadedSkill => skill !== null);\n\t\t},\n\t\t() => [],\n\t);\n}\n\nexport function resetSkillsDownstreamForTests(): void {\n\tdownstreamClients.clear();\n}\n"]}

package/dist/skills/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/skills/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAWpE,OAAO,EACN,KAAK,mBAAmB,EAGxB,MAAM,qBAAqB,CAAC;AAmB7B;;GAEG;AACH,wBAAgB,eAAe,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACT,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;CAC5C,GACC,SAAS,CAqJX;AA2DD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/skills/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAYpE,OAAO,EACN,KAAK,mBAAmB,EAGxB,MAAM,qBAAqB,CAAC;AAmB7B;;GAEG;AACH,wBAAgB,eAAe,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACT,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;CAC5C,GACC,SAAS,CAsJX;AA2DD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/skills/tool.js

@@ -8,6 +8,7 @@ import { Type } from "@sinclair/typebox";
 import { createLogger } from "../utils/logger.js";
 import { buildSkillArtifactMetadata } from "./artifact-metadata.js";
 import { findSkill, formatSkillForInjection, formatSkillListItem, loadSkills, searchSkills, } from "./loader.js";
+import { buildSkillRuntimeActivation } from "./runtime-activation.js";
 import { loadSkillsFromService, resolveSkillsServiceConfig, } from "./service-client.js";
 const logger = createLogger("skills:tool");
 /**
@@ -149,6 +150,7 @@ Available skills can be listed by calling this tool with skill="list".`,
                 content: [{ type: "text", text }],
                 details: {
                     skillMetadata: buildSkillArtifactMetadata(skill),
+                    skillRuntimeActivation: buildSkillRuntimeActivation(skill),
                 },
             };
         },

package/dist/skills/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/skills/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAEN,SAAS,EACT,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAEN,qBAAqB,EACrB,0BAA0B,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EACV,kHAAkH;KACnH,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE;QACzC,WAAW,EAAE,yCAAyC;KACtD,CAAC,CACF;CACD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,YAAoB,EACpB,OAIC;IAED,wCAAwC;IACxC,IAAI,YAAY,GAAkC,IAAI,CAAC;IAEvD,MAAM,SAAS,GAAG,KAAK,IAA4B,EAAE;QACpD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC3B,YAAY,GAAG,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACvE,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM,KAAK,CAAC;YACb,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,YAAY,CAAC;IAC3B,CAAC,CAAC;IAEF,OAAO;QACN,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE;;;;;;;;;uEASwD;QACrE,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,KAAK,EACb,UAAkB,EAClB,MAA+B,EACJ,EAAE;YAC7B,MAAM,SAAS,GAAI,MAAM,CAAC,KAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA0C,CAAC;YAE/D,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;oBAClE,OAAO,EAAE,IAAI;iBACb,CAAC;YACH,CAAC;YAED,IAAI,MAAqB,CAAC;YAC1B,IAAI,CAAC;gBACJ,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO;oBACN,OAAO,EAAE;wBACR;4BACC,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,yBACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACtD,EAAE;yBACF;qBACD;oBACD,OAAO,EAAE,IAAI;iBACb,CAAC;YACH,CAAC;YAED,wBAAwB;YACxB,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;gBACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO;wBACN,OAAO,EAAE;4BACR;gCACC,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,6HAA6H;6BACnI;yBACD;qBACD,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,GAAG;oBACb,qBAAqB,MAAM,CAAC,MAAM,IAAI;oBACtC,EAAE;oBACF,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnD,EAAE;oBACF,8DAA8D;iBAC9D,CAAC;gBAEF,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;iBACnD,CAAC;YACH,CAAC;YAED,gCAAgC;YAChC,IAAI,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAEzC,gCAAgC;YAChC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAChD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACpB,CAAC;qBAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,KAAK,GAAG;wBACb,0BAA0B,SAAS,IAAI;wBACvC,EAAE;wBACF,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpD,EAAE;wBACF,sCAAsC;qBACtC,CAAC;oBAEF,OAAO;wBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;qBACnD,CAAC;gBACH,CAAC;YACF,CAAC;YAED,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,WAAW,GAChB,MAAM,CAAC,MAAM,GAAG,CAAC;oBAChB,CAAC,CAAC,yBAAyB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACjE,CAAC,CAAC,uFAAuF,CAAC;gBAE5F,OAAO;oBACN,OAAO,EAAE;wBACR;4BACC,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,UAAU,SAAS,eAAe,WAAW,EAAE;yBACrD;qBACD;oBACD,OAAO,EAAE,IAAI;iBACb,CAAC;YACH,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC5B,CAAC,CAAC;YAEH,qCAAqC;YACrC,IAAI,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAE1C,uCAAuC;YACvC,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC;oBACtD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACrC,CAAC;YACF,CAAC;YAED,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE;oBACR,aAAa,EAAE,0BAA0B,CAAC,KAAK,CAAC;iBAChD;aACD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CACnB,WAA0B,EAC1B,aAA4B;IAE5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QACjC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBAC1D,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAC/B,CAAC,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,OAIC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,OAAO,EAAE,cAAc,KAAK,KAAK,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,CAAC,IAAI,CACV,+DAA+D,EAC/D;YACC,KAAK,EAAE,OAAO;SACd,CACD,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;IACtB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,8DAA8D;IAC9D,uEAAuE;IACvE,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Skill Tool - Allows the agent to load specialized domain skills.\n *\n * This tool enables the agent to dynamically load skill instructions\n * and resources when it recognizes a task that matches a skill's domain.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { AgentTool, AgentToolResult } from \"../agent/types.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { buildSkillArtifactMetadata } from \"./artifact-metadata.js\";\nimport {\n\ttype LoadedSkill,\n\tfindSkill,\n\tformatSkillForInjection,\n\tformatSkillListItem,\n\tloadSkills,\n\tsearchSkills,\n} from \"./loader.js\";\nimport {\n\ttype SkillsServiceConfig,\n\tloadSkillsFromService,\n\tresolveSkillsServiceConfig,\n} from \"./service-client.js\";\n\nconst logger = createLogger(\"skills:tool\");\n\n/**\n * Skill tool input schema.\n */\nconst SkillToolSchema = Type.Object({\n\tskill: Type.String({\n\t\tdescription:\n\t\t\t'The name of the skill to load. Use \"list\" to see all available skills, or a search term to find matching skills.',\n\t}),\n\targs: Type.Optional(\n\t\tType.Record(Type.String(), Type.String(), {\n\t\t\tdescription: \"Optional arguments to pass to the skill\",\n\t\t}),\n\t),\n});\n\n/**\n * Create the Skill tool definition.\n */\nexport function createSkillTool(\n\tworkspaceDir: string,\n\toptions?: {\n\t\tincludeSystem?: boolean;\n\t\tincludeService?: boolean;\n\t\tskillsService?: SkillsServiceConfig | false;\n\t},\n): AgentTool {\n\t// Load skills once when tool is created\n\tlet cachedSkills: Promise<LoadedSkill[]> | null = null;\n\n\tconst getSkills = async (): Promise<LoadedSkill[]> => {\n\t\tif (cachedSkills === null) {\n\t\t\tcachedSkills = loadSkillsForTool(workspaceDir, options).catch((error) => {\n\t\t\t\tcachedSkills = null;\n\t\t\t\tthrow error;\n\t\t\t});\n\t\t}\n\t\treturn await cachedSkills;\n\t};\n\n\treturn {\n\t\tname: \"Skill\",\n\t\tlabel: \"Skill\",\n\t\tdescription: `Load a specialized skill that provides domain-specific instructions and workflows.\n\nWhen you recognize that a task matches one of the available skills, use this tool to load the full skill instructions. The skill will inject detailed instructions, workflows, and access to bundled resources (scripts, references, templates) into the conversation context.\n\nUse this tool proactively when:\n- The user asks about a domain that matches an available skill\n- You need specialized procedures or workflows\n- You want access to skill-specific resources\n\nAvailable skills can be listed by calling this tool with skill=\"list\".`,\n\t\tparameters: SkillToolSchema,\n\t\texecute: async (\n\t\t\ttoolCallId: string,\n\t\t\tparams: Record<string, unknown>,\n\t\t): Promise<AgentToolResult> => {\n\t\t\tconst skillName = (params.skill as string)?.trim() ?? \"\";\n\t\t\tconst args = params.args as Record<string, string> | undefined;\n\n\t\t\tif (!skillName) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: skill name is required\" }],\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet skills: LoadedSkill[];\n\t\t\ttry {\n\t\t\t\tskills = await getSkills();\n\t\t\t} catch (error) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: `Error loading skills: ${\n\t\t\t\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t\t\t\t}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Handle \"list\" command\n\t\t\tif (skillName.toLowerCase() === \"list\") {\n\t\t\t\tif (skills.length === 0) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\ttext: \"No skills available. Skills can be added to `.maestro/skills/` in your workspace or `~/.maestro/skills/` for global skills.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst lines = [\n\t\t\t\t\t`Available Skills (${skills.length}):`,\n\t\t\t\t\t\"\",\n\t\t\t\t\t...skills.map((s) => `- ${formatSkillListItem(s)}`),\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Use Skill tool with the skill name to load its instructions.\",\n\t\t\t\t];\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: lines.join(\"\\n\") }],\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Try to find exact match first\n\t\t\tlet skill = findSkill(skills, skillName);\n\n\t\t\t// If no exact match, try search\n\t\t\tif (!skill) {\n\t\t\t\tconst matches = searchSkills(skills, skillName);\n\t\t\t\tif (matches.length === 1) {\n\t\t\t\t\tskill = matches[0];\n\t\t\t\t} else if (matches.length > 1) {\n\t\t\t\t\tconst lines = [\n\t\t\t\t\t\t`Multiple skills match \"${skillName}\":`,\n\t\t\t\t\t\t\"\",\n\t\t\t\t\t\t...matches.map((s) => `- ${formatSkillListItem(s)}`),\n\t\t\t\t\t\t\"\",\n\t\t\t\t\t\t\"Please specify the exact skill name.\",\n\t\t\t\t\t];\n\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: lines.join(\"\\n\") }],\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (!skill) {\n\t\t\t\tconst suggestions =\n\t\t\t\t\tskills.length > 0\n\t\t\t\t\t\t? `\\n\\nAvailable skills: ${skills.map((s) => s.name).join(\", \")}`\n\t\t\t\t\t\t: '\\n\\nNo skills are available. Add skills to `.maestro/skills/` or use \"list\" to check.';\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: `Skill \"${skillName}\" not found.${suggestions}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlogger.info(\"Loading skill\", {\n\t\t\t\tname: skill.name,\n\t\t\t\tsourceType: skill.sourceType,\n\t\t\t});\n\n\t\t\t// Format skill content for injection\n\t\t\tlet text = formatSkillForInjection(skill);\n\n\t\t\t// Handle args substitution if provided\n\t\t\tif (args && Object.keys(args).length > 0) {\n\t\t\t\tfor (const [key, value] of Object.entries(args)) {\n\t\t\t\t\tconst pattern = new RegExp(`\\\\{\\\\{${key}\\\\}\\\\}`, \"g\");\n\t\t\t\t\ttext = text.replace(pattern, value);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\tdetails: {\n\t\t\t\t\tskillMetadata: buildSkillArtifactMetadata(skill),\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\t};\n}\n\nfunction mergeSkills(\n\tlocalSkills: LoadedSkill[],\n\tserviceSkills: LoadedSkill[],\n): LoadedSkill[] {\n\tconst skillMap = new Map<string, LoadedSkill>();\n\tfor (const skill of localSkills) {\n\t\tskillMap.set(skill.name.toLowerCase(), skill);\n\t}\n\tfor (const skill of serviceSkills) {\n\t\tconst existing = skillMap.get(skill.name.toLowerCase());\n\t\tif (existing) {\n\t\t\tlogger.debug(\"Skills service skill overrides local skill\", {\n\t\t\t\tname: skill.name,\n\t\t\t\toverridden: existing.sourceType,\n\t\t\t});\n\t\t}\n\t\tskillMap.set(skill.name.toLowerCase(), skill);\n\t}\n\treturn Array.from(skillMap.values());\n}\n\nasync function loadSkillsForTool(\n\tworkspaceDir: string,\n\toptions?: {\n\t\tincludeSystem?: boolean;\n\t\tincludeService?: boolean;\n\t\tskillsService?: SkillsServiceConfig | false;\n\t},\n): Promise<LoadedSkill[]> {\n\tconst result = loadSkills(workspaceDir, options);\n\tif (options?.includeService === false) {\n\t\treturn result.skills;\n\t}\n\n\tconst config = resolveSkillsServiceConfig(options?.skillsService);\n\tif (!config) {\n\t\treturn result.skills;\n\t}\n\n\ttry {\n\t\tconst serviceSkills = await loadSkillsFromService(config);\n\t\treturn mergeSkills(result.skills, serviceSkills);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (config.failureMode === \"required\") {\n\t\t\tthrow new Error(`Skills service unavailable: ${message}`);\n\t\t}\n\t\tlogger.warn(\n\t\t\t\"Failed to load skills from skills service; using local skills\",\n\t\t\t{\n\t\t\t\terror: message,\n\t\t\t},\n\t\t);\n\t\treturn result.skills;\n\t}\n}\n\n/**\n * Invalidate cached skills (call after skill files change).\n */\nexport function invalidateSkillCache(): void {\n\t// This would need to be connected to the actual tool instance\n\t// For now, skills are loaded fresh each time createSkillTool is called\n\tlogger.debug(\"Skill cache invalidation requested\");\n}\n"]}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/skills/tool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Skill Tool - Allows the agent to load specialized domain skills.\n *\n * This tool enables the agent to dynamically load skill instructions\n * and resources when it recognizes a task that matches a skill's domain.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { AgentTool, AgentToolResult } from \"../agent/types.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { buildSkillArtifactMetadata } from \"./artifact-metadata.js\";\nimport {\n\ttype LoadedSkill,\n\tfindSkill,\n\tformatSkillForInjection,\n\tformatSkillListItem,\n\tloadSkills,\n\tsearchSkills,\n} from \"./loader.js\";\nimport { buildSkillRuntimeActivation } from \"./runtime-activation.js\";\nimport {\n\ttype SkillsServiceConfig,\n\tloadSkillsFromService,\n\tresolveSkillsServiceConfig,\n} from \"./service-client.js\";\n\nconst logger = createLogger(\"skills:tool\");\n\n/**\n * Skill tool input schema.\n */\nconst SkillToolSchema = Type.Object({\n\tskill: Type.String({\n\t\tdescription:\n\t\t\t'The name of the skill to load. Use \"list\" to see all available skills, or a search term to find matching skills.',\n\t}),\n\targs: Type.Optional(\n\t\tType.Record(Type.String(), Type.String(), {\n\t\t\tdescription: \"Optional arguments to pass to the skill\",\n\t\t}),\n\t),\n});\n\n/**\n * Create the Skill tool definition.\n */\nexport function createSkillTool(\n\tworkspaceDir: string,\n\toptions?: {\n\t\tincludeSystem?: boolean;\n\t\tincludeService?: boolean;\n\t\tskillsService?: SkillsServiceConfig | false;\n\t},\n): AgentTool {\n\t// Load skills once when tool is created\n\tlet cachedSkills: Promise<LoadedSkill[]> | null = null;\n\n\tconst getSkills = async (): Promise<LoadedSkill[]> => {\n\t\tif (cachedSkills === null) {\n\t\t\tcachedSkills = loadSkillsForTool(workspaceDir, options).catch((error) => {\n\t\t\t\tcachedSkills = null;\n\t\t\t\tthrow error;\n\t\t\t});\n\t\t}\n\t\treturn await cachedSkills;\n\t};\n\n\treturn {\n\t\tname: \"Skill\",\n\t\tlabel: \"Skill\",\n\t\tdescription: `Load a specialized skill that provides domain-specific instructions and workflows.\n\nWhen you recognize that a task matches one of the available skills, use this tool to load the full skill instructions. The skill will inject detailed instructions, workflows, and access to bundled resources (scripts, references, templates) into the conversation context.\n\nUse this tool proactively when:\n- The user asks about a domain that matches an available skill\n- You need specialized procedures or workflows\n- You want access to skill-specific resources\n\nAvailable skills can be listed by calling this tool with skill=\"list\".`,\n\t\tparameters: SkillToolSchema,\n\t\texecute: async (\n\t\t\ttoolCallId: string,\n\t\t\tparams: Record<string, unknown>,\n\t\t): Promise<AgentToolResult> => {\n\t\t\tconst skillName = (params.skill as string)?.trim() ?? \"\";\n\t\t\tconst args = params.args as Record<string, string> | undefined;\n\n\t\t\tif (!skillName) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: skill name is required\" }],\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet skills: LoadedSkill[];\n\t\t\ttry {\n\t\t\t\tskills = await getSkills();\n\t\t\t} catch (error) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: `Error loading skills: ${\n\t\t\t\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t\t\t\t}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Handle \"list\" command\n\t\t\tif (skillName.toLowerCase() === \"list\") {\n\t\t\t\tif (skills.length === 0) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\ttext: \"No skills available. Skills can be added to `.maestro/skills/` in your workspace or `~/.maestro/skills/` for global skills.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst lines = [\n\t\t\t\t\t`Available Skills (${skills.length}):`,\n\t\t\t\t\t\"\",\n\t\t\t\t\t...skills.map((s) => `- ${formatSkillListItem(s)}`),\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Use Skill tool with the skill name to load its instructions.\",\n\t\t\t\t];\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: lines.join(\"\\n\") }],\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Try to find exact match first\n\t\t\tlet skill = findSkill(skills, skillName);\n\n\t\t\t// If no exact match, try search\n\t\t\tif (!skill) {\n\t\t\t\tconst matches = searchSkills(skills, skillName);\n\t\t\t\tif (matches.length === 1) {\n\t\t\t\t\tskill = matches[0];\n\t\t\t\t} else if (matches.length > 1) {\n\t\t\t\t\tconst lines = [\n\t\t\t\t\t\t`Multiple skills match \"${skillName}\":`,\n\t\t\t\t\t\t\"\",\n\t\t\t\t\t\t...matches.map((s) => `- ${formatSkillListItem(s)}`),\n\t\t\t\t\t\t\"\",\n\t\t\t\t\t\t\"Please specify the exact skill name.\",\n\t\t\t\t\t];\n\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: lines.join(\"\\n\") }],\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (!skill) {\n\t\t\t\tconst suggestions =\n\t\t\t\t\tskills.length > 0\n\t\t\t\t\t\t? `\\n\\nAvailable skills: ${skills.map((s) => s.name).join(\", \")}`\n\t\t\t\t\t\t: '\\n\\nNo skills are available. Add skills to `.maestro/skills/` or use \"list\" to check.';\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: `Skill \"${skillName}\" not found.${suggestions}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlogger.info(\"Loading skill\", {\n\t\t\t\tname: skill.name,\n\t\t\t\tsourceType: skill.sourceType,\n\t\t\t});\n\n\t\t\t// Format skill content for injection\n\t\t\tlet text = formatSkillForInjection(skill);\n\n\t\t\t// Handle args substitution if provided\n\t\t\tif (args && Object.keys(args).length > 0) {\n\t\t\t\tfor (const [key, value] of Object.entries(args)) {\n\t\t\t\t\tconst pattern = new RegExp(`\\\\{\\\\{${key}\\\\}\\\\}`, \"g\");\n\t\t\t\t\ttext = text.replace(pattern, value);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\tdetails: {\n\t\t\t\t\tskillMetadata: buildSkillArtifactMetadata(skill),\n\t\t\t\t\tskillRuntimeActivation: buildSkillRuntimeActivation(skill),\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\t};\n}\n\nfunction mergeSkills(\n\tlocalSkills: LoadedSkill[],\n\tserviceSkills: LoadedSkill[],\n): LoadedSkill[] {\n\tconst skillMap = new Map<string, LoadedSkill>();\n\tfor (const skill of localSkills) {\n\t\tskillMap.set(skill.name.toLowerCase(), skill);\n\t}\n\tfor (const skill of serviceSkills) {\n\t\tconst existing = skillMap.get(skill.name.toLowerCase());\n\t\tif (existing) {\n\t\t\tlogger.debug(\"Skills service skill overrides local skill\", {\n\t\t\t\tname: skill.name,\n\t\t\t\toverridden: existing.sourceType,\n\t\t\t});\n\t\t}\n\t\tskillMap.set(skill.name.toLowerCase(), skill);\n\t}\n\treturn Array.from(skillMap.values());\n}\n\nasync function loadSkillsForTool(\n\tworkspaceDir: string,\n\toptions?: {\n\t\tincludeSystem?: boolean;\n\t\tincludeService?: boolean;\n\t\tskillsService?: SkillsServiceConfig | false;\n\t},\n): Promise<LoadedSkill[]> {\n\tconst result = loadSkills(workspaceDir, options);\n\tif (options?.includeService === false) {\n\t\treturn result.skills;\n\t}\n\n\tconst config = resolveSkillsServiceConfig(options?.skillsService);\n\tif (!config) {\n\t\treturn result.skills;\n\t}\n\n\ttry {\n\t\tconst serviceSkills = await loadSkillsFromService(config);\n\t\treturn mergeSkills(result.skills, serviceSkills);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (config.failureMode === \"required\") {\n\t\t\tthrow new Error(`Skills service unavailable: ${message}`);\n\t\t}\n\t\tlogger.warn(\n\t\t\t\"Failed to load skills from skills service; using local skills\",\n\t\t\t{\n\t\t\t\terror: message,\n\t\t\t},\n\t\t);\n\t\treturn result.skills;\n\t}\n}\n\n/**\n * Invalidate cached skills (call after skill files change).\n */\nexport function invalidateSkillCache(): void {\n\t// This would need to be connected to the actual tool instance\n\t// For now, skills are loaded fresh each time createSkillTool is called\n\tlogger.debug(\"Skill cache invalidation requested\");\n}\n"]}

package/dist/skills/types.d.ts

@@ -22,6 +22,14 @@ export interface Skill {
     tags?: string[];
     /** Required tools for this skill */
     requiredTools?: string[];
+    /** Built-in Maestro tools this skill expects to use */
+    builtinTools?: string[];
+    /** Preferred model while this skill is active */
+    model?: string;
+    /** Preferred agent mode while this skill is active */
+    mode?: string;
+    /** Whether the skill should run in isolated context when supported */
+    isolatedContext?: boolean;
     /** Whether this skill is currently active in the session */
     active?: boolean;
 }
@@ -37,6 +45,12 @@ export interface SkillMetadata {
     tags?: string[];
     /** Required tools */
     tools?: string[];
+    /** Built-in Maestro tools */
+    builtinTools?: string[];
+    /** Preferred model */
+    model?: string;
+    /** Preferred mode */
+    mode?: string;
     /** Trigger patterns (when to auto-activate) */
     triggers?: string[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,iCAAiC;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,iCAAiC;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/skills/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Skills System Types\n *\n * Type definitions for the skills system that enables reusable,\n * shareable capabilities for the agent.\n */\n\n/**\n * A skill definition.\n */\nexport interface Skill {\n\t/** Unique skill name (used in .maestro/skills/<name>.md) */\n\tname: string;\n\t/** Human-readable description */\n\tdescription: string;\n\t/** The skill's prompt/instructions content */\n\tcontent: string;\n\t/** File path where the skill is defined */\n\tfilePath: string;\n\t/** Whether this skill is from the global config */\n\tisGlobal: boolean;\n\t/** Tags for categorization */\n\ttags?: string[];\n\t/** Required tools for this skill */\n\trequiredTools?: string[];\n\t/** Whether this skill is currently active in the session */\n\tactive?: boolean;\n}\n\n/**\n * Skill metadata parsed from frontmatter.\n */\nexport interface SkillMetadata {\n\t/** Skill name override */\n\tname?: string;\n\t/** Skill description */\n\tdescription?: string;\n\t/** Tags for categorization */\n\ttags?: string[];\n\t/** Required tools */\n\ttools?: string[];\n\t/** Trigger patterns (when to auto-activate) */\n\ttriggers?: string[];\n}\n\n/**\n * Result of loading skills from a directory.\n */\nexport interface SkillsLoadResult {\n\t/** Successfully loaded skills */\n\tskills: Skill[];\n\t/** Errors encountered during loading */\n\terrors: Array<{ file: string; error: string }>;\n}\n\n/**\n * Skill execution context.\n */\nexport interface SkillContext {\n\t/** Current working directory */\n\tcwd: string;\n\t/** Arguments passed to the skill */\n\targs?: string;\n\t/** Available tools */\n\ttools?: string[];\n\t/** Session ID */\n\tsessionId?: string;\n}\n\n/**\n * Options for skill activation.\n */\nexport interface SkillActivationOptions {\n\t/** Arguments to pass to the skill */\n\targs?: string;\n\t/** Whether to auto-deactivate after use */\n\tautoDeactivate?: boolean;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Skills System Types\n *\n * Type definitions for the skills system that enables reusable,\n * shareable capabilities for the agent.\n */\n\n/**\n * A skill definition.\n */\nexport interface Skill {\n\t/** Unique skill name (used in .maestro/skills/<name>.md) */\n\tname: string;\n\t/** Human-readable description */\n\tdescription: string;\n\t/** The skill's prompt/instructions content */\n\tcontent: string;\n\t/** File path where the skill is defined */\n\tfilePath: string;\n\t/** Whether this skill is from the global config */\n\tisGlobal: boolean;\n\t/** Tags for categorization */\n\ttags?: string[];\n\t/** Required tools for this skill */\n\trequiredTools?: string[];\n\t/** Built-in Maestro tools this skill expects to use */\n\tbuiltinTools?: string[];\n\t/** Preferred model while this skill is active */\n\tmodel?: string;\n\t/** Preferred agent mode while this skill is active */\n\tmode?: string;\n\t/** Whether the skill should run in isolated context when supported */\n\tisolatedContext?: boolean;\n\t/** Whether this skill is currently active in the session */\n\tactive?: boolean;\n}\n\n/**\n * Skill metadata parsed from frontmatter.\n */\nexport interface SkillMetadata {\n\t/** Skill name override */\n\tname?: string;\n\t/** Skill description */\n\tdescription?: string;\n\t/** Tags for categorization */\n\ttags?: string[];\n\t/** Required tools */\n\ttools?: string[];\n\t/** Built-in Maestro tools */\n\tbuiltinTools?: string[];\n\t/** Preferred model */\n\tmodel?: string;\n\t/** Preferred mode */\n\tmode?: string;\n\t/** Trigger patterns (when to auto-activate) */\n\ttriggers?: string[];\n}\n\n/**\n * Result of loading skills from a directory.\n */\nexport interface SkillsLoadResult {\n\t/** Successfully loaded skills */\n\tskills: Skill[];\n\t/** Errors encountered during loading */\n\terrors: Array<{ file: string; error: string }>;\n}\n\n/**\n * Skill execution context.\n */\nexport interface SkillContext {\n\t/** Current working directory */\n\tcwd: string;\n\t/** Arguments passed to the skill */\n\targs?: string;\n\t/** Available tools */\n\ttools?: string[];\n\t/** Session ID */\n\tsessionId?: string;\n}\n\n/**\n * Options for skill activation.\n */\nexport interface SkillActivationOptions {\n\t/** Arguments to pass to the skill */\n\targs?: string;\n\t/** Whether to auto-deactivate after use */\n\tautoDeactivate?: boolean;\n}\n"]}

package/dist/telemetry/agent-operating-plane-context.d.ts

@@ -0,0 +1,24 @@
+import type { MaestroCorrelation } from "./maestro-event-bus.js";
+export type AgentOperatingPlaneDataClassification = "public" | "internal" | "customer" | "restricted";
+export type AgentOperatingPlaneRetentionClass = "ephemeral" | "operational_audit" | "security_audit" | "legal_hold";
+export interface AgentOperatingPlaneCorrelationInput extends Partial<MaestroCorrelation> {
+    workspace_id: string;
+    session_id: string;
+}
+export interface AgentOperatingPlaneMetadataInput {
+    dataClassification?: AgentOperatingPlaneDataClassification;
+    retentionClass?: AgentOperatingPlaneRetentionClass;
+    safeSummary?: string;
+}
+export interface AgentOperatingPlaneContextInput {
+    correlation: AgentOperatingPlaneCorrelationInput;
+    metadata?: AgentOperatingPlaneMetadataInput;
+}
+export interface AgentOperatingPlaneContext {
+    correlation: MaestroCorrelation;
+    metadata: Record<string, string>;
+}
+export declare function buildAgentOperatingPlaneCorrelation(input: AgentOperatingPlaneCorrelationInput): MaestroCorrelation;
+export declare function buildAgentOperatingPlaneMetadata(input?: AgentOperatingPlaneMetadataInput): Record<string, string>;
+export declare function buildAgentOperatingPlaneContext(input: AgentOperatingPlaneContextInput): AgentOperatingPlaneContext;
+//# sourceMappingURL=agent-operating-plane-context.d.ts.map

package/dist/telemetry/agent-operating-plane-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-operating-plane-context.d.ts","sourceRoot":"","sources":["../../src/telemetry/agent-operating-plane-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,qCAAqC,GAC9C,QAAQ,GACR,UAAU,GACV,UAAU,GACV,YAAY,CAAC;AAEhB,MAAM,MAAM,iCAAiC,GAC1C,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,YAAY,CAAC;AAEhB,MAAM,WAAW,mCAChB,SAAQ,OAAO,CAAC,kBAAkB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gCAAgC;IAChD,kBAAkB,CAAC,EAAE,qCAAqC,CAAC;IAC3D,cAAc,CAAC,EAAE,iCAAiC,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC/C,WAAW,EAAE,mCAAmC,CAAC;IACjD,QAAQ,CAAC,EAAE,gCAAgC,CAAC;CAC5C;AAED,MAAM,WAAW,0BAA0B;IAC1C,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAmBD,wBAAgB,mCAAmC,CAClD,KAAK,EAAE,mCAAmC,GACxC,kBAAkB,CAqBpB;AAED,wBAAgB,gCAAgC,CAC/C,KAAK,GAAE,gCAAqC,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,+BAA+B,GACpC,0BAA0B,CAK5B"}

package/dist/telemetry/agent-operating-plane-context.js

@@ -0,0 +1,54 @@
+function cleanString(value) {
+    const cleanValue = value?.trim();
+    return cleanValue ? cleanValue : undefined;
+}
+function compactStringRecord(record) {
+    if (!record)
+        return undefined;
+    const compacted = Object.fromEntries(Object.entries(record)
+        .map(([key, value]) => [key, cleanString(value)])
+        .filter((entry) => Boolean(entry[1])));
+    return Object.keys(compacted).length > 0 ? compacted : undefined;
+}
+export function buildAgentOperatingPlaneCorrelation(input) {
+    return {
+        organization_id: cleanString(input.organization_id),
+        user_id: cleanString(input.user_id),
+        workspace_id: cleanString(input.workspace_id) ?? "unknown",
+        session_id: cleanString(input.session_id) ?? "unknown",
+        agent_run_id: cleanString(input.agent_run_id),
+        agent_run_step_id: cleanString(input.agent_run_step_id),
+        agent_id: cleanString(input.agent_id),
+        actor_id: cleanString(input.actor_id),
+        principal_id: cleanString(input.principal_id),
+        trace_id: cleanString(input.trace_id),
+        traceparent: cleanString(input.traceparent),
+        tracestate: cleanString(input.tracestate),
+        request_id: cleanString(input.request_id),
+        parent_event_id: cleanString(input.parent_event_id),
+        remote_runner_session_id: cleanString(input.remote_runner_session_id),
+        objective_id: cleanString(input.objective_id),
+        conversation_id: cleanString(input.conversation_id),
+        attributes: compactStringRecord(input.attributes),
+    };
+}
+export function buildAgentOperatingPlaneMetadata(input = {}) {
+    const metadata = {};
+    const dataClassification = cleanString(input.dataClassification);
+    const retentionClass = cleanString(input.retentionClass);
+    const safeSummary = cleanString(input.safeSummary);
+    if (dataClassification)
+        metadata.data_classification = dataClassification;
+    if (retentionClass)
+        metadata.retention_class = retentionClass;
+    if (safeSummary)
+        metadata.safe_summary = safeSummary;
+    return metadata;
+}
+export function buildAgentOperatingPlaneContext(input) {
+    return {
+        correlation: buildAgentOperatingPlaneCorrelation(input.correlation),
+        metadata: buildAgentOperatingPlaneMetadata(input.metadata),
+    };
+}
+//# sourceMappingURL=agent-operating-plane-context.js.map