@stigmer/mcp-server 3.0.8-dev.20260612122433

package/domains/mcpservers/delete.js

@@ -0,0 +1,42 @@
+// MCP server delete path: resolve org/slug → id, then delete, both over a single
+// shared transport.
+// Go parity: mcp-server/internal/domains/mcpservers/delete.go.
+//
+// Outlier: unlike the agent/skill/workflow command controllers (which take a
+// typed {X}Id), McpServerCommandController.delete takes the generic
+// ApiResourceDeleteInput{resource_id}.
+import { createClient } from "@connectrpc/connect";
+import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { McpServerCommandController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/command_pb";
+import { McpServerQueryController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/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 an MCP server by org and slug, returning the deleted MCP server as
+ * protojson.
+ */
+export async function deleteMcpServer(serverAddress, token, org, slug) {
+    const desc = `MCP server "${slug}" in org "${org}"`;
+    return withTransport(serverAddress, token, async (transport, callOptions) => {
+        const query = createClient(McpServerQueryController, transport);
+        let id;
+        try {
+            const mcpServer = await query.getByReference({ org, kind: ApiResourceKind.mcp_server, slug }, callOptions);
+            id = mcpServer.metadata?.id ?? "";
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+        const command = createClient(McpServerCommandController, transport);
+        try {
+            const deleted = await command.delete({ resourceId: id }, callOptions);
+            return toProtoJson(McpServerSchema, deleted);
+        }
+        catch (err) {
+            throw rpcError(err, desc);
+        }
+    });
+}
+//# sourceMappingURL=delete.js.map

package/domains/mcpservers/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/domains/mcpservers/delete.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oBAAoB;AACpB,+DAA+D;AAC/D,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,uCAAuC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACpG,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,eAAe,CACnC,aAAqB,EACrB,KAAa,EACb,GAAW,EACX,IAAY;IAEZ,MAAM,IAAI,GAAG,eAAe,IAAI,aAAa,GAAG,GAAG,CAAC;IACpD,OAAO,aAAa,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE;QAC1E,MAAM,KAAK,GAAG,YAAY,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,cAAc,CAC1C,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,EAC/C,WAAW,CACZ,CAAC;YACF,EAAE,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YACtE,OAAO,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC/C,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/mcpservers/fetch.d.ts

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

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

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

package/domains/mcpservers/fetch.js

@@ -0,0 +1,26 @@
+// MCP server read path: the single RPC both the get_mcp_server tool and the
+// mcp-server resource template delegate to.
+// Go parity: mcp-server/internal/domains/mcpservers/fetch.go.
+import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { McpServerQueryController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/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 an MCP server by org and slug, returning its protojson
+ * representation. Errors are classified into user-facing messages via
+ * {@link rpcError}.
+ */
+export async function fetchMcpServer(serverAddress, token, org, slug) {
+    return withClient(McpServerQueryController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const mcpServer = await client.getByReference({ org, kind: ApiResourceKind.mcp_server, slug }, callOptions);
+            return toProtoJson(McpServerSchema, mcpServer);
+        }
+        catch (err) {
+            throw rpcError(err, `MCP server "${slug}" in org "${org}"`);
+        }
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/domains/mcpservers/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/domains/mcpservers/fetch.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4CAA4C;AAC5C,8DAA8D;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACpG,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;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,aAAqB,EACrB,KAAa,EACb,GAAW,EACX,IAAY;IAEZ,OAAO,UAAU,CAAC,wBAAwB,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC9F,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,cAAc,CAC3C,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,EAC/C,WAAW,CACZ,CAAC;YACF,OAAO,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,GAAG,EAAE,eAAe,IAAI,aAAa,GAAG,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/domains/mcpservers/resources.d.ts

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

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

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

package/domains/mcpservers/resources.js

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

package/domains/mcpservers/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/domains/mcpservers/resources.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,kEAAkE;AAKlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,wFAAwF;AACxF,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,MAAqB;IACjF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE;QAC/B,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,+EAA+E;QAC5F,QAAQ,EAAE,oCAAoC;QAC9C,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IACH,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAChC,CAAC"}

package/domains/mcpservers/tools.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/mcpservers/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAMhE,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAwDzF"}

package/domains/mcpservers/tools.js

@@ -0,0 +1,39 @@
+// MCP tools for the McpServer domain.
+// Go parity: mcp-server/internal/domains/mcpservers/tools.go.
+//
+// Tool name, description, and per-field input descriptions are part of the
+// parity contract (clients surface them to the model verbatim).
+import { z } from "zod";
+import { McpServerInputShape } from "../../gen/mcpserver.js";
+import { resolveToken } from "../client.js";
+import { textOrError } from "../toolresult.js";
+import { applyMcpServer } from "./apply.js";
+import { deleteMcpServer } from "./delete.js";
+import { fetchMcpServer } from "./fetch.js";
+/** Register every McpServer-domain tool; returns the registered tool names. */
+export function registerMcpServerTools(server, target) {
+    server.registerTool("get_mcp_server", {
+        description: "Get full details of a Stigmer MCP server by its org and slug (e.g. org=acme slug=my-server).",
+        inputSchema: {
+            org: z.string().describe("Organization slug that owns the MCP server (e.g. acme)."),
+            slug: z
+                .string()
+                .describe("MCP server slug — the unique identifier within the org (e.g. my-server)."),
+        },
+    }, (args, extra) => textOrError(() => fetchMcpServer(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug)));
+    server.registerTool("apply_mcp_server", {
+        description: "Create or update a Stigmer MCP server definition (idempotent). Provide identity fields (name, org) and server configuration (stdio/http, tools, env, etc.).",
+        inputSchema: McpServerInputShape,
+    }, (args, extra) => textOrError(() => applyMcpServer(target.serverAddress, resolveToken(extra, target.apiKey), args)));
+    server.registerTool("delete_mcp_server", {
+        description: "Delete a Stigmer MCP server definition by its org and slug. Returns the deleted MCP server.",
+        inputSchema: {
+            org: z.string().describe("Organization slug that owns the MCP server (e.g. acme)."),
+            slug: z
+                .string()
+                .describe("MCP server slug — the unique identifier within the org (e.g. github)."),
+        },
+    }, (args, extra) => textOrError(() => deleteMcpServer(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug)));
+    return ["get_mcp_server", "apply_mcp_server", "delete_mcp_server"];
+}
+//# sourceMappingURL=tools.js.map

package/domains/mcpservers/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/mcpservers/tools.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,8DAA8D;AAC9D,EAAE;AACF,2EAA2E;AAC3E,gEAAgE;AAGhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAqB;IAC7E,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,8FAA8F;QAChG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YACnF,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,0EAA0E,CAAC;SACxF;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAC9F,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,6JAA6J;QAC/J,WAAW,EAAE,mBAAmB;KACjC,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAC/E,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,6FAA6F;QAC/F,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YACnF,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,uEAAuE,CAAC;SACrF;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,eAAe,CACb,MAAM,CAAC,aAAa,EACpB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAClC,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,IAAI,CACV,CACF,CACJ,CAAC;IAEF,OAAO,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;AACrE,CAAC"}

package/domains/resourcehandler.d.ts

@@ -0,0 +1,27 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "./client.js";
+/** Domain read used by a non-versioned resource template. */
+export type ResourceFetch = (serverAddress: string, token: string, org: string, slug: string) => Promise<string>;
+/** Domain read used by a versioned resource template ("" version means latest). */
+export type VersionedResourceFetch = (serverAddress: string, token: string, org: string, slug: string, version: string) => Promise<string>;
+/** Options shared by both registration helpers. */
+interface ResourceOptions {
+    /** Stable resource name surfaced in resources/templates/list (e.g. stigmer_agent). */
+    readonly name: string;
+    /** Human title surfaced to clients (e.g. "Stigmer Agent"). */
+    readonly title: string;
+    /** Human description surfaced to clients. */
+    readonly description: string;
+    /** RFC-6570 URI template, e.g. stigmer://agents/{org}/{slug}. */
+    readonly template: string;
+}
+/** Register a stigmer://{authority}/{org}/{slug} resource template. */
+export declare function registerResource(server: McpServer, target: BackendTarget, opts: ResourceOptions & {
+    readonly fetch: ResourceFetch;
+}): void;
+/** Register a stigmer://{authority}/{org}/{slug}[/{version}] resource template. */
+export declare function registerVersionedResource(server: McpServer, target: BackendTarget, opts: ResourceOptions & {
+    readonly fetch: VersionedResourceFetch;
+}): void;
+export {};
+//# sourceMappingURL=resourcehandler.d.ts.map

package/domains/resourcehandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourcehandler.d.ts","sourceRoot":"","sources":["../../src/domains/resourcehandler.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAGtF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/D,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,CAC1B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,mFAAmF;AACnF,MAAM,MAAM,sBAAsB,GAAG,CACnC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,mDAAmD;AACnD,UAAU,eAAe;IACvB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACxD,IAAI,CAWN;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GACjE,IAAI,CAiBN"}

package/domains/resourcehandler.js

@@ -0,0 +1,32 @@
+// Registration helpers for MCP resource templates.
+// Go parity: mcp-server/internal/domains/resourcehandler.go.
+//
+// Every Stigmer resource template resolves the per-request credential the same
+// way tools do (resolveToken over extra.authInfo), parses org/slug[/version]
+// from the request URI, delegates to the domain fetch, and returns a single
+// application/json content entry. These helpers keep each domain's resources.ts
+// a one-liner and ensure the auth + result shape stay identical across domains.
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { resolveToken } from "./client.js";
+import { parseResourceURI, parseVersionedResourceURI } from "./resourceuri.js";
+/** Register a stigmer://{authority}/{org}/{slug} resource template. */
+export function registerResource(server, target, opts) {
+    server.registerResource(opts.name, new ResourceTemplate(opts.template, { list: undefined }), { title: opts.title, description: opts.description, mimeType: "application/json" }, async (uri, _vars, extra) => {
+        const { org, slug } = parseResourceURI(uri.href);
+        const text = await opts.fetch(target.serverAddress, resolveToken(extra, target.apiKey), org, slug);
+        return jsonResource(uri.href, text);
+    });
+}
+/** Register a stigmer://{authority}/{org}/{slug}[/{version}] resource template. */
+export function registerVersionedResource(server, target, opts) {
+    server.registerResource(opts.name, new ResourceTemplate(opts.template, { list: undefined }), { title: opts.title, description: opts.description, mimeType: "application/json" }, async (uri, _vars, extra) => {
+        const { org, slug, version } = parseVersionedResourceURI(uri.href);
+        const text = await opts.fetch(target.serverAddress, resolveToken(extra, target.apiKey), org, slug, version);
+        return jsonResource(uri.href, text);
+    });
+}
+/** Wrap fetched JSON text into the single-entry ReadResourceResult tools expect. */
+function jsonResource(uri, text) {
+    return { contents: [{ uri, mimeType: "application/json", text }] };
+}
+//# sourceMappingURL=resourcehandler.js.map

package/domains/resourcehandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourcehandler.js","sourceRoot":"","sources":["../../src/domains/resourcehandler.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,6DAA6D;AAC7D,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAEhF,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGtF,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AA+B/E,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,MAAqB,EACrB,IAAyD;IAEzD,MAAM,CAAC,gBAAgB,CACrB,IAAI,CAAC,IAAI,EACT,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACxD,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAClF,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACnG,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAqB,EACrB,IAAkE;IAElE,MAAM,CAAC,gBAAgB,CACrB,IAAI,CAAC,IAAI,EACT,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACxD,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAClF,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAC3B,MAAM,CAAC,aAAa,EACpB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAClC,GAAG,EACH,IAAI,EACJ,OAAO,CACR,CAAC;QACF,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,SAAS,YAAY,CAAC,GAAW,EAAE,IAAY;IAC7C,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/domains/resourceuri.d.ts

@@ -0,0 +1,34 @@
+/** The org and slug extracted from a two-segment resource URI. */
+export interface ResourceRef {
+    readonly org: string;
+    readonly slug: string;
+}
+/** A resource ref that may also carry an explicit version ("" means latest). */
+export interface VersionedResourceRef extends ResourceRef {
+    readonly version: string;
+}
+/**
+ * Extract org and slug from a stigmer://{authority}/{org}/{slug} URI.
+ * Throws when the scheme is not "stigmer" or the path is not exactly two
+ * non-empty segments.
+ */
+export declare function parseResourceURI(uri: string): ResourceRef;
+/**
+ * Extract org, slug, and optional version from a resource URI. Two path
+ * segments yield version "" (latest); three yield an explicit, non-empty
+ * version. Any other shape throws.
+ */
+export declare function parseVersionedResourceURI(uri: string): VersionedResourceRef;
+/**
+ * Map a singular kind name (as it appears in the ApiResourceKind proto enum) to
+ * the plural authority used in stigmer:// URIs. Only kinds that have a
+ * registered MCP resource template appear here.
+ */
+export declare const kindToAuthority: Readonly<Record<string, string>>;
+/**
+ * Construct a stigmer:// URI from a kind, org, and slug — the inverse of
+ * {@link parseResourceURI}. Returns "" when the kind has no registered template
+ * or org/slug are empty, mirroring the Go server's enrichment fallback.
+ */
+export declare function buildResourceURI(kind: string, org: string, slug: string): string;
+//# sourceMappingURL=resourceuri.d.ts.map

package/domains/resourceuri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceuri.d.ts","sourceRoot":"","sources":["../../src/domains/resourceuri.ts"],"names":[],"mappings":"AASA,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAazD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CA6B3E;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK5D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhF"}

package/domains/resourceuri.js

@@ -0,0 +1,100 @@
+// Parsing and construction of stigmer:// resource URIs.
+// Go parity: mcp-server/internal/domains/resourceuri.go.
+//
+// A resource URI has the form stigmer://{authority}/{org}/{slug}[/{version}].
+// The authority (e.g. "agents") is the URL host and encodes the kind; org/slug
+// (and optional version) are the path segments. Parsing deliberately validates
+// only the scheme and the path-segment count/shape — the authority is not
+// checked here, exactly as the Go server behaves.
+/**
+ * Extract org and slug from a stigmer://{authority}/{org}/{slug} URI.
+ * Throws when the scheme is not "stigmer" or the path is not exactly two
+ * non-empty segments.
+ */
+export function parseResourceURI(uri) {
+    const segments = pathSegments(uri);
+    if (segments.length !== 2) {
+        throw new Error(`expected URI path with 2 segments (org/slug), got ${segments.length} in "${uri}"`);
+    }
+    const org = segments[0] ?? "";
+    const slug = segments[1] ?? "";
+    if (org === "" || slug === "") {
+        throw new Error(`org and slug must be non-empty in "${uri}"`);
+    }
+    return { org, slug };
+}
+/**
+ * Extract org, slug, and optional version from a resource URI. Two path
+ * segments yield version "" (latest); three yield an explicit, non-empty
+ * version. Any other shape throws.
+ */
+export function parseVersionedResourceURI(uri) {
+    const segments = pathSegments(uri);
+    let org = "";
+    let slug = "";
+    let version = "";
+    switch (segments.length) {
+        case 2:
+            org = segments[0] ?? "";
+            slug = segments[1] ?? "";
+            break;
+        case 3:
+            org = segments[0] ?? "";
+            slug = segments[1] ?? "";
+            version = segments[2] ?? "";
+            if (version === "") {
+                throw new Error(`version segment must be non-empty in "${uri}"`);
+            }
+            break;
+        default:
+            throw new Error(`expected URI path with 2 or 3 segments (org/slug[/version]), got ${segments.length} in "${uri}"`);
+    }
+    if (org === "" || slug === "") {
+        throw new Error(`org and slug must be non-empty in "${uri}"`);
+    }
+    return { org, slug, version };
+}
+/**
+ * Map a singular kind name (as it appears in the ApiResourceKind proto enum) to
+ * the plural authority used in stigmer:// URIs. Only kinds that have a
+ * registered MCP resource template appear here.
+ */
+export const kindToAuthority = {
+    agent: "agents",
+    mcp_server: "mcp-servers",
+    skill: "skills",
+    workflow: "workflows",
+};
+/**
+ * Construct a stigmer:// URI from a kind, org, and slug — the inverse of
+ * {@link parseResourceURI}. Returns "" when the kind has no registered template
+ * or org/slug are empty, mirroring the Go server's enrichment fallback.
+ */
+export function buildResourceURI(kind, org, slug) {
+    const authority = kindToAuthority[kind];
+    if (authority === undefined || org === "" || slug === "") {
+        return "";
+    }
+    return `stigmer://${authority}/${org}/${slug}`;
+}
+/**
+ * Parse the URI, assert the scheme, and return its path split into segments.
+ * The double-slash authority (the kind) is intentionally discarded; only the
+ * path carries org/slug[/version]. Interior empty segments are preserved so the
+ * count matches Go's strings.Split semantics.
+ */
+function pathSegments(uri) {
+    let parsed;
+    try {
+        parsed = new URL(uri);
+    }
+    catch (err) {
+        throw new Error(`malformed resource URI "${uri}": ${err instanceof Error ? err.message : err}`);
+    }
+    if (parsed.protocol !== "stigmer:") {
+        throw new Error(`unexpected URI scheme "${parsed.protocol.replace(/:$/, "")}", expected "stigmer"`);
+    }
+    const trimmed = parsed.pathname.replace(/^\/+/, "").replace(/\/+$/, "");
+    return trimmed === "" ? [] : trimmed.split("/");
+}
+//# sourceMappingURL=resourceuri.js.map

package/domains/resourceuri.js.map

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

package/domains/rpcerr.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Translate a Connect/gRPC error into a user-friendly Error.
+ *
+ * `resourceDescription` identifies what was being accessed, e.g.
+ * `agent "code-reviewer" in org "stigmer"`.
+ */
+export declare function rpcError(err: unknown, resourceDescription: string): Error;
+//# sourceMappingURL=rpcerr.d.ts.map

package/domains/rpcerr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcerr.d.ts","sourceRoot":"","sources":["../../src/domains/rpcerr.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,GAAG,KAAK,CAUzE"}

package/domains/rpcerr.js

@@ -0,0 +1,42 @@
+// Translation of transport/RPC failures into user-facing tool errors.
+//
+// Parity contract (mirrors Go internal/domains/rpcerr.go): the original error is
+// logged at WARN for operator debugging; only the classified, user-friendly
+// message is returned to the AI client. Message text is kept verbatim so the
+// TS and Go servers are indistinguishable to clients.
+import { Code, ConnectError } from "@connectrpc/connect";
+import { log } from "../logger.js";
+/**
+ * Translate a Connect/gRPC error into a user-friendly Error.
+ *
+ * `resourceDescription` identifies what was being accessed, e.g.
+ * `agent "code-reviewer" in org "stigmer"`.
+ */
+export function rpcError(err, resourceDescription) {
+    const ce = ConnectError.from(err);
+    log.warn("rpc call failed", {
+        resource: resourceDescription,
+        code: Code[ce.code],
+        grpc_message: ce.rawMessage,
+    });
+    return new Error(classifyCode(ce, resourceDescription));
+}
+function classifyCode(ce, resourceDescription) {
+    switch (ce.code) {
+        case Code.NotFound:
+            return `${resourceDescription} not found. Verify the org and slug are correct.`;
+        case Code.PermissionDenied:
+            return `Permission denied for ${resourceDescription}. Check your API key permissions.`;
+        case Code.Unauthenticated:
+            return "Authentication failed. Check your API key.";
+        case Code.Unavailable:
+            return "Stigmer server is unavailable. Ensure it is running and reachable.";
+        case Code.DeadlineExceeded:
+            return "Request timed out contacting stigmer-server.";
+        case Code.InvalidArgument:
+            return ce.rawMessage;
+        default:
+            return `unexpected error: ${ce.rawMessage}`;
+    }
+}
+//# sourceMappingURL=rpcerr.js.map

package/domains/rpcerr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcerr.js","sourceRoot":"","sources":["../../src/domains/rpcerr.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,iFAAiF;AACjF,4EAA4E;AAC5E,6EAA6E;AAC7E,sDAAsD;AAEtD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,mBAA2B;IAChE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAElC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QACnB,YAAY,EAAE,EAAE,CAAC,UAAU;KAC5B,CAAC,CAAC;IAEH,OAAO,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,EAAgB,EAAE,mBAA2B;IACjE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,QAAQ;YAChB,OAAO,GAAG,mBAAmB,kDAAkD,CAAC;QAClF,KAAK,IAAI,CAAC,gBAAgB;YACxB,OAAO,yBAAyB,mBAAmB,mCAAmC,CAAC;QACzF,KAAK,IAAI,CAAC,eAAe;YACvB,OAAO,4CAA4C,CAAC;QACtD,KAAK,IAAI,CAAC,WAAW;YACnB,OAAO,oEAAoE,CAAC;QAC9E,KAAK,IAAI,CAAC,gBAAgB;YACxB,OAAO,8CAA8C,CAAC;QACxD,KAAK,IAAI,CAAC,eAAe;YACvB,OAAO,EAAE,CAAC,UAAU,CAAC;QACvB;YACE,OAAO,qBAAqB,EAAE,CAAC,UAAU,EAAE,CAAC;IAChD,CAAC;AACH,CAAC"}

package/domains/search/tools.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/search/tools.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AA2B5E,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA2CtF"}

package/domains/search/tools.js

@@ -0,0 +1,125 @@
+// The "search" MCP tool, backed by SearchService.search.
+// Go parity: mcp-server/internal/domains/search/tools.go.
+//
+// One tool covers listing, full-text search, and cross-kind discovery (replacing
+// per-kind list_* tools); the combination of parameters selects the behavior.
+// Each result entry is enriched with a resource_uri that clients can hand
+// straight to resources/read, bridging discovery to read.
+import { toJson } from "@bufbuild/protobuf";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { SearchResponseSchema, } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { SearchService } from "@stigmer/protos/ai/stigmer/search/v1/query_pb";
+import { z } from "zod";
+import { resolveToken, withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { buildResourceURI } from "../resourceuri.js";
+import { rpcError } from "../rpcerr.js";
+import { textOrError } from "../toolresult.js";
+/**
+ * The searchable kinds and their proto enum values. This is deliberately the
+ * four searchable kinds (not every ApiResourceKind), mirroring the Go server's
+ * `knownKinds` map and its validation surface.
+ */
+const knownKinds = {
+    agent: ApiResourceKind.agent,
+    skill: ApiResourceKind.skill,
+    mcp_server: ApiResourceKind.mcp_server,
+    workflow: ApiResourceKind.workflow,
+};
+/** Register the search tool; returns the registered tool names. */
+export function registerSearchTools(server, target) {
+    server.registerTool("search", {
+        description: "Search and list Stigmer resources (agents, skills, MCP servers, workflows). " +
+            "Set 'kinds' to filter by resource type. Set 'query' for full-text search. " +
+            "Set 'org' to scope to an organization. Omit 'query' to list all accessible resources.",
+        inputSchema: {
+            kinds: z
+                .array(z.string())
+                .optional()
+                .describe("Resource kinds to search. Valid: agent, skill, mcp_server, workflow. Empty searches all."),
+            query: z
+                .string()
+                .optional()
+                .describe("Full-text search query. Empty lists all accessible resources."),
+            org: z
+                .string()
+                .optional()
+                .describe("Organization slug to scope the search. Empty searches all accessible orgs."),
+            exclude_public: z
+                .boolean()
+                .optional()
+                .describe("Exclude public/platform resources from results."),
+            page_size: z.number().int().optional().describe("Results per page (default 20, max 100)."),
+            page_num: z.number().int().optional().describe("Page number (1-indexed, default 1)."),
+        },
+    }, (args, extra) => textOrError(() => search(target.serverAddress, resolveToken(extra, target.apiKey), {
+        kinds: args.kinds,
+        query: args.query,
+        org: args.org,
+        excludePublic: args.exclude_public,
+        pageSize: args.page_size,
+        pageNum: args.page_num,
+    })));
+    return ["search"];
+}
+/** Run the search RPC and return the enriched protojson result. */
+async function search(serverAddress, token, args) {
+    const kinds = parseKinds(args.kinds);
+    return withClient(SearchService, serverAddress, token, async (client, callOptions) => {
+        const req = {
+            kinds,
+            query: args.query ?? "",
+            org: args.org ?? "",
+            excludePublic: args.excludePublic ?? false,
+        };
+        // Attach pagination only when explicitly requested, letting the server apply
+        // its own defaults otherwise (Go does the same).
+        if ((args.pageSize ?? 0) > 0 || (args.pageNum ?? 0) > 0) {
+            req.page = { size: args.pageSize ?? 0, num: args.pageNum ?? 0 };
+        }
+        let resp;
+        try {
+            resp = await client.search(req, callOptions);
+        }
+        catch (err) {
+            throw rpcError(err, args.org ? `search results in org "${args.org}"` : "search results");
+        }
+        return enrichSearchResponse(resp);
+    });
+}
+/** Convert user-supplied kind strings to proto enum values, rejecting unknowns. */
+function parseKinds(raw) {
+    if (!raw || raw.length === 0) {
+        return [];
+    }
+    return raw.map((s) => {
+        const kind = knownKinds[s];
+        if (kind === undefined) {
+            throw new Error(`unknown resource kind "${s}"; valid kinds: agent, skill, mcp_server, workflow`);
+        }
+        return kind;
+    });
+}
+/**
+ * Serialize the response and inject a resource_uri into each entry whose kind
+ * has a registered resource template. Empty responses short-circuit to the plain
+ * marshal to avoid the walk.
+ */
+function enrichSearchResponse(resp) {
+    if (resp.entries.length === 0) {
+        return toProtoJson(SearchResponseSchema, resp);
+    }
+    const data = toJson(SearchResponseSchema, resp, { useProtoFieldName: true });
+    const entries = Array.isArray(data.entries)
+        ? data.entries
+        : [];
+    for (let i = 0; i < entries.length && i < resp.entries.length; i++) {
+        const r = resp.entries[i];
+        const uri = buildResourceURI(ApiResourceKind[r.kind] ?? "", r.org, r.slug);
+        if (uri !== "") {
+            entries[i].resource_uri = uri;
+        }
+    }
+    return JSON.stringify(data, null, 2);
+}
+//# sourceMappingURL=tools.js.map

package/domains/search/tools.js.map

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

package/domains/skills/delete.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/delete.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAoBjB"}