@stigmer/protos 0.0.34

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

@@ -0,0 +1,167 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/session/v1/workspace.proto.
+ */
+export declare const file_ai_stigmer_agentic_session_v1_workspace: GenFile;
+/**
+ * WorkspaceSource defines where the agent's workspace content comes from.
+ *
+ * This is a pure source-definition type: it describes the origin of workspace
+ * content (a git repo or a local directory) without any identity or naming.
+ * Use WorkspaceEntry to pair a source with a name for session-level usage.
+ *
+ * @generated from message ai.stigmer.agentic.session.v1.WorkspaceSource
+ */
+export type WorkspaceSource = Message<"ai.stigmer.agentic.session.v1.WorkspaceSource"> & {
+    /**
+     * @generated from oneof ai.stigmer.agentic.session.v1.WorkspaceSource.source
+     */
+    source: {
+        /**
+         * @generated from field: ai.stigmer.agentic.session.v1.GitRepoSource git_repo = 1;
+         */
+        value: GitRepoSource;
+        case: "gitRepo";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.session.v1.LocalPathSource local_path = 2;
+         */
+        value: LocalPathSource;
+        case: "localPath";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.WorkspaceSource.
+ * Use `create(WorkspaceSourceSchema)` to create a new message.
+ */
+export declare const WorkspaceSourceSchema: GenMessage<WorkspaceSource>;
+/**
+ * WorkspaceEntry pairs a WorkspaceSource with a human-readable name,
+ * forming an addressable unit within a session's workspace.
+ *
+ * In a multi-root workspace (VS Code model), each entry is a separate
+ * directory or repository that the agent can operate on. The name serves as
+ * the entry's identity: it appears in the system prompt, and in cloud mode
+ * it becomes the subdirectory name under the workspace root.
+ *
+ * Names are auto-derived by the CLI from the repository name (last URL path
+ * segment sans ".git") or the directory basename. They must be unique within
+ * a session's workspace_entries list.
+ *
+ * @generated from message ai.stigmer.agentic.session.v1.WorkspaceEntry
+ */
+export type WorkspaceEntry = Message<"ai.stigmer.agentic.session.v1.WorkspaceEntry"> & {
+    /**
+     * Short identifier for this workspace entry (required).
+     * Used in system prompt headings and as the clone subdirectory in cloud mode.
+     * Example: "my-app", "frontend", "shared-lib"
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * The source that provides this entry's content (required).
+     *
+     * @generated from field: ai.stigmer.agentic.session.v1.WorkspaceSource source = 2;
+     */
+    source?: WorkspaceSource;
+};
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.WorkspaceEntry.
+ * Use `create(WorkspaceEntrySchema)` to create a new message.
+ */
+export declare const WorkspaceEntrySchema: GenMessage<WorkspaceEntry>;
+/**
+ * LocalPathSource uses an existing directory on the host filesystem as the
+ * workspace. The agent operates directly on the user's files -- changes are
+ * immediate and persistent.
+ *
+ * Deployment constraint: only valid when the agent-runner is in local mode.
+ * Cloud runners reject this at provisioning time with a clear error, the same
+ * way GitRepoSource rejects SSH URLs at validation time. This is a normal
+ * deployment-specific constraint, not a schema limitation.
+ *
+ * No copy or clone is made. The path is used directly as the workspace root.
+ *
+ * @generated from message ai.stigmer.agentic.session.v1.LocalPathSource
+ */
+export type LocalPathSource = Message<"ai.stigmer.agentic.session.v1.LocalPathSource"> & {
+    /**
+     * Absolute path to an existing directory on the host filesystem (required).
+     * The runner validates that the path exists and is a directory at
+     * provisioning time.
+     * Example: "/home/user/projects/my-app", "/Users/dev/src/acme-api"
+     *
+     * @generated from field: string path = 1;
+     */
+    path: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.LocalPathSource.
+ * Use `create(LocalPathSourceSchema)` to create a new message.
+ */
+export declare const LocalPathSourceSchema: GenMessage<LocalPathSource>;
+/**
+ * GitRepoSource provisions a workspace by cloning a git repository.
+ *
+ * Authentication: The provisioner resolves GITHUB_TOKEN from the merged
+ * environment (Agent defaults < Environment < ExecutionContext.runtime_env)
+ * and injects it into the clone URL. The token is consumed by provisioning
+ * and stripped before forwarding to the agent runtime (see AD-05).
+ *
+ * HTTPS only for MVP. SSH key authentication is a future enhancement.
+ *
+ * @generated from message ai.stigmer.agentic.session.v1.GitRepoSource
+ */
+export type GitRepoSource = Message<"ai.stigmer.agentic.session.v1.GitRepoSource"> & {
+    /**
+     * HTTPS clone URL (required).
+     * Must use the https:// scheme. SSH URLs (git@...) are not supported.
+     * Example: "https://github.com/acme/my-app.git"
+     *
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * Branch to clone (optional).
+     * When empty, the repository's default branch is used.
+     * Example: "main", "develop", "feature/workspace-support"
+     *
+     * @generated from field: string branch = 2;
+     */
+    branch: string;
+    /**
+     * Commit SHA to checkout after cloning (optional).
+     * When set, the workspace is checked out at this exact commit (detached HEAD).
+     * When both branch and commit are set, the branch is cloned first, then
+     * the commit is checked out -- this allows shallow clones of a specific
+     * commit on a known branch.
+     * When only commit is set (no branch), a full clone is required to
+     * locate the commit.
+     *
+     * @generated from field: string commit = 3;
+     */
+    commit: string;
+    /**
+     * Clone depth (optional).
+     *
+     * Presence semantics:
+     *   - Absent (not set): shallow clone with depth 1 (fast default).
+     *   - 0: full clone with complete history.
+     *   - N > 0: shallow clone with depth N.
+     *
+     * Uses proto3 optional to distinguish "not set" from "set to 0."
+     *
+     * @generated from field: optional int32 depth = 4;
+     */
+    depth?: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.GitRepoSource.
+ * Use `create(GitRepoSourceSchema)` to create a new message.
+ */
+export declare const GitRepoSourceSchema: GenMessage<GitRepoSource>;

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

@@ -0,0 +1,30 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/session/v1/workspace.proto (package ai.stigmer.agentic.session.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb";
+/**
+ * Describes the file ai/stigmer/agentic/session/v1/workspace.proto.
+ */
+export const file_ai_stigmer_agentic_session_v1_workspace = /*@__PURE__*/ fileDesc("Ci1haS9zdGlnbWVyL2FnZW50aWMvc2Vzc2lvbi92MS93b3Jrc3BhY2UucHJvdG8SHWFpLnN0aWdtZXIuYWdlbnRpYy5zZXNzaW9uLnYxIqoBCg9Xb3Jrc3BhY2VTb3VyY2USQAoIZ2l0X3JlcG8YASABKAsyLC5haS5zdGlnbWVyLmFnZW50aWMuc2Vzc2lvbi52MS5HaXRSZXBvU291cmNlSAASRAoKbG9jYWxfcGF0aBgCIAEoCzIuLmFpLnN0aWdtZXIuYWdlbnRpYy5zZXNzaW9uLnYxLkxvY2FsUGF0aFNvdXJjZUgAQg8KBnNvdXJjZRIFukgCCAEibwoOV29ya3NwYWNlRW50cnkSFQoEbmFtZRgBIAEoCUIHukgEcgIQARJGCgZzb3VyY2UYAiABKAsyLi5haS5zdGlnbWVyLmFnZW50aWMuc2Vzc2lvbi52MS5Xb3Jrc3BhY2VTb3VyY2VCBrpIA8gBASIoCg9Mb2NhbFBhdGhTb3VyY2USFQoEcGF0aBgBIAEoCUIHukgEcgIQASL+AQoNR2l0UmVwb1NvdXJjZRKlAQoDdXJsGAEgASgJQpcBukiTAboBjAEKGWdpdF9yZXBvX3NvdXJjZS51cmwuaHR0cHMSUnVybCBtdXN0IHVzZSBIVFRQUyAoZS5nLiBodHRwczovL2dpdGh1Yi5jb20vb3JnL3JlcG8pLiBTU0ggVVJMcyBhcmUgbm90IHN1cHBvcnRlZC4aG3RoaXMuc3RhcnRzV2l0aCgnaHR0cHM6Ly8nKcgBARIOCgZicmFuY2gYAiABKAkSDgoGY29tbWl0GAMgASgJEhsKBWRlcHRoGAQgASgFQge6SAQaAigASACIAQFCCAoGX2RlcHRoYgZwcm90bzM", [file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.WorkspaceSource.
+ * Use `create(WorkspaceSourceSchema)` to create a new message.
+ */
+export const WorkspaceSourceSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_session_v1_workspace, 0);
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.WorkspaceEntry.
+ * Use `create(WorkspaceEntrySchema)` to create a new message.
+ */
+export const WorkspaceEntrySchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_session_v1_workspace, 1);
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.LocalPathSource.
+ * Use `create(LocalPathSourceSchema)` to create a new message.
+ */
+export const LocalPathSourceSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_session_v1_workspace, 2);
+/**
+ * Describes the message ai.stigmer.agentic.session.v1.GitRepoSource.
+ * Use `create(GitRepoSourceSchema)` to create a new message.
+ */
+export const GitRepoSourceSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_session_v1_workspace, 3);
+//# sourceMappingURL=workspace_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/workspace_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,4HAA4H;AAC5H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAY,aAAa,CAChF,QAAQ,CAAC,i4BAAi4B,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AA8B56B;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AAmC/D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AA4B/D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AA6D/D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,85 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { SkillSpec } from "./spec_pb";
+import type { SkillStatus } from "./status_pb";
+import type { ApiResourceMetadata } from "../../../commons/apiresource/metadata_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/api.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_api: GenFile;
+/**
+ * Skill represents a versioned, reusable unit of agent capability.
+ * Skills contain tools, scripts, and documentation that agents can use.
+ * Each skill version is immutably identified by a content hash.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.Skill
+ */
+export type Skill = Message<"ai.stigmer.agentic.skill.v1.Skill"> & {
+    /**
+     * 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.
+     * Skill names are normalized to slugs (e.g., "Calculator" → "calculator").
+     * Skills belong to an organization and can be public or private.
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceMetadata metadata = 3;
+     */
+    metadata?: ApiResourceMetadata;
+    /**
+     * User-provided skill configuration (desired state).
+     *
+     * @generated from field: ai.stigmer.agentic.skill.v1.SkillSpec spec = 4;
+     */
+    spec?: SkillSpec;
+    /**
+     * System-managed skill state (observed state).
+     *
+     * @generated from field: ai.stigmer.agentic.skill.v1.SkillStatus status = 5;
+     */
+    status?: SkillStatus;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.Skill.
+ * Use `create(SkillSchema)` to create a new message.
+ */
+export declare const SkillSchema: GenMessage<Skill>;
+/**
+ * SkillList represents a paginated list of skills.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.SkillList
+ */
+export type SkillList = Message<"ai.stigmer.agentic.skill.v1.SkillList"> & {
+    /**
+     * API version for this list type.
+     *
+     * @generated from field: string api_version = 1;
+     */
+    apiVersion: string;
+    /**
+     * Resource kind identifier for the list.
+     *
+     * @generated from field: string kind = 2;
+     */
+    kind: string;
+    /**
+     * List of skill resources.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.skill.v1.Skill items = 3;
+     */
+    items: Skill[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillList.
+ * Use `create(SkillListSchema)` to create a new message.
+ */
+export declare const SkillListSchema: GenMessage<SkillList>;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/api_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,kHAAkH;AAClH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qCAAqC,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,4CAA4C,EAAE,MAAM,0CAA0C,CAAC;AACxG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAY,aAAa,CACxE,QAAQ,CAAC,imBAAimB,EAAE,CAAC,qCAAqC,EAAE,uCAAuC,EAAE,4CAA4C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAgD1wB;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB,aAAa,CACzD,WAAW,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC;AA8BvD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,aAAa,CACjE,WAAW,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * SkillCommandController handles write operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillCommandController
+ */
+export declare const SkillCommandController: {
+    readonly typeName: "ai.stigmer.agentic.skill.v1.SkillCommandController";
+    readonly methods: {
+        /**
+         * Push (upload) a skill artifact.
+         * This operation creates a new skill if it doesn't exist, or creates a new version
+         * of an existing skill. The skill artifact must contain SKILL.md.
+         *
+         * Authorization:
+         * - Organization-scoped skills: Caller must have can_create_skill permission in the organization
+         * - Platform-scoped skills: Caller must be a platform operator (handled automatically by common auth step)
+         *
+         * The backend will:
+         * 1. Normalize the name to a slug
+         * 2. Find or create the skill resource
+         * 3. Extract SKILL.md from the artifact
+         * 4. Calculate SHA256 hash (version identifier)
+         * 5. Store the artifact (deduplicated by hash)
+         * 6. Update skill spec and status
+         * 7. Archive the previous version (if updating)
+         *
+         * Returns: The created or updated Skill resource (consistent with other CRUD operations)
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
+         */
+        readonly push: {
+            readonly name: "push";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Delete a skill and all its versions.
+         * This removes the skill from the main collection but preserves audit history.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
+         */
+        readonly delete: {
+            readonly name: "delete";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+    };
+};

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

@@ -0,0 +1,56 @@
+// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/command.proto (package ai.stigmer.agentic.skill.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { MethodKind } from "@bufbuild/protobuf";
+/**
+ * SkillCommandController handles write operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillCommandController
+ */
+export const SkillCommandController = {
+    typeName: "ai.stigmer.agentic.skill.v1.SkillCommandController",
+    methods: {
+        /**
+         * Push (upload) a skill artifact.
+         * This operation creates a new skill if it doesn't exist, or creates a new version
+         * of an existing skill. The skill artifact must contain SKILL.md.
+         *
+         * Authorization:
+         * - Organization-scoped skills: Caller must have can_create_skill permission in the organization
+         * - Platform-scoped skills: Caller must be a platform operator (handled automatically by common auth step)
+         *
+         * The backend will:
+         * 1. Normalize the name to a slug
+         * 2. Find or create the skill resource
+         * 3. Extract SKILL.md from the artifact
+         * 4. Calculate SHA256 hash (version identifier)
+         * 5. Store the artifact (deduplicated by hash)
+         * 6. Update skill spec and status
+         * 7. Archive the previous version (if updating)
+         *
+         * Returns: The created or updated Skill resource (consistent with other CRUD operations)
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
+         */
+        push: {
+            name: "push",
+            I: PushSkillRequest,
+            O: Skill,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Delete a skill and all its versions.
+         * This removes the skill from the main collection but preserves audit history.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
+         */
+        delete: {
+            name: "delete",
+            I: SkillId,
+            O: Skill,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=command_connect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE;QACP;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,gBAAgB;YACnB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;WAKG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

package/ai/stigmer/agentic/skill/v1/command_pb.d.ts

@@ -0,0 +1,52 @@
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { SkillSchema } from "./api_pb";
+import type { PushSkillRequestSchema, SkillIdSchema } from "./io_pb";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/command.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_command: GenFile;
+/**
+ * SkillCommandController handles write operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillCommandController
+ */
+export declare const SkillCommandController: GenService<{
+    /**
+     * Push (upload) a skill artifact.
+     * This operation creates a new skill if it doesn't exist, or creates a new version
+     * of an existing skill. The skill artifact must contain SKILL.md.
+     *
+     * Authorization:
+     * - Organization-scoped skills: Caller must have can_create_skill permission in the organization
+     * - Platform-scoped skills: Caller must be a platform operator (handled automatically by common auth step)
+     *
+     * The backend will:
+     * 1. Normalize the name to a slug
+     * 2. Find or create the skill resource
+     * 3. Extract SKILL.md from the artifact
+     * 4. Calculate SHA256 hash (version identifier)
+     * 5. Store the artifact (deduplicated by hash)
+     * 6. Update skill spec and status
+     * 7. Archive the previous version (if updating)
+     *
+     * Returns: The created or updated Skill resource (consistent with other CRUD operations)
+     *
+     * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
+     */
+    push: {
+        methodKind: "unary";
+        input: typeof PushSkillRequestSchema;
+        output: typeof SkillSchema;
+    };
+    /**
+     * Delete a skill and all its versions.
+     * This removes the skill from the main collection but preserves audit history.
+     *
+     * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
+     */
+    delete: {
+        methodKind: "unary";
+        input: typeof SkillIdSchema;
+        output: typeof SkillSchema;
+    };
+}>;

package/ai/stigmer/agentic/skill/v1/command_pb.js

@@ -0,0 +1,19 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/command.proto (package ai.stigmer.agentic.skill.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_skill_v1_api } from "./api_pb";
+import { file_ai_stigmer_agentic_skill_v1_io } from "./io_pb";
+import { file_ai_stigmer_commons_apiresource_rpc_service_options } from "../../../commons/apiresource/rpc_service_options_pb";
+import { file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options } from "../../../iam/iampolicy/v1/rpcauthorization/method_options_pb";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/command.proto.
+ */
+export const file_ai_stigmer_agentic_skill_v1_command = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvY29tbWFuZC5wcm90bxIbYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxMr4CChZTa2lsbENvbW1hbmRDb250cm9sbGVyEpkBCgRwdXNoEi0uYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlB1c2hTa2lsbFJlcXVlc3QaIi5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGwiPsK4GDoIFRAeIgNvcmcqL3VuYXV0aG9yaXplZCB0byBwdXNoIHNraWxsIGluIHRoaXMgb3JnYW5pemF0aW9uEoEBCgZkZWxldGUSJC5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGxJZBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Ta2lsbCItwrgYKQgCECsiBXZhbHVlKhx1bmF1dGhvcml6ZWQgdG8gZGVsZXRlIHNraWxsGgSg/ysrYgZwcm90bzM", [file_ai_stigmer_agentic_skill_v1_api, file_ai_stigmer_agentic_skill_v1_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
+/**
+ * SkillCommandController handles write operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillCommandController
+ */
+export const SkillCommandController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_skill_v1_command, 0);
+//# sourceMappingURL=command_pb.js.map

package/ai/stigmer/agentic/skill/v1/command_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,sHAAsH;AACtH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,yhBAAyhB,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE9uB;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAuC9B,aAAa,CAChB,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/skill/v1/io_pb.d.ts

@@ -0,0 +1,118 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { GitProvenance } from "./status_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/io.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_io: GenFile;
+/**
+ * SkillId wraps a skill identifier.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.SkillId
+ */
+export type SkillId = Message<"ai.stigmer.agentic.skill.v1.SkillId"> & {
+    /**
+     * @generated from field: string value = 1;
+     */
+    value: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillId.
+ * Use `create(SkillIdSchema)` to create a new message.
+ */
+export declare const SkillIdSchema: GenMessage<SkillId>;
+/**
+ * PushSkillRequest contains the skill artifact and metadata for upload.
+ * This operation creates a new skill if it doesn't exist, or creates a new version
+ * of an existing skill.
+ *
+ * The skill name and description are extracted by the backend from the SKILL.md
+ * YAML frontmatter within the artifact. The CLI validates the format but does not
+ * send these fields - backend is the single source of truth for parsing.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.PushSkillRequest
+ */
+export type PushSkillRequest = Message<"ai.stigmer.agentic.skill.v1.PushSkillRequest"> & {
+    /**
+     * Organization that owns this skill. Required.
+     * All skills belong to exactly one organization.
+     *
+     * @generated from field: string org = 1;
+     */
+    org: string;
+    /**
+     * Skill artifact as a ZIP file (binary content).
+     * The ZIP must contain:
+     * - SKILL.md (required): Interface definition and documentation with YAML frontmatter
+     *   - name: Skill identifier (required in frontmatter, kebab-case)
+     *   - description: Human-readable description (optional but recommended)
+     * - Tool executables/scripts (optional)
+     * - Additional files referenced in SKILL.md
+     *
+     * @generated from field: bytes artifact = 2;
+     */
+    artifact: Uint8Array;
+    /**
+     * Optional tag to associate with this version.
+     * If provided, this tag will point to the new version.
+     * If empty/not provided, the version will only be accessible via its hash.
+     * Examples: "stable", "v1.0", "latest"
+     *
+     * @generated from field: string tag = 3;
+     */
+    tag: string;
+    /**
+     * Git provenance for this skill version. Optional.
+     * Populated by CLI during push:
+     * - For local pushes: auto-detected if directory is within a git repository
+     * - For git pushes: resolved from user-provided URL/ref
+     * Absent when pushed from a non-git directory.
+     * This is stored in SkillStatus.git_provenance for traceability.
+     *
+     * @generated from field: ai.stigmer.agentic.skill.v1.GitProvenance git_provenance = 4;
+     */
+    gitProvenance?: GitProvenance;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.PushSkillRequest.
+ * Use `create(PushSkillRequestSchema)` to create a new message.
+ */
+export declare const PushSkillRequestSchema: GenMessage<PushSkillRequest>;
+/**
+ * GetArtifactRequest requests download of a skill artifact by storage key.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.GetArtifactRequest
+ */
+export type GetArtifactRequest = Message<"ai.stigmer.agentic.skill.v1.GetArtifactRequest"> & {
+    /**
+     * The artifact storage key from skill.status.artifact_storage_key.
+     * This key identifies the location of the ZIP file in storage (R2/S3).
+     *
+     * @generated from field: string artifact_storage_key = 1;
+     */
+    artifactStorageKey: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.GetArtifactRequest.
+ * Use `create(GetArtifactRequestSchema)` to create a new message.
+ */
+export declare const GetArtifactRequestSchema: GenMessage<GetArtifactRequest>;
+/**
+ * GetArtifactResponse contains the skill artifact content.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.GetArtifactResponse
+ */
+export type GetArtifactResponse = Message<"ai.stigmer.agentic.skill.v1.GetArtifactResponse"> & {
+    /**
+     * The skill artifact as a ZIP file (binary content).
+     * Contains SKILL.md and implementation files.
+     *
+     * @generated from field: bytes artifact = 1;
+     */
+    artifact: Uint8Array;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.GetArtifactResponse.
+ * Use `create(GetArtifactResponseSchema)` to create a new message.
+ */
+export declare const GetArtifactResponseSchema: GenMessage<GetArtifactResponse>;

package/ai/stigmer/agentic/skill/v1/io_pb.js

@@ -0,0 +1,31 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/io.proto (package ai.stigmer.agentic.skill.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_skill_v1_status } from "./status_pb";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/io.proto.
+ */
+export const file_ai_stigmer_agentic_skill_v1_io = /*@__PURE__*/ fileDesc("CiRhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvaW8ucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MSIgCgdTa2lsbElkEhUKBXZhbHVlGAEgASgJQga6SAPIAQEitQEKEFB1c2hTa2lsbFJlcXVlc3QSEwoDb3JnGAEgASgJQga6SAPIAQESGAoIYXJ0aWZhY3QYAiABKAxCBrpIA8gBARIoCgN0YWcYAyABKAlCG7pIGHIWMhReJHxeW2EtekEtWjAtOS5fLV0rJBJCCg5naXRfcHJvdmVuYW5jZRgEIAEoCzIqLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5HaXRQcm92ZW5hbmNlSgQIBRAGIjoKEkdldEFydGlmYWN0UmVxdWVzdBIkChRhcnRpZmFjdF9zdG9yYWdlX2tleRgBIAEoCUIGukgDyAEBIicKE0dldEFydGlmYWN0UmVzcG9uc2USEAoIYXJ0aWZhY3QYASABKAxiBnByb3RvMw", [file_ai_stigmer_agentic_skill_v1_status, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillId.
+ * Use `create(SkillIdSchema)` to create a new message.
+ */
+export const SkillIdSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_io, 0);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.PushSkillRequest.
+ * Use `create(PushSkillRequestSchema)` to create a new message.
+ */
+export const PushSkillRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_io, 1);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.GetArtifactRequest.
+ * Use `create(GetArtifactRequestSchema)` to create a new message.
+ */
+export const GetArtifactRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_io, 2);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.GetArtifactResponse.
+ * Use `create(GetArtifactResponseSchema)` to create a new message.
+ */
+export const GetArtifactResponseSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_io, 3);
+//# sourceMappingURL=io_pb.js.map

package/ai/stigmer/agentic/skill/v1/io_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iHAAiH;AACjH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAY,aAAa,CACvE,QAAQ,CAAC,ghBAAghB,EAAE,CAAC,uCAAuC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAcpmB;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,aAAa,CAC7D,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AA0DtD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAiBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAiBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC"}