@stigmer/sdk 3.12.4 → 3.12.6

package/src/gen/agentexecution.ts

@@ -1,21 +1,22 @@
 // Code generated by stigmer-codegen. DO NOT EDIT.
 
 import { wrapError } from "./errors.js";
-import { stripUndefined, toTimestamp } from "./proto-utils.js";
+import { stripUndefined, toTimestamp, toResourceRefInput, toResourceRefInputs, toExecVarInputMap } from "./proto-utils.js";
 import { type ResourceRef, type EnvVarInput } from "./types.js";
 import { create, type JsonObject } from "@bufbuild/protobuf";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
-import { ToolApprovalOverrideSchema, McpServerUsageSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
+import { ToolApprovalOverrideSchema, McpServerUsageSchema, type ToolApprovalOverride, type McpServerUsage } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
 import { AgentExecutionSchema, type AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
 import { AgentExecutionCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/command_pb";
-import { InteractionMode, ApprovalMode, ServiceTier } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { InteractionMode, ApprovalMode, ServiceTier, ThinkingMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { AgentExecutionIdSchema, AgentExecutionUpdateStatusInputSchema, UpdateStatusResponseSchema, SubmitApprovalInputSchema, SubmitFileDecisionInputSchema, CancelAgentExecutionInputSchema, TerminateAgentExecutionInputSchema, RecoverAgentExecutionInputSchema, PauseAgentExecutionInputSchema, ResumeAgentExecutionInputSchema, UploadAttachmentRequestSchema, UploadAttachmentResponseSchema, ListAgentExecutionsRequestSchema, AgentExecutionListSchema, ListAgentExecutionsBySessionRequestSchema, GetArtifactDownloadUrlRequestSchema, GetArtifactDownloadUrlResponseSchema, GetArtifactContentRequestSchema, GetArtifactContentResponseSchema, GetExecutionUsageReportInputSchema, GetExecutionUsageReportOutputSchema, GetSessionUsageReportInputSchema, GetSessionUsageReportOutputSchema, GetAgentUsageReportInputSchema, GetAgentUsageReportOutputSchema, GetOrgUsageReportInputSchema, GetOrgUsageReportOutputSchema, GetAgentExecutionSummaryRequestSchema, AgentExecutionSummarySchema, type AgentExecutionUpdateStatusInput, type UpdateStatusResponse, type SubmitApprovalInput, type SubmitFileDecisionInput, type CancelAgentExecutionInput, type TerminateAgentExecutionInput, type RecoverAgentExecutionInput, type PauseAgentExecutionInput, type ResumeAgentExecutionInput, type UploadAttachmentRequest, type UploadAttachmentResponse, type ListAgentExecutionsRequest, type AgentExecutionList, type ListAgentExecutionsBySessionRequest, type GetArtifactDownloadUrlRequest, type GetArtifactDownloadUrlResponse, type GetArtifactContentRequest, type GetArtifactContentResponse, type GetExecutionUsageReportInput, type GetExecutionUsageReportOutput, type GetSessionUsageReportInput, type GetSessionUsageReportOutput, type GetAgentUsageReportInput, type GetAgentUsageReportOutput, type GetOrgUsageReportInput, type GetOrgUsageReportOutput, type GetAgentExecutionSummaryRequest, type AgentExecutionSummary } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
 import { AgentExecutionQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/query_pb";
-import { AgentExecutionSpecSchema, ContextManagementConfigSchema, ExecutionConfigSchema, AttachmentSchema, ConversationCatchupSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/spec_pb";
+import { AgentExecutionSpecSchema, ContextManagementConfigSchema, ExecutionConfigSchema, AttachmentSchema, ConversationCatchupSchema, DeclaredPreferencesSchema, type ContextManagementConfig, type ExecutionConfig, type Attachment, type ConversationCatchup, type DeclaredPreferences } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/spec_pb";
 import { ExecutionValueSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/spec_pb";
 import { Harness, CursorMode, ExecutionTarget, GitWriteBackMode } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
-import { SessionSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/spec_pb";
-import { GitRepoSourceSchema, LocalPathSourceSchema, WorkspaceSourceSchema, WorkspaceEntrySchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+import { SessionSpecSchema, type SessionSpec } from "@stigmer/protos/ai/stigmer/agentic/session/v1/spec_pb";
+import { GitRepoSourceSchema, LocalPathSourceSchema, WorkspaceSourceSchema, WorkspaceEntrySchema, type GitRepoSource, type LocalPathSource, type WorkspaceSource, type WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceIdSchema, ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
 import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
@@ -173,6 +174,14 @@ export class AgentExecutionClient {
 
 /** Input for creating/updating a AgentExecution. */
 export interface AgentExecutionInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
   name: string;
   slug?: string;
   org: string;
@@ -192,6 +201,7 @@ export interface AgentExecutionInput {
   activityTaskQueue?: string;
   supersedesExecutionId?: string;
   conversationCatchup?: ConversationCatchupInput;
+  declaredPreferences?: DeclaredPreferencesInput;
 }
 
 /** SDK input type for SessionSpec. */
@@ -261,6 +271,7 @@ export interface ExecutionConfigInput {
   buildFromPlan?: boolean;
   approvalMode?: ApprovalMode;
   serviceTier?: ServiceTier;
+  thinkingMode?: ThinkingMode;
 }
 
 /** SDK input type for ContextManagementConfig. */
@@ -286,6 +297,12 @@ export interface ConversationCatchupInput {
   windowEnd?: Date | string;
 }
 
+/** SDK input type for DeclaredPreferences. */
+export interface DeclaredPreferencesInput {
+  orgContext?: string;
+  userContext?: string;
+}
+
 function buildGitRepoSourceProto(input: GitRepoSourceInput) {
   return Object.assign(create(GitRepoSourceSchema), stripUndefined({
     url: input.url,
@@ -371,6 +388,7 @@ function buildExecutionConfigProto(input: ExecutionConfigInput) {
   if (input.buildFromPlan !== undefined) msg.buildFromPlan = input.buildFromPlan;
   if (input.approvalMode !== undefined) msg.approvalMode = input.approvalMode;
   if (input.serviceTier !== undefined) msg.serviceTier = input.serviceTier;
+  if (input.thinkingMode !== undefined) msg.thinkingMode = input.thinkingMode;
   return msg;
 }
 
@@ -392,6 +410,13 @@ function buildConversationCatchupProto(input: ConversationCatchupInput) {
   return msg;
 }
 
+function buildDeclaredPreferencesProto(input: DeclaredPreferencesInput) {
+  return Object.assign(create(DeclaredPreferencesSchema), stripUndefined({
+    orgContext: input.orgContext,
+    userContext: input.userContext,
+  }));
+}
+
 export function buildAgentExecutionProto(input: AgentExecutionInput): AgentExecution {
   const sessionSpec = input.sessionSpec ? buildSessionSpecProto(input.sessionSpec) : undefined;
   const executionConfig = input.executionConfig ? buildExecutionConfigProto(input.executionConfig) : undefined;
@@ -402,10 +427,12 @@ export function buildAgentExecutionProto(input: AgentExecutionInput): AgentExecu
   }
   const attachments = input.attachments?.map(buildAttachmentProto);
   const conversationCatchup = input.conversationCatchup ? buildConversationCatchupProto(input.conversationCatchup) : undefined;
+  const declaredPreferences = input.declaredPreferences ? buildDeclaredPreferencesProto(input.declaredPreferences) : undefined;
   return Object.assign(create(AgentExecutionSchema), {
     apiVersion: "agentic.stigmer.ai/v1",
     kind: "AgentExecution",
     metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
       name: input.name,
       org: input.org,
       ...(input.slug && { slug: input.slug }),
@@ -427,6 +454,161 @@ export function buildAgentExecutionProto(input: AgentExecutionInput): AgentExecu
       activityTaskQueue: input.activityTaskQueue,
       supersedesExecutionId: input.supersedesExecutionId,
       conversationCatchup,
+      declaredPreferences,
     })),
   }) as AgentExecution;
 }
+
+function toGitRepoSourceInput(msg: GitRepoSource): GitRepoSourceInput {
+  return {
+    url: msg.url ?? "",
+    branch: msg.branch || undefined,
+    commit: msg.commit || undefined,
+    depth: msg.depth || undefined,
+    writeBackMode: msg.writeBackMode || undefined,
+  };
+}
+
+function toLocalPathSourceInput(msg: LocalPathSource): LocalPathSourceInput {
+  return {
+    path: msg.path || undefined,
+  };
+}
+
+function toWorkspaceSourceInput(msg: WorkspaceSource): WorkspaceSourceInput {
+  return {
+    gitRepo: msg.source?.case === "gitRepo" ? toGitRepoSourceInput(msg.source.value) : undefined,
+    localPath: msg.source?.case === "localPath" ? toLocalPathSourceInput(msg.source.value) : undefined,
+  };
+}
+
+function toWorkspaceEntryInput(msg: WorkspaceEntry): WorkspaceEntryInput {
+  return {
+    name: msg.name || undefined,
+    source: toWorkspaceSourceInput(msg.source ?? create(WorkspaceSourceSchema)),
+  };
+}
+
+function toToolApprovalOverrideInput(msg: ToolApprovalOverride): ToolApprovalOverrideInput {
+  return {
+    toolName: msg.toolName || undefined,
+    requiresApproval: msg.requiresApproval || undefined,
+    message: msg.message || undefined,
+  };
+}
+
+function toMcpServerUsageInput(msg: McpServerUsage): McpServerUsageInput {
+  return {
+    mcpServerRef: toResourceRefInput(msg.mcpServerRef) ?? { org: "", slug: "" },
+    enabledTools: msg.enabledTools?.length ? [...msg.enabledTools] : undefined,
+    toolApprovalOverrides: msg.toolApprovalOverrides?.length ? msg.toolApprovalOverrides.map(toToolApprovalOverrideInput) : undefined,
+  };
+}
+
+function toSessionSpecInput(msg: SessionSpec): SessionSpecInput {
+  return {
+    agentInstanceId: msg.agentInstanceId || undefined,
+    subject: msg.subject || undefined,
+    harnessStateId: msg.harnessStateId || undefined,
+    harnessStateIdHistory: msg.harnessStateIdHistory?.length ? [...msg.harnessStateIdHistory] : undefined,
+    metadata: Object.keys(msg.metadata ?? {}).length > 0 ? { ...msg.metadata } : undefined,
+    workspaceEntries: msg.workspaceEntries?.length ? msg.workspaceEntries.map(toWorkspaceEntryInput) : undefined,
+    mcpServerUsages: msg.mcpServerUsages?.length ? msg.mcpServerUsages.map(toMcpServerUsageInput) : undefined,
+    skillRefs: toResourceRefInputs(msg.skillRefs),
+    harness: msg.harness || undefined,
+    cursorMode: msg.cursorMode || undefined,
+    executionTarget: msg.executionTarget || undefined,
+  };
+}
+
+function toContextManagementConfigInput(msg: ContextManagementConfig): ContextManagementConfigInput {
+  return {
+    disableSummarization: msg.disableSummarization || undefined,
+    customTriggerThreshold: msg.customTriggerThreshold || undefined,
+    customTargetTokens: msg.customTargetTokens || undefined,
+  };
+}
+
+function toExecutionConfigInput(msg: ExecutionConfig): ExecutionConfigInput {
+  return {
+    modelName: msg.modelName || undefined,
+    contextManagement: msg.contextManagement ? toContextManagementConfigInput(msg.contextManagement) : undefined,
+    maxToolRounds: msg.maxToolRounds || undefined,
+    maxToolResultChars: msg.maxToolResultChars || undefined,
+    maxCostUsd: msg.maxCostUsd || undefined,
+    interactionMode: msg.interactionMode || undefined,
+    structuredOutputSchema: msg.structuredOutputSchema,
+    buildFromPlan: msg.buildFromPlan || undefined,
+    approvalMode: msg.approvalMode || undefined,
+    serviceTier: msg.serviceTier || undefined,
+    thinkingMode: msg.thinkingMode || undefined,
+  };
+}
+
+function toAttachmentInput(msg: Attachment): AttachmentInput {
+  return {
+    filename: msg.filename || undefined,
+    storageKey: msg.storageKey || undefined,
+    mountPath: msg.mountPath || undefined,
+    contentType: msg.contentType || undefined,
+    extract: msg.extract || undefined,
+    localPath: msg.localPath || undefined,
+  };
+}
+
+function toConversationCatchupInput(msg: ConversationCatchup): ConversationCatchupInput {
+  return {
+    digest: msg.digest || undefined,
+    windowEnd: msg.windowEnd ? timestampDate(msg.windowEnd) : undefined,
+  };
+}
+
+function toDeclaredPreferencesInput(msg: DeclaredPreferences): DeclaredPreferencesInput {
+  return {
+    orgContext: msg.orgContext || undefined,
+    userContext: msg.userContext || undefined,
+  };
+}
+
+/**
+ * Maps a fetched {@link AgentExecution} to a complete {@link AgentExecutionInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toAgentExecutionUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toAgentExecutionUpdateInput(resource: AgentExecution): AgentExecutionInput {
+  const meta = resource.metadata;
+  const spec = resource.spec ?? create(AgentExecutionSpecSchema);
+  return {
+    // Exact update addressing (id-first in the update pipeline) — for
+    // platform-scoped (org-less) kinds the org+slug fallback cannot
+    // match, so the id is the ONLY working address.
+    id: meta?.id || undefined,
+    name: meta?.name ?? "",
+    slug: meta?.slug || undefined,
+    org: meta?.org ?? "",
+    labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
+    visibility: meta?.visibility || undefined,
+    sessionId: spec.sessionId || undefined,
+    agentId: spec.agentId || undefined,
+    sessionSpec: spec.sessionSpec ? toSessionSpecInput(spec.sessionSpec) : undefined,
+    message: spec.message || undefined,
+    executionConfig: spec.executionConfig ? toExecutionConfigInput(spec.executionConfig) : undefined,
+    runtimeEnv: toExecVarInputMap(spec.runtimeEnv),
+    callbackToken: spec.callbackToken?.length ? spec.callbackToken : undefined,
+    autoApproveAll: spec.autoApproveAll || undefined,
+    parentWorkflowId: spec.parentWorkflowId || undefined,
+    attachments: spec.attachments?.length ? spec.attachments.map(toAttachmentInput) : undefined,
+    workspaceFileRefs: spec.workspaceFileRefs?.length ? [...spec.workspaceFileRefs] : undefined,
+    activityTaskQueue: spec.activityTaskQueue || undefined,
+    supersedesExecutionId: spec.supersedesExecutionId || undefined,
+    conversationCatchup: spec.conversationCatchup ? toConversationCatchupInput(spec.conversationCatchup) : undefined,
+    declaredPreferences: spec.declaredPreferences ? toDeclaredPreferencesInput(spec.declaredPreferences) : undefined,
+  };
+}

package/src/gen/agentinstance.ts

@@ -1,7 +1,7 @@
 // Code generated by stigmer-codegen. DO NOT EDIT.
 
 import { wrapError } from "./errors.js";
-import { stripUndefined } from "./proto-utils.js";
+import { stripUndefined, toResourceRefInputs } from "./proto-utils.js";
 import { type ResourceRef } from "./types.js";
 import { create } from "@bufbuild/protobuf";
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
@@ -82,6 +82,14 @@ export class AgentInstanceClient {
 
 /** Input for creating/updating a AgentInstance. */
 export interface AgentInstanceInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
   name: string;
   slug?: string;
   org: string;
@@ -98,6 +106,7 @@ export function buildAgentInstanceProto(input: AgentInstanceInput): AgentInstanc
     apiVersion: "agentic.stigmer.ai/v1",
     kind: "AgentInstance",
     metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
       name: input.name,
       org: input.org,
       ...(input.slug && { slug: input.slug }),
@@ -111,3 +120,34 @@ export function buildAgentInstanceProto(input: AgentInstanceInput): AgentInstanc
     })),
   }) as AgentInstance;
 }
+
+/**
+ * Maps a fetched {@link AgentInstance} to a complete {@link AgentInstanceInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toAgentInstanceUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toAgentInstanceUpdateInput(resource: AgentInstance): AgentInstanceInput {
+  const meta = resource.metadata;
+  const spec = resource.spec ?? create(AgentInstanceSpecSchema);
+  return {
+    // Exact update addressing (id-first in the update pipeline) — for
+    // platform-scoped (org-less) kinds the org+slug fallback cannot
+    // match, so the id is the ONLY working address.
+    id: meta?.id || undefined,
+    name: meta?.name ?? "",
+    slug: meta?.slug || undefined,
+    org: meta?.org ?? "",
+    labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
+    visibility: meta?.visibility || undefined,
+    agentId: spec.agentId || undefined,
+    description: spec.description || undefined,
+    environmentRefs: toResourceRefInputs(spec.environmentRefs),
+  };
+}

package/src/gen/agentshare.ts

@@ -1,17 +1,17 @@
 // Code generated by stigmer-codegen. DO NOT EDIT.
 
 import { wrapError } from "./errors.js";
-import { stripUndefined } from "./proto-utils.js";
+import { stripUndefined, toResourceRefInput, toResourceRefInputs } from "./proto-utils.js";
 import { type ResourceRef } from "./types.js";
 import { create } from "@bufbuild/protobuf";
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
-import { ServiceTier } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import { RunConfigSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/invocation_pb";
+import { ServiceTier, ThinkingMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { RunConfigSchema, type RunConfig } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/invocation_pb";
 import { AgentShareSchema, type AgentShare } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/api_pb";
 import { AgentShareCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/command_pb";
 import { AgentShareIdSchema, RotateShareLinkInputSchema, GetAgentSharesByAgentRequestSchema, AgentShareListSchema, ListAgentSharesRequestSchema, GetSharedProfileRequestSchema, SharedAgentProfileSchema, type RotateShareLinkInput, type GetAgentSharesByAgentRequest, type AgentShareList, type ListAgentSharesRequest, type GetSharedProfileRequest, type SharedAgentProfile } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/io_pb";
 import { AgentShareQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/query_pb";
-import { AgentShareSpecSchema, AgentShareAudience, AgentShareMessagesSchema } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/spec_pb";
+import { AgentShareSpecSchema, AgentShareAudience, AgentShareMessagesSchema, type AgentShareMessages } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/spec_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
@@ -96,6 +96,14 @@ export class AgentShareClient {
 
 /** Input for creating/updating a AgentShare. */
 export interface AgentShareInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
   name: string;
   slug?: string;
   org: string;
@@ -123,6 +131,7 @@ export interface RunConfigInput {
   maxCostUsd?: number;
   maxToolRounds?: number;
   serviceTier?: ServiceTier;
+  thinkingMode?: ThinkingMode;
 }
 
 function buildAgentShareMessagesProto(input: AgentShareMessagesInput) {
@@ -139,6 +148,7 @@ function buildRunConfigProto(input: RunConfigInput) {
     maxCostUsd: input.maxCostUsd,
     maxToolRounds: input.maxToolRounds,
     serviceTier: input.serviceTier,
+    thinkingMode: input.thinkingMode,
   }));
 }
 
@@ -151,6 +161,7 @@ export function buildAgentShareProto(input: AgentShareInput): AgentShare {
     apiVersion: "agentic.stigmer.ai/v1",
     kind: "AgentShare",
     metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
       name: input.name,
       org: input.org,
       ...(input.slug && { slug: input.slug }),
@@ -168,3 +179,56 @@ export function buildAgentShareProto(input: AgentShareInput): AgentShare {
     })),
   }) as AgentShare;
 }
