@superatomai/sdk-node 0.0.80-dsp → 0.0.81-dsp

package/dist/index.d.mts

@@ -2217,6 +2217,11 @@ interface AnswerProviderContext {
     context?: PromptContext;
     /** Files attached to this question (R2 references). Absent when none. */
     attachments?: PromptAttachment[];
+    /**
+     * The composition graph to answer from, from the relay-verified identity:
+     * "draft" or a release seq. Absent means the live release.
+     */
+    graphVersion?: 'draft' | number;
 }
 /**
  * One narrator tick while an answer was being produced: what the narrator was
@@ -5137,7 +5142,14 @@ interface RequestContext {
     policies?: SourcePolicy[];
     /** Correlates the audit log with a chat turn. */
     requestId?: string;
+    /**
+     * Which composition graph this user's questions are answered from, as the
+     * relay stamped it: "draft" or a release seq. Absent means the live release.
+     */
+    graphVersion?: GraphVersion;
 }
+/** A composition graph version: the platform's working copy, or a published release seq. */
+type GraphVersion = 'draft' | number;
 /** The context for the current async chain, or `undefined` if none was established. */
 declare function getRequestContext(): RequestContext | undefined;
 /**
@@ -5161,6 +5173,7 @@ declare function runAsUser<T>(user: {
     projectId?: string;
     requestId?: string;
     policies?: SourcePolicy[];
+    graphVersion?: GraphVersion;
 }, fn: () => T): T;
 /**
  * Declare a unit of work as trusted, naming why.
@@ -6687,4 +6700,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };
+export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type GraphVersion, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };

package/dist/index.d.ts

@@ -2217,6 +2217,11 @@ interface AnswerProviderContext {
     context?: PromptContext;
     /** Files attached to this question (R2 references). Absent when none. */
     attachments?: PromptAttachment[];
+    /**
+     * The composition graph to answer from, from the relay-verified identity:
+     * "draft" or a release seq. Absent means the live release.
+     */
+    graphVersion?: 'draft' | number;
 }
 /**
  * One narrator tick while an answer was being produced: what the narrator was
@@ -5137,7 +5142,14 @@ interface RequestContext {
     policies?: SourcePolicy[];
     /** Correlates the audit log with a chat turn. */
     requestId?: string;
+    /**
+     * Which composition graph this user's questions are answered from, as the
+     * relay stamped it: "draft" or a release seq. Absent means the live release.
+     */
+    graphVersion?: GraphVersion;
 }
