@stigmer/mcp-server 3.0.8-dev.20260612122433

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAMhE,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkDxF"}

package/domains/workflows/tools.js

@@ -0,0 +1,35 @@
+// MCP tools for the Workflow domain (CRUD: get, apply, delete).
+// Go parity: mcp-server/internal/domains/workflows/tools.go.
+//
+// The workflow-specific tools (validate_workflow_yaml, task-kind registry) live
+// in sibling files.
+import { z } from "zod";
+import { WorkflowInputShape } from "../../gen/workflow.js";
+import { resolveToken } from "../client.js";
+import { textOrError } from "../toolresult.js";
+import { applyWorkflow } from "./apply.js";
+import { deleteWorkflow } from "./delete.js";
+import { fetchWorkflow } from "./fetch.js";
+/** Register the Workflow CRUD tools; returns the registered tool names. */
+export function registerWorkflowTools(server, target) {
+    server.registerTool("get_workflow", {
+        description: "Get full details of a Stigmer workflow by its org and slug.",
+        inputSchema: {
+            org: z.string().describe("Organization slug that owns the workflow."),
+            slug: z.string().describe("Workflow slug — unique identifier within the org."),
+        },
+    }, (args, extra) => textOrError(() => fetchWorkflow(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug)));
+    server.registerTool("apply_workflow", {
+        description: "Create or update a Stigmer workflow (idempotent). Provide identity fields (name, org) and workflow configuration (document, tasks, env, etc.).",
+        inputSchema: WorkflowInputShape,
+    }, (args, extra) => textOrError(() => applyWorkflow(target.serverAddress, resolveToken(extra, target.apiKey), args)));
+    server.registerTool("delete_workflow", {
+        description: "Delete a Stigmer workflow by its org and slug. Returns the deleted workflow.",
+        inputSchema: {
+            org: z.string().describe("Organization slug that owns the workflow."),
+            slug: z.string().describe("Workflow slug — unique identifier within the org."),
+        },
+    }, (args, extra) => textOrError(() => deleteWorkflow(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug)));
+    return ["get_workflow", "apply_workflow", "delete_workflow"];
+}
+//# sourceMappingURL=tools.js.map

package/domains/workflows/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/workflows/tools.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,6DAA6D;AAC7D,EAAE;AACF,gFAAgF;AAChF,oBAAoB;AAGpB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAqB;IAC5E,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EAAE,6DAA6D;QAC1E,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SAC/E;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,aAAa,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAC7F,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,gJAAgJ;QAClJ,WAAW,EAAE,kBAAkB;KAChC,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,aAAa,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAC9E,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SAC/E;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,WAAW,CAAC,GAAG,EAAE,CACf,cAAc,CACZ,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,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAC/D,CAAC"}

package/domains/workflows/validate.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/domains/workflows/validate.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAgB5E,mFAAmF;AACnF,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,GACpB,MAAM,EAAE,CAuBV"}

package/domains/workflows/validate.js