+
+function toAgentShareMessagesInput(msg: AgentShareMessages): AgentShareMessagesInput {
+  return {
+    rateLimited: msg.rateLimited || undefined,
+    unavailable: msg.unavailable || undefined,
+    conversationEnded: msg.conversationEnded || undefined,
+  };
+}
+
+function toRunConfigInput(msg: RunConfig): RunConfigInput {
+  return {
+    modelName: msg.modelName || undefined,
+    maxCostUsd: msg.maxCostUsd || undefined,
+    maxToolRounds: msg.maxToolRounds || undefined,
+    serviceTier: msg.serviceTier || undefined,
+    thinkingMode: msg.thinkingMode || undefined,
+  };
+}
+
+/**
+ * Maps a fetched {@link AgentShare} to a complete {@link AgentShareInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toAgentShareUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toAgentShareUpdateInput(resource: AgentShare): AgentShareInput {
+  const meta = resource.metadata;
+  const spec = resource.spec ?? create(AgentShareSpecSchema);
+  return {
+    // Exact update addressing (id-first in the update pipeline) — for
+    // platform-scoped (org-less) kinds the org+slug fallback cannot
+    // match, so the id is the ONLY working address.
+    id: meta?.id || undefined,
+    name: meta?.name ?? "",
+    slug: meta?.slug || undefined,
+    org: meta?.org ?? "",
+    labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
+    visibility: meta?.visibility || undefined,
+    agentRef: toResourceRefInput(spec.agentRef) ?? { org: "", slug: "" },
+    enabled: spec.enabled || undefined,
+    audience: spec.audience || undefined,
+    allowedOrigins: spec.allowedOrigins?.length ? [...spec.allowedOrigins] : undefined,
+    messages: spec.messages ? toAgentShareMessagesInput(spec.messages) : undefined,
+    environmentRefs: toResourceRefInputs(spec.environmentRefs),
+    runConfig: spec.runConfig ? toRunConfigInput(spec.runConfig) : undefined,
+  };
+}

package/src/gen/apikey.ts

@@ -3,7 +3,7 @@
 import { wrapError } from "./errors.js";
 import { stripUndefined, toTimestamp } from "./proto-utils.js";
 import { create } from "@bufbuild/protobuf";
-import { EmptySchema } from "@bufbuild/protobuf/wkt";
+import { EmptySchema, timestampDate } from "@bufbuild/protobuf/wkt";
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
@@ -62,6 +62,14 @@ export class ApiKeyClient {
 
 /** Input for creating/updating a ApiKey. */
 export interface ApiKeyInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
   name: string;
   slug?: string;
   org: string;
