@stigmer/mcp-server 3.0.8-dev.20260612122433

package/domains/skills/delete.js

@@ -0,0 +1,38 @@
+// Skill delete path: resolve org/slug → id, then delete (removing the skill and
+// all its versions), both over a single shared transport.
+// Go parity: mcp-server/internal/domains/skills/delete.go.
+import { createClient } from "@connectrpc/connect";
+import { SkillSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
+import { SkillCommandController } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/command_pb";
+import { SkillQueryController } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/query_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { withTransport } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+/**
+ * Delete a skill and all its versions by org and slug, returning the deleted
+ * skill as protojson.
+ */
+export async function deleteSkill(serverAddress, token, org, slug) {
+    const desc = `skill "${slug}" in org "${org}"`;
+    return withTransport(serverAddress, token, async (transport, callOptions) => {
+        const query = createClient(SkillQueryController, transport);
+        let id;
+        try {
+            const skill = await query.getByReference({ org, kind: ApiResourceKind.skill, slug }, callOptions);
+            id = skill.metadata?.id ?? "";
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+        const command = createClient(SkillCommandController, transport);
+        try {
+            const deleted = await command.delete({ value: id }, callOptions);
+            return toProtoJson(SkillSchema, deleted);
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+    });
+}
+//# sourceMappingURL=delete.js.map

package/domains/skills/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/domains/skills/delete.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0DAA0D;AAC1D,2DAA2D;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAEtH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,aAAqB,EACrB,KAAa,EACb,GAAW,EACX,IAAY;IAEZ,MAAM,IAAI,GAAG,UAAU,IAAI,aAAa,GAAG,GAAG,CAAC;IAC/C,OAAO,aAAa,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE;QAC1E,MAAM,KAAK,GAAG,YAAY,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;YAClG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YACjE,OAAO,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/domains/skills/fetch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Retrieve a skill by org, slug, and optional version, returning its protojson
+ * representation. Pass an empty version string for the latest version.
+ */
+export declare function fetchSkill(serverAddress: string, token: string, org: string, slug: string, version: string): Promise<string>;
+//# sourceMappingURL=fetch.d.ts.map

package/domains/skills/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/fetch.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/domains/skills/fetch.js

@@ -0,0 +1,28 @@
+// Skill read path: the single RPC the get_skill tool and both skill resource
+// templates (latest + versioned) delegate to.
+// Go parity: mcp-server/internal/domains/skills/fetch.go.
+//
+// Skills are versioned: an empty version string requests the latest version; a
+// tag name or SHA-256 hash requests a specific one.
+import { SkillSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
+import { SkillQueryController } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/query_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+/**
+ * Retrieve a skill by org, slug, and optional version, returning its protojson
+ * representation. Pass an empty version string for the latest version.
+ */
+export async function fetchSkill(serverAddress, token, org, slug, version) {
+    return withClient(SkillQueryController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const skill = await client.getByReference({ org, kind: ApiResourceKind.skill, slug, version }, callOptions);
+            return toProtoJson(SkillSchema, skill);
+        }
+        catch (err) {
+            throw rpcError(err, `skill "${slug}" in org "${org}"`);
+        }
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/domains/skills/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/domains/skills/fetch.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8CAA8C;AAC9C,0DAA0D;AAC1D,EAAE;AACF,+EAA+E;AAC/E,oDAAoD;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAEtH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAAqB,EACrB,KAAa,EACb,GAAW,EACX,IAAY,EACZ,OAAe;IAEf,OAAO,UAAU,CAAC,oBAAoB,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC1F,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,CACvC,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EACnD,WAAW,CACZ,CAAC;YACF,OAAO,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,UAAU,IAAI,aAAa,GAAG,GAAG,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/domains/skills/resources.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BackendTarget } from "../client.js";
+/** Register both skill resource templates; returns the registered resource names. */
+export declare function registerSkillResources(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=resources.d.ts.map

package/domains/skills/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/resources.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAqBzF"}

package/domains/skills/resources.js

@@ -0,0 +1,25 @@
+// Skill resource templates: latest (stigmer://skills/{org}/{slug}) and versioned
+// (stigmer://skills/{org}/{slug}/{version}).
+// Go parity: mcp-server/internal/domains/skills/resources.go.
+import { registerResource, registerVersionedResource } from "../resourcehandler.js";
+import { fetchSkill } from "./fetch.js";
+/** Register both skill resource templates; returns the registered resource names. */
+export function registerSkillResources(server, target) {
+    registerResource(server, target, {
+        name: "stigmer_skill",
+        title: "Stigmer Skill",
+        description: "Full definition of a Stigmer skill (latest version), identified by organization and slug.",
+        template: "stigmer://skills/{org}/{slug}",
+        // Two-segment URI → latest version (empty version string).
+        fetch: (serverAddress, token, org, slug) => fetchSkill(serverAddress, token, org, slug, ""),
+    });
+    registerVersionedResource(server, target, {
+        name: "stigmer_skill_version",
+        title: "Stigmer Skill (versioned)",
+        description: "Full definition of a Stigmer skill at a specific version, identified by organization, slug, and version (tag name or SHA-256 hash).",
+        template: "stigmer://skills/{org}/{slug}/{version}",
+        fetch: fetchSkill,
+    });
+    return ["stigmer_skill", "stigmer_skill_version"];
+}
+//# sourceMappingURL=resources.js.map

package/domains/skills/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/domains/skills/resources.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,6CAA6C;AAC7C,8DAA8D;AAK9D,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAqB;IAC7E,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE;QAC/B,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,2FAA2F;QAC7F,QAAQ,EAAE,+BAA+B;QACzC,2DAA2D;QAC3D,KAAK,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEH,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE;QACxC,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,qIAAqI;QACvI,QAAQ,EAAE,yCAAyC;QACnD,KAAK,EAAE,UAAU;KAClB,CAAC,CAAC;IAEH,OAAO,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAAC;AACpD,CAAC"}

package/domains/skills/tools.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "../client.js";
+/** Register every Skill-domain tool; returns the registered tool names. */
+export declare function registerSkillTools(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=tools.d.ts.map

package/domains/skills/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAKhE,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkDrF"}

package/domains/skills/tools.js

@@ -0,0 +1,39 @@
+// MCP tools for the Skill domain.
+// Go parity: mcp-server/internal/domains/skills/tools.go.
+//
+// Skills are read-only over MCP (search/get/delete); creation/update happens via
+// `stigmer skill push` (content hashing, diffing, tag management). `version` is
+// optional — omit it for the latest version.
+import { z } from "zod";
+import { resolveToken } from "../client.js";
+import { textOrError } from "../toolresult.js";
+import { deleteSkill } from "./delete.js";
+import { fetchSkill } from "./fetch.js";
+/** Register every Skill-domain tool; returns the registered tool names. */
+export function registerSkillTools(server, target) {
+    server.registerTool("get_skill", {
+        description: "Get full details of a Stigmer skill by org and slug, optionally at a specific version. " +
+            "Omit 'version' for the latest.",
+        inputSchema: {
+            org: z.string().describe("Organization slug that owns the skill."),
+            slug: z.string().describe("Skill slug — unique identifier within the org."),
+            version: z
+                .string()
+                .optional()
+                .describe("Version to retrieve: tag name (e.g. stable) or SHA-256 hash. Omit for latest."),
+        },
+    }, (args, extra) => textOrError(() => 
+    // Empty string means "latest", matching the Go handler passing input.Version.
+    fetchSkill(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug, args.version ?? "")));
+    server.registerTool("delete_skill", {
+        description: "Delete a Stigmer skill and all its versions by org and slug. To create or update skills, use the 'stigmer skill push' CLI command. Returns the deleted skill.",
+        inputSchema: {
+            org: z.string().describe("Organization slug that owns the skill (e.g. stigmer)."),
+            slug: z
+                .string()
+                .describe("Skill slug — the unique identifier within the org (e.g. code-review-best-practices). Deletes the skill and all its versions."),
+        },
+    }, (args, extra) => textOrError(() => deleteSkill(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug)));
+    return ["get_skill", "delete_skill"];
+}
+//# sourceMappingURL=tools.js.map

package/domains/skills/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/skills/tools.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,0DAA0D;AAC1D,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,6CAA6C;AAG7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAqB;IACzE,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EACT,yFAAyF;YACzF,gCAAgC;QAClC,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC3E,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+EAA+E,CAAC;SAC7F;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE;IACf,8EAA8E;IAC9E,UAAU,CACR,MAAM,CAAC,aAAa,EACpB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAClC,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,IAAI,EAAE,CACnB,CACF,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,+JAA+J;QACjK,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACjF,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,8HAA8H,CAC/H;SACJ;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAC3F,CACJ,CAAC;IAEF,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACvC,CAAC"}

package/domains/toolresult.d.ts

@@ -0,0 +1,12 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** Wrap a plain text payload into the CallToolResult structure tools return. */
+export declare function textResult(text: string): CallToolResult;
+/** Wrap a failure into an `isError` CallToolResult carrying its message. */
+export declare function errorResult(err: unknown): CallToolResult;
+/**
+ * Run a string-producing tool body, returning its output as a text result or,
+ * if it throws, as an `isError` result. Domain handlers compose this so the
+ * try/catch lives in exactly one place.
+ */
+export declare function textOrError(produce: () => Promise<string>): Promise<CallToolResult>;
+//# sourceMappingURL=toolresult.d.ts.map

package/domains/toolresult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolresult.d.ts","sourceRoot":"","sources":["../../src/domains/toolresult.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEvD;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAGxD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAMzF"}

package/domains/toolresult.js

@@ -0,0 +1,30 @@
+// Helpers for shaping MCP tool return values.
+//
+// Mirrors Go internal/domains/toolresult.go: every tool returns its payload as
+// a single text content block, and a failed call surfaces as an `isError`
+// result carrying the user-facing message (the Go SDK does this when a handler
+// returns an error; here we do it explicitly so behavior is identical and
+// every domain handler stays a one-liner).
+/** Wrap a plain text payload into the CallToolResult structure tools return. */
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+/** Wrap a failure into an `isError` CallToolResult carrying its message. */
+export function errorResult(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/**
+ * Run a string-producing tool body, returning its output as a text result or,
+ * if it throws, as an `isError` result. Domain handlers compose this so the
+ * try/catch lives in exactly one place.
+ */
+export async function textOrError(produce) {
+    try {
+        return textResult(await produce());
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+//# sourceMappingURL=toolresult.js.map

package/domains/toolresult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolresult.js","sourceRoot":"","sources":["../../src/domains/toolresult.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAC/E,0EAA0E;AAC1E,2CAA2C;AAI3C,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA8B;IAC9D,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/domains/workflowexecutions/tools.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "../client.js";
+/** Register the workflow-execution tools; returns the registered tool names. */
+export declare function registerWorkflowExecutionTools(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=tools.d.ts.map

package/domains/workflowexecutions/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/workflowexecutions/tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAK5E,gFAAgF;AAChF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAgDjG"}

package/domains/workflowexecutions/tools.js

@@ -0,0 +1,80 @@
+// MCP tools for querying workflow execution status and event logs.
+// Go parity: mcp-server/internal/domains/workflowexecutions/tools.go.
+//
+// Backed by WorkflowExecutionQueryController (get, getEventLog). These are
+// diagnostic reads for running/failed executions.
+import { WorkflowExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import { GetEventLogResponseSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { WorkflowExecutionQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/query_pb";
+import { z } from "zod";
+import { resolveToken, withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+import { textOrError } from "../toolresult.js";
+/** Register the workflow-execution tools; returns the registered tool names. */
+export function registerWorkflowExecutionTools(server, target) {
+    server.registerTool("get_workflow_execution", {
+        description: "Get a workflow execution's full status including phase, tasks, errors, cost, and timing. Use for diagnosing failed or running executions.",
+        inputSchema: {
+            execution_id: z.string().describe("Workflow execution ID (wex_* format)."),
+        },
+    }, (args, extra) => textOrError(() => getWorkflowExecution(target.serverAddress, resolveToken(extra, target.apiKey), args.execution_id)));
+    server.registerTool("get_workflow_execution_events", {
+        description: "Get the event log for a workflow execution. " +
+            "Returns task transitions, errors, cost checkpoints, and approval events. " +
+            "Use for deep diagnosis of execution failures.",
+        inputSchema: {
+            execution_id: z.string().describe("Workflow execution ID (wex_* format)."),
+            task_name: z.string().optional().describe("Filter events by task name."),
+            page_size: z
+                .number()
+                .int()
+                .optional()
+                .describe("Number of events per page (default 100, max 500)."),
+        },
+    }, (args, extra) => textOrError(() => getWorkflowExecutionEvents(target.serverAddress, resolveToken(extra, target.apiKey), {
+        executionId: args.execution_id,
+        taskName: args.task_name,
+        pageSize: args.page_size,
+    })));
+    return ["get_workflow_execution", "get_workflow_execution_events"];
+}
+/** Fetch a single workflow execution by id. */
+async function getWorkflowExecution(serverAddress, token, executionId) {
+    if (executionId === "") {
+        throw new Error("execution_id is required");
+    }
+    return withClient(WorkflowExecutionQueryController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const execution = await client.get({ value: executionId }, callOptions);
+            return toProtoJson(WorkflowExecutionSchema, execution);
+        }
+        catch (err) {
+            throw rpcError(err, `workflow execution "${executionId}"`);
+        }
+    });
+}
+/** Fetch the event log for an execution, optionally filtered and paginated. */
+async function getWorkflowExecutionEvents(serverAddress, token, args) {
+    if (args.executionId === "") {
+        throw new Error("execution_id is required");
+    }
+    return withClient(WorkflowExecutionQueryController, serverAddress, token, async (client, callOptions) => {
+        const req = {
+            executionId: args.executionId,
+            taskName: args.taskName ?? "",
+        };
+        // Forward page_size only when set, letting the server apply its default.
+        if ((args.pageSize ?? 0) > 0) {
+            req.pageSize = args.pageSize;
+        }
+        try {
+            const resp = await client.getEventLog(req, callOptions);
+            return toProtoJson(GetEventLogResponseSchema, resp);
+        }
+        catch (err) {
+            throw rpcError(err, `event log for execution "${args.executionId}"`);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/domains/workflowexecutions/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/workflowexecutions/tools.ts"],"names":[],"mappings":"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"}

package/domains/workflows/apply.d.ts

@@ -0,0 +1,4 @@
+import { type WorkflowInput } from "../../gen/workflow.js";
+/** Create or update a workflow, returning the persisted workflow as protojson. */
+export declare function applyWorkflow(serverAddress: string, token: string, input: WorkflowInput): Promise<string>;
+//# sourceMappingURL=apply.d.ts.map

package/domains/workflows/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/apply.ts"],"names":[],"mappings":"AAaA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKjF,kFAAkF;AAClF,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/domains/workflows/apply.js

@@ -0,0 +1,30 @@
+// Workflow apply path: create-or-update via the WorkflowCommandController.apply
+// RPC. The flat MCP input is projected into a fully-formed Workflow proto by the
+// generated workflowInputToProto bridge (codegen, src/gen/workflow.ts), which
+// expands each task's typed config into the task_config Struct.
+//
+// Go parity note: the Go MCP server keeps apply_workflow registered but its
+// generated input cannot express recursive task nesting in Go's jsonschema
+// reflection. protobuf-es + zod's z.lazy resolve that limitation, so the TS
+// server exposes apply_workflow at full fidelity.
+import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { WorkflowCommandController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/command_pb";
+import { workflowInputToProto } from "../../gen/workflow.js";
+import { withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+/** Create or update a workflow, returning the persisted workflow as protojson. */
+export async function applyWorkflow(serverAddress, token, input) {
+    const workflow = workflowInputToProto(input);
+    const desc = `workflow "${workflow.metadata?.slug ?? ""}" in org "${workflow.metadata?.org ?? ""}"`;
+    return withClient(WorkflowCommandController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const result = await client.apply(workflow, callOptions);
+            return toProtoJson(WorkflowSchema, result);
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+    });
+}
+//# sourceMappingURL=apply.js.map

package/domains/workflows/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/domains/workflows/apply.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAEtG,OAAO,EAAE,oBAAoB,EAAsB,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,aAAqB,EACrB,KAAa,EACb,KAAoB;IAEpB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,aAAa,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,aAAa,QAAQ,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC;IACpG,OAAO,UAAU,CACf,yBAAyB,EACzB,aAAa,EACb,KAAK,EACL,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACzD,OAAO,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/domains/workflows/delete.d.ts

@@ -0,0 +1,3 @@
+/** Delete a workflow by org and slug, returning the deleted workflow as protojson. */
+export declare function deleteWorkflow(serverAddress: string, token: string, org: string, slug: string): Promise<string>;
+//# sourceMappingURL=delete.d.ts.map

package/domains/workflows/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/delete.ts"],"names":[],"mappings":"AAcA,sFAAsF;AACtF,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/domains/workflows/delete.js

@@ -0,0 +1,35 @@
+// Workflow delete path: resolve org/slug → id, then delete, both over a single
+// shared transport.
+// Go parity: mcp-server/internal/domains/workflows/delete.go.
+import { createClient } from "@connectrpc/connect";
+import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { WorkflowCommandController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/command_pb";
+import { WorkflowQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/query_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { withTransport } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+/** Delete a workflow by org and slug, returning the deleted workflow as protojson. */
+export async function deleteWorkflow(serverAddress, token, org, slug) {
+    const desc = `workflow "${slug}" in org "${org}"`;
+    return withTransport(serverAddress, token, async (transport, callOptions) => {
+        const query = createClient(WorkflowQueryController, transport);
+        let id;
+        try {
+            const workflow = await query.getByReference({ org, kind: ApiResourceKind.workflow, slug }, callOptions);
+            id = workflow.metadata?.id ?? "";
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+        const command = createClient(WorkflowCommandController, transport);
+        try {
+            const deleted = await command.delete({ value: id }, callOptions);
+            return toProtoJson(WorkflowSchema, deleted);
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+    });
+}
+//# sourceMappingURL=delete.js.map

package/domains/workflows/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/domains/workflows/delete.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,oBAAoB;AACpB,8DAA8D;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAEtH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,aAAqB,EACrB,KAAa,EACb,GAAW,EACX,IAAY;IAEZ,MAAM,IAAI,GAAG,aAAa,IAAI,aAAa,GAAG,GAAG,CAAC;IAClD,OAAO,aAAa,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE;QAC1E,MAAM,KAAK,GAAG,YAAY,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;QAC/D,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,CACzC,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,EAC7C,WAAW,CACZ,CAAC;YACF,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YACjE,OAAO,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/domains/workflows/fetch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Retrieve a workflow by org and slug, returning its protojson representation.
+ * Errors are classified into user-facing messages via {@link rpcError}.
+ */
+export declare function fetchWorkflow(serverAddress: string, token: string, org: string, slug: string): Promise<string>;
+//# sourceMappingURL=fetch.d.ts.map

package/domains/workflows/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/fetch.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/domains/workflows/fetch.js

@@ -0,0 +1,25 @@
+// Workflow read path: the single RPC both the get_workflow tool and the
+// workflow resource template delegate to.
+// Go parity: mcp-server/internal/domains/workflows/fetch.go.
+import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { WorkflowQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/query_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+/**
+ * Retrieve a workflow by org and slug, returning its protojson representation.
+ * Errors are classified into user-facing messages via {@link rpcError}.
+ */
+export async function fetchWorkflow(serverAddress, token, org, slug) {
+    return withClient(WorkflowQueryController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const workflow = await client.getByReference({ org, kind: ApiResourceKind.workflow, slug }, callOptions);
+            return toProtoJson(WorkflowSchema, workflow);
+        }
+        catch (err) {
+            throw rpcError(err, `workflow "${slug}" in org "${org}"`);
+        }
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/domains/workflows/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/domains/workflows/fetch.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0CAA0C;AAC1C,6DAA6D;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAEtH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,aAAqB,EACrB,KAAa,EACb,GAAW,EACX,IAAY;IAEZ,OAAO,UAAU,CAAC,uBAAuB,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAC1C,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,EAC7C,WAAW,CACZ,CAAC;YACF,OAAO,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,aAAa,IAAI,aAAa,GAAG,GAAG,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/domains/workflows/resources.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BackendTarget } from "../client.js";
+/** Register the workflow resource template; returns the registered resource names. */
+export declare function registerWorkflowResources(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=resources.d.ts.map

package/domains/workflows/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/resources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAS5F"}

package/domains/workflows/resources.js

@@ -0,0 +1,16 @@
+// Workflow resource template (stigmer://workflows/{org}/{slug}).
+// Go parity: mcp-server/internal/domains/workflows/resources.go.
+import { registerResource } from "../resourcehandler.js";
+import { fetchWorkflow } from "./fetch.js";
+/** Register the workflow resource template; returns the registered resource names. */
+export function registerWorkflowResources(server, target) {
+    registerResource(server, target, {
+        name: "stigmer_workflow",
+        title: "Stigmer Workflow",
+        description: "Full definition of a Stigmer workflow, identified by organization and slug.",
+        template: "stigmer://workflows/{org}/{slug}",
+        fetch: fetchWorkflow,
+    });
+    return ["stigmer_workflow"];
+}
+//# sourceMappingURL=resources.js.map

package/domains/workflows/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/domains/workflows/resources.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,iEAAiE;AAKjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,sFAAsF;AACtF,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,MAAqB;IAChF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE;QAC/B,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,6EAA6E;QAC1F,QAAQ,EAAE,kCAAkC;QAC5C,KAAK,EAAE,aAAa;KACrB,CAAC,CAAC;IACH,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC9B,CAAC"}

package/domains/workflows/taskkinds.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "../client.js";
+/** Register the task-kind registry tools; returns the registered tool names. */
+export declare function registerTaskKindTools(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=taskkinds.d.ts.map

package/domains/workflows/taskkinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskkinds.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/taskkinds.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAK5E,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAgCxF"}

package/domains/workflows/taskkinds.js

@@ -0,0 +1,66 @@
+// Task-kind registry tools (get_task_kind_registry, get_task_kind).
+// Go parity: mcp-server/internal/domains/workflows/task_registry.go.
+//
+// Both tools read the same registry via TaskKindRegistryQueryController;
+// get_task_kind fetches the full registry then selects one descriptor by name
+// (case-insensitive), exactly as the Go server does — there is no single-kind
+// RPC.
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { GetTaskKindRegistryResponseSchema, TaskKindDescriptorSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/task_kind_descriptor_pb";
+import { TaskKindRegistryQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/task_kind_registry_query_pb";
+import { z } from "zod";
+import { resolveToken, withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+import { textOrError } from "../toolresult.js";
+/** Register the task-kind registry tools; returns the registered tool names. */
+export function registerTaskKindTools(server, target) {
+    server.registerTool("get_task_kind_registry", {
+        description: "Get the complete workflow task kind registry with all 20 task kind descriptors, field schemas, JSON Schemas, categories, examples, and output shapes.",
+        inputSchema: {},
+    }, (_args, extra) => textOrError(() => getTaskKindRegistry(target.serverAddress, resolveToken(extra, target.apiKey))));
+    server.registerTool("get_task_kind", {
+        description: "Get a single workflow task kind descriptor by name with field schemas, JSON Schema, examples, and output shape.",
+        inputSchema: {
+            kind: z
+                .string()
+                .describe("Task kind name (one of: set_vars, http_call, grpc_call, activity_call, switch_case, for_each, fork, try_catch, listen, wait, raise_error, run_workflow, agent_call, llm_call, transform, human_input, validate, emit_event, notification, eval)."),
+        },
+    }, (args, extra) => textOrError(() => getTaskKind(target.serverAddress, resolveToken(extra, target.apiKey), args.kind)));
+    return ["get_task_kind_registry", "get_task_kind"];
+}
+/** Fetch and marshal the full task-kind registry. */
+async function getTaskKindRegistry(serverAddress, token) {
+    return withClient(TaskKindRegistryQueryController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const resp = await client.getTaskKindRegistry({}, callOptions);
+            return toProtoJson(GetTaskKindRegistryResponseSchema, resp);
+        }
+        catch (err) {
+            throw rpcError(err, "task kind registry");
+        }
+    });
+}
+/** Fetch the registry and return the single descriptor matching `kind`. */
+async function getTaskKind(serverAddress, token, kind) {
+    if (kind === "") {
+        throw new Error("kind is required");
+    }
+    return withClient(TaskKindRegistryQueryController, serverAddress, token, async (client, callOptions) => {
+        let resp;
+        try {
+            resp = await client.getTaskKindRegistry({}, callOptions);
+        }
+        catch (err) {
+            throw rpcError(err, "task kind registry");
+        }
+        const normalized = kind.trim().toLowerCase();
+        for (const desc of resp.descriptors) {
+            if ((WorkflowTaskKind[desc.kind] ?? "").toLowerCase() === normalized) {
+                return toProtoJson(TaskKindDescriptorSchema, desc);
+            }
+        }
+        throw new Error(`task kind "${kind}" not found in registry; use get_task_kind_registry to see all available kinds`);
+    });
+}
+//# sourceMappingURL=taskkinds.js.map

package/domains/workflows/taskkinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskkinds.js","sourceRoot":"","sources":["../../../src/domains/workflows/taskkinds.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,qEAAqE;AACrE,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO;AAGP,OAAO,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAC1F,OAAO,EACL,iCAAiC,EACjC,wBAAwB,GACzB,MAAM,wEAAwE,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,4EAA4E,CAAC;AAC7H,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAqB;IAC5E,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,uJAAuJ;QACzJ,WAAW,EAAE,EAAE;KAChB,EACD,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACf,WAAW,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CACnG,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,iHAAiH;QACnH,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,kPAAkP,CACnP;SACJ;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CACjF,CACJ,CAAC;IAEF,OAAO,CAAC,wBAAwB,EAAE,eAAe,CAAC,CAAC;AACrD,CAAC;AAED,qDAAqD;AACrD,KAAK,UAAU,mBAAmB,CAAC,aAAqB,EAAE,KAAa;IACrE,OAAO,UAAU,CACf,+BAA+B,EAC/B,aAAa,EACb,KAAK,EACL,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAC/D,OAAO,WAAW,CAAC,iCAAiC,EAAE,IAAI,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,WAAW,CAAC,aAAqB,EAAE,KAAa,EAAE,IAAY;IAC3E,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,UAAU,CACf,+BAA+B,EAC/B,aAAa,EACb,KAAK,EACL,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC5B,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;gBACrE,OAAO,WAAW,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,gFAAgF,CACnG,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/domains/workflows/tools.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "../client.js";
+/** Register the Workflow CRUD tools; returns the registered tool names. */
+export declare function registerWorkflowTools(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=tools.d.ts.map