@stigmer/protos 0.0.91 → 0.0.93

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

@@ -0,0 +1,204 @@
+// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/runner/v1/command.proto (package ai.stigmer.agentic.runner.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { MethodKind } from "@bufbuild/protobuf";
+/**
+ * RunnerCommandController handles write operations and the bidirectional
+ * command stream for runners.
+ *
+ * Two creation patterns are supported:
+ *
+ * 1. **CLI/Desktop (persistent runners)**: The client calls apply with a slug
+ *    stored in ~/.stigmer/runner.json. If the runner exists, it reactivates.
+ *    If not, it creates. This is the primary registration path.
+ *
+ * 2. **Platform (ephemeral runners)**: The execution workflow calls create
+ *    with metadata label stigmer.ai/system-managed: "true". The runner is
+ *    torn down via delete when the execution completes.
+ *
+ * After registration, the runner opens the connect bidi stream — its only
+ * ongoing communication channel with the server. Heartbeats flow runner to
+ * server; commands (e.g., ListDirectory) flow server to runner.
+ *
+ * @generated from service ai.stigmer.agentic.runner.v1.RunnerCommandController
+ */
+export const RunnerCommandController = {
+    typeName: "ai.stigmer.agentic.runner.v1.RunnerCommandController",
+    methods: {
+        /**
+         * Create or update a runner.
+         *
+         * @internal
+         * Primary registration path for CLI/Desktop runners. The handler determines
+         * whether to create or update based on whether the resource already exists
+         * (resolved by org + slug). Authorization is handled in the handler.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.apply
+         */
+        apply: {
+            name: "apply",
+            I: Runner,
+            O: Runner,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Create a new runner.
+         *
+         * @internal
+         * Authorization: Caller must have can_create_runner permission in the
+         * organization. The server generates the task queue name (runner:{id})
+         * and sets the initial phase to PENDING.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.create
+         */
+        create: {
+            name: "create",
+            I: Runner,
+            O: Runner,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Update an existing runner.
+         *
+         * @internal
+         * Used for updating spec fields (e.g., description). Status fields are
+         * updated via the connect stream heartbeat, not via this RPC.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.update
+         */
+        update: {
+            name: "update",
+            I: Runner,
+            O: Runner,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Delete a runner.
+         *
+         * @internal
+         * For persistent runners: removes the resource and its task queue.
+         * For system-managed runners: called by the execution workflow during
+         * cleanup after the execution completes.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.delete
+         */
+        delete: {
+            name: "delete",
+            I: RunnerId,
+            O: Runner,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Send a command to a connected runner and return the response synchronously.
+         *
+         * This is the API entry point for UI-triggered runner commands. The server
+         * looks up the runner's active bidi stream, pushes the command, and blocks
+         * until the runner responds or the timeout (10s) expires.
+         *
+         * Requires an active connect stream — returns UNAVAILABLE if the runner
+         * is not connected. Returns FAILED_PRECONDITION if the runner's phase
+         * prevents command delivery (STOPPED, PENDING, FAILED).
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.sendCommand
+         */
+        sendCommand: {
+            name: "sendCommand",
+            I: RunnerSendCommandInput,
+            O: RunnerCommandResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Stop a running runner gracefully.
+         *
+         * If the runner is connected: sends a StopRunnerRequest via the bidi
+         * stream, waits for acknowledgment, then returns the updated Runner.
+         * The runner will send a STOPPED heartbeat and close its stream after
+         * acknowledging — the phase transition completes asynchronously.
+         *
+         * If the runner is not connected (offline, already stopped): directly
+         * transitions the runner to STOPPED and returns the updated resource.
+         *
+         * Idempotent: stopping an already-STOPPED or FAILED runner returns the
+         * resource as-is without error.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.stop
+         */
+        stop: {
+            name: "stop",
+            I: RunnerStopInput,
+            O: Runner,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Establish a bidirectional command stream between the runner and the server.
+         *
+         * This is the runner's primary ongoing communication channel. The runner
+         * pushes heartbeats (liveness + state); the server pushes commands
+         * (e.g., ListDirectory for workspace browsing). Both directions use the
+         * same open connection.
+         *
+         * Stream lifecycle:
+         *   1. Runner calls apply to register/reactivate, then opens this stream.
+         *   2. First message MUST be a RunnerHeartbeat (authenticates via runner_id).
+         *   3. Runner sends heartbeats every 30s.
+         *   4. Server pushes RunnerCommandRequest when the UI triggers an operation.
+         *   5. Runner handles commands locally and sends RunnerCommandResponse.
+         *   6. On graceful shutdown: runner sends phase=STOPPED heartbeat, closes stream.
+         *   7. On disconnect: server starts heartbeat timeout (90s) -> STOPPED.
+         *
+         * @internal
+         * Authorization is handled via the first heartbeat message: the server
+         * looks up the runner_id and verifies ownership. Skipped at the interceptor
+         * level because the stream input is not a resource type.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.connect
+         */
+        connect: {
+            name: "connect",
+            I: RunnerStreamClientMessage,
+            O: RunnerStreamServerMessage,
+            kind: MethodKind.BiDiStreaming,
+        },
+        /**
+         * Create a one-time launch token for the browser-to-CLI runner handshake.
+         *
+         * Called by the web console when the user clicks "Launch Local Runner."
+         * The server mints a Stigmer JWT for the caller, wraps it in an opaque
+         * token stored in Redis (60s TTL, single-use), and returns the token for
+         * the browser to embed in a stigmer:// URL.
+         *
+         * The caller must have can_create_runner permission in the organization —
+         * if you can create a runner, you can create a launch token.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.createLaunchToken
+         */
+        createLaunchToken: {
+            name: "createLaunchToken",
+            I: CreateLaunchTokenRequest,
+            O: CreateLaunchTokenResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Exchange a one-time launch token for long-lived runner credentials.
+         *
+         * Called by the CLI (or Desktop app) after receiving a stigmer:// URL from
+         * the OS. The token is consumed atomically — a second exchange attempt
+         * returns NOT_FOUND.
+         *
+         * @internal
+         * This RPC is public — no Bearer token is required. The one-time launch
+         * token IS the proof of authorization: it was created by an authenticated
+         * user with can_create_runner permission, and can only be used once.
+         *
+         * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.exchangeLaunchToken
+         */
+        exchangeLaunchToken: {
+            name: "exchangeLaunchToken",
+            I: ExchangeLaunchTokenRequest,
+            O: ExchangeLaunchTokenResponse,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=command_connect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/runner/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wHAAwH;AACxH,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,sDAAsD;IAChE,OAAO,EAAE;QACP;;;;;;;;;WASG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;WASG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;WASG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;WAYG;QACH,WAAW,EAAE;YACX,IAAI,EAAE,aAAa;YACnB,CAAC,EAAE,sBAAsB;YACzB,CAAC,EAAE,qBAAqB;YACxB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;WAeG;QACH,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,eAAe;YAClB,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;WAuBG;QACH,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,CAAC,EAAE,yBAAyB;YAC5B,CAAC,EAAE,yBAAyB;YAC5B,IAAI,EAAE,UAAU,CAAC,aAAa;SAC/B;QACD;;;;;;;;;;;;WAYG;QACH,iBAAiB,EAAE;YACjB,IAAI,EAAE,mBAAmB;YACzB,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,yBAAyB;YAC5B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;WAaG;QACH,mBAAmB,EAAE;YACnB,IAAI,EAAE,qBAAqB;YAC3B,CAAC,EAAE,0BAA0B;YAC7B,CAAC,EAAE,2BAA2B;YAC9B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -0,0 +1,193 @@
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { RunnerSchema } from "./api_pb";
+import type { CreateLaunchTokenRequestSchema, CreateLaunchTokenResponseSchema, ExchangeLaunchTokenRequestSchema, ExchangeLaunchTokenResponseSchema, RunnerCommandResponseSchema, RunnerIdSchema, RunnerSendCommandInputSchema, RunnerStopInputSchema, RunnerStreamClientMessageSchema, RunnerStreamServerMessageSchema } from "./io_pb";
+/**
+ * Describes the file ai/stigmer/agentic/runner/v1/command.proto.
+ */
+export declare const file_ai_stigmer_agentic_runner_v1_command: GenFile;
+/**
+ * RunnerCommandController handles write operations and the bidirectional
+ * command stream for runners.
+ *
+ * Two creation patterns are supported:
+ *
+ * 1. **CLI/Desktop (persistent runners)**: The client calls apply with a slug
+ *    stored in ~/.stigmer/runner.json. If the runner exists, it reactivates.
+ *    If not, it creates. This is the primary registration path.
+ *
+ * 2. **Platform (ephemeral runners)**: The execution workflow calls create
+ *    with metadata label stigmer.ai/system-managed: "true". The runner is
+ *    torn down via delete when the execution completes.
+ *
+ * After registration, the runner opens the connect bidi stream — its only
+ * ongoing communication channel with the server. Heartbeats flow runner to
+ * server; commands (e.g., ListDirectory) flow server to runner.
+ *
+ * @generated from service ai.stigmer.agentic.runner.v1.RunnerCommandController
+ */
+export declare const RunnerCommandController: GenService<{
+    /**
+     * Create or update a runner.
+     *
+     * @internal
+     * Primary registration path for CLI/Desktop runners. The handler determines
+     * whether to create or update based on whether the resource already exists
+     * (resolved by org + slug). Authorization is handled in the handler.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.apply
+     */
+    apply: {
+        methodKind: "unary";
+        input: typeof RunnerSchema;
+        output: typeof RunnerSchema;
+    };
+    /**
+     * Create a new runner.
+     *
+     * @internal
+     * Authorization: Caller must have can_create_runner permission in the
+     * organization. The server generates the task queue name (runner:{id})
+     * and sets the initial phase to PENDING.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.create
+     */
+    create: {
+        methodKind: "unary";
+        input: typeof RunnerSchema;
+        output: typeof RunnerSchema;
+    };
+    /**
+     * Update an existing runner.
+     *
+     * @internal
+     * Used for updating spec fields (e.g., description). Status fields are
+     * updated via the connect stream heartbeat, not via this RPC.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.update
+     */
+    update: {
+        methodKind: "unary";
+        input: typeof RunnerSchema;
+        output: typeof RunnerSchema;
+    };
+    /**
+     * Delete a runner.
+     *
+     * @internal
+     * For persistent runners: removes the resource and its task queue.
+     * For system-managed runners: called by the execution workflow during
+     * cleanup after the execution completes.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.delete
+     */
+    delete: {
+        methodKind: "unary";
+        input: typeof RunnerIdSchema;
+        output: typeof RunnerSchema;
+    };
+    /**
+     * Send a command to a connected runner and return the response synchronously.
+     *
+     * This is the API entry point for UI-triggered runner commands. The server
+     * looks up the runner's active bidi stream, pushes the command, and blocks
+     * until the runner responds or the timeout (10s) expires.
+     *
+     * Requires an active connect stream — returns UNAVAILABLE if the runner
+     * is not connected. Returns FAILED_PRECONDITION if the runner's phase
+     * prevents command delivery (STOPPED, PENDING, FAILED).
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.sendCommand
+     */
+    sendCommand: {
+        methodKind: "unary";
+        input: typeof RunnerSendCommandInputSchema;
+        output: typeof RunnerCommandResponseSchema;
+    };
+    /**
+     * Stop a running runner gracefully.
+     *
+     * If the runner is connected: sends a StopRunnerRequest via the bidi
+     * stream, waits for acknowledgment, then returns the updated Runner.
+     * The runner will send a STOPPED heartbeat and close its stream after
+     * acknowledging — the phase transition completes asynchronously.
+     *
+     * If the runner is not connected (offline, already stopped): directly
+     * transitions the runner to STOPPED and returns the updated resource.
+     *
+     * Idempotent: stopping an already-STOPPED or FAILED runner returns the
+     * resource as-is without error.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.stop
+     */
+    stop: {
+        methodKind: "unary";
+        input: typeof RunnerStopInputSchema;
+        output: typeof RunnerSchema;
+    };
+    /**
+     * Establish a bidirectional command stream between the runner and the server.
+     *
+     * This is the runner's primary ongoing communication channel. The runner
+     * pushes heartbeats (liveness + state); the server pushes commands
+     * (e.g., ListDirectory for workspace browsing). Both directions use the
+     * same open connection.
+     *
+     * Stream lifecycle:
+     *   1. Runner calls apply to register/reactivate, then opens this stream.
+     *   2. First message MUST be a RunnerHeartbeat (authenticates via runner_id).
+     *   3. Runner sends heartbeats every 30s.
+     *   4. Server pushes RunnerCommandRequest when the UI triggers an operation.
+     *   5. Runner handles commands locally and sends RunnerCommandResponse.
+     *   6. On graceful shutdown: runner sends phase=STOPPED heartbeat, closes stream.
+     *   7. On disconnect: server starts heartbeat timeout (90s) -> STOPPED.
+     *
+     * @internal
+     * Authorization is handled via the first heartbeat message: the server
+     * looks up the runner_id and verifies ownership. Skipped at the interceptor
+     * level because the stream input is not a resource type.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.connect
+     */
+    connect: {
+        methodKind: "bidi_streaming";
+        input: typeof RunnerStreamClientMessageSchema;
+        output: typeof RunnerStreamServerMessageSchema;
+    };
+    /**
+     * Create a one-time launch token for the browser-to-CLI runner handshake.
+     *
+     * Called by the web console when the user clicks "Launch Local Runner."
+     * The server mints a Stigmer JWT for the caller, wraps it in an opaque
+     * token stored in Redis (60s TTL, single-use), and returns the token for
+     * the browser to embed in a stigmer:// URL.
+     *
+     * The caller must have can_create_runner permission in the organization —
+     * if you can create a runner, you can create a launch token.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.createLaunchToken
+     */
+    createLaunchToken: {
+        methodKind: "unary";
+        input: typeof CreateLaunchTokenRequestSchema;
+        output: typeof CreateLaunchTokenResponseSchema;
+    };
+    /**
+     * Exchange a one-time launch token for long-lived runner credentials.
+     *
+     * Called by the CLI (or Desktop app) after receiving a stigmer:// URL from
+     * the OS. The token is consumed atomically — a second exchange attempt
+     * returns NOT_FOUND.
+     *
+     * @internal
+     * This RPC is public — no Bearer token is required. The one-time launch
+     * token IS the proof of authorization: it was created by an authenticated
+     * user with can_create_runner permission, and can only be used once.
+     *
+     * @generated from rpc ai.stigmer.agentic.runner.v1.RunnerCommandController.exchangeLaunchToken
+     */
+    exchangeLaunchToken: {
+        methodKind: "unary";
+        input: typeof ExchangeLaunchTokenRequestSchema;
+        output: typeof ExchangeLaunchTokenResponseSchema;
+    };
+}>;

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

@@ -0,0 +1,34 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/runner/v1/command.proto (package ai.stigmer.agentic.runner.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_runner_v1_api } from "./api_pb";
+import { file_ai_stigmer_agentic_runner_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_commons_rpc_method_options } from "../../../commons/rpc/method_options_pb";
+/**
+ * Describes the file ai/stigmer/agentic/runner/v1/command.proto.
+ */
+export const file_ai_stigmer_agentic_runner_v1_command = /*@__PURE__*/ fileDesc("CiphaS9zdGlnbWVyL2FnZW50aWMvcnVubmVyL3YxL2NvbW1hbmQucHJvdG8SHGFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEy8woKF1J1bm5lckNvbW1hbmRDb250cm9sbGVyElMKBWFwcGx5EiQuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5SdW5uZXIaJC5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lchKgAQoGY3JlYXRlEiQuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5SdW5uZXIaJC5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lciJKwrgYRggZEB4iDG1ldGFkYXRhLm9yZyoydW5hdXRob3JpemVkIHRvIGNyZWF0ZSBydW5uZXIgaW4gdGhpcyBvcmdhbml6YXRpb24SigEKBnVwZGF0ZRIkLmFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEuUnVubmVyGiQuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5SdW5uZXIiNMK4GDAIAhAuIgttZXRhZGF0YS5pZCoddW5hdXRob3JpemVkIHRvIHVwZGF0ZSBydW5uZXIShgEKBmRlbGV0ZRImLmFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEuUnVubmVySWQaJC5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lciIuwrgYKggDEC4iBXZhbHVlKh11bmF1dGhvcml6ZWQgdG8gZGVsZXRlIHJ1bm5lchK7AQoLc2VuZENvbW1hbmQSNC5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lclNlbmRDb21tYW5kSW5wdXQaMy5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lckNvbW1hbmRSZXNwb25zZSJBwrgYPQgBEC4iCXJ1bm5lcl9pZCosdW5hdXRob3JpemVkIHRvIHNlbmQgY29tbWFuZHMgdG8gdGhpcyBydW5uZXISkgEKBHN0b3ASLS5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lclN0b3BJbnB1dBokLmFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEuUnVubmVyIjXCuBgxCAIQLiIJcnVubmVyX2lkKiB1bmF1dGhvcml6ZWQgdG8gc3RvcCB0aGlzIHJ1bm5lchKFAQoHY29ubmVjdBI3LmFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEuUnVubmVyU3RyZWFtQ2xpZW50TWVzc2FnZRo3LmFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEuUnVubmVyU3RyZWFtU2VydmVyTWVzc2FnZSIE0LgYASgBMAES1QEKEWNyZWF0ZUxhdW5jaFRva2VuEjYuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5DcmVhdGVMYXVuY2hUb2tlblJlcXVlc3QaNy5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLkNyZWF0ZUxhdW5jaFRva2VuUmVzcG9uc2UiT8K4GEsIGRAeIgNvcmcqQHVuYXV0aG9yaXplZCB0byBjcmVhdGUgcnVubmVyIGxhdW5jaCB0b2tlbnMgaW4gdGhpcyBvcmdhbml6YXRpb24SkAEKE2V4Y2hhbmdlTGF1bmNoVG9rZW4SOC5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLkV4Y2hhbmdlTGF1bmNoVG9rZW5SZXF1ZXN0GjkuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5FeGNoYW5nZUxhdW5jaFRva2VuUmVzcG9uc2UiBMi4GAEaBKD/Ky5iBnByb3RvMw", [file_ai_stigmer_agentic_runner_v1_api, file_ai_stigmer_agentic_runner_v1_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
+/**
+ * RunnerCommandController handles write operations and the bidirectional
+ * command stream for runners.
+ *
+ * Two creation patterns are supported:
+ *
+ * 1. **CLI/Desktop (persistent runners)**: The client calls apply with a slug
+ *    stored in ~/.stigmer/runner.json. If the runner exists, it reactivates.
+ *    If not, it creates. This is the primary registration path.
+ *
+ * 2. **Platform (ephemeral runners)**: The execution workflow calls create
+ *    with metadata label stigmer.ai/system-managed: "true". The runner is
+ *    torn down via delete when the execution completes.
+ *
+ * After registration, the runner opens the connect bidi stream — its only
+ * ongoing communication channel with the server. Heartbeats flow runner to
+ * server; commands (e.g., ListDirectory) flow server to runner.
+ *
+ * @generated from service ai.stigmer.agentic.runner.v1.RunnerCommandController
+ */
+export const RunnerCommandController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_runner_v1_command, 0);
+//# sourceMappingURL=command_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/runner/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wHAAwH;AACxH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qCAAqC,EAAE,MAAM,UAAU,CAAC;AAEjE,OAAO,EAAE,oCAAoC,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AAEpG;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAY,aAAa,CAC7E,QAAQ,CAAC,w7DAAw7D,EAAE,CAAC,qCAAqC,EAAE,oCAAoC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAEznE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAqK/B,aAAa,CAChB,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/runner/v1/enum_pb.d.ts

@@ -0,0 +1,69 @@
+import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/runner/v1/enum.proto.
+ */
+export declare const file_ai_stigmer_agentic_runner_v1_enum: GenFile;
+/**
+ * RunnerPhase tracks the operational state of a runner process.
+ *
+ * Phase transitions are driven by two sources:
+ * - The runner process itself (via connect stream heartbeat): PENDING -> READY, READY <-> BUSY
+ * - The server (via heartbeat timeout or explicit stop): any -> STOPPED, any -> FAILED
+ *
+ * Transition diagram:
+ *   PENDING  -> READY   (first heartbeat received)
+ *   READY    -> BUSY    (runner reports max capacity reached)
+ *   BUSY     -> READY   (runner reports capacity freed)
+ *   READY    -> STOPPED (heartbeat timeout or explicit stop)
+ *   BUSY     -> STOPPED (heartbeat timeout or explicit stop)
+ *   STOPPED  -> READY   (runner restarts and heartbeats again)
+ *   any      -> FAILED  (unrecoverable error reported by runner or server)
+ *
+ * @generated from enum ai.stigmer.agentic.runner.v1.RunnerPhase
+ */
+export declare enum RunnerPhase {
+    /**
+     * @generated from enum value: RUNNER_PHASE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Resource created but no heartbeat received yet.
+     * This is the initial phase after create/apply, before the runner
+     * process has started polling its task queue and heartbeating.
+     *
+     * @generated from enum value: RUNNER_PHASE_PENDING = 1;
+     */
+    PENDING = 1,
+    /**
+     * Runner is heartbeating and accepting new executions.
+     *
+     * @generated from enum value: RUNNER_PHASE_READY = 2;
+     */
+    READY = 2,
+    /**
+     * Runner is heartbeating but at maximum concurrent execution capacity.
+     * New executions should not be dispatched to this runner.
+     *
+     * @generated from enum value: RUNNER_PHASE_BUSY = 3;
+     */
+    BUSY = 3,
+    /**
+     * Runner has stopped heartbeating (timeout) or was explicitly stopped.
+     * The resource is retained for identity persistence — a runner that
+     * restarts and resumes heartbeating transitions back to READY.
+     *
+     * @generated from enum value: RUNNER_PHASE_STOPPED = 4;
+     */
+    STOPPED = 4,
+    /**
+     * Unrecoverable error. Runner or server reported a fatal condition.
+     * Requires investigation; does not auto-recover on heartbeat.
+     *
+     * @generated from enum value: RUNNER_PHASE_FAILED = 5;
+     */
+    FAILED = 5
+}
+/**
+ * Describes the enum ai.stigmer.agentic.runner.v1.RunnerPhase.
+ */
+export declare const RunnerPhaseSchema: GenEnum<RunnerPhase>;

package/ai/stigmer/agentic/runner/v1/enum_pb.js

@@ -0,0 +1,74 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/runner/v1/enum.proto (package ai.stigmer.agentic.runner.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/runner/v1/enum.proto.
+ */
+export const file_ai_stigmer_agentic_runner_v1_enum = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvcnVubmVyL3YxL2VudW0ucHJvdG8SHGFpLnN0aWdtZXIuYWdlbnRpYy5ydW5uZXIudjEqpwEKC1J1bm5lclBoYXNlEhwKGFJVTk5FUl9QSEFTRV9VTlNQRUNJRklFRBAAEhgKFFJVTk5FUl9QSEFTRV9QRU5ESU5HEAESFgoSUlVOTkVSX1BIQVNFX1JFQURZEAISFQoRUlVOTkVSX1BIQVNFX0JVU1kQAxIYChRSVU5ORVJfUEhBU0VfU1RPUFBFRBAEEhcKE1JVTk5FUl9QSEFTRV9GQUlMRUQQBWIGcHJvdG8z");
+/**
+ * RunnerPhase tracks the operational state of a runner process.
+ *
+ * Phase transitions are driven by two sources:
+ * - The runner process itself (via connect stream heartbeat): PENDING -> READY, READY <-> BUSY
+ * - The server (via heartbeat timeout or explicit stop): any -> STOPPED, any -> FAILED
+ *
+ * Transition diagram:
+ *   PENDING  -> READY   (first heartbeat received)
+ *   READY    -> BUSY    (runner reports max capacity reached)
+ *   BUSY     -> READY   (runner reports capacity freed)
+ *   READY    -> STOPPED (heartbeat timeout or explicit stop)
+ *   BUSY     -> STOPPED (heartbeat timeout or explicit stop)
+ *   STOPPED  -> READY   (runner restarts and heartbeats again)
+ *   any      -> FAILED  (unrecoverable error reported by runner or server)
+ *
+ * @generated from enum ai.stigmer.agentic.runner.v1.RunnerPhase
+ */
+export var RunnerPhase;
+(function (RunnerPhase) {
+    /**
+     * @generated from enum value: RUNNER_PHASE_UNSPECIFIED = 0;
+     */
+    RunnerPhase[RunnerPhase["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Resource created but no heartbeat received yet.
+     * This is the initial phase after create/apply, before the runner
+     * process has started polling its task queue and heartbeating.
+     *
+     * @generated from enum value: RUNNER_PHASE_PENDING = 1;
+     */
+    RunnerPhase[RunnerPhase["PENDING"] = 1] = "PENDING";
+    /**
+     * Runner is heartbeating and accepting new executions.
+     *
+     * @generated from enum value: RUNNER_PHASE_READY = 2;
+     */
+    RunnerPhase[RunnerPhase["READY"] = 2] = "READY";
+    /**
+     * Runner is heartbeating but at maximum concurrent execution capacity.
+     * New executions should not be dispatched to this runner.
+     *
+     * @generated from enum value: RUNNER_PHASE_BUSY = 3;
+     */
+    RunnerPhase[RunnerPhase["BUSY"] = 3] = "BUSY";
+    /**
+     * Runner has stopped heartbeating (timeout) or was explicitly stopped.
+     * The resource is retained for identity persistence — a runner that
+     * restarts and resumes heartbeating transitions back to READY.
+     *
+     * @generated from enum value: RUNNER_PHASE_STOPPED = 4;
+     */
+    RunnerPhase[RunnerPhase["STOPPED"] = 4] = "STOPPED";
+    /**
+     * Unrecoverable error. Runner or server reported a fatal condition.
+     * Requires investigation; does not auto-recover on heartbeat.
+     *
+     * @generated from enum value: RUNNER_PHASE_FAILED = 5;
+     */
+    RunnerPhase[RunnerPhase["FAILED"] = 5] = "FAILED";
+})(RunnerPhase || (RunnerPhase = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.runner.v1.RunnerPhase.
+ */
+export const RunnerPhaseSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_runner_v1_enum, 0);
+//# sourceMappingURL=enum_pb.js.map

package/ai/stigmer/agentic/runner/v1/enum_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/runner/v1/enum_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qHAAqH;AACrH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,8UAA8U,CAAC,CAAC;AAE3V;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAN,IAAY,WA8CX;AA9CD,WAAY,WAAW;IACrB;;OAEG;IACH,2DAAe,CAAA;IAEf;;;;;;OAMG;IACH,mDAAW,CAAA;IAEX;;;;OAIG;IACH,+CAAS,CAAA;IAET;;;;;OAKG;IACH,6CAAQ,CAAA;IAER;;;;;;OAMG;IACH,mDAAW,CAAA;IAEX;;;;;OAKG;IACH,iDAAU,CAAA;AACZ,CAAC,EA9CW,WAAW,KAAX,WAAW,QA8CtB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAyB,aAAa,CAClE,QAAQ,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}