@@ -79,6 +87,7 @@ export function buildApiKeyProto(input: ApiKeyInput): ApiKey {
     apiVersion: "iam.stigmer.ai/v1",
     kind: "ApiKey",
     metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
       name: input.name,
       org: input.org,
       ...(input.slug && { slug: input.slug }),
@@ -93,3 +102,35 @@ export function buildApiKeyProto(input: ApiKeyInput): ApiKey {
     })),
   }) as ApiKey;
 }
+
+/**
+ * Maps a fetched {@link ApiKey} to a complete {@link ApiKeyInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toApiKeyUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toApiKeyUpdateInput(resource: ApiKey): ApiKeyInput {
+  const meta = resource.metadata;
+  const spec = resource.spec ?? create(ApiKeySpecSchema);
+  return {
+    // Exact update addressing (id-first in the update pipeline) — for
+    // platform-scoped (org-less) kinds the org+slug fallback cannot
+    // match, so the id is the ONLY working address.
+    id: meta?.id || undefined,
+    name: meta?.name ?? "",
+    slug: meta?.slug || undefined,
+    org: meta?.org ?? "",
+    labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
+    visibility: meta?.visibility || undefined,
+    keyHash: spec.keyHash || undefined,
+    fingerprint: spec.fingerprint || undefined,
+    expiresAt: spec.expiresAt ? timestampDate(spec.expiresAt) : undefined,
+    neverExpires: spec.neverExpires || undefined,
+  };
+}

package/src/gen/artifact.ts

@@ -62,6 +62,14 @@ export class ArtifactClient {
 
 /** Input for creating/updating a Artifact. */
 export interface ArtifactInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
   name: string;
   slug?: string;
   org: string;
