@stigmer/protos 0.0.34

package/ai/stigmer/agentic/mcpserver/v1/spec_pb.js

@@ -0,0 +1,31 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/mcpserver/v1/spec.proto (package ai.stigmer.agentic.mcpserver.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_environment_v1_spec } from "../../environment/v1/spec_pb";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb";
+/**
+ * Describes the file ai/stigmer/agentic/mcpserver/v1/spec.proto.
+ */
+export const file_ai_stigmer_agentic_mcpserver_v1_spec = /*@__PURE__*/ fileDesc("CiphaS9zdGlnbWVyL2FnZW50aWMvbWNwc2VydmVyL3YxL3NwZWMucHJvdG8SH2FpLnN0aWdtZXIuYWdlbnRpYy5tY3BzZXJ2ZXIudjEinAMKDU1jcFNlcnZlclNwZWMSEwoLZGVzY3JpcHRpb24YASABKAkSEAoIaWNvbl91cmwYAiABKAkSDAoEdGFncxgDIAMoCRJDCgVzdGRpbxgEIAEoCzIyLmFpLnN0aWdtZXIuYWdlbnRpYy5tY3BzZXJ2ZXIudjEuU3RkaW9TZXJ2ZXJDb25maWdIABJBCgRodHRwGAUgASgLMjEuYWkuc3RpZ21lci5hZ2VudGljLm1jcHNlcnZlci52MS5IdHRwU2VydmVyQ29uZmlnSAASHQoVZGVmYXVsdF9lbmFibGVkX3Rvb2xzGAcgAygJEkQKCGVudl9zcGVjGAggASgLMjIuYWkuc3RpZ21lci5hZ2VudGljLmVudmlyb25tZW50LnYxLkVudmlyb25tZW50U3BlYxJTChZkZWZhdWx0X3Rvb2xfYXBwcm92YWxzGAkgAygLMjMuYWkuc3RpZ21lci5hZ2VudGljLm1jcHNlcnZlci52MS5Ub29sQXBwcm92YWxQb2xpY3lCFAoLc2VydmVyX3R5cGUSBbpIAggBIk8KEVN0ZGlvU2VydmVyQ29uZmlnEhcKB2NvbW1hbmQYASABKAlCBrpIA8gBARIMCgRhcmdzGAIgAygJEhMKC3dvcmtpbmdfZGlyGAMgASgJIuACChBIdHRwU2VydmVyQ29uZmlnEhgKA3VybBgBIAEoCUILukgIyAEBcgOIAQESTwoHaGVhZGVycxgCIAMoCzI+LmFpLnN0aWdtZXIuYWdlbnRpYy5tY3BzZXJ2ZXIudjEuSHR0cFNlcnZlckNvbmZpZy5IZWFkZXJzRW50cnkSWAoMcXVlcnlfcGFyYW1zGAMgAygLMkIuYWkuc3RpZ21lci5hZ2VudGljLm1jcHNlcnZlci52MS5IdHRwU2VydmVyQ29uZmlnLlF1ZXJ5UGFyYW1zRW50cnkSIwoPdGltZW91dF9zZWNvbmRzGAQgASgFQgq6SAcaBRisAigAGi4KDEhlYWRlcnNFbnRyeRILCgNrZXkYASABKAkSDQoFdmFsdWUYAiABKAk6AjgBGjIKEFF1ZXJ5UGFyYW1zRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASJBChJUb29sQXBwcm92YWxQb2xpY3kSGgoJdG9vbF9uYW1lGAEgASgJQge6SARyAhABEg8KB21lc3NhZ2UYAiABKAliBnByb3RvMw", [file_ai_stigmer_agentic_environment_v1_spec, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.McpServerSpec.
+ * Use `create(McpServerSpecSchema)` to create a new message.
+ */
+export const McpServerSpecSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_spec, 0);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.StdioServerConfig.
+ * Use `create(StdioServerConfigSchema)` to create a new message.
+ */
+export const StdioServerConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_spec, 1);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.HttpServerConfig.
+ * Use `create(HttpServerConfigSchema)` to create a new message.
+ */
+export const HttpServerConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_spec, 2);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.ToolApprovalPolicy.
+ * Use `create(ToolApprovalPolicySchema)` to create a new message.
+ */
+export const ToolApprovalPolicySchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_spec, 3);
+//# sourceMappingURL=spec_pb.js.map

