@evalops/maestro 0.10.8 → 0.10.11

package/dist/skills/service-client.js

@@ -0,0 +1,258 @@
+import { loadOAuthCredentials } from "../oauth/storage.js";
+import { fetchDownstream, } from "../utils/downstream-http.js";
+import * as downstream from "../utils/downstream.js";
+const CONNECT_PROTOCOL_VERSION = "1";
+const DEFAULT_LIMIT = 100;
+const DEFAULT_MAX_ATTEMPTS = 2;
+const DEFAULT_SURFACE = "maestro";
+const DEFAULT_TIMEOUT_MS = 2_000;
+const LIST_SKILLS_PATH = "/skills.v1.SkillService/List";
+export const SKILLS_CALL_FAILURE_MODES = {
+    listSkills: {
+        optional: downstream.FailOpen,
+        required: downstream.FailClosed,
+    },
+};
+const downstreamClients = new Map();
+function trimString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function getEnvValue(names) {
+    for (const name of names) {
+        const value = trimString(process.env[name]);
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function parsePositiveInt(value, fallback) {
+    const parsed = Number.parseInt(value ?? "", 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function normalizeBaseUrl(baseUrl) {
+    let normalized = baseUrl.trim();
+    for (const suffix of [LIST_SKILLS_PATH, "/skills.v1.SkillService"]) {
+        if (normalized.endsWith(suffix)) {
+            normalized = normalized.slice(0, -suffix.length);
+        }
+    }
+    return normalized.replace(/\/+$/, "");
+}
+function resolveWorkspaceId(config) {
+    const configuredWorkspaceId = trimString(config?.workspaceId);
+    const envWorkspaceId = getEnvValue([
+        "SKILLS_SERVICE_WORKSPACE_ID",
+        "MAESTRO_SKILLS_WORKSPACE_ID",
+        "MAESTRO_EVALOPS_ORG_ID",
+        "EVALOPS_ORGANIZATION_ID",
+        "MAESTRO_ENTERPRISE_ORG_ID",
+    ]);
+    if (configuredWorkspaceId ?? envWorkspaceId) {
+        return configuredWorkspaceId ?? envWorkspaceId;
+    }
+    const stored = loadOAuthCredentials("evalops")?.metadata?.organizationId;
+    return typeof stored === "string" && stored.trim().length > 0
+        ? stored.trim()
+        : undefined;
+}
+function normalizeLimit(value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return DEFAULT_LIMIT;
+    }
+    return Math.max(1, Math.min(500, Math.trunc(value)));
+}
+export function resolveSkillsServiceConfig(config) {
+    if (config === false) {
+        return null;
+    }
+    const baseUrl = trimString(config?.baseUrl) ??
+        getEnvValue(["SKILLS_SERVICE_URL", "MAESTRO_SKILLS_SERVICE_URL"]);
+    if (!baseUrl) {
+        return null;
+    }
+    const workspaceId = resolveWorkspaceId(config);
+    if (!workspaceId) {
+        return null;
+    }
+    const storedToken = trimString(loadOAuthCredentials("evalops")?.access);
+    const token = trimString(config?.token) ??
+        getEnvValue([
+            "SKILLS_SERVICE_TOKEN",
+            "MAESTRO_SKILLS_SERVICE_TOKEN",
+            "MAESTRO_EVALOPS_ACCESS_TOKEN",
+        ]) ??
+        storedToken;
+    const required = config?.required ??
+        getEnvValue([
+            "SKILLS_SERVICE_REQUIRED",
+            "MAESTRO_SKILLS_SERVICE_REQUIRED",
+        ]) === "1";
+    return {
+        baseUrl: normalizeBaseUrl(baseUrl),
+        circuitFailureThreshold: config?.circuitFailureThreshold ??
+            parsePositiveInt(getEnvValue([
+                "SKILLS_SERVICE_CIRCUIT_FAILURE_THRESHOLD",
+                "MAESTRO_SKILLS_SERVICE_CIRCUIT_FAILURE_THRESHOLD",
+            ]), 5),
+        circuitResetTimeoutMs: config?.circuitResetTimeoutMs ??
+            parsePositiveInt(getEnvValue([
+                "SKILLS_SERVICE_CIRCUIT_RESET_TIMEOUT_MS",
+                "MAESTRO_SKILLS_SERVICE_CIRCUIT_RESET_TIMEOUT_MS",
+            ]), 30_000),
+        circuitSuccessThreshold: config?.circuitSuccessThreshold ??
+            parsePositiveInt(getEnvValue([
+                "SKILLS_SERVICE_CIRCUIT_SUCCESS_THRESHOLD",
+                "MAESTRO_SKILLS_SERVICE_CIRCUIT_SUCCESS_THRESHOLD",
+            ]), 2),
+        entityId: trimString(config?.entityId) ??
+            getEnvValue(["SKILLS_SERVICE_ENTITY_ID", "MAESTRO_SKILLS_ENTITY_ID"]),
+        failureMode: required ? "required" : "optional",
+        limit: config?.limit ??
+            parsePositiveInt(getEnvValue(["SKILLS_SERVICE_LIMIT", "MAESTRO_SKILLS_SERVICE_LIMIT"]), DEFAULT_LIMIT),
+        maxAttempts: config?.maxAttempts ??
+            parsePositiveInt(getEnvValue([
+                "SKILLS_SERVICE_MAX_ATTEMPTS",
+                "MAESTRO_SKILLS_SERVICE_MAX_ATTEMPTS",
+            ]), DEFAULT_MAX_ATTEMPTS),
+        surface: trimString(config?.surface) ??
+            getEnvValue(["SKILLS_SERVICE_SURFACE"]) ??
+            DEFAULT_SURFACE,
+        timeoutMs: config?.timeoutMs ??
+            parsePositiveInt(getEnvValue([
+                "SKILLS_SERVICE_TIMEOUT_MS",
+                "MAESTRO_SKILLS_SERVICE_TIMEOUT_MS",
+            ]), DEFAULT_TIMEOUT_MS),
+        token,
+        workspaceId,
+    };
+}
+function getDownstreamClient(config, op) {
+    const failureMode = SKILLS_CALL_FAILURE_MODES[op][config.failureMode];
+    const key = JSON.stringify({
+        baseUrl: config.baseUrl,
+        failureMode,
+        op,
+        reset: config.circuitResetTimeoutMs,
+        success: config.circuitSuccessThreshold,
+        threshold: config.circuitFailureThreshold,
+    });
+    const cached = downstreamClients.get(key);
+    if (cached) {
+        return cached;
+    }
+    const client = downstream.New(`skills.${op}`, {
+        failureMode,
+        breaker: {
+            failureThreshold: config.circuitFailureThreshold,
+            resetTimeoutMs: config.circuitResetTimeoutMs,
+            successThreshold: config.circuitSuccessThreshold,
+            toolName: `skills.${op}`,
+        },
+    });
+    downstreamClients.set(key, client);
+    return client;
+}
+function toHttpFailureMode(client) {
+    return client.failureMode === downstream.FailClosed ? "required" : "optional";
+}
+function buildHeaders(config) {
+    return {
+        ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),
+        "Connect-Protocol-Version": CONNECT_PROTOCOL_VERSION,
+        "Content-Type": "application/json",
+        "X-Surface": config.surface,
+        ...(config.entityId ? { "X-Entity-ID": config.entityId } : {}),
+    };
+}
+function normalizeScope(scope) {
+    switch (scope) {
+        case "SKILL_SCOPE_GLOBAL":
+        case "global":
+        case 1:
+            return "global";
+        case "SKILL_SCOPE_WORKSPACE":
+        case "workspace":
+        case 2:
+            return "workspace";
+        case "SKILL_SCOPE_PERSONAL":
+        case "personal":
+        case 3:
+            return "personal";
+        default:
+            return undefined;
+    }
+}
+function normalizeTags(tags) {
+    const normalized = Array.isArray(tags)
+        ? tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0)
+        : [];
+    return normalized.length > 0 ? normalized : undefined;
+}
+function toLoadedSkill(skill) {
+    const id = trimString(skill.id);
+    const name = trimString(skill.name);
+    const content = trimString(skill.content);
+    if (!id || !name || !content) {
+        return null;
+    }
+    const scope = normalizeScope(skill.scope);
+    const metadata = {
+        skillServiceId: id,
+        ...(trimString(skill.workspaceId)
+            ? { workspaceId: trimString(skill.workspaceId) }
+            : {}),
+        ...(trimString(skill.ownerId)
+            ? { ownerId: trimString(skill.ownerId) }
+            : {}),
+        ...(typeof skill.currentVersion === "number" &&
+            Number.isFinite(skill.currentVersion)
+            ? { currentVersion: String(Math.trunc(skill.currentVersion)) }
+            : {}),
+        ...(scope ? { scope } : {}),
+    };
+    return {
+        name,
+        description: trimString(skill.description) ?? "Skill from skills service",
+        content,
+        metadata,
+        tags: normalizeTags(skill.tags),
+        sourcePath: `skills-service://${id}`,
+        sourceType: "service",
+        resources: [],
+        resourceDirs: {},
+    };
+}
+export async function loadSkillsFromService(config, options) {
+    const client = getDownstreamClient(config, "listSkills");
+    return downstream.CallOp(client, "listSkills", async () => {
+        const response = await fetchDownstream(`${config.baseUrl}${LIST_SKILLS_PATH}`, {
+            method: "POST",
+            headers: buildHeaders(config),
+            signal: options?.signal,
+            body: JSON.stringify({
+                workspaceId: config.workspaceId,
+                limit: normalizeLimit(config.limit),
+                offset: 0,
+            }),
+        }, {
+            serviceName: "skills service",
+            failureMode: toHttpFailureMode(client),
+            timeoutMs: config.timeoutMs,
+            maxAttempts: config.maxAttempts,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`skills service returned ${response.status}: ${text || response.statusText}`);
+        }
+        const payload = (await response.json());
+        return (payload.skills ?? [])
+            .map(toLoadedSkill)
+            .filter((skill) => skill !== null);
+    }, () => []);
+}
+export function resetSkillsDownstreamForTests() {
+    downstreamClients.clear();
+}
+//# sourceMappingURL=service-client.js.map

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

@@ -0,0 +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"]}

package/dist/skills/tool.d.ts

@@ -5,11 +5,14 @@
  * and resources when it recognizes a task that matches a skill's domain.
  */
 import type { AgentTool } from "../agent/types.js";
+import { type SkillsServiceConfig } from "./service-client.js";
 /**
  * Create the Skill tool definition.
  */
 export declare function createSkillTool(workspaceDir: string, options?: {
     includeSystem?: boolean;
+    includeService?: boolean;
+    skillsService?: SkillsServiceConfig | false;
 }): AgentTool;
 /**
  * Invalidate cached skills (call after skill files change).

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;AA4BpE;;GAEG;AACH,wBAAgB,eAAe,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,SAAS,CAiIX;AAED;;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;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"}

package/dist/skills/tool.js

@@ -6,7 +6,9 @@
  */
 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 { loadSkillsFromService, resolveSkillsServiceConfig, } from "./service-client.js";
 const logger = createLogger("skills:tool");
 /**
  * Skill tool input schema.
@@ -25,12 +27,14 @@ const SkillToolSchema = Type.Object({
 export function createSkillTool(workspaceDir, options) {
     // Load skills once when tool is created
     let cachedSkills = null;
-    const getSkills = () => {
+    const getSkills = async () => {
         if (cachedSkills === null) {
-            const result = loadSkills(workspaceDir, options);
-            cachedSkills = result.skills;
+            cachedSkills = loadSkillsForTool(workspaceDir, options).catch((error) => {
+                cachedSkills = null;
+                throw error;
+            });
         }
-        return cachedSkills;
+        return await cachedSkills;
     };
     return {
         name: "Skill",
@@ -55,7 +59,21 @@ Available skills can be listed by calling this tool with skill="list".`,
                     isError: true,
                 };
             }
-            const skills = getSkills();
+            let skills;
+            try {
+                skills = await getSkills();
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error loading skills: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             // Handle "list" command
             if (skillName.toLowerCase() === "list") {
                 if (skills.length === 0) {
@@ -129,10 +147,54 @@ Available skills can be listed by calling this tool with skill="list".`,
             }
             return {
                 content: [{ type: "text", text }],
+                details: {
+                    skillMetadata: buildSkillArtifactMetadata(skill),
+                },
             };
         },
     };
 }
+function mergeSkills(localSkills, serviceSkills) {
+    const skillMap = new Map();
+    for (const skill of localSkills) {
+        skillMap.set(skill.name.toLowerCase(), skill);
+    }
+    for (const skill of serviceSkills) {
+        const existing = skillMap.get(skill.name.toLowerCase());
+        if (existing) {
+            logger.debug("Skills service skill overrides local skill", {
+                name: skill.name,
+                overridden: existing.sourceType,
+            });
+        }
+        skillMap.set(skill.name.toLowerCase(), skill);
+    }
+    return Array.from(skillMap.values());
+}
+async function loadSkillsForTool(workspaceDir, options) {
+    const result = loadSkills(workspaceDir, options);
+    if (options?.includeService === false) {
+        return result.skills;
+    }
+    const config = resolveSkillsServiceConfig(options?.skillsService);
+    if (!config) {
+        return result.skills;
+    }
+    try {
+        const serviceSkills = await loadSkillsFromService(config);
+        return mergeSkills(result.skills, serviceSkills);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (config.failureMode === "required") {
+            throw new Error(`Skills service unavailable: ${message}`);
+        }
+        logger.warn("Failed to load skills from skills service; using local skills", {
+            error: message,
+        });
+        return result.skills;
+    }
+}
 /**
  * Invalidate cached skills (call after skill files change).
  */

package/dist/skills/tool.js.map

@@ -1 +1 @@
-{"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 {\n\ttype LoadedSkill,\n\tfindSkill,\n\tformatSkillForInjection,\n\tformatSkillListItem,\n\tloadSkills,\n\tsearchSkills,\n} from \"./loader.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?: { includeSystem?: boolean },\n): AgentTool {\n\t// Load skills once when tool is created\n\tlet cachedSkills: LoadedSkill[] | null = null;\n\n\tconst getSkills = (): LoadedSkill[] => {\n\t\tif (cachedSkills === null) {\n\t\t\tconst result = loadSkills(workspaceDir, options);\n\t\t\tcachedSkills = result.skills;\n\t\t}\n\t\treturn 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\tconst skills = getSkills();\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};\n\t\t},\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 {\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"]}