@@ -106,6 +114,7 @@ export function buildArtifactProto(input: ArtifactInput): Artifact {
     apiVersion: "agentic.stigmer.ai/v1",
     kind: "Artifact",
     metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
       name: input.name,
       org: input.org,
       ...(input.slug && { slug: input.slug }),

package/src/gen/channelapp.ts

@@ -9,7 +9,7 @@ import { ChannelAppSchema, type ChannelApp } from "@stigmer/protos/ai/stigmer/ag
 import { ChannelAppCommandController } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/command_pb";
 import { ListChannelAppsByOrgInputSchema, ChannelAppsSchema, type ListChannelAppsByOrgInput, type ChannelApps } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/io_pb";
 import { ChannelAppQueryController } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/query_pb";
-import { ChannelAppSpecSchema, SlackChannelAppConfigSchema, WhatsAppChannelAppConfigSchema } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/spec_pb";
+import { ChannelAppSpecSchema, SlackChannelAppConfigSchema, WhatsAppChannelAppConfigSchema, type SlackChannelAppConfig, type WhatsAppChannelAppConfig } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/spec_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceIdSchema, ApiResourceReferenceSchema, ApiResourceDeleteInputSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
@@ -74,6 +74,14 @@ export class ChannelAppClient {
 
 /** Input for creating/updating a ChannelApp. */
 export interface ChannelAppInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
   name: string;
   slug?: string;
   org: string;
@@ -127,6 +135,7 @@ export function buildChannelAppProto(input: ChannelAppInput): ChannelApp {
     apiVersion: "agentic.stigmer.ai/v1",
     kind: "ChannelApp",
     metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
       name: input.name,
       org: input.org,
       ...(input.slug && { slug: input.slug }),
@@ -136,3 +145,50 @@ export function buildChannelAppProto(input: ChannelAppInput): ChannelApp {
     spec,
   }) as ChannelApp;
 }
+
+function toSlackChannelAppConfigInput(msg: SlackChannelAppConfig): SlackChannelAppConfigInput {
+  return {
+    clientId: msg.clientId || undefined,
+    clientSecret: msg.clientSecret || undefined,
+    signingSecret: msg.signingSecret || undefined,
+  };
+}
+
+function toWhatsAppChannelAppConfigInput(msg: WhatsAppChannelAppConfig): WhatsAppChannelAppConfigInput {
+  return {
+    appId: msg.appId || undefined,
+    appSecret: msg.appSecret || undefined,
+    accessToken: msg.accessToken || undefined,
+    verifyToken: msg.verifyToken || undefined,
+  };
+}
+
+/**
+ * Maps a fetched {@link ChannelApp} to a complete {@link ChannelAppInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toChannelAppUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toChannelAppUpdateInput(resource: ChannelApp): ChannelAppInput {
+  const meta = resource.metadata;
+  const spec = resource.spec ?? create(ChannelAppSpecSchema);
+  return {
+    // Exact update addressing (id-first in the update pipeline) — for
+    // platform-scoped (org-less) kinds the org+slug fallback cannot
+    // match, so the id is the ONLY working address.
+    id: meta?.id || undefined,
+    name: meta?.name ?? "",
+    slug: meta?.slug || undefined,
+    org: meta?.org ?? "",
+    labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
+    visibility: meta?.visibility || undefined,
+    slack: spec.providerConfig?.case === "slack" ? toSlackChannelAppConfigInput(spec.providerConfig.value) : undefined,
+    whatsapp: spec.providerConfig?.case === "whatsapp" ? toWhatsAppChannelAppConfigInput(spec.providerConfig.value) : undefined,
+  };
+}

package/src/gen/client.ts

@@ -90,7 +90,7 @@ export { type AgentInput, type McpServerUsageInput, type ToolApprovalOverrideInp
 export { AgentChannelClient } from "./agentchannel.js";
 export { type AgentChannelInput, type SlackChannelConfigInput, type WhatsAppChannelConfigInput, type RunConfigInput } from "./agentchannel.js";
 export { AgentExecutionClient } from "./agentexecution.js";
-export { type AgentExecutionInput, type SessionSpecInput, type WorkspaceEntryInput, type WorkspaceSourceInput, type GitRepoSourceInput, type LocalPathSourceInput, type ExecutionConfigInput, type ContextManagementConfigInput, type AttachmentInput, type ConversationCatchupInput } from "./agentexecution.js";
+export { type AgentExecutionInput, type SessionSpecInput, type WorkspaceEntryInput, type WorkspaceSourceInput, type GitRepoSourceInput, type LocalPathSourceInput, type ExecutionConfigInput, type ContextManagementConfigInput, type AttachmentInput, type ConversationCatchupInput, type DeclaredPreferencesInput } from "./agentexecution.js";
 export { AgentInstanceClient } from "./agentinstance.js";
 export { type AgentInstanceInput } from "./agentinstance.js";
 export { AgentShareClient } from "./agentshare.js";
@@ -108,7 +108,7 @@ export { type ExecutionContextInput } from "./executioncontext.js";
 export { IamPolicyClient } from "./iampolicy.js";
 export { type IamPolicyInput, type ApiResourceRefInput } from "./iampolicy.js";
 export { IdentityAccountClient } from "./identityaccount.js";
-export { type IdentityAccountInput } from "./identityaccount.js";
+export { type IdentityAccountInput, type IdentityAccountPreferencesInput } from "./identityaccount.js";
 export { IdentityProviderClient } from "./identityprovider.js";
 export { type IdentityProviderInput } from "./identityprovider.js";
 export { InvitationClient } from "./invitation.js";
@@ -118,7 +118,7 @@ export { type McpServerInput, type StdioServerConfigInput, type HttpServerConfig
 export { OAuthAppClient } from "./oauthapp.js";
 export { type OAuthAppInput } from "./oauthapp.js";
 export { OrganizationClient } from "./organization.js";
-export { type OrganizationInput } from "./organization.js";
+export { type OrganizationInput, type OrganizationPreferencesInput } from "./organization.js";
 export { PlatformClientClient } from "./platformclient.js";
 export { type PlatformClientInput } from "./platformclient.js";
 export { ProjectClient } from "./project.js";