@@ -0,0 +1,113 @@
+// The validate_workflow_yaml tool.
+// Go parity: mcp-server/internal/domains/workflows/validate.go.
+//
+// The YAML is parsed to a Workflow proto locally (string task kinds are checked
+// against the accepted set), then validated server-side via
+// WorkflowCommandController.validateSpec — the same Temporal-based pipeline used
+// by workflow create/update.
+//
+// Parity note (Go D4): the Go server's taskKindNameToEnum map is an identity map
+// that omits `eval`, so Go rejects valid `eval` tasks. We derive the accepted
+// set directly from the WorkflowTaskKind enum's value names instead — identical
+// behavior for the other 19 kinds AND correct for `eval`. Flagged for the Go
+// side as a T03 follow-up.
+import { fromJson } from "@bufbuild/protobuf";
+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 { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { ServerlessWorkflowValidationSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/serverless/validation_pb";
+import { z } from "zod";
+import { parse as parseYaml } from "yaml";
+import { resolveToken, withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+import { rpcError } from "../rpcerr.js";
+import { textOrError } from "../toolresult.js";
+/**
+ * The task kinds the YAML may declare, derived from the proto enum (every value
+ * except the unspecified zero value). Deriving from the enum keeps this in lock
+ * step with the contract and avoids a hand-maintained list.
+ */
+const acceptedTaskKinds = new Set(Object.values(WorkflowTaskKind).filter((v) => typeof v === "string" && v !== "workflow_task_kind_unspecified"));
+/** Register the validate_workflow_yaml tool; returns the registered tool names. */
+export function registerValidateWorkflowYamlTool(server, target) {
+    server.registerTool("validate_workflow_yaml", {
+        description: "Validate a Stigmer workflow YAML for structural and semantic correctness. " +
+            "Uses the same Temporal-based validation pipeline as workflow create/update. " +
+            "Returns validation state (VALID/INVALID/FAILED), errors, warnings, and the generated internal YAML.",
+        inputSchema: {
+            yaml: z
+                .string()
+                .describe("Complete Stigmer workflow YAML content to validate (apiVersion, kind, metadata, spec)."),
+        },
+    }, (args, extra) => textOrError(() => validateWorkflowYaml(target.serverAddress, resolveToken(extra, target.apiKey), args.yaml)));
+    return ["validate_workflow_yaml"];
+}
+/** Parse the YAML to a Workflow proto, then validate it server-side. */
+async function validateWorkflowYaml(serverAddress, token, yamlContent) {
+    if (yamlContent.trim() === "") {
+        throw new Error("yaml is required");
+    }
+    let workflow;
+    try {
+        workflow = parseWorkflowYaml(yamlContent);
+    }
+    catch (err) {
+        throw new Error(`failed to parse workflow YAML: ${errMessage(err)}`);
+    }
+    return withClient(WorkflowCommandController, serverAddress, token, async (client, callOptions) => {
+        try {
+            const validation = await client.validateSpec(workflow, callOptions);
+            return toProtoJson(ServerlessWorkflowValidationSchema, validation);
+        }
+        catch (err) {
+            throw rpcError(err, "workflow validation");
+        }
+    });
+}
+/**
+ * Convert a Stigmer workflow YAML string to a Workflow proto. The YAML has an
+ * apiVersion/kind/metadata/spec shape; task kinds are validated against the
+ * accepted set. task_config is a google.protobuf.Struct and round-trips through
+ * JSON naturally.
+ */
+function parseWorkflowYaml(yamlContent) {
+    let raw;
+    try {
+        raw = parseYaml(yamlContent);
+    }
+    catch (err) {
+        throw new Error(`invalid YAML syntax: ${errMessage(err)}`);
+    }
+    if (!isObject(raw)) {
+        throw new Error("missing or invalid 'spec' field");
+    }
+    const spec = raw.spec;
+    if (!isObject(spec)) {
+        throw new Error("missing or invalid 'spec' field");
+    }
+    const tasks = spec.tasks;
+    if (Array.isArray(tasks)) {
+        tasks.forEach((task, i) => {
+            if (!isObject(task)) {
+                return;
+            }
+            const kind = task.kind;
+            if (typeof kind === "string" && kind !== "" && !acceptedTaskKinds.has(kind)) {
+                throw new Error(`unknown task kind "${kind}" at tasks[${i}]`);
+            }
+        });
+    }
+    try {
+        return fromJson(WorkflowSchema, raw, { ignoreUnknownFields: true });
+    }
+    catch (err) {
+        throw new Error(`failed to unmarshal into Workflow proto: ${errMessage(err)}`);
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=validate.js.map

package/domains/workflows/validate.js.map

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

package/gen/agent.d.ts

@@ -0,0 +1,385 @@
+import { type Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import { z } from "zod";
+/** AgentSpec defines the configurable properties of an agent. @internal This is the "Template" layer — declares capabilities and requirements. The overview.md file provides the SDK-facing description and example YAML. */
+export declare const AgentInputShape: {
+    readonly name: z.ZodString;
+    readonly slug: z.ZodOptional<z.ZodString>;
+    readonly org: z.ZodString;
+    readonly visibility: z.ZodOptional<z.ZodString>;
+    readonly labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    readonly tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    readonly description: z.ZodOptional<z.ZodString>;
+    readonly icon_url: z.ZodOptional<z.ZodString>;
+    readonly instructions: z.ZodOptional<z.ZodString>;
+    readonly mcp_server_usages: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        mcp_server_ref: z.ZodLazy<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            slug: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            slug: string;
+            org?: string | undefined;
+        }, {
+            slug: string;
+            org?: string | undefined;
+        }>>;
+        enabled_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tool_approval_overrides: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            tool_name: z.ZodOptional<z.ZodString>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+            message: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }, {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }>>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mcp_server_ref: {
+            slug: string;
+            org?: string | undefined;
+        };
+        enabled_tools?: string[] | undefined;
+        tool_approval_overrides?: {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }[] | undefined;
+    }, {
+        mcp_server_ref: {
+            slug: string;
+            org?: string | undefined;
+        };
+        enabled_tools?: string[] | undefined;
+        tool_approval_overrides?: {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }[] | undefined;
+    }>>, "many">>;
+    readonly skill_refs: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        org: z.ZodOptional<z.ZodString>;
+        slug: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        org?: string | undefined;
+        version?: string | undefined;
+    }, {
+        slug: string;
+        org?: string | undefined;
+        version?: string | undefined;
+    }>>, "many">>;
+    readonly sub_agents: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        mcp_access: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            mcp_server: z.ZodString;
+            enabled_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }, {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }>>, "many">>;
+        skill_refs: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            slug: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }, {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }>>, "many">>;
+        model_override: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+        instructions?: string | undefined;
+        mcp_access?: {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }[] | undefined;
+        skill_refs?: {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }[] | undefined;
+        model_override?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+        instructions?: string | undefined;
+        mcp_access?: {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }[] | undefined;
+        skill_refs?: {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }[] | undefined;
+        model_override?: string | undefined;
+    }>>, "many">>;
+    readonly env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodLazy<z.ZodObject<{
+        is_secret: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        optional?: boolean | undefined;
+        is_secret?: boolean | undefined;
+    }, {
+        description?: string | undefined;
+        optional?: boolean | undefined;
+        is_secret?: boolean | undefined;
+    }>>>>;
+};
+export declare const AgentInputSchema: z.ZodObject<{
+    readonly name: z.ZodString;
+    readonly slug: z.ZodOptional<z.ZodString>;
+    readonly org: z.ZodString;
+    readonly visibility: z.ZodOptional<z.ZodString>;
+    readonly labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    readonly tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    readonly description: z.ZodOptional<z.ZodString>;
+    readonly icon_url: z.ZodOptional<z.ZodString>;
+    readonly instructions: z.ZodOptional<z.ZodString>;
+    readonly mcp_server_usages: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        mcp_server_ref: z.ZodLazy<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            slug: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            slug: string;
+            org?: string | undefined;
+        }, {
+            slug: string;
+            org?: string | undefined;
+        }>>;
+        enabled_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tool_approval_overrides: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            tool_name: z.ZodOptional<z.ZodString>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+            message: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }, {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }>>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mcp_server_ref: {
+            slug: string;
+            org?: string | undefined;
+        };
+        enabled_tools?: string[] | undefined;
+        tool_approval_overrides?: {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }[] | undefined;
+    }, {
+        mcp_server_ref: {
+            slug: string;
+            org?: string | undefined;
+        };
+        enabled_tools?: string[] | undefined;
+        tool_approval_overrides?: {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }[] | undefined;
+    }>>, "many">>;
+    readonly skill_refs: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        org: z.ZodOptional<z.ZodString>;
+        slug: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        org?: string | undefined;
+        version?: string | undefined;
+    }, {
+        slug: string;
+        org?: string | undefined;
+        version?: string | undefined;
+    }>>, "many">>;
+    readonly sub_agents: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        mcp_access: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            mcp_server: z.ZodString;
+            enabled_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }, {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }>>, "many">>;
+        skill_refs: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            slug: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }, {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }>>, "many">>;
+        model_override: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+        instructions?: string | undefined;
+        mcp_access?: {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }[] | undefined;
+        skill_refs?: {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }[] | undefined;
+        model_override?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+        instructions?: string | undefined;
+        mcp_access?: {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }[] | undefined;
+        skill_refs?: {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }[] | undefined;
+        model_override?: string | undefined;
+    }>>, "many">>;
+    readonly env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodLazy<z.ZodObject<{
+        is_secret: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        optional?: boolean | undefined;
+        is_secret?: boolean | undefined;
+    }, {
+        description?: string | undefined;
+        optional?: boolean | undefined;
+        is_secret?: boolean | undefined;
+    }>>>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    org: string;
+    visibility?: string | undefined;
+    slug?: string | undefined;
+    description?: string | undefined;
+    instructions?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tags?: string[] | undefined;
+    env?: Record<string, {
+        description?: string | undefined;
+        optional?: boolean | undefined;
+        is_secret?: boolean | undefined;
+    }> | undefined;
+    skill_refs?: {
+        slug: string;
+        org?: string | undefined;
+        version?: string | undefined;
+    }[] | undefined;
+    icon_url?: string | undefined;
+    mcp_server_usages?: {
+        mcp_server_ref: {
+            slug: string;
+            org?: string | undefined;
+        };
+        enabled_tools?: string[] | undefined;
+        tool_approval_overrides?: {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    sub_agents?: {
+        name: string;
+        description?: string | undefined;
+        instructions?: string | undefined;
+        mcp_access?: {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }[] | undefined;
+        skill_refs?: {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }[] | undefined;
+        model_override?: string | undefined;
+    }[] | undefined;
+}, {
+    name: string;
+    org: string;
+    visibility?: string | undefined;
+    slug?: string | undefined;
+    description?: string | undefined;
+    instructions?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tags?: string[] | undefined;
+    env?: Record<string, {
+        description?: string | undefined;
+        optional?: boolean | undefined;
+        is_secret?: boolean | undefined;
+    }> | undefined;
+    skill_refs?: {
+        slug: string;
+        org?: string | undefined;
+        version?: string | undefined;
+    }[] | undefined;
+    icon_url?: string | undefined;
+    mcp_server_usages?: {
+        mcp_server_ref: {
+            slug: string;
+            org?: string | undefined;
+        };
+        enabled_tools?: string[] | undefined;
+        tool_approval_overrides?: {
+            message?: string | undefined;
+            tool_name?: string | undefined;
+            requires_approval?: boolean | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    sub_agents?: {
+        name: string;
+        description?: string | undefined;
+        instructions?: string | undefined;
+        mcp_access?: {
+            mcp_server: string;
+            enabled_tools?: string[] | undefined;
+        }[] | undefined;
+        skill_refs?: {
+            slug: string;
+            org?: string | undefined;
+            version?: string | undefined;
+        }[] | undefined;
+        model_override?: string | undefined;
+    }[] | undefined;
+}>;
+export type AgentInput = z.infer<typeof AgentInputSchema>;
+/** Build the fully-formed Agent proto from the flat MCP apply input. */
+export declare function agentInputToProto(input: AgentInput): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/gen/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/gen/agent.ts"],"names":[],"mappings":"AAOA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAM7F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6NAA6N;AAC7N,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAclB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA4B,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAqD1D,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAyB1D"}