package/dist/telemetry/index.d.ts

@@ -4,6 +4,10 @@
  * Centralized telemetry exports including wide events pattern.
  */
 export { recordTelemetry, recordToolExecution, recordEvaluationResult, recordLoaderStage, recordSseSkip, logToolFailure, recordBackgroundTaskEvent, recordApiRequest, recordBusinessMetric, recordSessionStart, recordSessionDuration, recordTokenUsage, recordCost, recordCompaction, recordModelSwitch, recordSandboxViolation, getTelemetryStatus, setTelemetryRuntimeOverride, getBackgroundTaskHistory, type TelemetryStatus, type ApiRequestTelemetry, type ToolExecutionTelemetry, type EvaluationTelemetry, type LoaderStageTelemetry, type SseTelemetry, type BackgroundTaskTelemetry, type BusinessMetricTelemetry, type SandboxViolationTelemetry, } from "../telemetry.js";
+export { MAESTRO_BUS_EVENT_CATALOG, MAESTRO_BUS_EVENT_TYPES, MaestroBusEventType, getMaestroBusEventCatalogEntry, isMaestroBusEventType, listMaestroBusEventCatalog, type MaestroBusEventCatalogEntry, type MaestroBusEventCategory, } from "./maestro-event-catalog.js";
+export { buildMaestroCloudEvent, closeMaestroEventBusTransport, getMaestroEventBusStatus, maestroCorrelationToChronicleMetadata, publishMaestroCloudEvent, publishMaestroCloudEventStrict, recordMaestroApprovalHit, recordMaestroEvalScored, recordMaestroFirewallBlock, recordMaestroLearnedContext, recordMaestroPromptVariantSelected, recordMaestroSessionEvent, recordMaestroSkillInvoked, recordMaestroSkillOutcome, recordMaestroToolCallAttempt, recordMaestroToolCallCompleted, resolveMaestroEventBusConfig, setMaestroEventBusTransportForTests, type ApprovalHitEventData, type EvalScoredEventData, type FirewallBlockEventData, type MaestroCloudEvent, type MaestroCloseReason, type MaestroCorrelation, type MaestroDecisionMode, type MaestroEventBusConfig, type MaestroEventBusStatus, type MaestroEventBusTransport, type MaestroLearnedContextEventData, type MaestroLearnedContextEvidence, type MaestroPrincipal, type MaestroRuntimeMode, type MaestroSessionEventData, type MaestroSessionState, type MaestroSkillOutcomeProtoStatus, type MaestroSkillOutcomeStatus, type MaestroSurface, type MaestroToolCallStatus, type PublishMaestroEventOptions, type RecordMaestroApprovalHitInput, type RecordMaestroEvalScoredInput, type RecordMaestroFirewallBlockInput, type RecordMaestroLearnedContextInput, type RecordMaestroPromptVariantSelectedInput, type PromptVariantSelectedEventData, type RecordMaestroSkillInvokedInput, type RecordMaestroSkillOutcomeInput, type RecordMaestroToolCallAttemptInput, type RecordMaestroToolCallCompletedInput, type SandboxViolationEventData, type SkillInvocationEventData, type SkillOutcomeEventData, type ToolCallAttemptEventData, type ToolCallResultEventData, } from "./maestro-event-bus.js";
+export { CANONICAL_MAESTRO_PUBLISHER_CONFORMANCE_FIXTURE_NAME, buildCanonicalMaestroPublisherConformanceFixture, canonicalMaestroPublisherConformanceFixtureJson, type BuildMaestroPublisherConformanceFixtureOptions, type MaestroPublisherConformanceFixture, type MaestroPublisherConformanceFixtureEvent, } from "./maestro-publisher-conformance-fixture.js";
+export { CANONICAL_MAESTRO_PLATFORM_REPLAY_FIXTURE_NAME, buildCanonicalMaestroPlatformReplayFixture, canonicalMaestroPlatformReplayFixtureJson, type MaestroPlatformReplayFixture, type MaestroPlatformReplayFixtureEvent, } from "./maestro-platform-replay-fixture.js";
 export { TurnCollector, createTurnCollector, getSamplingConfigFromEnv, type CanonicalTurnEvent, type ToolExecution, type TokenUsage as WideEventTokenUsage, type ModelInfo, type TailSamplingConfig, } from "./wide-events.js";
 export { TurnTracker, createTurnTracker, type TurnTrackerConfig, type TurnTrackerContext, } from "./turn-tracker.js";
 export { SessionPerfCollector, formatPerfReport, type SessionPerfSnapshot, } from "./session-perf.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC9B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,SAAS,EACd,KAAK,kBAAkB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACN,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,mBAAmB,GACxB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/index.js

