@stigmer/sdk 1.0.4 → 2.0.0

package/src/gen/workflow.ts

@@ -15,9 +15,11 @@ import { type ServerlessWorkflowValidation } from "@stigmer/protos/ai/stigmer/ag
 import { WorkflowSpecSchema, WorkflowDocumentSchema, ExportSchema, FlowControlSchema, WorkflowTaskSchema, WorkflowBudgetSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/spec_pb";
 import { GetTaskKindRegistryRequestSchema, GetTaskKindRegistryResponseSchema, type GetTaskKindRegistryRequest, type GetTaskKindRegistryResponse } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/task_kind_descriptor_pb";
 import { TaskKindRegistryQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/task_kind_registry_query_pb";
+import { TagWorkflowVersionInputSchema, ListWorkflowVersionsInputSchema, ListWorkflowVersionsResponseSchema, GetWorkflowVersionInputSchema, WorkflowVersionEntrySchema, type TagWorkflowVersionInput, type ListWorkflowVersionsInput, type ListWorkflowVersionsResponse, type GetWorkflowVersionInput, type WorkflowVersionEntry } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/version_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
-import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { ApiResourceReferenceSchema, type UpdateVisibilityInput } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema, ApiResourceMetadataVersionSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
 import { PageInfoSchema } from "@stigmer/protos/ai/stigmer/commons/rpc/pagination_pb";
 import { SearchRequestSchema } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
 import { SearchService } from "@stigmer/protos/ai/stigmer/search/v1/query_pb";
@@ -54,6 +56,12 @@ export class WorkflowClient {
     } catch (e) { throw wrapError(e); }
   }
 
+  async updateVisibility(input: UpdateVisibilityInput): Promise<Workflow> {
+    try {
+      return await this.command.updateVisibility(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
   async delete(id: string): Promise<Workflow> {
     try {
       return await this.command.delete(create(WorkflowIdSchema, { value: id }));
@@ -66,6 +74,12 @@ export class WorkflowClient {
     } catch (e) { throw wrapError(e); }
   }
 
+  async tagVersion(input: TagWorkflowVersionInput): Promise<Workflow> {
+    try {
+      return await this.command.tagVersion(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
   async get(id: string): Promise<Workflow> {
     try {
       return await this.query.get(create(WorkflowIdSchema, { value: id }));
@@ -78,6 +92,18 @@ export class WorkflowClient {
     } catch (e) { throw wrapError(e); }
   }
 
+  async listVersions(input: ListWorkflowVersionsInput): Promise<ListWorkflowVersionsResponse> {
+    try {
+      return await this.query.listVersions(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getVersion(input: GetWorkflowVersionInput): Promise<WorkflowVersionEntry> {
+    try {
+      return await this.query.getVersion(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
   async getTaskKindRegistry(input: GetTaskKindRegistryRequest): Promise<GetTaskKindRegistryResponse> {
     try {
       return await this.taskKindRegistryQuery.getTaskKindRegistry(input);
@@ -109,6 +135,8 @@ export interface WorkflowInput {
   slug?: string;
   org: string;
   labels?: Record<string, string>;
+  visibility?: ApiResourceVisibility;
+  versionMessage?: string;
   description?: string;
   document: WorkflowDocumentInput;
   tasks?: WorkflowTaskInput[];
@@ -127,11 +155,12 @@ export interface WorkflowDocumentInput {
 
 /** SDK input type for WorkflowTask. */
 export interface WorkflowTaskInput {
-  name: string;
+  name?: string;
   kind: WorkflowTaskKind;
   taskConfig: JsonObject;
   export?: ExportInput;
   flow?: FlowControlInput;
+  compensate?: WorkflowTaskInput[];
 }
 
 /** SDK input type for Export. */
@@ -188,6 +217,7 @@ function buildWorkflowTaskProto(input: WorkflowTaskInput) {
   if (input.taskConfig !== undefined) msg.taskConfig = input.taskConfig;
   if (input.export) msg.export = buildExportProto(input.export);
   if (input.flow) msg.flow = buildFlowControlProto(input.flow);
+  if (input.compensate) msg.compensate = input.compensate.map(buildWorkflowTaskProto);
   return msg;
 }
 
@@ -224,6 +254,8 @@ function buildWorkflowProto(input: WorkflowInput): Workflow {
       org: input.org,
       ...(input.slug && { slug: input.slug }),
       ...(input.labels && { labels: input.labels }),
+      ...(input.visibility && { visibility: input.visibility }),
+      ...(input.versionMessage && { version: Object.assign(create(ApiResourceMetadataVersionSchema), { message: input.versionMessage }) }),
     }),
     spec: Object.assign(create(WorkflowSpecSchema), stripUndefined({
       description: input.description,

package/src/gen/workflowexecution.ts

@@ -6,12 +6,14 @@ import { type EnvVarInput } from "./types";
 import { create } from "@bufbuild/protobuf";
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
 import { ExecutionValueSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/spec_pb";
+import { ExecutionTarget } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
 import { WorkflowExecutionSchema, type WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
 import { WorkflowExecutionCommandController } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/command_pb";
 import { WorkflowExecutionEventSchema, type WorkflowExecutionEvent } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
 import { WorkflowExecutionIdSchema, WorkflowExecutionUpdateStatusInputSchema, SubmitWorkflowApprovalInputSchema, SubmitWorkflowTaskApprovalInputSchema, SendSignalInputSchema, CancelWorkflowExecutionInputSchema, TerminateWorkflowExecutionInputSchema, RecoverWorkflowExecutionInputSchema, PauseWorkflowExecutionInputSchema, ResumeWorkflowExecutionInputSchema, ListWorkflowExecutionsRequestSchema, WorkflowExecutionListSchema, ListWorkflowExecutionsByWorkflowRequestSchema, SubscribeWorkflowExecutionRequestSchema, GetEventLogRequestSchema, GetEventLogResponseSchema, SubscribeEventsRequestSchema, GetExecutionSummaryRequestSchema, ExecutionSummarySchema, ListPendingApprovalsRequestSchema, PendingApprovalsListSchema, type WorkflowExecutionUpdateStatusInput, type SubmitWorkflowApprovalInput, type SubmitWorkflowTaskApprovalInput, type SendSignalInput, type CancelWorkflowExecutionInput, type TerminateWorkflowExecutionInput, type RecoverWorkflowExecutionInput, type PauseWorkflowExecutionInput, type ResumeWorkflowExecutionInput, type ListWorkflowExecutionsRequest, type WorkflowExecutionList, type ListWorkflowExecutionsByWorkflowRequest, type SubscribeWorkflowExecutionRequest, type GetEventLogRequest, type GetEventLogResponse, type SubscribeEventsRequest, type GetExecutionSummaryRequest, type ExecutionSummary, type ListPendingApprovalsRequest, type PendingApprovalsList } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
 import { WorkflowExecutionQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/query_pb";
 import { WorkflowExecutionSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/spec_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceIdSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
 import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
 
@@ -156,12 +158,14 @@ export interface WorkflowExecutionInput {
   slug?: string;
   org: string;
   labels?: Record<string, string>;
+  visibility?: ApiResourceVisibility;
   workflowInstanceId?: string;
   workflowId?: string;
   triggerMessage?: string;
   triggerMetadata?: Record<string, string>;
   runtimeEnv?: Record<string, EnvVarInput>;
   callbackToken?: Uint8Array;
+  executionTarget?: ExecutionTarget;
 }
 
 function buildWorkflowExecutionProto(input: WorkflowExecutionInput): WorkflowExecution {
@@ -178,6 +182,7 @@ function buildWorkflowExecutionProto(input: WorkflowExecutionInput): WorkflowExe
       org: input.org,
       ...(input.slug && { slug: input.slug }),
       ...(input.labels && { labels: input.labels }),
+      ...(input.visibility && { visibility: input.visibility }),
     }),
     spec: Object.assign(create(WorkflowExecutionSpecSchema), stripUndefined({
       workflowInstanceId: input.workflowInstanceId,
@@ -186,6 +191,7 @@ function buildWorkflowExecutionProto(input: WorkflowExecutionInput): WorkflowExe
       triggerMetadata: input.triggerMetadata,
       runtimeEnv,
       callbackToken: input.callbackToken,
+      executionTarget: input.executionTarget,
     })),
   }) as WorkflowExecution;
 }

package/src/gen/workflowinstance.ts

@@ -11,7 +11,8 @@ import { WorkflowInstanceIdSchema, GetWorkflowInstancesByWorkflowRequestSchema,
 import { WorkflowInstanceQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/query_pb";
 import { WorkflowInstanceSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/spec_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { ApiResourceReferenceSchema, type UpdateVisibilityInput } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
 import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
 
 /** Provides operations on workflowinstance resources. */
@@ -42,6 +43,12 @@ export class WorkflowInstanceClient {
     } catch (e) { throw wrapError(e); }
   }
 
+  async updateVisibility(input: UpdateVisibilityInput): Promise<WorkflowInstance> {
+    try {
+      return await this.command.updateVisibility(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
   async delete(id: string): Promise<WorkflowInstance> {
     try {
       return await this.command.delete(create(WorkflowInstanceIdSchema, { value: id }));
@@ -73,6 +80,7 @@ export interface WorkflowInstanceInput {
   slug?: string;
   org: string;
   labels?: Record<string, string>;
+  visibility?: ApiResourceVisibility;
   workflowId?: string;
   description?: string;
   environmentRefs?: ResourceRef[];
@@ -88,6 +96,7 @@ function buildWorkflowInstanceProto(input: WorkflowInstanceInput): WorkflowInsta
       org: input.org,
       ...(input.slug && { slug: input.slug }),
       ...(input.labels && { labels: input.labels }),
+      ...(input.visibility && { visibility: input.visibility }),
     }),
     spec: Object.assign(create(WorkflowInstanceSpecSchema), stripUndefined({
       workflowId: input.workflowId,

package/src/index.ts

@@ -3,6 +3,9 @@
 // Top-level client
 export { Stigmer } from "./stigmer";
 
+// Runner adapter
+export { type RunnerAdapter } from "./runner-adapter";
+
 // Configuration
 export { type StigmerConfig, type TokenProvider } from "./config";
 
@@ -44,6 +47,14 @@ export {
 } from "./iam-role";
 export { IamRole } from "@stigmer/protos/ai/stigmer/iam/v1/enum_pb";
 
+// Activity client (unified recents)
+export {
+  ActivityClient,
+  type ListRecentActivityParams,
+  type ListRecentActivityResponse,
+} from "./activity";
+export type { RecentActivityEntry as RecentActivityEntryProto } from "./activity";
+
 // Billing client
 export {
   BillingClient,

package/src/runner-adapter.ts

@@ -0,0 +1,21 @@
+/**
+ * Framework-agnostic RunnerAdapter interface.
+ *
+ * This is the canonical type definition re-exported by `@stigmer/react`.
+ * Non-React consumers (Node.js scripts, custom frameworks) can import
+ * directly from `@stigmer/sdk`.
+ *
+ * When `executionTarget` is `"local"`, SDK clients automatically call
+ * the adapter at the appropriate lifecycle points. The consumer never
+ * needs to manage runner processes directly.
+ */
+export interface RunnerAdapter {
+  /** Called after a session is created with executionTarget=LOCAL. */
+  onSessionCreated(sessionId: string): Promise<void>;
+  /** Called when a session reaches a terminal phase. */
+  onSessionTerminated(sessionId: string): Promise<void>;
+  /** Called after a workflow execution is created with executionTarget=LOCAL. */
+  onWorkflowExecutionCreated(executionId: string): Promise<void>;
+  /** Called when a workflow execution reaches a terminal phase. */
+  onWorkflowExecutionTerminated(executionId: string): Promise<void>;
+}

package/src/stigmer.ts

@@ -1,3 +1,4 @@
+import { ActivityClient } from "./activity";
 import { BillingClient } from "./billing";
 import { GeneratedClient } from "./gen/client";
 import { GitHubClient } from "./github";
@@ -9,6 +10,9 @@ import {
   type StigmerConfig,
   type TokenProvider,
 } from "./config";
+import { ExecutionTarget } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+
+type ExecutionTargetOption = StigmerConfig["executionTarget"];
 
 /**
  * Top-level Stigmer API client.
@@ -55,6 +59,19 @@ export class Stigmer extends GeneratedClient {
    */
   readonly fetch: typeof globalThis.fetch | undefined;
 
+  /**
+   * Default execution target for sessions and workflow executions.
+   *
+   * When set, `session.create()` and `workflowExecution.create()`
+   * apply this as the default when the per-call input does not
+   * specify an explicit `executionTarget`.
+   *
+   * `undefined` means the server decides (LOCAL for OSS, CLOUD for
+   * managed).
+   */
+  readonly defaultExecutionTarget: ExecutionTarget | undefined;
+
+  readonly activity: ActivityClient;
   readonly billing: BillingClient;
   readonly platform: PlatformClient;
   readonly search: SearchClient;
@@ -70,14 +87,39 @@ export class Stigmer extends GeneratedClient {
 
     this.baseUrl = config.baseUrl;
     this.fetch = config.fetch;
+    this.defaultExecutionTarget = toExecutionTarget(config.executionTarget);
     this._tokenProvider = config.apiKey
       ? () => config.apiKey!
       : config.getAccessToken ?? (() => null);
 
+    this.activity = new ActivityClient(transport);
     this.billing = new BillingClient(transport);
     this.platform = new PlatformClient(transport);
     this.search = new SearchClient(transport);
     this.github = new GitHubClient(transport);
+
+    if (this.defaultExecutionTarget != null) {
+      this._applyExecutionTargetDefaults();
+    }
+  }
+
+  /**
+   * Wrap `session.create/apply` so that the client-level
+   * `defaultExecutionTarget` is applied when the per-call input
+   * does not specify one.
+   *
+   * WorkflowExecutionInput does not yet have `executionTarget` in
+   * codegen; that will be wired once the codegen schema is updated.
+   */
+  private _applyExecutionTargetDefaults(): void {
+    const target = this.defaultExecutionTarget!;
+    const origSessionCreate = this.session.create.bind(this.session);
+    const origSessionApply = this.session.apply.bind(this.session);
+
+    this.session.create = (input) =>
+      origSessionCreate(applySessionDefault(input, target));
+    this.session.apply = (input) =>
+      origSessionApply(applySessionDefault(input, target));
   }
 
   /**
@@ -94,3 +136,30 @@ export class Stigmer extends GeneratedClient {
     return await this._tokenProvider();
   }
 }
+
+function toExecutionTarget(
+  opt: ExecutionTargetOption,
+): ExecutionTarget | undefined {
+  switch (opt) {
+    case "local":
+      return ExecutionTarget.LOCAL;
+    case "cloud":
+      return ExecutionTarget.CLOUD;
+    default:
+      return undefined;
+  }
+}
+
+function applySessionDefault<T extends { executionTarget?: ExecutionTarget }>(
+  input: T,
+  target: ExecutionTarget,
+): T {
+  if (
+    input.executionTarget == null ||
+    input.executionTarget === ExecutionTarget.UNSPECIFIED
+  ) {
+    return { ...input, executionTarget: target };
+  }
+  return input;
+}
+

package/stigmer.d.ts

@@ -1,9 +1,11 @@
+import { ActivityClient } from "./activity";
 import { BillingClient } from "./billing";
 import { GeneratedClient } from "./gen/client";
 import { GitHubClient } from "./github";
 import { PlatformClient } from "./platform";
 import { SearchClient } from "./search";
 import { type StigmerConfig } from "./config";
+import { ExecutionTarget } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
 /**
  * Top-level Stigmer API client.
  *
@@ -47,12 +49,33 @@ export declare class Stigmer extends GeneratedClient {
      * in Tauri where the global `fetch` is restricted by CSP/CORS.
      */
     readonly fetch: typeof globalThis.fetch | undefined;
+    /**
+     * Default execution target for sessions and workflow executions.
+     *
+     * When set, `session.create()` and `workflowExecution.create()`
+     * apply this as the default when the per-call input does not
+     * specify an explicit `executionTarget`.
+     *
+     * `undefined` means the server decides (LOCAL for OSS, CLOUD for
+     * managed).
+     */
+    readonly defaultExecutionTarget: ExecutionTarget | undefined;
+    readonly activity: ActivityClient;
     readonly billing: BillingClient;
     readonly platform: PlatformClient;
     readonly search: SearchClient;
     readonly github: GitHubClient;
     private readonly _tokenProvider;
     constructor(config: StigmerConfig);
+    /**
+     * Wrap `session.create/apply` so that the client-level
+     * `defaultExecutionTarget` is applied when the per-call input
+     * does not specify one.
+     *
+     * WorkflowExecutionInput does not yet have `executionTarget` in
+     * codegen; that will be wired once the codegen schema is updated.
+     */
+    private _applyExecutionTargetDefaults;
     /**
      * Retrieve the current authentication credential.
      *

package/stigmer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stigmer.d.ts","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAEpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,MAAM,EAAE,aAAa;IAkBjC;;;;;;;;;OASG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGlD"}
+{"version":3,"file":"stigmer.d.ts","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC;AAIxF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAEpD;;;;;;;;;OASG;IACH,QAAQ,CAAC,sBAAsB,EAAE,eAAe,GAAG,SAAS,CAAC;IAE7D,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,MAAM,EAAE,aAAa;IAwBjC;;;;;;;OAOG;IACH,OAAO,CAAC,6BAA6B;IAWrC;;;;;;;;;OASG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGlD"}

package/stigmer.js

@@ -1,3 +1,4 @@
+import { ActivityClient } from "./activity";
 import { BillingClient } from "./billing";
 import { GeneratedClient } from "./gen/client";
 import { GitHubClient } from "./github";
@@ -5,6 +6,7 @@ import { PlatformClient } from "./platform";
 import { SearchClient } from "./search";
 import { createStigmerTransport } from "./transport";
 import { validateConfig, } from "./config";
+import { ExecutionTarget } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
 /**
  * Top-level Stigmer API client.
  *
@@ -48,6 +50,18 @@ export class Stigmer extends GeneratedClient {
      * in Tauri where the global `fetch` is restricted by CSP/CORS.
      */
     fetch;
+    /**
+     * Default execution target for sessions and workflow executions.
+     *
+     * When set, `session.create()` and `workflowExecution.create()`
+     * apply this as the default when the per-call input does not
+     * specify an explicit `executionTarget`.
+     *
+     * `undefined` means the server decides (LOCAL for OSS, CLOUD for
+     * managed).
+     */
+    defaultExecutionTarget;
+    activity;
     billing;
     platform;
     search;
@@ -59,13 +73,33 @@ export class Stigmer extends GeneratedClient {
         super(transport);
         this.baseUrl = config.baseUrl;
         this.fetch = config.fetch;
+        this.defaultExecutionTarget = toExecutionTarget(config.executionTarget);
         this._tokenProvider = config.apiKey
             ? () => config.apiKey
             : config.getAccessToken ?? (() => null);
+        this.activity = new ActivityClient(transport);
         this.billing = new BillingClient(transport);
         this.platform = new PlatformClient(transport);
         this.search = new SearchClient(transport);
         this.github = new GitHubClient(transport);
+        if (this.defaultExecutionTarget != null) {
+            this._applyExecutionTargetDefaults();
+        }
+    }
+    /**
+     * Wrap `session.create/apply` so that the client-level
+     * `defaultExecutionTarget` is applied when the per-call input
+     * does not specify one.
+     *
+     * WorkflowExecutionInput does not yet have `executionTarget` in
+     * codegen; that will be wired once the codegen schema is updated.
+     */
+    _applyExecutionTargetDefaults() {
+        const target = this.defaultExecutionTarget;
+        const origSessionCreate = this.session.create.bind(this.session);
+        const origSessionApply = this.session.apply.bind(this.session);
+        this.session.create = (input) => origSessionCreate(applySessionDefault(input, target));
+        this.session.apply = (input) => origSessionApply(applySessionDefault(input, target));
     }
     /**
      * Retrieve the current authentication credential.
@@ -81,4 +115,21 @@ export class Stigmer extends GeneratedClient {
         return await this._tokenProvider();
     }
 }
+function toExecutionTarget(opt) {
+    switch (opt) {
+        case "local":
+            return ExecutionTarget.LOCAL;
+        case "cloud":
+            return ExecutionTarget.CLOUD;
+        default:
+            return undefined;
+    }
+}
+function applySessionDefault(input, target) {
+    if (input.executionTarget == null ||
+        input.executionTarget === ExecutionTarget.UNSPECIFIED) {
+        return { ...input, executionTarget: target };
+    }
+    return input;
+}
 //# sourceMappingURL=stigmer.js.map

package/stigmer.js.map

@@ -1 +1 @@
-{"version":3,"file":"stigmer.js","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,cAAc,GAGf,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACM,OAAO,CAAS;IAEzB;;;;;;;;OAQG;IACM,KAAK,CAAsC;IAE3C,OAAO,CAAgB;IACvB,QAAQ,CAAiB;IACzB,MAAM,CAAe;IACrB,MAAM,CAAe;IAEb,cAAc,CAAgB;IAE/C,YAAY,MAAqB;QAC/B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC3E,KAAK,CAAC,SAAS,CAAC,CAAC;QAEjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM;YACjC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAO;YACtB,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;CACF"}
+{"version":3,"file":"stigmer.js","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"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"}

package/gen/runner.d.ts

@@ -1,32 +0,0 @@
-import { BidiStream } from "./bidi-stream";
-import { type ResourceRef } from "./types";
-import { type Transport } from "@connectrpc/connect";
-import { type Runner } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
-import { type RunnerSendCommandInput, type RunnerCommandResponse, type RunnerStopInput, type RunnerStreamClientMessage, type RunnerStreamServerMessage, type CreateLaunchTokenRequest, type CreateLaunchTokenResponse, type ExchangeLaunchTokenRequest, type ExchangeLaunchTokenResponse, type ListRunnersRequest, type RunnerList } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
-/** Provides operations on runner resources. */
-export declare class RunnerClient {
-    private readonly command;
-    private readonly query;
-    constructor(transport: Transport);
-    apply(input: RunnerInput): Promise<Runner>;
-    create(input: RunnerInput): Promise<Runner>;
-    update(input: RunnerInput): Promise<Runner>;
-    delete(id: string): Promise<Runner>;
-    sendCommand(input: RunnerSendCommandInput): Promise<RunnerCommandResponse>;
-    stop(input: RunnerStopInput): Promise<Runner>;
-    connect(signal?: AbortSignal): BidiStream<RunnerStreamClientMessage, RunnerStreamServerMessage>;
-    createLaunchToken(input: CreateLaunchTokenRequest): Promise<CreateLaunchTokenResponse>;
-    exchangeLaunchToken(input: ExchangeLaunchTokenRequest): Promise<ExchangeLaunchTokenResponse>;
-    get(id: string): Promise<Runner>;
-    getByReference(ref: ResourceRef): Promise<Runner>;
-    list(input: ListRunnersRequest): Promise<RunnerList>;
-}
-/** Input for creating/updating a Runner. */
-export interface RunnerInput {
-    name: string;
-    slug?: string;
-    org: string;
-    labels?: Record<string, string>;
-    description?: string;
-}
-//# sourceMappingURL=runner.d.ts.map

package/gen/runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/gen/runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAEhG,OAAO,EAAwV,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,KAAK,0BAA0B,EAAE,KAAK,2BAA2B,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAOrtB,+CAA+C;AAC/C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;gBAEjD,SAAS,EAAE,SAAS;IAK1B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnC,WAAW,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM1E,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;IAIzF,iBAAiB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAMtF,mBAAmB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAM5F,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhC,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjD,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAK3D;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/gen/runner.js

@@ -1,130 +0,0 @@
-// Code generated by stigmer-codegen. DO NOT EDIT.
-import { BidiStream } from "./bidi-stream";
-import { wrapError } from "./errors";
-import { stripUndefined } from "./proto-utils";
-import { create } from "@bufbuild/protobuf";
-import { createClient } from "@connectrpc/connect";
-import { RunnerSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
-import { RunnerCommandController } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/command_pb";
-import { RunnerIdSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
-import { RunnerQueryController } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/query_pb";
-import { RunnerSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/spec_pb";
-import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
-import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
-/** Provides operations on runner resources. */
-export class RunnerClient {
-    command;
-    query;
-    constructor(transport) {
-        this.command = createClient(RunnerCommandController, transport);
-        this.query = createClient(RunnerQueryController, transport);
-    }
-    async apply(input) {
-        try {
-            return await this.command.apply(buildRunnerProto(input));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async create(input) {
-        try {
-            return await this.command.create(buildRunnerProto(input));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async update(input) {
-        try {
-            return await this.command.update(buildRunnerProto(input));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async delete(id) {
-        try {
-            return await this.command.delete(create(RunnerIdSchema, { value: id }));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async sendCommand(input) {
-        try {
-            return await this.command.sendCommand(input);
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async stop(input) {
-        try {
-            return await this.command.stop(input);
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    connect(signal) {
-        return new BidiStream((reqs) => this.command.connect(reqs, { signal }));
-    }
-    async createLaunchToken(input) {
-        try {
-            return await this.command.createLaunchToken(input);
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async exchangeLaunchToken(input) {
-        try {
-            return await this.command.exchangeLaunchToken(input);
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async get(id) {
-        try {
-            return await this.query.get(create(RunnerIdSchema, { value: id }));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async getByReference(ref) {
-        try {
-            return await this.query.getByReference(create(ApiResourceReferenceSchema, { ...ref, kind: ApiResourceKind.runner }));
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-    async list(input) {
-        try {
-            return await this.query.list(input);
-        }
-        catch (e) {
-            throw wrapError(e);
-        }
-    }
-}
-function buildRunnerProto(input) {
-    return Object.assign(create(RunnerSchema), {
-        apiVersion: "agentic.stigmer.ai/v1",
-        kind: "Runner",
-        metadata: Object.assign(create(ApiResourceMetadataSchema), {
-            name: input.name,
-            org: input.org,
-            ...(input.slug && { slug: input.slug }),
-            ...(input.labels && { labels: input.labels }),
-        }),
-        spec: Object.assign(create(RunnerSpecSchema), stripUndefined({
-            description: input.description,
-        })),
-    });
-}
-//# sourceMappingURL=runner.js.map