@stigmer/protos 1.0.4 → 2.0.1

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

@@ -1,247 +0,0 @@
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
-import type { RunnerPhase } from "./enum_pb.js";
-import type { RunnerSpec } from "./spec_pb.js";
-import type { ApiResourceMetadata } from "../../../commons/apiresource/metadata_pb.js";
-import type { ApiResourceAudit } from "../../../commons/apiresource/status_pb.js";
-import type { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { Message } from "@bufbuild/protobuf";
-/**
- * Describes the file ai/stigmer/agentic/runner/v1/api.proto.
- */
-export declare const file_ai_stigmer_agentic_runner_v1_api: GenFile;
-/**
- * Runner represents a process that executes work on the Stigmer platform.
- *
- * Runners are the computational backbone of the platform. Every execution
- * runs on a runner — whether auto-created by the platform for a cloud
- * execution or started by a user on their own machine via CLI or desktop app.
- *
- * Runner follows the Kubernetes Node pattern:
- * - **Thin spec**: the user declares intent (a name, a description). That's it.
- * - **Rich status**: the runner process self-reports everything via the
- *   connect stream — phase, capacity, machine info, task queue.
- * - **Identity persists across restarts**: a runner that stops and restarts
- *   reconnects to the same resource. The CLI stores the runner ID locally and
- *   calls apply to reactivate the same identity, same queue.
- *
- * Two creation patterns:
- * - **User-created (persistent)**: user runs `stigmer runner start`, runner
- *   appears in the session composer, user selects it for their sessions.
- * - **System-managed (ephemeral)**: platform auto-creates a runner for a cloud
- *   execution, labels it stigmer.ai/system-managed: "true", tears it down when
- *   the execution completes. Hidden from the session composer.
- *
- * Sessions bind to a runner via SessionSpec.runner_id. Executions record
- * which runner handled them via AgentExecutionStatus.runner_id.
- *
- * @generated from message ai.stigmer.agentic.runner.v1.Runner
- */
-export type Runner = Message<"ai.stigmer.agentic.runner.v1.Runner"> & {
-    /**
-     * 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, organization, and labels.
-     *
-     * Notable labels:
-     * - stigmer.ai/system-managed: "true" — set on ephemeral runners created by
-     *   the platform for cloud executions. These are hidden from the session
-     *   composer and garbage-collected after the execution completes.
-     * - stigmer.ai/sandbox-id: "<id>" — set by the launcher when a cloud sandbox
-     *   is provisioned for this runner. Used by the deprovisioning step for
-     *   cleanup. Empty for local runners.
-     *
-     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceMetadata metadata = 3;
-     */
-    metadata?: ApiResourceMetadata;
-    /**
-     * User-declared desired state. Intentionally thin — see RunnerSpec.
-     *
-     * @generated from field: ai.stigmer.agentic.runner.v1.RunnerSpec spec = 4;
-     */
-    spec?: RunnerSpec;
-    /**
-     * System-managed operational state reported by the runner process.
-     *
-     * @generated from field: ai.stigmer.agentic.runner.v1.RunnerStatus status = 5;
-     */
-    status?: RunnerStatus;
-};
-/**
- * Describes the message ai.stigmer.agentic.runner.v1.Runner.
- * Use `create(RunnerSchema)` to create a new message.
- */
-export declare const RunnerSchema: GenMessage<Runner>;
-/**
- * RunnerStatus contains all operational state for a runner.
- *
- * Every field here is either system-managed (phase, task_queue) or
- * runner-reported via heartbeat (last_heartbeat_at, current_executions,
- * connection_info). None of it is user-declared — that separation is the
- * spec/status invariant.
- *
- * @generated from message ai.stigmer.agentic.runner.v1.RunnerStatus
- */
-export type RunnerStatus = Message<"ai.stigmer.agentic.runner.v1.RunnerStatus"> & {
-    /**
-     * Standard audit information (created_at, updated_at, created_by, etc.)
-     *
-     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAudit audit = 99;
-     */
-    audit?: ApiResourceAudit;
-    /**
-     * Current operational phase of the runner process.
-     *
-     * @generated from field: ai.stigmer.agentic.runner.v1.RunnerPhase phase = 1;
-     */
-    phase: RunnerPhase;
-    /**
-     * Temporal task queue this runner polls for work.
-     * Format: "runner:{runner-id}"
-     * Set by the server when the runner resource is created; immutable after.
-     * The execution workflow reads this field to route activities to the runner.
-     *
-     * @generated from field: string task_queue = 2;
-     */
-    taskQueue: string;
-    /**
-     * Timestamp of the last successful heartbeat from the runner process.
-     * Used by the server to detect stale runners: if now - last_heartbeat_at
-     * exceeds the heartbeat timeout (default 90s), the phase transitions to
-     * STOPPED.
-     *
-     * @generated from field: google.protobuf.Timestamp last_heartbeat_at = 3;
-     */
-    lastHeartbeatAt?: Timestamp;
-    /**
-     * Timestamp when this runner first transitioned to READY.
-     *
-     * @generated from field: google.protobuf.Timestamp started_at = 4;
-     */
-    startedAt?: Timestamp;
-    /**
-     * Timestamp when this runner last transitioned to STOPPED or FAILED.
-     * Empty while the runner is active (PENDING, READY, or BUSY).
-     *
-     * @generated from field: google.protobuf.Timestamp stopped_at = 5;
-     */
-    stoppedAt?: Timestamp;
-    /**
-     * Number of executions currently in progress on this runner.
-     * Reported by the runner on each heartbeat. Used by the dispatch logic
-     * to determine runner availability and load.
-     *
-     * @generated from field: int32 current_executions = 6;
-     */
-    currentExecutions: number;
-    /**
-     * Self-reported information about the machine running this runner.
-     * Populated by the runner process on each heartbeat.
-     *
-     * @generated from field: ai.stigmer.agentic.runner.v1.RunnerConnectionInfo connection_info = 8;
-     */
-    connectionInfo?: RunnerConnectionInfo;
-    /**
-     * Per-process execution counts in a multi-process sandbox.
-     *
-     * In cloud mode, a single Runner resource hosts three co-located processes
-     * (agent, cursor, workflow), each reporting its own execution count via
-     * heartbeats with distinct process_type values. This map tracks the last
-     * reported count for each process type.
-     *
-     * The aggregate current_executions field (above) is derived from the sum
-     * of all values in this map. The runner is considered idle when every
-     * value is zero.
-     *
-     * Keys: "agent", "cursor", "workflow".
-     * Empty for single-process local runners (backward compatible).
-     *
-     * @generated from field: map<string, int32> process_executions = 9;
-     */
-    processExecutions: {
-        [key: string]: number;
-    };
-    /**
-     * Timestamp when all processes in this runner last became idle
-     * (every value in process_executions is zero and no streams are active).
-     *
-     * Set by the server when the aggregate transitions from busy to idle.
-     * Cleared when any process reports activity. Used by server-side idle
-     * detection to trigger deprovisioning after a configurable timeout.
-     *
-     * Empty while any process has active executions.
-     *
-     * @generated from field: google.protobuf.Timestamp idle_since = 10;
-     */
-    idleSince?: Timestamp;
-};
-/**
- * Describes the message ai.stigmer.agentic.runner.v1.RunnerStatus.
- * Use `create(RunnerStatusSchema)` to create a new message.
- */
-export declare const RunnerStatusSchema: GenMessage<RunnerStatus>;
-/**
- * RunnerConnectionInfo contains self-reported details about the runner's
- * host environment. Populated by the runner process on each heartbeat
- * message sent over the connect stream.
- *
- * This information is used for:
- * - UI display: "Alice's MacBook Pro (darwin/arm64)"
- * - Debugging: matching runner behavior to specific OS/arch combinations
- * - Version tracking: ensuring runners stay up-to-date
- *
- * @generated from message ai.stigmer.agentic.runner.v1.RunnerConnectionInfo
- */
-export type RunnerConnectionInfo = Message<"ai.stigmer.agentic.runner.v1.RunnerConnectionInfo"> & {
-    /**
-     * Hostname or user-friendly machine name.
-     * Example: "Alice's MacBook Pro", "ci-runner-3.internal"
-     *
-     * @generated from field: string hostname = 1;
-     */
-    hostname: string;
-    /**
-     * Operating system reported by the runner process.
-     * Example: "darwin", "linux", "windows"
-     *
-     * @generated from field: string os = 2;
-     */
-    os: string;
-    /**
-     * CPU architecture reported by the runner process.
-     * Example: "arm64", "amd64"
-     *
-     * @generated from field: string arch = 3;
-     */
-    arch: string;
-    /**
-     * Version of the runner software.
-     * Example: "0.4.2"
-     *
-     * @generated from field: string runner_version = 4;
-     */
-    runnerVersion: string;
-    /**
-     * Stable machine identifier, generated once per Stigmer CLI installation
-     * and persisted at ~/.stigmer/machine.json. Used for runner deduplication
-     * across hostname changes. Format: "mach_" + 32 hex chars.
-     * Example: "mach_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
-     *
-     * @generated from field: string machine_id = 5;
-     */
-    machineId: string;
-};
-/**
- * Describes the message ai.stigmer.agentic.runner.v1.RunnerConnectionInfo.
- * Use `create(RunnerConnectionInfoSchema)` to create a new message.
- */
-export declare const RunnerConnectionInfoSchema: GenMessage<RunnerConnectionInfo>;

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

@@ -1,30 +0,0 @@
-// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
-// @generated from file ai/stigmer/agentic/runner/v1/api.proto (package ai.stigmer.agentic.runner.v1, syntax proto3)
-/* eslint-disable */
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
-import { file_ai_stigmer_agentic_runner_v1_enum } from "./enum_pb.js";
-import { file_ai_stigmer_agentic_runner_v1_spec } from "./spec_pb.js";
-import { file_ai_stigmer_commons_apiresource_metadata } from "../../../commons/apiresource/metadata_pb.js";
-import { file_ai_stigmer_commons_apiresource_status } from "../../../commons/apiresource/status_pb.js";
-import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb.js";
-import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
-/**
- * Describes the file ai/stigmer/agentic/runner/v1/api.proto.
- */
-export const file_ai_stigmer_agentic_runner_v1_api = /*@__PURE__*/ fileDesc("CiZhaS9zdGlnbWVyL2FnZW50aWMvcnVubmVyL3YxL2FwaS5wcm90bxIcYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MSKbAgoGUnVubmVyEjEKC2FwaV92ZXJzaW9uGAEgASgJQhy6SBlyFwoVYWdlbnRpYy5zdGlnbWVyLmFpL3YxEhsKBGtpbmQYAiABKAlCDbpICnIICgZSdW5uZXISTQoIbWV0YWRhdGEYAyABKAsyMy5haS5zdGlnbWVyLmNvbW1vbnMuYXBpcmVzb3VyY2UuQXBpUmVzb3VyY2VNZXRhZGF0YUIGukgDyAEBEjYKBHNwZWMYBCABKAsyKC5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lclNwZWMSOgoGc3RhdHVzGAUgASgLMiouYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5SdW5uZXJTdGF0dXMi7AQKDFJ1bm5lclN0YXR1cxI/CgVhdWRpdBhjIAEoCzIwLmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZUF1ZGl0EjgKBXBoYXNlGAEgASgOMikuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5SdW5uZXJQaGFzZRISCgp0YXNrX3F1ZXVlGAIgASgJEjUKEWxhc3RfaGVhcnRiZWF0X2F0GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIuCgpzdGFydGVkX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIuCgpzdG9wcGVkX2F0GAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIaChJjdXJyZW50X2V4ZWN1dGlvbnMYBiABKAUSSwoPY29ubmVjdGlvbl9pbmZvGAggASgLMjIuYWkuc3RpZ21lci5hZ2VudGljLnJ1bm5lci52MS5SdW5uZXJDb25uZWN0aW9uSW5mbxJdChJwcm9jZXNzX2V4ZWN1dGlvbnMYCSADKAsyQS5haS5zdGlnbWVyLmFnZW50aWMucnVubmVyLnYxLlJ1bm5lclN0YXR1cy5Qcm9jZXNzRXhlY3V0aW9uc0VudHJ5Ei4KCmlkbGVfc2luY2UYCiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wGjgKFlByb2Nlc3NFeGVjdXRpb25zRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgFOgI4AUoECAcQCCJuChRSdW5uZXJDb25uZWN0aW9uSW5mbxIQCghob3N0bmFtZRgBIAEoCRIKCgJvcxgCIAEoCRIMCgRhcmNoGAMgASgJEhYKDnJ1bm5lcl92ZXJzaW9uGAQgASgJEhIKCm1hY2hpbmVfaWQYBSABKAliBnByb3RvMw", [file_ai_stigmer_agentic_runner_v1_enum, file_ai_stigmer_agentic_runner_v1_spec, file_ai_stigmer_commons_apiresource_metadata, file_ai_stigmer_commons_apiresource_status, file_buf_validate_validate, file_google_protobuf_timestamp]);
-/**
- * Describes the message ai.stigmer.agentic.runner.v1.Runner.
- * Use `create(RunnerSchema)` to create a new message.
- */
-export const RunnerSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_runner_v1_api, 0);
-/**
- * Describes the message ai.stigmer.agentic.runner.v1.RunnerStatus.
- * Use `create(RunnerStatusSchema)` to create a new message.
- */
-export const RunnerStatusSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_runner_v1_api, 1);
-/**
- * Describes the message ai.stigmer.agentic.runner.v1.RunnerConnectionInfo.
- * Use `create(RunnerConnectionInfoSchema)` to create a new message.
- */
-export const RunnerConnectionInfoSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_runner_v1_api, 2);
-//# sourceMappingURL=api_pb.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/runner/v1/api_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,oHAAoH;AACpH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,sCAAsC,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,sCAAsC,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,4CAA4C,EAAE,MAAM,6CAA6C,CAAC;AAE3G,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAY,aAAa,CACzE,QAAQ,CAAC,47CAA47C,EAAE,CAAC,sCAAsC,EAAE,sCAAsC,EAAE,4CAA4C,EAAE,0CAA0C,EAAE,0BAA0B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AA0EjrD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB,aAAa,CAC3D,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AAiHxD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AA0DxD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -1,198 +0,0 @@
-/**
- * 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: {
-    readonly typeName: "ai.stigmer.agentic.runner.v1.RunnerCommandController";
-    readonly 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
-         */
-        readonly apply: {
-            readonly name: "apply";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly create: {
-            readonly name: "create";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly update: {
-            readonly name: "update";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly delete: {
-            readonly name: "delete";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly sendCommand: {
-            readonly name: "sendCommand";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly stop: {
-            readonly name: "stop";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly connect: {
-            readonly name: "connect";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly createLaunchToken: {
-            readonly name: "createLaunchToken";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-        /**
-         * 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
-         */
-        readonly exchangeLaunchToken: {
-            readonly name: "exchangeLaunchToken";
-            readonly I: any;
-            readonly O: any;
-            readonly kind: any;
-        };
-    };
-};

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

@@ -1,206 +0,0 @@
-// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts,import_extension=js"
-// @generated from file ai/stigmer/agentic/runner/v1/command.proto (package ai.stigmer.agentic.runner.v1, syntax proto3)
-/* eslint-disable */
-// @ts-nocheck
-import { Runner } from "./api_pbjs";
-import { MethodKind } from "@bufbuild/protobuf";
-import { CreateLaunchTokenRequest, CreateLaunchTokenResponse, ExchangeLaunchTokenRequest, ExchangeLaunchTokenResponse, RunnerCommandResponse, RunnerId, RunnerSendCommandInput, RunnerStopInput, RunnerStreamClientMessage, RunnerStreamServerMessage } from "./io_pbjs";
-/**
- * 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