@@ -5,6 +5,11 @@
  */
 // Re-export from main telemetry module
 export { recordTelemetry, recordToolExecution, recordEvaluationResult, recordLoaderStage, recordSseSkip, logToolFailure, recordBackgroundTaskEvent, recordApiRequest, recordBusinessMetric, recordSessionStart, recordSessionDuration, recordTokenUsage, recordCost, recordCompaction, recordModelSwitch, recordSandboxViolation, getTelemetryStatus, setTelemetryRuntimeOverride, getBackgroundTaskHistory, } from "../telemetry.js";
+// Maestro event bus catalog shared with the public mirror.
+export { MAESTRO_BUS_EVENT_CATALOG, MAESTRO_BUS_EVENT_TYPES, MaestroBusEventType, getMaestroBusEventCatalogEntry, isMaestroBusEventType, listMaestroBusEventCatalog, } from "./maestro-event-catalog.js";
+export { buildMaestroCloudEvent, closeMaestroEventBusTransport, getMaestroEventBusStatus, maestroCorrelationToChronicleMetadata, publishMaestroCloudEvent, publishMaestroCloudEventStrict, recordMaestroApprovalHit, recordMaestroEvalScored, recordMaestroFirewallBlock, recordMaestroLearnedContext, recordMaestroPromptVariantSelected, recordMaestroSessionEvent, recordMaestroSkillInvoked, recordMaestroSkillOutcome, recordMaestroToolCallAttempt, recordMaestroToolCallCompleted, resolveMaestroEventBusConfig, setMaestroEventBusTransportForTests, } from "./maestro-event-bus.js";
+export { CANONICAL_MAESTRO_PUBLISHER_CONFORMANCE_FIXTURE_NAME, buildCanonicalMaestroPublisherConformanceFixture, canonicalMaestroPublisherConformanceFixtureJson, } from "./maestro-publisher-conformance-fixture.js";
+export { CANONICAL_MAESTRO_PLATFORM_REPLAY_FIXTURE_NAME, buildCanonicalMaestroPlatformReplayFixture, canonicalMaestroPlatformReplayFixtureJson, } from "./maestro-platform-replay-fixture.js";
 // Wide events (canonical turn events)
 export { TurnCollector, createTurnCollector, getSamplingConfigFromEnv, } from "./wide-events.js";
 // Turn tracking integration

