@stigmer/sdk 3.12.6 → 3.12.8

package/src/gen/agentexecution.ts

@@ -12,7 +12,7 @@ import { AgentExecutionCommandController } from "@stigmer/protos/ai/stigmer/agen
 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, DeclaredPreferencesSchema, type ContextManagementConfig, type ExecutionConfig, type Attachment, type ConversationCatchup, type DeclaredPreferences } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/spec_pb";
+import { AgentExecutionSpecSchema, ContextManagementConfigSchema, ExecutionConfigSchema, AttachmentSchema, ConversationCatchupSchema, DeclaredPreferencesSchema, RecalledMemoryFactSchema, RecalledMemoriesSchema, type ContextManagementConfig, type ExecutionConfig, type Attachment, type ConversationCatchup, type DeclaredPreferences, type RecalledMemoryFact, type RecalledMemories } 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, type SessionSpec } from "@stigmer/protos/ai/stigmer/agentic/session/v1/spec_pb";
@@ -202,6 +202,7 @@ export interface AgentExecutionInput {
   supersedesExecutionId?: string;
   conversationCatchup?: ConversationCatchupInput;
   declaredPreferences?: DeclaredPreferencesInput;
+  recalledMemories?: RecalledMemoriesInput;
 }
 
 /** SDK input type for SessionSpec. */
@@ -303,6 +304,18 @@ export interface DeclaredPreferencesInput {
   userContext?: string;
 }
 
+/** SDK input type for RecalledMemories. */
+export interface RecalledMemoriesInput {
+  enabled?: boolean;
+  facts?: RecalledMemoryFactInput[];
+}
+
+/** SDK input type for RecalledMemoryFact. */
+export interface RecalledMemoryFactInput {
+  memoryId?: string;
+  content?: string;
+}
+
 function buildGitRepoSourceProto(input: GitRepoSourceInput) {
   return Object.assign(create(GitRepoSourceSchema), stripUndefined({
     url: input.url,
@@ -417,6 +430,20 @@ function buildDeclaredPreferencesProto(input: DeclaredPreferencesInput) {
   }));
 }
 
+function buildRecalledMemoryFactProto(input: RecalledMemoryFactInput) {
+  return Object.assign(create(RecalledMemoryFactSchema), stripUndefined({
+    memoryId: input.memoryId,
+    content: input.content,
+  }));
+}
+
+function buildRecalledMemoriesProto(input: RecalledMemoriesInput) {
+  const msg = create(RecalledMemoriesSchema);
+  if (input.enabled !== undefined) msg.enabled = input.enabled;
+  if (input.facts) msg.facts = input.facts.map(buildRecalledMemoryFactProto);
+  return msg;
+}
+
 export function buildAgentExecutionProto(input: AgentExecutionInput): AgentExecution {
   const sessionSpec = input.sessionSpec ? buildSessionSpecProto(input.sessionSpec) : undefined;
   const executionConfig = input.executionConfig ? buildExecutionConfigProto(input.executionConfig) : undefined;
@@ -428,6 +455,7 @@ 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;
+  const recalledMemories = input.recalledMemories ? buildRecalledMemoriesProto(input.recalledMemories) : undefined;
   return Object.assign(create(AgentExecutionSchema), {
     apiVersion: "agentic.stigmer.ai/v1",
     kind: "AgentExecution",
@@ -455,6 +483,7 @@ export function buildAgentExecutionProto(input: AgentExecutionInput): AgentExecu
       supersedesExecutionId: input.supersedesExecutionId,
       conversationCatchup,
       declaredPreferences,
+      recalledMemories,
     })),
   }) as AgentExecution;
 }
@@ -570,6 +599,20 @@ function toDeclaredPreferencesInput(msg: DeclaredPreferences): DeclaredPreferenc
   };
 }
 