package/ai/stigmer/agentic/mcpserver/v1/spec_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/mcpserver/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,2HAA2H;AAC3H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,2CAA2C,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAY,aAAa,CAC7E,QAAQ,CAAC,4zCAA4zC,EAAE,CAAC,2CAA2C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA0Ip5C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC;AA6C5D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC;AAqE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC;AAsE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/mcpserver/v1/status_pb.d.ts

@@ -0,0 +1,290 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { ApiResourceAudit } from "../../../commons/apiresource/status_pb";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/mcpserver/v1/status.proto.
+ */
+export declare const file_ai_stigmer_agentic_mcpserver_v1_status: GenFile;
+/**
+ * McpServerStatus represents the system-managed state of an MCP server definition.
+ *
+ * This status tracks two concerns:
+ *
+ * 1. Structural validation — whether the definition is valid and can be used by agents.
+ *
+ * 2. Discovered capabilities — the tools and resource templates the MCP server
+ *    actually provides. Populated by one of three mechanisms:
+ *      a. Static seedpack bootstrap (for built-in servers like stigmer-mcp-server)
+ *      b. CLI discovery: `stigmer discover mcp-server <name>` connects locally,
+ *         queries the running server, and pushes results via updateDiscoveredCapabilities
+ *      c. Agent-runner runtime cache (future)
+ *
+ *    CLI discovery runs on the developer's machine, so credentials (e.g., GITHUB_TOKEN)
+ *    never leave the local environment. The server only receives tool/resource metadata.
+ *
+ * @generated from message ai.stigmer.agentic.mcpserver.v1.McpServerStatus
+ */
+export type McpServerStatus = Message<"ai.stigmer.agentic.mcpserver.v1.McpServerStatus"> & {
+    /**
+     * Validation state of the MCP server definition.
+     * Indicates whether the definition passed structural validation.
+     *
+     * @generated from field: ai.stigmer.agentic.mcpserver.v1.ValidationState validation_state = 1;
+     */
+    validationState: ValidationState;
+    /**
+     * Human-readable validation message.
+     * Populated when validation_state is INVALID to explain what's wrong.
+     * Empty when validation_state is VALID or UNSPECIFIED.
+     * Examples:
+     * - "server_type is required: must specify stdio, http, or docker"
+     * - "http.url is not a valid URL: missing scheme"
+     * - "docker.image is required"
+     *
+     * @generated from field: string validation_message = 2;
+     */
+    validationMessage: string;
+    /**
+     * Tools and resource templates discovered from the MCP server.
+     * Optional — absent until discovery has been performed (or seeded from seedpack).
+     *
+     * @generated from field: ai.stigmer.agentic.mcpserver.v1.DiscoveredCapabilities discovered_capabilities = 3;
+     */
+    discoveredCapabilities?: DiscoveredCapabilities;
+    /**
+     * Standard audit information tracking creation and modification.
+     * Field 99 follows Stigmer convention for audit placement in status messages.
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAudit audit = 99;
+     */
+    audit?: ApiResourceAudit;
+};
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.McpServerStatus.
+ * Use `create(McpServerStatusSchema)` to create a new message.
+ */
+export declare const McpServerStatusSchema: GenMessage<McpServerStatus>;
+/**
+ * DiscoveredCapabilities holds the tools and resource templates reported by an
+ * MCP server. This is a point-in-time snapshot — the server's actual capabilities
+ * may change if tools are added or removed.
+ *
+ * IMPORTANT — Tools vs Resource Templates:
+ * These are two fundamentally different MCP capability types:
+ *
+ *   - tools: Callable actions the agent can invoke (e.g., search_code, create_pr).
+ *     These are the ONLY names valid for use in Agent `enabled_tools`,
+ *     McpServer `default_enabled_tools`, and `tool_approval_overrides`.
+ *
+ *   - resource_templates: Read-only data endpoints accessed by URI template
+ *     (e.g., cloud-resource-schema://{kind}). These are NOT callable tools.
+ *     Resource template names must NEVER appear in `enabled_tools` or
+ *     `default_enabled_tools` — doing so causes a fatal runtime error because
+ *     the agent-runner cannot find them in the tools registry.
+ *
+ * When authoring Agent YAML, always select tool names from `tools` only.
+ * Resource templates serve a different purpose (data discovery) and are
+ * accessed through MCP resource reads, not tool calls.
+ *
+ * Populated by:
+ * - Seedpack bootstrap (built-in servers with known, stable tool sets)
+ * - CLI discovery (`stigmer discover mcp-server <name>`)
+ * - Agent-runner runtime cache (future)
+ *
+ * @generated from message ai.stigmer.agentic.mcpserver.v1.DiscoveredCapabilities
+ */
+export type DiscoveredCapabilities = Message<"ai.stigmer.agentic.mcpserver.v1.DiscoveredCapabilities"> & {
+    /**
+     * Tools reported by the MCP server via tools/list.
+     * These are callable actions. Only names from this list may be used in
+     * Agent `enabled_tools` and McpServer `default_enabled_tools`.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.mcpserver.v1.DiscoveredTool tools = 1;
+     */
+    tools: DiscoveredTool[];
+    /**
+     * Resource templates reported by the MCP server via resources/templates/list.
+     * These are read-only data endpoints, NOT callable tools.
+     * Resource template names must NOT be placed in `enabled_tools` —
+     * they are accessed via MCP resource reads, not tool invocations.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.mcpserver.v1.DiscoveredResourceTemplate resource_templates = 2;
+     */
+    resourceTemplates: DiscoveredResourceTemplate[];
+    /**
+     * When this snapshot was captured.
+     *
+     * @generated from field: google.protobuf.Timestamp last_discovered_at = 3;
+     */
+    lastDiscoveredAt?: Timestamp;
+    /**
+     * How this snapshot was produced.
+     *
+     * @generated from field: ai.stigmer.agentic.mcpserver.v1.DiscoverySource discovered_by = 4;
+     */
+    discoveredBy: DiscoverySource;
+};
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.DiscoveredCapabilities.
+ * Use `create(DiscoveredCapabilitiesSchema)` to create a new message.
+ */
+export declare const DiscoveredCapabilitiesSchema: GenMessage<DiscoveredCapabilities>;
+/**
+ * DiscoveredTool describes a single tool reported by an MCP server.
+ *
+ * Maps directly to the MCP protocol's Tool type from tools/list:
+ *   - name: unique tool identifier within the server
+ *   - description: human-readable explanation of what the tool does
+ *   - input_schema: JSON Schema describing the tool's expected input
+ *
+ * @generated from message ai.stigmer.agentic.mcpserver.v1.DiscoveredTool
+ */
+export type DiscoveredTool = Message<"ai.stigmer.agentic.mcpserver.v1.DiscoveredTool"> & {
+    /**
+     * Unique tool name within the MCP server (case-sensitive).
+     * Example: "search", "get_agent", "apply_mcp_server"
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Human-readable description of the tool's purpose.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * JSON Schema describing the tool's input parameters.
+     * Stored as a Struct for natural representation in YAML/JSON and to allow
+     * inspection without string parsing. This is the raw schema from the MCP
+     * server's tools/list response.
+     *
+     * @generated from field: google.protobuf.Struct input_schema = 3;
+     */
+    inputSchema?: JsonObject;
+};
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.DiscoveredTool.
+ * Use `create(DiscoveredToolSchema)` to create a new message.
+ */
+export declare const DiscoveredToolSchema: GenMessage<DiscoveredTool>;
+/**
+ * DiscoveredResourceTemplate describes a parameterized resource template
+ * reported by an MCP server via resources/templates/list.
+ *
+ * Resource templates use URI templates (RFC 6570) with placeholders that
+ * clients fill in to access specific resources.
+ *
+ * Example:
+ *   uri_template: "stigmer://agents/{org}/{slug}"
+ *   name: "stigmer_agent"
+ *   description: "Full definition of a Stigmer agent"
+ *   mime_type: "application/json"
+ *
+ * @generated from message ai.stigmer.agentic.mcpserver.v1.DiscoveredResourceTemplate
+ */
+export type DiscoveredResourceTemplate = Message<"ai.stigmer.agentic.mcpserver.v1.DiscoveredResourceTemplate"> & {
+    /**
+     * URI template with placeholders (RFC 6570).
+     * Example: "stigmer://agents/{org}/{slug}"
+     *
+     * @generated from field: string uri_template = 1;
+     */
+    uriTemplate: string;
+    /**
+     * Identifier for this resource template.
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * Human-readable description of the resource.
+     *
+     * @generated from field: string description = 3;
+     */
+    description: string;
+    /**
+     * MIME type of the resource content.
+     * Example: "application/json"
+     *
+     * @generated from field: string mime_type = 4;
+     */
+    mimeType: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.DiscoveredResourceTemplate.
+ * Use `create(DiscoveredResourceTemplateSchema)` to create a new message.
+ */
+export declare const DiscoveredResourceTemplateSchema: GenMessage<DiscoveredResourceTemplate>;
+/**
+ * ValidationState represents the structural validity of an MCP server definition.
+ * This is NOT runtime health — it only indicates whether the definition is valid.
+ *
+ * @generated from enum ai.stigmer.agentic.mcpserver.v1.ValidationState
+ */
+export declare enum ValidationState {
+    /**
+     * Default/unspecified state.
+     * Used when validation has not yet been performed.
+     *
+     * @generated from enum value: validation_state_unspecified = 0;
+     */
+    validation_state_unspecified = 0,
+    /**
+     * The MCP server definition is structurally valid.
+     * All required fields are present and have valid values.
+     * The definition can be referenced by agents.
+     *
+     * @generated from enum value: valid = 1;
+     */
+    valid = 1,
+    /**
+     * The MCP server definition is invalid.
+     * Check validation_message for details on what's wrong.
+     * The definition should be corrected before use.
+     *
+     * @generated from enum value: invalid = 2;
+     */
+    invalid = 2
+}
+/**
+ * Describes the enum ai.stigmer.agentic.mcpserver.v1.ValidationState.
+ */
+export declare const ValidationStateSchema: GenEnum<ValidationState>;
+/**
+ * DiscoverySource identifies how discovered capabilities were obtained.
+ *
+ * @generated from enum ai.stigmer.agentic.mcpserver.v1.DiscoverySource
+ */
+export declare enum DiscoverySource {
+    /**
+     * Default/unspecified.
+     *
+     * @generated from enum value: discovery_source_unspecified = 0;
+     */
+    discovery_source_unspecified = 0,
+    /**
+     * Statically defined in the seedpack (built-in servers with known tool sets).
+     *
+     * @generated from enum value: seedpack = 1;
+     */
+    seedpack = 1,
+    /**
+     * Discovered by the CLI via `stigmer discover mcp-server <name>`.
+     * The CLI connects to the MCP server locally and pushes results to the server.
+     *
+     * @generated from enum value: cli = 2;
+     */
+    cli = 2,
+    /**
+     * Discovered by the agent-runner at runtime (future).
+     *
+     * @generated from enum value: agent_runner = 3;
+     */
+    agent_runner = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.mcpserver.v1.DiscoverySource.
+ */
+export declare const DiscoverySourceSchema: GenEnum<DiscoverySource>;

package/ai/stigmer/agentic/mcpserver/v1/status_pb.js

@@ -0,0 +1,104 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/mcpserver/v1/status.proto (package ai.stigmer.agentic.mcpserver.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_commons_apiresource_status } from "../../../commons/apiresource/status_pb";
+import { file_google_protobuf_struct, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/agentic/mcpserver/v1/status.proto.
+ */
+export const file_ai_stigmer_agentic_mcpserver_v1_status = /*@__PURE__*/ fileDesc("CixhaS9zdGlnbWVyL2FnZW50aWMvbWNwc2VydmVyL3YxL3N0YXR1cy5wcm90bxIfYWkuc3RpZ21lci5hZ2VudGljLm1jcHNlcnZlci52MSKUAgoPTWNwU2VydmVyU3RhdHVzEkoKEHZhbGlkYXRpb25fc3RhdGUYASABKA4yMC5haS5zdGlnbWVyLmFnZW50aWMubWNwc2VydmVyLnYxLlZhbGlkYXRpb25TdGF0ZRIaChJ2YWxpZGF0aW9uX21lc3NhZ2UYAiABKAkSWAoXZGlzY292ZXJlZF9jYXBhYmlsaXRpZXMYAyABKAsyNy5haS5zdGlnbWVyLmFnZW50aWMubWNwc2VydmVyLnYxLkRpc2NvdmVyZWRDYXBhYmlsaXRpZXMSPwoFYXVkaXQYYyABKAsyMC5haS5zdGlnbWVyLmNvbW1vbnMuYXBpcmVzb3VyY2UuQXBpUmVzb3VyY2VBdWRpdCKyAgoWRGlzY292ZXJlZENhcGFiaWxpdGllcxI+CgV0b29scxgBIAMoCzIvLmFpLnN0aWdtZXIuYWdlbnRpYy5tY3BzZXJ2ZXIudjEuRGlzY292ZXJlZFRvb2wSVwoScmVzb3VyY2VfdGVtcGxhdGVzGAIgAygLMjsuYWkuc3RpZ21lci5hZ2VudGljLm1jcHNlcnZlci52MS5EaXNjb3ZlcmVkUmVzb3VyY2VUZW1wbGF0ZRI2ChJsYXN0X2Rpc2NvdmVyZWRfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEkcKDWRpc2NvdmVyZWRfYnkYBCABKA4yMC5haS5zdGlnbWVyLmFnZW50aWMubWNwc2VydmVyLnYxLkRpc2NvdmVyeVNvdXJjZSJiCg5EaXNjb3ZlcmVkVG9vbBIMCgRuYW1lGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEi0KDGlucHV0X3NjaGVtYRgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QiaAoaRGlzY292ZXJlZFJlc291cmNlVGVtcGxhdGUSFAoMdXJpX3RlbXBsYXRlGAEgASgJEgwKBG5hbWUYAiABKAkSEwoLZGVzY3JpcHRpb24YAyABKAkSEQoJbWltZV90eXBlGAQgASgJKksKD1ZhbGlkYXRpb25TdGF0ZRIgChx2YWxpZGF0aW9uX3N0YXRlX3Vuc3BlY2lmaWVkEAASCQoFdmFsaWQQARILCgdpbnZhbGlkEAIqXAoPRGlzY292ZXJ5U291cmNlEiAKHGRpc2NvdmVyeV9zb3VyY2VfdW5zcGVjaWZpZWQQABIMCghzZWVkcGFjaxABEgcKA2NsaRACEhAKDGFnZW50X3J1bm5lchADYgZwcm90bzM", [file_ai_stigmer_commons_apiresource_status, file_google_protobuf_struct, file_google_protobuf_timestamp]);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.McpServerStatus.
+ * Use `create(McpServerStatusSchema)` to create a new message.
+ */
+export const McpServerStatusSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_status, 0);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.DiscoveredCapabilities.
+ * Use `create(DiscoveredCapabilitiesSchema)` to create a new message.
+ */
+export const DiscoveredCapabilitiesSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_status, 1);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.DiscoveredTool.
+ * Use `create(DiscoveredToolSchema)` to create a new message.
+ */
+export const DiscoveredToolSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_status, 2);
+/**
+ * Describes the message ai.stigmer.agentic.mcpserver.v1.DiscoveredResourceTemplate.
+ * Use `create(DiscoveredResourceTemplateSchema)` to create a new message.
+ */
+export const DiscoveredResourceTemplateSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_mcpserver_v1_status, 3);
+/**
+ * ValidationState represents the structural validity of an MCP server definition.
+ * This is NOT runtime health — it only indicates whether the definition is valid.
+ *
+ * @generated from enum ai.stigmer.agentic.mcpserver.v1.ValidationState
+ */
+export var ValidationState;
+(function (ValidationState) {
+    /**
+     * Default/unspecified state.
+     * Used when validation has not yet been performed.
+     *
+     * @generated from enum value: validation_state_unspecified = 0;
+     */
+    ValidationState[ValidationState["validation_state_unspecified"] = 0] = "validation_state_unspecified";
+    /**
+     * The MCP server definition is structurally valid.
+     * All required fields are present and have valid values.
+     * The definition can be referenced by agents.
+     *
+     * @generated from enum value: valid = 1;
+     */
+    ValidationState[ValidationState["valid"] = 1] = "valid";
+    /**
+     * The MCP server definition is invalid.
+     * Check validation_message for details on what's wrong.
+     * The definition should be corrected before use.
+     *
+     * @generated from enum value: invalid = 2;
+     */
+    ValidationState[ValidationState["invalid"] = 2] = "invalid";
+})(ValidationState || (ValidationState = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.mcpserver.v1.ValidationState.
+ */
+export const ValidationStateSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_mcpserver_v1_status, 0);
+/**
+ * DiscoverySource identifies how discovered capabilities were obtained.
+ *
+ * @generated from enum ai.stigmer.agentic.mcpserver.v1.DiscoverySource
+ */
+export var DiscoverySource;
+(function (DiscoverySource) {
+    /**
+     * Default/unspecified.
+     *
+     * @generated from enum value: discovery_source_unspecified = 0;
+     */
+    DiscoverySource[DiscoverySource["discovery_source_unspecified"] = 0] = "discovery_source_unspecified";
+    /**
+     * Statically defined in the seedpack (built-in servers with known tool sets).
+     *
+     * @generated from enum value: seedpack = 1;
+     */
+    DiscoverySource[DiscoverySource["seedpack"] = 1] = "seedpack";
+    /**
+     * Discovered by the CLI via `stigmer discover mcp-server <name>`.
+     * The CLI connects to the MCP server locally and pushes results to the server.
+     *
+     * @generated from enum value: cli = 2;
+     */
+    DiscoverySource[DiscoverySource["cli"] = 2] = "cli";
+    /**
+     * Discovered by the agent-runner at runtime (future).
+     *
+     * @generated from enum value: agent_runner = 3;
+     */
+    DiscoverySource[DiscoverySource["agent_runner"] = 3] = "agent_runner";
+})(DiscoverySource || (DiscoverySource = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.mcpserver.v1.DiscoverySource.
+ */
+export const DiscoverySourceSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_mcpserver_v1_status, 1);
+//# sourceMappingURL=status_pb.js.map

package/ai/stigmer/agentic/mcpserver/v1/status_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/mcpserver/v1/status_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,6HAA6H;AAC7H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AAEpG,OAAO,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGrG;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAY,aAAa,CAC/E,QAAQ,CAAC,63CAA63C,EAAE,CAAC,0CAA0C,EAAE,2BAA2B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AA4Dr/C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAkE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuC,aAAa,CAC3F,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAuC9D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAiD9D;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA2C,aAAa,CACnG,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAN,IAAY,eA0BX;AA1BD,WAAY,eAAe;IACzB;;;;;OAKG;IACH,qGAAgC,CAAA;IAEhC;;;;;;OAMG;IACH,uDAAS,CAAA;IAET;;;;;;OAMG;IACH,2DAAW,CAAA;AACb,CAAC,EA1BW,eAAe,KAAf,eAAe,QA0B1B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B,aAAa,CAC1E,QAAQ,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAN,IAAY,eA6BX;AA7BD,WAAY,eAAe;IACzB;;;;OAIG;IACH,qGAAgC,CAAA;IAEhC;;;;OAIG;IACH,6DAAY,CAAA;IAEZ;;;;;OAKG;IACH,mDAAO,CAAA;IAEP;;;;OAIG;IACH,qEAAgB,CAAA;AAClB,CAAC,EA7BW,eAAe,KAAf,eAAe,QA6B1B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B,aAAa,CAC1E,QAAQ,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/session/v1/api_pb.d.ts

@@ -0,0 +1,52 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { SessionSpec } from "./spec_pb";
+import type { ApiResourceMetadata } from "../../../commons/apiresource/metadata_pb";
+import type { ApiResourceAuditStatus } from "../../../commons/apiresource/status_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/session/v1/api.proto.
+ */
+export declare const file_ai_stigmer_agentic_session_v1_api: GenFile;
+/**
+ * Session represents a multi-turn conversation thread with an agent.
+ *
+ * @generated from message ai.stigmer.agentic.session.v1.Session
+ */
+export type Session = Message<"ai.stigmer.agentic.session.v1.Session"> & {
+    /**
+     * API version for this resource type.
+     *
+     * @generated from field: string api_version = 1;
+     */
+    apiVersion: string;
+    /**
+     * Resource kind identifier.
+     *
+     * @generated from field: string kind = 2;
+     */
+    kind: string;
+    /**
+     * Standard resource metadata including name, id, labels, and tags.
+     * Sessions belong to an organization and are typically PRIVATE visibility.
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceMetadata metadata = 3;
+     */
+    metadata?: ApiResourceMetadata;
+    /**
+     * Session-specific configuration.
+     *
+     * @generated from field: ai.stigmer.agentic.session.v1.SessionSpec spec = 4;
+     */
+    spec?: SessionSpec;
+    /**
+     * System-managed status containing audit information.
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAuditStatus status = 5;
+     */
+    status?: ApiResourceAuditStatus;
+};
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.Session.
+ * Use `create(SessionSchema)` to create a new message.
+ */
+export declare const SessionSchema: GenMessage<Session>;

package/ai/stigmer/agentic/session/v1/api_pb.js

@@ -0,0 +1,18 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/session/v1/api.proto (package ai.stigmer.agentic.session.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_session_v1_spec } from "./spec_pb";
+import { file_ai_stigmer_commons_apiresource_metadata } from "../../../commons/apiresource/metadata_pb";
+import { file_ai_stigmer_commons_apiresource_status } from "../../../commons/apiresource/status_pb";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb";
+/**
+ * Describes the file ai/stigmer/agentic/session/v1/api.proto.
+ */
+export const file_ai_stigmer_agentic_session_v1_api = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvc2Vzc2lvbi92MS9hcGkucHJvdG8SHWFpLnN0aWdtZXIuYWdlbnRpYy5zZXNzaW9uLnYxIqsCCgdTZXNzaW9uEjEKC2FwaV92ZXJzaW9uGAEgASgJQhy6SBlyFwoVYWdlbnRpYy5zdGlnbWVyLmFpL3YxEhwKBGtpbmQYAiABKAlCDrpIC3IJCgdTZXNzaW9uEk0KCG1ldGFkYXRhGAMgASgLMjMuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlTWV0YWRhdGFCBrpIA8gBARI4CgRzcGVjGAQgASgLMiouYWkuc3RpZ21lci5hZ2VudGljLnNlc3Npb24udjEuU2Vzc2lvblNwZWMSRgoGc3RhdHVzGAUgASgLMjYuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlQXVkaXRTdGF0dXNiBnByb3RvMw", [file_ai_stigmer_agentic_session_v1_spec, file_ai_stigmer_commons_apiresource_metadata, file_ai_stigmer_commons_apiresource_status, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.Session.
+ * Use `create(SessionSchema)` to create a new message.
+ */
+export const SessionSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_session_v1_api, 0);
+//# sourceMappingURL=api_pb.js.map

package/ai/stigmer/agentic/session/v1/api_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/api_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,sHAAsH;AACtH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,WAAW,CAAC;AAEpE,OAAO,EAAE,4CAA4C,EAAE,MAAM,0CAA0C,CAAC;AAExG,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,ggBAAggB,EAAE,CAAC,uCAAuC,EAAE,4CAA4C,EAAE,0CAA0C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA6C9qB;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,aAAa,CAC7D,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/session/v1/command_connect.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SessionCommandController handles write operations for agent sessions.
+ *
+ * @generated from service ai.stigmer.agentic.session.v1.SessionCommandController
+ */
+export declare const SessionCommandController: {
+    readonly typeName: "ai.stigmer.agentic.session.v1.SessionCommandController";
+    readonly methods: {
+        /**
+         * Create or update a session.
+         * The authorization and state-operation are determined depending on whether the session
+         * is going to be created or updated which is determined as part of the request execution.
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.apply
+         */
+        readonly apply: {
+            readonly name: "apply";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Create a new session for an agent.
+         * Requires can_create_session permission in the organization.
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.create
+         */
+        readonly create: {
+            readonly name: "create";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Update an existing session (e.g., subject, thread_id, sandbox_id).
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.update
+         */
+        readonly update: {
+            readonly name: "update";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Delete a session (also cleans up thread and sandbox).
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.delete
+         */
+        readonly delete: {
+            readonly name: "delete";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+    };
+};

package/ai/stigmer/agentic/session/v1/command_connect.js

@@ -0,0 +1,63 @@
+// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/session/v1/command.proto (package ai.stigmer.agentic.session.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { MethodKind } from "@bufbuild/protobuf";
+/**
+ * SessionCommandController handles write operations for agent sessions.
+ *
+ * @generated from service ai.stigmer.agentic.session.v1.SessionCommandController
+ */
+export const SessionCommandController = {
+    typeName: "ai.stigmer.agentic.session.v1.SessionCommandController",
+    methods: {
+        /**
+         * Create or update a session.
+         * The authorization and state-operation are determined depending on whether the session
+         * is going to be created or updated which is determined as part of the request execution.
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.apply
+         */
+        apply: {
+            name: "apply",
+            I: Session,
+            O: Session,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Create a new session for an agent.
+         * Requires can_create_session permission in the organization.
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.create
+         */
+        create: {
+            name: "create",
+            I: Session,
+            O: Session,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Update an existing session (e.g., subject, thread_id, sandbox_id).
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.update
+         */
+        update: {
+            name: "update",
+            I: Session,
+            O: Session,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Delete a session (also cleans up thread and sandbox).
+         *
+         * @generated from rpc ai.stigmer.agentic.session.v1.SessionCommandController.delete
+         */
+        delete: {
+            name: "delete",
+            I: SessionId,
+            O: Session,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=command_connect.js.map

package/ai/stigmer/agentic/session/v1/command_connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0HAA0H;AAC1H,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ,EAAE,wDAAwD;IAClE,OAAO,EAAE;QACP;;;;;;WAMG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,OAAO;YACV,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;WAKG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,OAAO;YACV,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,OAAO;YACV,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,SAAS;YACZ,CAAC,EAAE,OAAO;YACV,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}