@stigmer/protos 0.0.34

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

@@ -0,0 +1,57 @@
+/**
+ * SkillQueryController handles read operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillQueryController
+ */
+export declare const SkillQueryController: {
+    readonly typeName: "ai.stigmer.agentic.skill.v1.SkillQueryController";
+    readonly methods: {
+        /**
+         * Get a single skill by ID.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.get
+         */
+        readonly get: {
+            readonly name: "get";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Get a skill by API resource reference with version support.
+         *
+         * Version resolution (via ApiResourceReference.version field):
+         * - Empty/"latest" → Returns current version from main collection
+         * - Tag name (e.g., "stable", "v1.0") → Resolves to version with this tag
+         * - SHA256 hash (64 hex chars) → Returns exact immutable version
+         *
+         * Authorization is handled in the handler after resolving the reference to a skill ID.
+         * (Input doesn't contain skill ID, so proto-level auth cannot work)
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getByReference
+         */
+        readonly getByReference: {
+            readonly name: "getByReference";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Download skill artifact from storage by its storage key.
+         * Returns the ZIP file containing SKILL.md and implementation files.
+         *
+         * This endpoint is used by the agent-runner to download and extract
+         * skill artifacts into the sandbox at /bin/skills/{version_hash}/.
+         *
+         * Authorization is skipped as the storage key itself acts as a capability token.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getArtifact
+         */
+        readonly getArtifact: {
+            readonly name: "getArtifact";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+    };
+};

package/ai/stigmer/agentic/skill/v1/query_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/skill/v1/query.proto (package ai.stigmer.agentic.skill.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { MethodKind } from "@bufbuild/protobuf";
+/**
+ * SkillQueryController handles read operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillQueryController
+ */
+export const SkillQueryController = {
+    typeName: "ai.stigmer.agentic.skill.v1.SkillQueryController",
+    methods: {
+        /**
+         * Get a single skill by ID.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.get
+         */
+        get: {
+            name: "get",
+            I: SkillId,
+            O: Skill,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Get a skill by API resource reference with version support.
+         *
+         * Version resolution (via ApiResourceReference.version field):
+         * - Empty/"latest" → Returns current version from main collection
+         * - Tag name (e.g., "stable", "v1.0") → Resolves to version with this tag
+         * - SHA256 hash (64 hex chars) → Returns exact immutable version
+         *
+         * Authorization is handled in the handler after resolving the reference to a skill ID.
+         * (Input doesn't contain skill ID, so proto-level auth cannot work)
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getByReference
+         */
+        getByReference: {
+            name: "getByReference",
+            I: ApiResourceReference,
+            O: Skill,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Download skill artifact from storage by its storage key.
+         * Returns the ZIP file containing SKILL.md and implementation files.
+         *
+         * This endpoint is used by the agent-runner to download and extract
+         * skill artifacts into the sandbox at /bin/skills/{version_hash}/.
+         *
+         * Authorization is skipped as the storage key itself acts as a capability token.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getArtifact
+         */
+        getArtifact: {
+            name: "getArtifact",
+            I: GetArtifactRequest,
+            O: GetArtifactResponse,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=query_connect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oHAAoH;AACpH,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,kDAAkD;IAC5D,OAAO,EAAE;QACP;;;;WAIG;QACH,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;WAYG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;WAUG;QACH,WAAW,EAAE;YACX,IAAI,EAAE,aAAa;YACnB,CAAC,EAAE,kBAAkB;YACrB,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -0,0 +1,59 @@
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { SkillSchema } from "./api_pb";
+import type { GetArtifactRequestSchema, GetArtifactResponseSchema, SkillIdSchema } from "./io_pb";
+import type { ApiResourceReferenceSchema } from "../../../commons/apiresource/io_pb";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/query.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_query: GenFile;
+/**
+ * SkillQueryController handles read operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillQueryController
+ */
+export declare const SkillQueryController: GenService<{
+    /**
+     * Get a single skill by ID.
+     *
+     * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.get
+     */
+    get: {
+        methodKind: "unary";
+        input: typeof SkillIdSchema;
+        output: typeof SkillSchema;
+    };
+    /**
+     * Get a skill by API resource reference with version support.
+     *
+     * Version resolution (via ApiResourceReference.version field):
+     * - Empty/"latest" → Returns current version from main collection
+     * - Tag name (e.g., "stable", "v1.0") → Resolves to version with this tag
+     * - SHA256 hash (64 hex chars) → Returns exact immutable version
+     *
+     * Authorization is handled in the handler after resolving the reference to a skill ID.
+     * (Input doesn't contain skill ID, so proto-level auth cannot work)
+     *
+     * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getByReference
+     */
+    getByReference: {
+        methodKind: "unary";
+        input: typeof ApiResourceReferenceSchema;
+        output: typeof SkillSchema;
+    };
+    /**
+     * Download skill artifact from storage by its storage key.
+     * Returns the ZIP file containing SKILL.md and implementation files.
+     *
+     * This endpoint is used by the agent-runner to download and extract
+     * skill artifacts into the sandbox at /bin/skills/{version_hash}/.
+     *
+     * Authorization is skipped as the storage key itself acts as a capability token.
+     *
+     * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getArtifact
+     */
+    getArtifact: {
+        methodKind: "unary";
+        input: typeof GetArtifactRequestSchema;
+        output: typeof GetArtifactResponseSchema;
+    };
+}>;

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

@@ -0,0 +1,20 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/query.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_io } from "../../../commons/apiresource/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/query.proto.
+ */
+export const file_ai_stigmer_agentic_skill_v1_query = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvcXVlcnkucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MTKDAwoUU2tpbGxRdWVyeUNvbnRyb2xsZXISewoDZ2V0EiQuYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlNraWxsSWQaIi5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGwiKsK4GCYIAxArIgV2YWx1ZSoZdW5hdXRob3JpemVkIHRvIGdldCBza2lsbBJwCg5nZXRCeVJlZmVyZW5jZRI0LmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZVJlZmVyZW5jZRoiLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Ta2lsbCIE0LgYARJ2CgtnZXRBcnRpZmFjdBIvLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5HZXRBcnRpZmFjdFJlcXVlc3QaMC5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuR2V0QXJ0aWZhY3RSZXNwb25zZSIE0LgYARoEoP8rK2IGcHJvdG8z", [file_ai_stigmer_agentic_skill_v1_api, file_ai_stigmer_agentic_skill_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
+/**
+ * SkillQueryController handles read operations for skills.
+ *
+ * @generated from service ai.stigmer.agentic.skill.v1.SkillQueryController
+ */
+export const SkillQueryController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_skill_v1_query, 0);
+//# sourceMappingURL=query_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/query_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oHAAoH;AACpH,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;AAE9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,knBAAknB,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/2B;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GA6C5B,aAAa,CAChB,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,59 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/spec.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_spec: GenFile;
+/**
+ * SkillSpec defines the stored desired state of a skill.
+ * All fields are extracted from the skill artifact by the backend.
+ * This follows the Kubernetes spec pattern - contains user's desired state.
+ *
+ * Note: Source/provenance information is NOT stored here - it's in SkillStatus
+ * as GitProvenance (observed state). See synth.proto for SDK input structure.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.SkillSpec
+ */
+export type SkillSpec = Message<"ai.stigmer.agentic.skill.v1.SkillSpec"> & {
+    /**
+     * SKILL.md content extracted from the artifact.
+     * Contains the skill's interface definition, documentation, usage examples,
+     * and tool descriptions. This content is injected into agent prompts.
+     *
+     * @generated from field: string skill_md = 1;
+     */
+    skillMd: string;
+    /**
+     * Optional user-provided tag for this skill version.
+     * Tags are mutable pointers that can be updated to reference new versions.
+     * Examples: "stable", "v1.0", "beta", "latest"
+     * If not provided, the version will only be accessible via its immutable hash.
+     *
+     * @generated from field: string tag = 2;
+     */
+    tag: string;
+    /**
+     * Skill name extracted from SKILL.md YAML frontmatter.
+     * This is the canonical name used for identification and references.
+     * Must be kebab-case: lowercase letters, numbers, and hyphens only.
+     * Examples: "calculator", "web-scraper", "math-utils"
+     *
+     * @generated from field: string name = 3;
+     */
+    name: string;
+    /**
+     * Human-readable description extracted from SKILL.md YAML frontmatter.
+     * Provides a concise summary of what this skill does for marketplace display
+     * and system prompt injection into AI agents.
+     * Should be 1-2 sentences, ideally under 100 tokens for prompt efficiency.
+     * Example: "Extracts text and tables from PDF files using OCR when needed"
+     *
+     * @generated from field: string description = 5;
+     */
+    description: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillSpec.
+ * Use `create(SkillSpecSchema)` to create a new message.
+ */
+export declare const SkillSpecSchema: GenMessage<SkillSpec>;

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

@@ -0,0 +1,15 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/spec.proto (package ai.stigmer.agentic.skill.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/skill/v1/spec.proto.
+ */
+export const file_ai_stigmer_agentic_skill_v1_spec = /*@__PURE__*/ fileDesc("CiZhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvc3BlYy5wcm90bxIbYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxIpoBCglTa2lsbFNwZWMSGQoIc2tpbGxfbWQYASABKAlCB7pIBHICEAESKAoDdGFnGAIgASgJQhu6SBhyFjIUXiR8XlthLXpBLVowLTkuXy1dKyQSLQoEbmFtZRgDIAEoCUIfukgcchoyGF5bYS16MC05XSsoLVthLXowLTldKykqJBITCgtkZXNjcmlwdGlvbhgFIAEoCUoECAQQBWIGcHJvdG8z", [file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillSpec.
+ * Use `create(SkillSpecSchema)` to create a new message.
+ */
+export const SkillSpecSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_spec, 0);
+//# sourceMappingURL=spec_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mHAAmH;AACnH,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,qCAAqC,GAAY,aAAa,CACzE,QAAQ,CAAC,0TAA0T,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAsDrW;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,aAAa,CACjE,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,146 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { ApiResourceAudit } from "../../../commons/apiresource/status_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/status.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_status: GenFile;
+/**
+ * SkillStatus represents the system-managed state of a skill.
+ * This represents observed state managed by the system.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.SkillStatus
+ */
+export type SkillStatus = Message<"ai.stigmer.agentic.skill.v1.SkillStatus"> & {
+    /**
+     * Standard audit information tracking creation and modification.
+     * Field 99 follows Stigmer convention for audit placement.
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAudit audit = 99;
+     */
+    audit?: ApiResourceAudit;
+    /**
+     * SHA256 hash of the skill artifact Zip file.
+     * This is the content fingerprint and serves as the immutable version identifier.
+     * Calculated by the system from the uploaded artifact.
+     *
+     * @generated from field: string version_hash = 1;
+     */
+    versionHash: string;
+    /**
+     * Storage location key for the skill artifact.
+     * Format varies based on storage backend:
+     * - Local: "<hash>.zip"
+     * - Cloud: "skills/<slug>_<hash>.zip"
+     * This is determined by the system based on storage configuration.
+     *
+     * @generated from field: string artifact_storage_key = 2;
+     */
+    artifactStorageKey: string;
+    /**
+     * Current lifecycle state of the skill.
+     *
+     * @generated from field: ai.stigmer.agentic.skill.v1.SkillState state = 3;
+     */
+    state: SkillState;
+    /**
+     * Git provenance tracking where the skill artifacts originated from.
+     * Populated by CLI during push, provides traceability and enables
+     * "view on GitHub" links and reproducible deployments.
+     * Absent when pushed from a non-git directory.
+     *
+     * @generated from field: ai.stigmer.agentic.skill.v1.GitProvenance git_provenance = 4;
+     */
+    gitProvenance?: GitProvenance;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillStatus.
+ * Use `create(SkillStatusSchema)` to create a new message.
+ */
+export declare const SkillStatusSchema: GenMessage<SkillStatus>;
+/**
+ * GitProvenance tracks the git origin of skill artifacts.
+ * This is system-detected metadata, not user-specified configuration.
+ * Populated by CLI during push based on:
+ * - Local push: auto-detected from directory's git context
+ * - Git push: resolved from user-provided URL/ref
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.GitProvenance
+ */
+export type GitProvenance = Message<"ai.stigmer.agentic.skill.v1.GitProvenance"> & {
+    /**
+     * Git remote URL.
+     * For local push: detected "origin" remote URL
+     * For git push: the user-provided repository URL
+     * Example: "https://github.com/stigmer/skills.git"
+     *
+     * @generated from field: string remote_url = 1;
+     */
+    remoteUrl: string;
+    /**
+     * Original git reference (for display purposes).
+     * For local push: detected branch name (e.g., "main") or empty if detached HEAD
+     * For git push: the user-provided ref (e.g., "v1.0.0", "main")
+     * This preserves user intent for display while commit provides immutability.
+     *
+     * @generated from field: string ref = 2;
+     */
+    ref: string;
+    /**
+     * Resolved commit SHA (for reproducibility).
+     * Always populated - this is the immutable version reference.
+     * Full 40-character SHA ensures exact reproducibility.
+     * Example: "abc123def456789012345678901234567890abcd"
+     *
+     * @generated from field: string commit = 3;
+     */
+    commit: string;
+    /**
+     * Subdirectory path relative to repo root.
+     * Empty if skill is at repo root.
+     * Example: "skills/calculator"
+     *
+     * @generated from field: string subdir = 4;
+     */
+    subdir: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.GitProvenance.
+ * Use `create(GitProvenanceSchema)` to create a new message.
+ */
+export declare const GitProvenanceSchema: GenMessage<GitProvenance>;
+/**
+ * SkillState represents the lifecycle state of a skill.
+ *
+ * @generated from enum ai.stigmer.agentic.skill.v1.SkillState
+ */
+export declare enum SkillState {
+    /**
+     * Unspecified state (default/invalid).
+     *
+     * @generated from enum value: SKILL_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Skill artifact is being uploaded to storage.
+     *
+     * @generated from enum value: SKILL_STATE_UPLOADING = 1;
+     */
+    UPLOADING = 1,
+    /**
+     * Skill is ready to be used by agents.
+     *
+     * @generated from enum value: SKILL_STATE_READY = 2;
+     */
+    READY = 2,
+    /**
+     * Skill upload or processing failed.
+     *
+     * @generated from enum value: SKILL_STATE_FAILED = 3;
+     */
+    FAILED = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.skill.v1.SkillState.
+ */
+export declare const SkillStateSchema: GenEnum<SkillState>;

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

@@ -0,0 +1,57 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/status.proto (package ai.stigmer.agentic.skill.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_buf_validate_validate } from "../../../../../buf/validate/validate_pb";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/status.proto.
+ */
+export const file_ai_stigmer_agentic_skill_v1_status = /*@__PURE__*/ fileDesc("CihhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvc3RhdHVzLnByb3RvEhthaS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEilQIKC1NraWxsU3RhdHVzEj8KBWF1ZGl0GGMgASgLMjAuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlQXVkaXQSKwoMdmVyc2lvbl9oYXNoGAEgASgJQhW6SBJyEDIOXlthLWYwLTldezY0fSQSHAoUYXJ0aWZhY3Rfc3RvcmFnZV9rZXkYAiABKAkSNgoFc3RhdGUYAyABKA4yJy5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGxTdGF0ZRJCCg5naXRfcHJvdmVuYW5jZRgEIAEoCzIqLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5HaXRQcm92ZW5hbmNlImIKDUdpdFByb3ZlbmFuY2USGwoKcmVtb3RlX3VybBgBIAEoCUIHukgEcgIQARILCgNyZWYYAiABKAkSFwoGY29tbWl0GAMgASgJQge6SARyAhABEg4KBnN1YmRpchgEIAEoCSpzCgpTa2lsbFN0YXRlEhsKF1NLSUxMX1NUQVRFX1VOU1BFQ0lGSUVEEAASGQoVU0tJTExfU1RBVEVfVVBMT0FESU5HEAESFQoRU0tJTExfU1RBVEVfUkVBRFkQAhIWChJTS0lMTF9TVEFURV9GQUlMRUQQA2IGcHJvdG8z", [file_ai_stigmer_commons_apiresource_status, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillStatus.
+ * Use `create(SkillStatusSchema)` to create a new message.
+ */
+export const SkillStatusSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_status, 0);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.GitProvenance.
+ * Use `create(GitProvenanceSchema)` to create a new message.
+ */
+export const GitProvenanceSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_status, 1);
+/**
+ * SkillState represents the lifecycle state of a skill.
+ *
+ * @generated from enum ai.stigmer.agentic.skill.v1.SkillState
+ */
+export var SkillState;
+(function (SkillState) {
+    /**
+     * Unspecified state (default/invalid).
+     *
+     * @generated from enum value: SKILL_STATE_UNSPECIFIED = 0;
+     */
+    SkillState[SkillState["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Skill artifact is being uploaded to storage.
+     *
+     * @generated from enum value: SKILL_STATE_UPLOADING = 1;
+     */
+    SkillState[SkillState["UPLOADING"] = 1] = "UPLOADING";
+    /**
+     * Skill is ready to be used by agents.
+     *
+     * @generated from enum value: SKILL_STATE_READY = 2;
+     */
+    SkillState[SkillState["READY"] = 2] = "READY";
+    /**
+     * Skill upload or processing failed.
+     *
+     * @generated from enum value: SKILL_STATE_FAILED = 3;
+     */
+    SkillState[SkillState["FAILED"] = 3] = "FAILED";
+})(SkillState || (SkillState = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.skill.v1.SkillState.
+ */
+export const SkillStateSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_skill_v1_status, 0);
+//# sourceMappingURL=status_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/status_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qHAAqH;AACrH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,kwBAAkwB,EAAE,CAAC,0CAA0C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAuDz1B;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAoD1D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAN,IAAY,UA4BX;AA5BD,WAAY,UAAU;IACpB;;;;OAIG;IACH,yDAAe,CAAA;IAEf;;;;OAIG;IACH,qDAAa,CAAA;IAEb;;;;OAIG;IACH,6CAAS,CAAA;IAET;;;;OAIG;IACH,+CAAU,CAAA;AACZ,CAAC,EA5BW,UAAU,KAAV,UAAU,QA4BrB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,aAAa,CAChE,QAAQ,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,125 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/synth.proto.
+ */
+export declare const file_ai_stigmer_agentic_skill_v1_synth: GenFile;
+/**
+ * SkillSynth defines the input for SDK-to-CLI skill handover.
+ * SDK synthesizes this to .stigmer/skill-N.pb, CLI reads and processes it.
+ *
+ * This is NOT the stored SkillSpec - it's input for creating the spec.
+ * CLI reads this, fetches content from source, and calls PushSkillRequest.
+ *
+ * Flow:
+ *   1. SDK: skill.FromDir(ctx, "./calculator") or skill.FromGit(ctx, "github.com/org/skills")
+ *   2. SDK: Writes SkillSynth to .stigmer/skill-N.pb
+ *   3. CLI: Reads SkillSynth, fetches content, creates artifact ZIP
+ *   4. CLI: Detects git provenance, calls PushSkillRequest
+ *   5. Backend: Extracts SKILL.md, stores SkillSpec + SkillStatus
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.SkillSynth
+ */
+export type SkillSynth = Message<"ai.stigmer.agentic.skill.v1.SkillSynth"> & {
+    /**
+     * Source location of the skill artifacts.
+     *
+     * @generated from oneof ai.stigmer.agentic.skill.v1.SkillSynth.source
+     */
+    source: {
+        /**
+         * Local directory containing SKILL.md
+         *
+         * @generated from field: ai.stigmer.agentic.skill.v1.LocalDir local = 1;
+         */
+        value: LocalDir;
+        case: "local";
+    } | {
+        /**
+         * Remote git repository containing SKILL.md
+         *
+         * @generated from field: ai.stigmer.agentic.skill.v1.Git git = 2;
+         */
+        value: Git;
+        case: "git";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * Optional version tag for this skill.
+     * Tags are mutable pointers that can be updated to reference new versions.
+     * Examples: "stable", "v1.0", "beta", "latest"
+     * If not provided, the version will only be accessible via its immutable hash.
+     *
+     * @generated from field: string tag = 3;
+     */
+    tag: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillSynth.
+ * Use `create(SkillSynthSchema)` to create a new message.
+ */
+export declare const SkillSynthSchema: GenMessage<SkillSynth>;
+/**
+ * LocalDir points to a local directory containing SKILL.md.
+ * CLI will read this directory, create a ZIP artifact, and auto-detect
+ * git provenance if the directory is within a git repository.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.LocalDir
+ */
+export type LocalDir = Message<"ai.stigmer.agentic.skill.v1.LocalDir"> & {
+    /**
+     * Path to the skill directory (relative to SDK project root or absolute).
+     * The directory must contain a SKILL.md file.
+     * Relative paths are resolved from the directory containing main.go.
+     * Examples: "./skills/calculator", "../shared-skills/web-search", "/home/user/my-skill"
+     *
+     * @generated from field: string path = 1;
+     */
+    path: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.LocalDir.
+ * Use `create(LocalDirSchema)` to create a new message.
+ */
+export declare const LocalDirSchema: GenMessage<LocalDir>;
+/**
+ * Git points to a git repository containing SKILL.md.
+ * CLI will clone the repository, checkout the specified ref, and create
+ * a ZIP artifact from the specified subdirectory.
+ *
+ * @generated from message ai.stigmer.agentic.skill.v1.Git
+ */
+export type Git = Message<"ai.stigmer.agentic.skill.v1.Git"> & {
+    /**
+     * Git repository URL (HTTPS or SSH).
+     * CLI uses locally configured git credentials for authentication.
+     * Examples: "https://github.com/stigmer/skills.git", "git@github.com:stigmer/skills.git"
+     *
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * Git reference - tag, branch name, or commit SHA.
+     * If empty, defaults to the repository's default branch (usually "main").
+     * CLI resolves this to a commit SHA for provenance tracking.
+     * Examples: "v1.0.0", "main", "feature/new-skill", "abc123def456..."
+     *
+     * @generated from field: string ref = 2;
+     */
+    ref: string;
+    /**
+     * Subdirectory within the repository containing SKILL.md.
+     * If empty, SKILL.md is expected at the repository root.
+     * Example: "skills/calculator"
+     *
+     * @generated from field: string subdir = 3;
+     */
+    subdir: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.Git.
+ * Use `create(GitSchema)` to create a new message.
+ */
+export declare const GitSchema: GenMessage<Git>;

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

@@ -0,0 +1,24 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/skill/v1/synth.proto (package ai.stigmer.agentic.skill.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/skill/v1/synth.proto.
+ */
+export const file_ai_stigmer_agentic_skill_v1_synth = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvc3ludGgucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MSKMAQoKU2tpbGxTeW50aBI2CgVsb2NhbBgBIAEoCzIlLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Mb2NhbERpckgAEi8KA2dpdBgCIAEoCzIgLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5HaXRIABILCgN0YWcYAyABKAlCCAoGc291cmNlIhgKCExvY2FsRGlyEgwKBHBhdGgYASABKAkiLwoDR2l0EgsKA3VybBgBIAEoCRILCgNyZWYYAiABKAkSDgoGc3ViZGlyGAMgASgJYgZwcm90bzM");
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.SkillSynth.
+ * Use `create(SkillSynthSchema)` to create a new message.
+ */
+export const SkillSynthSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_synth, 0);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.LocalDir.
+ * Use `create(LocalDirSchema)` to create a new message.
+ */
+export const LocalDirSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_synth, 1);
+/**
+ * Describes the message ai.stigmer.agentic.skill.v1.Git.
+ * Use `create(GitSchema)` to create a new message.
+ */
+export const GitSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_skill_v1_synth, 2);
+//# sourceMappingURL=synth_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"synth_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/synth_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oHAAoH;AACpH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,6YAA6Y,CAAC,CAAC;AAqD1Z;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B,aAAa,CACnE,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AAqBzD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,aAAa,CAC/D,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AAuCzD;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB,aAAa,CACrD,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}