+function toRecalledMemoryFactInput(msg: RecalledMemoryFact): RecalledMemoryFactInput {
+  return {
+    memoryId: msg.memoryId || undefined,
+    content: msg.content || undefined,
+  };
+}
+
+function toRecalledMemoriesInput(msg: RecalledMemories): RecalledMemoriesInput {
+  return {
+    enabled: msg.enabled || undefined,
+    facts: msg.facts?.length ? msg.facts.map(toRecalledMemoryFactInput) : undefined,
+  };
+}
+
 /**
  * Maps a fetched {@link AgentExecution} to a complete {@link AgentExecutionInput} for `update()`.
  *
@@ -610,5 +653,6 @@ export function toAgentExecutionUpdateInput(resource: AgentExecution): AgentExec
     supersedesExecutionId: spec.supersedesExecutionId || undefined,
     conversationCatchup: spec.conversationCatchup ? toConversationCatchupInput(spec.conversationCatchup) : undefined,
     declaredPreferences: spec.declaredPreferences ? toDeclaredPreferencesInput(spec.declaredPreferences) : undefined,
+    recalledMemories: spec.recalledMemories ? toRecalledMemoriesInput(spec.recalledMemories) : undefined,
   };
 }

package/src/gen/client.ts

@@ -16,6 +16,7 @@ import { IdentityAccountClient } from "./identityaccount.js";
 import { IdentityProviderClient } from "./identityprovider.js";
 import { InvitationClient } from "./invitation.js";
 import { McpServerClient } from "./mcpserver.js";
+import { MemoryClient } from "./memory.js";
 import { OAuthAppClient } from "./oauthapp.js";
 import { OrganizationClient } from "./organization.js";
 import { PlatformClientClient } from "./platformclient.js";
@@ -44,6 +45,7 @@ export class GeneratedClient {
   readonly identityProvider: IdentityProviderClient;
   readonly invitation: InvitationClient;
   readonly mcpServer: McpServerClient;
+  readonly memory: MemoryClient;
   readonly oauthapp: OAuthAppClient;
   readonly organization: OrganizationClient;
   readonly platformclient: PlatformClientClient;
@@ -71,6 +73,7 @@ export class GeneratedClient {
     this.identityProvider = new IdentityProviderClient(transport);
     this.invitation = new InvitationClient(transport);
     this.mcpServer = new McpServerClient(transport);
+    this.memory = new MemoryClient(transport);
     this.oauthapp = new OAuthAppClient(transport);
     this.organization = new OrganizationClient(transport);
     this.platformclient = new PlatformClientClient(transport);
@@ -90,7 +93,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, type DeclaredPreferencesInput } 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, type RecalledMemoriesInput, type RecalledMemoryFactInput } from "./agentexecution.js";
 export { AgentInstanceClient } from "./agentinstance.js";
 export { type AgentInstanceInput } from "./agentinstance.js";
 export { AgentShareClient } from "./agentshare.js";
@@ -115,6 +118,8 @@ export { InvitationClient } from "./invitation.js";
 export { type InvitationInput } from "./invitation.js";
 export { McpServerClient } from "./mcpserver.js";
 export { type McpServerInput, type StdioServerConfigInput, type HttpServerConfigInput, type ToolApprovalPolicyInput, type McpServerAuthInput } from "./mcpserver.js";
+export { MemoryClient } from "./memory.js";
+export { type MemoryInput, type MemoryProvenanceInput } from "./memory.js";
 export { OAuthAppClient } from "./oauthapp.js";
 export { type OAuthAppInput } from "./oauthapp.js";
 export { OrganizationClient } from "./organization.js";

package/src/gen/identityaccount.ts

@@ -138,6 +138,8 @@ export interface IdentityAccountPreferencesInput {
   defaultHarness?: string;
   defaultNativeModel?: string;
   defaultCursorModel?: string;
+  memoryEnabled?: boolean;
+  defaultAutoApprove?: boolean;
 }
 
 function buildIdentityAccountPreferencesProto(input: IdentityAccountPreferencesInput) {
@@ -146,6 +148,8 @@ function buildIdentityAccountPreferencesProto(input: IdentityAccountPreferencesI
     defaultHarness: input.defaultHarness,
     defaultNativeModel: input.defaultNativeModel,
     defaultCursorModel: input.defaultCursorModel,
+    memoryEnabled: input.memoryEnabled,
+    defaultAutoApprove: input.defaultAutoApprove,
   }));
 }
 
@@ -183,6 +187,8 @@ function toIdentityAccountPreferencesInput(msg: IdentityAccountPreferences): Ide
     defaultHarness: msg.defaultHarness || undefined,
     defaultNativeModel: msg.defaultNativeModel || undefined,
     defaultCursorModel: msg.defaultCursorModel || undefined,
+    memoryEnabled: msg.memoryEnabled || undefined,
+    defaultAutoApprove: msg.defaultAutoApprove || undefined,
   };
 }
 

package/src/gen/memory.ts

@@ -0,0 +1,164 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors.js";
+import { stripUndefined } from "./proto-utils.js";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { MemorySchema, type Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+import { MemoryCommandController } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/command_pb";
+import { MemoryIdSchema, ListMemoriesRequestSchema, MemoryListSchema, type ListMemoriesRequest, type MemoryList } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/io_pb";
+import { MemoryQueryController } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/query_pb";
+import { MemorySpecSchema, MemoryProvenanceSchema, type MemoryProvenance } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/spec_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+
+/** Provides operations on memory resources. */
+export class MemoryClient {
+  private readonly command: Client<typeof MemoryCommandController>;
+  private readonly query: Client<typeof MemoryQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(MemoryCommandController, transport);
+    this.query = createClient(MemoryQueryController, transport);
+  }
+
+  async create(input: MemoryInput): Promise<Memory> {
+    try {
+      return await this.command.create(buildMemoryProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: MemoryInput): Promise<Memory> {
+    try {
+      return await this.command.update(buildMemoryProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<Memory> {
+    try {
+      return await this.command.delete(create(MemoryIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async confirm(id: string): Promise<Memory> {
+    try {
+      return await this.command.confirm(create(MemoryIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async reject(id: string): Promise<Memory> {
+    try {
+      return await this.command.reject(create(MemoryIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Memory> {
+    try {
+      return await this.query.get(create(MemoryIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async list(input: ListMemoriesRequest): Promise<MemoryList> {
+    try {
+      return await this.query.list(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Memory. */
+export interface MemoryInput {
+  /**
+   * 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;
+  labels?: Record<string, string>;
+  visibility?: ApiResourceVisibility;
+  content?: string;
+  subjectIdentityAccountId?: string;
+  provenance?: MemoryProvenanceInput;
+}
+
+/** SDK input type for MemoryProvenance. */
+export interface MemoryProvenanceInput {
+  agentId?: string;
+  sessionId?: string;
+  agentExecutionId?: string;
+  toolCallId?: string;
+}
+
+function buildMemoryProvenanceProto(input: MemoryProvenanceInput) {
+  return Object.assign(create(MemoryProvenanceSchema), stripUndefined({
+    agentId: input.agentId,
+    sessionId: input.sessionId,
+    agentExecutionId: input.agentExecutionId,
+    toolCallId: input.toolCallId,
+  }));
+}
+
+export function buildMemoryProto(input: MemoryInput): Memory {
+  const provenance = input.provenance ? buildMemoryProvenanceProto(input.provenance) : undefined;
+  return Object.assign(create(MemorySchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "Memory",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
+      name: input.name,
+      org: input.org,
+      ...(input.slug && { slug: input.slug }),
+      ...(input.labels && { labels: input.labels }),
+      ...(input.visibility && { visibility: input.visibility }),
+    }),
+    spec: Object.assign(create(MemorySpecSchema), stripUndefined({
+      content: input.content,
+      subjectIdentityAccountId: input.subjectIdentityAccountId,
+      provenance,
+    })),
+  }) as Memory;
+}
+
+function toMemoryProvenanceInput(msg: MemoryProvenance): MemoryProvenanceInput {
+  return {
+    agentId: msg.agentId || undefined,
+    sessionId: msg.sessionId || undefined,
+    agentExecutionId: msg.agentExecutionId || undefined,
+    toolCallId: msg.toolCallId || undefined,
+  };
+}
+
+/**
+ * Maps a fetched {@link Memory} to a complete {@link MemoryInput} 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({ ...toMemoryUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toMemoryUpdateInput(resource: Memory): MemoryInput {
+  const meta = resource.metadata;
+  const spec = resource.spec ?? create(MemorySpecSchema);
+  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,
+    content: spec.content || undefined,
+    subjectIdentityAccountId: spec.subjectIdentityAccountId || undefined,
+    provenance: spec.provenance ? toMemoryProvenanceInput(spec.provenance) : undefined,
+  };
+}

package/src/gen/organization.ts

@@ -102,11 +102,13 @@ export interface OrganizationInput {
 /** SDK input type for OrganizationPreferences. */
 export interface OrganizationPreferencesInput {
   standingContext?: string;
+  memoryEnabled?: boolean;
 }
 
 function buildOrganizationPreferencesProto(input: OrganizationPreferencesInput) {
   return Object.assign(create(OrganizationPreferencesSchema), stripUndefined({
     standingContext: input.standingContext,
+    memoryEnabled: input.memoryEnabled,
   }));
 }
 
@@ -139,6 +141,7 @@ export function buildOrganizationProto(input: OrganizationInput): Organization {
 function toOrganizationPreferencesInput(msg: OrganizationPreferences): OrganizationPreferencesInput {
   return {
     standingContext: msg.standingContext || undefined,
+    memoryEnabled: msg.memoryEnabled || undefined,
   };
 }
 

package/src/index.ts

@@ -249,6 +249,13 @@ export {
   type HttpServerConfigInput,
   type ToolApprovalPolicyInput,
 } from "./gen/mcpserver.js";
+export {
+  MemoryClient,
+  buildMemoryProto,
+  toMemoryUpdateInput,
+  type MemoryInput,
+  type MemoryProvenanceInput,
+} from "./gen/memory.js";
 export {
   connectAndWait,
   ConnectStillRunningError,
@@ -314,6 +321,27 @@ export {
   isInformativePolicySource,
 } from "./execution/approval-provenance.js";
 export { isTerminalPhase } from "./execution/execution-phases.js";
+export {
+  sortChronologically,
+  supersededExecutionIds,
+  isBuildFromPlanTurn,
+  syntheticUserPrompt,
+  execIdFromStorageKey,
+} from "./execution/conversation-rules.js";
+export {
+  assembleSessionTranscript,
+  fetchSessionTranscript,
+  resolveOffloadedOutputs,
+  transcriptToMarkdown,
+  transcriptToJson,
+  type SessionTranscript,
+  type TranscriptTurn,
+  type ResolvedToolOutput,
+  type SessionTranscriptClient,
+  type AssembleSessionTranscriptOptions,
+  type FetchSessionTranscriptOptions,
+  type TranscriptToMarkdownOptions,
+} from "./execution/transcript.js";
 export {
   foldFileReviewEventStream,
   displayFileChangeSets,