+/** A composition graph version: the platform's working copy, or a published release seq. */
+type GraphVersion = 'draft' | number;
 /** The context for the current async chain, or `undefined` if none was established. */
 declare function getRequestContext(): RequestContext | undefined;
 /**
@@ -5161,6 +5173,7 @@ declare function runAsUser<T>(user: {
     projectId?: string;
     requestId?: string;
     policies?: SourcePolicy[];
+    graphVersion?: GraphVersion;
 }, fn: () => T): T;
 /**
  * Declare a unit of work as trusted, naming why.
@@ -6687,4 +6700,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };
+export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type GraphVersion, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };

package/dist/index.js

@@ -421,7 +421,10 @@ var UserPromptRequestPayloadSchema = import_zod3.z.object({
 var MessageAuthContextSchema = import_zod3.z.object({
   userId: import_zod3.z.string(),
   orgId: import_zod3.z.string().optional(),
-  role: import_zod3.z.string().optional()
+  role: import_zod3.z.string().optional(),
+  // "draft" or a release seq; checked where it is read (request-identity.ts), so
+  // an unexpected value counts as the live release instead of rejecting the message.
+  graphVersion: import_zod3.z.unknown().optional()
 });
 var UserPromptRequestMessageSchema = import_zod3.z.object({
   id: import_zod3.z.string(),
@@ -1945,9 +1948,9 @@ function runWithContext(ctx, fn) {
   return getStorage().run(ctx, fn);
 }
 function runAsUser(user, fn) {
-  const { userId, orgId, role, projectId, requestId, policies } = user;
+  const { userId, orgId, role, projectId, requestId, policies, graphVersion } = user;
   return runWithContext(
-    { principal: { kind: "user", userId, orgId, role }, projectId, requestId, policies },
+    { principal: { kind: "user", userId, orgId, role }, projectId, requestId, policies, ...graphVersion !== void 0 ? { graphVersion } : {} },
     fn
   );
 }
@@ -2625,6 +2628,10 @@ function buildDirectToolCacheKey(toolId, parameters) {
 }
 
 // src/handlers/request-identity.ts
+function graphVersionOf(v) {
+  if (v === "draft") return "draft";
+  return Number.isInteger(v) && v > 0 ? v : void 0;
+}
 function policiesFromConfig(config2) {
   const entries = Array.isArray(config2) ? config2 : [config2];
   const out = [];
@@ -2693,7 +2700,15 @@ function runWithMessageIdentity(message, fn) {
       }
     }
     return runAsUser(
-      { userId: verified.userId, orgId: verified.orgId, role: verified.role, requestId, policies },
+      {
+        userId: verified.userId,
+        orgId: verified.orgId,
+        role: verified.role,
+        requestId,
+        policies,
+        // Only from the verified context: an unverified message has no say in which graph answers.
+        graphVersion: graphVersionOf(verified.graphVersion)
+      },
       fn
     );
   }
@@ -19820,7 +19835,8 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
       onNarration: narrationCallback,
       signal: abortController.signal,
       context: promptContextFrom(payload.context),
-      attachments
+      attachments,
+      graphVersion: getRequestContext()?.graphVersion
     }) : await get_agent_user_response(
       prompt,
       components,

package/dist/index.mjs

@@ -310,7 +310,10 @@ var UserPromptRequestPayloadSchema = z3.object({
 var MessageAuthContextSchema = z3.object({
   userId: z3.string(),
   orgId: z3.string().optional(),
-  role: z3.string().optional()
+  role: z3.string().optional(),
+  // "draft" or a release seq; checked where it is read (request-identity.ts), so
+  // an unexpected value counts as the live release instead of rejecting the message.
+  graphVersion: z3.unknown().optional()
 });
 var UserPromptRequestMessageSchema = z3.object({
   id: z3.string(),
@@ -1834,9 +1837,9 @@ function runWithContext(ctx, fn) {
   return getStorage().run(ctx, fn);
 }
 function runAsUser(user, fn) {
-  const { userId, orgId, role, projectId, requestId, policies } = user;
+  const { userId, orgId, role, projectId, requestId, policies, graphVersion } = user;
   return runWithContext(
-    { principal: { kind: "user", userId, orgId, role }, projectId, requestId, policies },
+    { principal: { kind: "user", userId, orgId, role }, projectId, requestId, policies, ...graphVersion !== void 0 ? { graphVersion } : {} },
     fn
   );
 }
@@ -2514,6 +2517,10 @@ function buildDirectToolCacheKey(toolId, parameters) {
 }
 
 // src/handlers/request-identity.ts
+function graphVersionOf(v) {
+  if (v === "draft") return "draft";
+  return Number.isInteger(v) && v > 0 ? v : void 0;
+}
 function policiesFromConfig(config2) {
   const entries = Array.isArray(config2) ? config2 : [config2];
   const out = [];
@@ -2582,7 +2589,15 @@ function runWithMessageIdentity(message, fn) {
       }
     }
     return runAsUser(
-      { userId: verified.userId, orgId: verified.orgId, role: verified.role, requestId, policies },
+      {
+        userId: verified.userId,
+        orgId: verified.orgId,
+        role: verified.role,
+        requestId,
+        policies,
+        // Only from the verified context: an unverified message has no say in which graph answers.
+        graphVersion: graphVersionOf(verified.graphVersion)
+      },
       fn
     );
   }
@@ -19709,7 +19724,8 @@ var get_user_request = async (data, components, sendMessage, anthropicApiKey, gr
       onNarration: narrationCallback,
       signal: abortController.signal,
       context: promptContextFrom(payload.context),
-      attachments
+      attachments,
+      graphVersion: getRequestContext()?.graphVersion
     }) : await get_agent_user_response(
       prompt,
       components,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superatomai/sdk-node",
-  "version": "0.0.80-dsp",
+  "version": "0.0.81-dsp",
   "description": "Node.js TypeScript SDK for Superatom",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",