package/dist/telemetry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uCAAuC;AACvC,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,GAUxB,MAAM,iBAAiB,CAAC;AAEzB,sCAAsC;AACtC,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,wBAAwB,GAMxB,MAAM,kBAAkB,CAAC;AAE1B,4BAA4B;AAC5B,OAAO,EACN,WAAW,EACX,iBAAiB,GAGjB,MAAM,mBAAmB,CAAC;AAE3B,kCAAkC;AAClC,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAEhB,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * Telemetry Module\n *\n * Centralized telemetry exports including wide events pattern.\n */\n\n// Re-export from main telemetry module\nexport {\n\trecordTelemetry,\n\trecordToolExecution,\n\trecordEvaluationResult,\n\trecordLoaderStage,\n\trecordSseSkip,\n\tlogToolFailure,\n\trecordBackgroundTaskEvent,\n\trecordApiRequest,\n\trecordBusinessMetric,\n\trecordSessionStart,\n\trecordSessionDuration,\n\trecordTokenUsage,\n\trecordCost,\n\trecordCompaction,\n\trecordModelSwitch,\n\trecordSandboxViolation,\n\tgetTelemetryStatus,\n\tsetTelemetryRuntimeOverride,\n\tgetBackgroundTaskHistory,\n\ttype TelemetryStatus,\n\ttype ApiRequestTelemetry,\n\ttype ToolExecutionTelemetry,\n\ttype EvaluationTelemetry,\n\ttype LoaderStageTelemetry,\n\ttype SseTelemetry,\n\ttype BackgroundTaskTelemetry,\n\ttype BusinessMetricTelemetry,\n\ttype SandboxViolationTelemetry,\n} from \"../telemetry.js\";\n\n// Wide events (canonical turn events)\nexport {\n\tTurnCollector,\n\tcreateTurnCollector,\n\tgetSamplingConfigFromEnv,\n\ttype CanonicalTurnEvent,\n\ttype ToolExecution,\n\ttype TokenUsage as WideEventTokenUsage,\n\ttype ModelInfo,\n\ttype TailSamplingConfig,\n} from \"./wide-events.js\";\n\n// Turn tracking integration\nexport {\n\tTurnTracker,\n\tcreateTurnTracker,\n\ttype TurnTrackerConfig,\n\ttype TurnTrackerContext,\n} from \"./turn-tracker.js\";\n\n// Session performance aggregation\nexport {\n\tSessionPerfCollector,\n\tformatPerfReport,\n\ttype SessionPerfSnapshot,\n} from \"./session-perf.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uCAAuC;AACvC,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,GAUxB,MAAM,iBAAiB,CAAC;AAEzB,2DAA2D;AAC3D,OAAO,EACN,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,qBAAqB,EACrB,0BAA0B,GAG1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACN,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,qCAAqC,EACrC,wBAAwB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,mCAAmC,GAqCnC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACN,oDAAoD,EACpD,gDAAgD,EAChD,+CAA+C,GAI/C,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACN,8CAA8C,EAC9C,0CAA0C,EAC1C,yCAAyC,GAGzC,MAAM,sCAAsC,CAAC;AAE9C,sCAAsC;AACtC,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,wBAAwB,GAMxB,MAAM,kBAAkB,CAAC;AAE1B,4BAA4B;AAC5B,OAAO,EACN,WAAW,EACX,iBAAiB,GAGjB,MAAM,mBAAmB,CAAC;AAE3B,kCAAkC;AAClC,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAEhB,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * Telemetry Module\n *\n * Centralized telemetry exports including wide events pattern.\n */\n\n// Re-export from main telemetry module\nexport {\n\trecordTelemetry,\n\trecordToolExecution,\n\trecordEvaluationResult,\n\trecordLoaderStage,\n\trecordSseSkip,\n\tlogToolFailure,\n\trecordBackgroundTaskEvent,\n\trecordApiRequest,\n\trecordBusinessMetric,\n\trecordSessionStart,\n\trecordSessionDuration,\n\trecordTokenUsage,\n\trecordCost,\n\trecordCompaction,\n\trecordModelSwitch,\n\trecordSandboxViolation,\n\tgetTelemetryStatus,\n\tsetTelemetryRuntimeOverride,\n\tgetBackgroundTaskHistory,\n\ttype TelemetryStatus,\n\ttype ApiRequestTelemetry,\n\ttype ToolExecutionTelemetry,\n\ttype EvaluationTelemetry,\n\ttype LoaderStageTelemetry,\n\ttype SseTelemetry,\n\ttype BackgroundTaskTelemetry,\n\ttype BusinessMetricTelemetry,\n\ttype SandboxViolationTelemetry,\n} from \"../telemetry.js\";\n\n// Maestro event bus catalog shared with the public mirror.\nexport {\n\tMAESTRO_BUS_EVENT_CATALOG,\n\tMAESTRO_BUS_EVENT_TYPES,\n\tMaestroBusEventType,\n\tgetMaestroBusEventCatalogEntry,\n\tisMaestroBusEventType,\n\tlistMaestroBusEventCatalog,\n\ttype MaestroBusEventCatalogEntry,\n\ttype MaestroBusEventCategory,\n} from \"./maestro-event-catalog.js\";\n\nexport {\n\tbuildMaestroCloudEvent,\n\tcloseMaestroEventBusTransport,\n\tgetMaestroEventBusStatus,\n\tmaestroCorrelationToChronicleMetadata,\n\tpublishMaestroCloudEvent,\n\tpublishMaestroCloudEventStrict,\n\trecordMaestroApprovalHit,\n\trecordMaestroEvalScored,\n\trecordMaestroFirewallBlock,\n\trecordMaestroLearnedContext,\n\trecordMaestroPromptVariantSelected,\n\trecordMaestroSessionEvent,\n\trecordMaestroSkillInvoked,\n\trecordMaestroSkillOutcome,\n\trecordMaestroToolCallAttempt,\n\trecordMaestroToolCallCompleted,\n\tresolveMaestroEventBusConfig,\n\tsetMaestroEventBusTransportForTests,\n\ttype ApprovalHitEventData,\n\ttype EvalScoredEventData,\n\ttype FirewallBlockEventData,\n\ttype MaestroCloudEvent,\n\ttype MaestroCloseReason,\n\ttype MaestroCorrelation,\n\ttype MaestroDecisionMode,\n\ttype MaestroEventBusConfig,\n\ttype MaestroEventBusStatus,\n\ttype MaestroEventBusTransport,\n\ttype MaestroLearnedContextEventData,\n\ttype MaestroLearnedContextEvidence,\n\ttype MaestroPrincipal,\n\ttype MaestroRuntimeMode,\n\ttype MaestroSessionEventData,\n\ttype MaestroSessionState,\n\ttype MaestroSkillOutcomeProtoStatus,\n\ttype MaestroSkillOutcomeStatus,\n\ttype MaestroSurface,\n\ttype MaestroToolCallStatus,\n\ttype PublishMaestroEventOptions,\n\ttype RecordMaestroApprovalHitInput,\n\ttype RecordMaestroEvalScoredInput,\n\ttype RecordMaestroFirewallBlockInput,\n\ttype RecordMaestroLearnedContextInput,\n\ttype RecordMaestroPromptVariantSelectedInput,\n\ttype PromptVariantSelectedEventData,\n\ttype RecordMaestroSkillInvokedInput,\n\ttype RecordMaestroSkillOutcomeInput,\n\ttype RecordMaestroToolCallAttemptInput,\n\ttype RecordMaestroToolCallCompletedInput,\n\ttype SandboxViolationEventData,\n\ttype SkillInvocationEventData,\n\ttype SkillOutcomeEventData,\n\ttype ToolCallAttemptEventData,\n\ttype ToolCallResultEventData,\n} from \"./maestro-event-bus.js\";\n\nexport {\n\tCANONICAL_MAESTRO_PUBLISHER_CONFORMANCE_FIXTURE_NAME,\n\tbuildCanonicalMaestroPublisherConformanceFixture,\n\tcanonicalMaestroPublisherConformanceFixtureJson,\n\ttype BuildMaestroPublisherConformanceFixtureOptions,\n\ttype MaestroPublisherConformanceFixture,\n\ttype MaestroPublisherConformanceFixtureEvent,\n} from \"./maestro-publisher-conformance-fixture.js\";\n\nexport {\n\tCANONICAL_MAESTRO_PLATFORM_REPLAY_FIXTURE_NAME,\n\tbuildCanonicalMaestroPlatformReplayFixture,\n\tcanonicalMaestroPlatformReplayFixtureJson,\n\ttype MaestroPlatformReplayFixture,\n\ttype MaestroPlatformReplayFixtureEvent,\n} from \"./maestro-platform-replay-fixture.js\";\n\n// Wide events (canonical turn events)\nexport {\n\tTurnCollector,\n\tcreateTurnCollector,\n\tgetSamplingConfigFromEnv,\n\ttype CanonicalTurnEvent,\n\ttype ToolExecution,\n\ttype TokenUsage as WideEventTokenUsage,\n\ttype ModelInfo,\n\ttype TailSamplingConfig,\n} from \"./wide-events.js\";\n\n// Turn tracking integration\nexport {\n\tTurnTracker,\n\tcreateTurnTracker,\n\ttype TurnTrackerConfig,\n\ttype TurnTrackerContext,\n} from \"./turn-tracker.js\";\n\n// Session performance aggregation\nexport {\n\tSessionPerfCollector,\n\tformatPerfReport,\n\ttype SessionPerfSnapshot,\n} from \"./session-perf.js\";\n"]}