basion-ai-sdk 0.19.0 → 0.20.0

package/dist/{app-ChZ3-kr7.d.ts → app-CfmWOkE7.d.ts}

@@ -377,6 +377,46 @@ interface CreateConversationPayload {
     isNew?: boolean;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Payload for creating an issue on a conversation.
+ *
+ * Attribution is caller-supplied and unopinionated:
+ *  - agent/judge callers pass `creatorType: 'agent'` + `createdByAgent`
+ *  - human callers pass `createdBy` (an auth.users id)
+ * When omitted, conversation-store resolves attribution from request context
+ * (no X-User-ID header ⇒ agent path).
+ */
+interface CreateIssuePayload {
+    /** Category KEY: 'factual_error' | 'tool_error' | 'communication' | 'safety' | 'other' */
+    category: string;
+    description: string;
+    severity?: 'low' | 'medium' | 'high' | 'critical';
+    messageId?: string;
+    creatorType?: 'evaluator' | 'admin' | 'agent';
+    createdByAgent?: string;
+    createdBy?: string;
+}
+/**
+ * Issue record returned by conversation-store (camelCase view of the API's
+ * snake_case IssueResponse).
+ */
+interface IssueData {
+    id: string;
+    conversationId: string;
+    messageId: string | null;
+    categoryId: string;
+    severity: string;
+    status: string;
+    description: string;
+    resolutionNote: string | null;
+    createdBy: string | null;
+    createdByAgent: string | null;
+    creatorType: string;
+    resolvedBy: string | null;
+    resolvedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
 /**
  * HTTP client for interacting with conversation-store API.
  */
@@ -399,6 +439,13 @@ declare class ConversationClient {
      * Update conversation fields (PATCH).
      */
     updateConversation(conversationId: string, data: Partial<ConversationData>): Promise<ConversationData>;
+    /**
+     * Create an issue on a conversation (or a specific message).
+     *
+     * Sends no X-User-ID header, so conversation-store treats the caller as a
+     * trusted service/agent and honors body-supplied attribution.
+     */
+    createIssue(conversationId: string, payload: CreateIssuePayload): Promise<IssueData>;
 }
 
 /**
@@ -2947,4 +2994,4 @@ declare class BasionAgentApp {
     private doShutdown;
 }
 
-export { ConversationMessage as $, type AttachmentInfo as A, BasionAgentApp as B, type CheckboxConfig as C, type DatePickerConfig as D, AttachmentClient as E, type Field as F, GatewayClient as G, type HiddenConfig as H, type InferFields as I, type JudgeHandler as J, type BinaryResult as K, type BraintrustConfig as L, type MultiSelectConfig as M, type NumberConfig as N, type OptionDef as O, type BundleRenderOptions as P, type Capability as Q, type CapabilityItem as R, StructuralStreamer as S, type TextConfig as T, type ChunkResult as U, type ValidationResult as V, type ConnectionState as W, type ConnectionStateListener as X, Conversation as Y, ConversationClient as Z, type ConversationData as _, type CheckboxGroupConfig as a, type SentryLoggerProxy as a$, DEFAULT_RECONNECTION_OPTIONS as a0, type DraftDecision as a1, type DraftResult as a2, type Edge as a3, type Entity as a4, type ExpandValueSetResult as a5, type GenuiComponent as a6, type GenuiComponentDict as a7, type GetMessagesOptions as a8, type GroupedMatch as a9, MemoryV2 as aA, MemoryV2Client as aB, type MemoryV2IngestPayload as aC, type MemoryV2SearchPayload as aD, type Need as aE, type NeedItem as aF, type NeedWithMatches as aG, type PathStep as aH, PatientProfileClient as aI, type PdfOptions as aJ, type ProduceAck as aK, type Prompt as aL, type QueryOptions as aM, type ReconnectionOptions as aN, type RegisterJudgeOptions as aO, type RegisterOptions as aP, type RelatedPage as aQ, type RenderBufferResult as aR, RenderClient as aS, type RenderOptions as aT, type RenderResult as aU, type SearchMatch as aV, type SearchOptions as aW, type SearchResult as aX, SenderFilter as aY, type SenderFilterOptions as aZ, type SentryConfig as a_, type GroupedMatchEntry as aa, type HeartbeatFailureCallback as ab, HeartbeatManager as ac, type HeartbeatOptions as ad, type IngestResponse as ae, type JudgeContext as af, type JudgeMetricDef as ag, type JudgeRequestPayload as ah, type JudgeVerdict as ai, type JudgeVerdictMetric as aj, type KafkaHeaders as ak, type KafkaMessage as al, KnowledgeGraphTool as am, type LogEntry as an, type LogLevel as ao, type LokiHandlerOptions as ap, LokiLogHandler as aq, type LookupCodeResult as ar, MatchingClient as as, MatchingTool as at, Memory as au, MemoryClient as av, type MemoryIngestOptions as aw, type MemoryMessage as ax, type MemorySearchOptions as ay, type MemorySearchResult as az, type FileFieldConfig as b, type SimilarDisease as b0, type StreamOptions as b1, Streamer as b2, type StreamerOptions as b3, Tools as b4, type UserSummary as b5, type ValidateCodeResult as b6, createAttachmentInfo as b7, getSentryLogger as b8, isBraintrustEnabled as b9, isSentryEnabled as ba, reportPath as bb, type SelectConfig as c, type SliderConfig as d, type SwitchConfig as e, type ConfirmationConfig as f, Message as g, type ConfirmationResult as h, type StepDef as i, type ToDict as j, type AccordionItemDef as k, type AccordionConfig as l, type AccordionComponentDict as m, type CardVariant as n, type CardSectionDef as o, type CardButtonDef as p, type CardConfig as q, type CardComponentDict as r, Agent as s, type MessageHandler as t, type AgentInfo as u, AgentInventoryTool as v, type AgentRegistrationData as w, type AgentSqlResult as x, type AppOptions as y, type ApproveDraftResult as z };
+export { ConversationMessage as $, type AttachmentInfo as A, BasionAgentApp as B, type CheckboxConfig as C, type DatePickerConfig as D, AttachmentClient as E, type Field as F, GatewayClient as G, type HiddenConfig as H, type InferFields as I, type JudgeHandler as J, type BinaryResult as K, type BraintrustConfig as L, type MultiSelectConfig as M, type NumberConfig as N, type OptionDef as O, type BundleRenderOptions as P, type Capability as Q, type CapabilityItem as R, StructuralStreamer as S, type TextConfig as T, type ChunkResult as U, type ValidationResult as V, type ConnectionState as W, type ConnectionStateListener as X, Conversation as Y, ConversationClient as Z, type ConversationData as _, type CheckboxGroupConfig as a, type SenderFilterOptions as a$, type CreateIssuePayload as a0, DEFAULT_RECONNECTION_OPTIONS as a1, type DraftDecision as a2, type DraftResult as a3, type Edge as a4, type Entity as a5, type ExpandValueSetResult as a6, type GenuiComponent as a7, type GenuiComponentDict as a8, type GetMessagesOptions as a9, type MemorySearchOptions as aA, type MemorySearchResult as aB, MemoryV2 as aC, MemoryV2Client as aD, type MemoryV2IngestPayload as aE, type MemoryV2SearchPayload as aF, type Need as aG, type NeedItem as aH, type NeedWithMatches as aI, type PathStep as aJ, PatientProfileClient as aK, type PdfOptions as aL, type ProduceAck as aM, type Prompt as aN, type QueryOptions as aO, type ReconnectionOptions as aP, type RegisterJudgeOptions as aQ, type RegisterOptions as aR, type RelatedPage as aS, type RenderBufferResult as aT, RenderClient as aU, type RenderOptions as aV, type RenderResult as aW, type SearchMatch as aX, type SearchOptions as aY, type SearchResult as aZ, SenderFilter as a_, type GroupedMatch as aa, type GroupedMatchEntry as ab, type HeartbeatFailureCallback as ac, HeartbeatManager as ad, type HeartbeatOptions as ae, type IngestResponse as af, type IssueData as ag, type JudgeContext as ah, type JudgeMetricDef as ai, type JudgeRequestPayload as aj, type JudgeVerdict as ak, type JudgeVerdictMetric as al, type KafkaHeaders as am, type KafkaMessage as an, KnowledgeGraphTool as ao, type LogEntry as ap, type LogLevel as aq, type LokiHandlerOptions as ar, LokiLogHandler as as, type LookupCodeResult as at, MatchingClient as au, MatchingTool as av, Memory as aw, MemoryClient as ax, type MemoryIngestOptions as ay, type MemoryMessage as az, type FileFieldConfig as b, type SentryConfig as b0, type SentryLoggerProxy as b1, type SimilarDisease as b2, type StreamOptions as b3, Streamer as b4, type StreamerOptions as b5, Tools as b6, type UserSummary as b7, type ValidateCodeResult as b8, createAttachmentInfo as b9, getSentryLogger as ba, isBraintrustEnabled as bb, isSentryEnabled as bc, reportPath as bd, type SelectConfig as c, type SliderConfig as d, type SwitchConfig as e, type ConfirmationConfig as f, Message as g, type ConfirmationResult as h, type StepDef as i, type ToDict as j, type AccordionItemDef as k, type AccordionConfig as l, type AccordionComponentDict as m, type CardVariant as n, type CardSectionDef as o, type CardButtonDef as p, type CardConfig as q, type CardComponentDict as r, Agent as s, type MessageHandler as t, type AgentInfo as u, AgentInventoryTool as v, type AgentRegistrationData as w, type AgentSqlResult as x, type AppOptions as y, type ApproveDraftResult as z };

package/dist/extensions/langgraph.d.ts

@@ -1,4 +1,4 @@
-import { B as BasionAgentApp } from '../app-ChZ3-kr7.js';
+import { B as BasionAgentApp } from '../app-CfmWOkE7.js';
 import 'zod';
 import '../vfs-client-CsHAFj1R.js';
 

package/dist/extensions/vercel-ai.d.ts

@@ -1,4 +1,4 @@
-import { B as BasionAgentApp } from '../app-ChZ3-kr7.js';
+import { B as BasionAgentApp } from '../app-CfmWOkE7.js';
 import 'zod';
 import '../vfs-client-CsHAFj1R.js';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { G as GatewayClient, S as StructuralStreamer, C as CheckboxConfig, F as Field, a as CheckboxGroupConfig, D as DatePickerConfig, b as FileFieldConfig, A as AttachmentInfo, H as HiddenConfig, M as MultiSelectConfig, N as NumberConfig, O as OptionDef, c as SelectConfig, d as SliderConfig, e as SwitchConfig, T as TextConfig, f as ConfirmationConfig, g as Message, h as ConfirmationResult, I as InferFields, V as ValidationResult, i as StepDef, j as ToDict, k as AccordionItemDef, l as AccordionConfig, m as AccordionComponentDict, n as CardVariant, o as CardSectionDef, p as CardButtonDef, q as CardConfig, r as CardComponentDict, B as BasionAgentApp, s as Agent, J as JudgeHandler, t as MessageHandler } from './app-ChZ3-kr7.js';
-export { u as AgentInfo, v as AgentInventoryTool, w as AgentRegistrationData, x as AgentSqlResult, y as AppOptions, z as ApproveDraftResult, E as AttachmentClient, K as BinaryResult, L as BraintrustConfig, P as BundleRenderOptions, Q as Capability, R as CapabilityItem, U as ChunkResult, W as ConnectionState, X as ConnectionStateListener, Y as Conversation, Z as ConversationClient, _ as ConversationData, $ as ConversationMessage, a0 as DEFAULT_RECONNECTION_OPTIONS, a1 as DraftDecision, a2 as DraftResult, a3 as Edge, a4 as Entity, a5 as ExpandValueSetResult, a6 as GenuiComponent, a7 as GenuiComponentDict, a8 as GetMessagesOptions, a9 as GroupedMatch, aa as GroupedMatchEntry, ab as HeartbeatFailureCallback, ac as HeartbeatManager, ad as HeartbeatOptions, ae as IngestResponse, af as JudgeContext, ag as JudgeMetricDef, ah as JudgeRequestPayload, ai as JudgeVerdict, aj as JudgeVerdictMetric, ak as KafkaHeaders, al as KafkaMessage, am as KnowledgeGraphTool, an as LogEntry, ao as LogLevel, ap as LokiHandlerOptions, aq as LokiLogHandler, ar as LookupCodeResult, as as MatchingClient, at as MatchingTool, au as Memory, av as MemoryClient, aw as MemoryIngestOptions, ax as MemoryMessage, ay as MemorySearchOptions, az as MemorySearchResult, aA as MemoryV2, aB as MemoryV2Client, aC as MemoryV2IngestPayload, aD as MemoryV2SearchPayload, aE as Need, aF as NeedItem, aG as NeedWithMatches, aH as PathStep, aI as PatientProfileClient, aJ as PdfOptions, aK as ProduceAck, aL as Prompt, aM as QueryOptions, aN as ReconnectionOptions, aO as RegisterJudgeOptions, aP as RegisterOptions, aQ as RelatedPage, aR as RenderBufferResult, aS as RenderClient, aT as RenderOptions, aU as RenderResult, aV as SearchMatch, aW as SearchOptions, aX as SearchResult, aY as SenderFilter, aZ as SenderFilterOptions, a_ as SentryConfig, a$ as SentryLoggerProxy, b0 as SimilarDisease, b1 as StreamOptions, b2 as Streamer, b3 as StreamerOptions, b4 as Tools, b5 as UserSummary, b6 as ValidateCodeResult, b7 as createAttachmentInfo, b8 as getSentryLogger, b9 as isBraintrustEnabled, ba as isSentryEnabled, bb as reportPath } from './app-ChZ3-kr7.js';
+import { G as GatewayClient, S as StructuralStreamer, C as CheckboxConfig, F as Field, a as CheckboxGroupConfig, D as DatePickerConfig, b as FileFieldConfig, A as AttachmentInfo, H as HiddenConfig, M as MultiSelectConfig, N as NumberConfig, O as OptionDef, c as SelectConfig, d as SliderConfig, e as SwitchConfig, T as TextConfig, f as ConfirmationConfig, g as Message, h as ConfirmationResult, I as InferFields, V as ValidationResult, i as StepDef, j as ToDict, k as AccordionItemDef, l as AccordionConfig, m as AccordionComponentDict, n as CardVariant, o as CardSectionDef, p as CardButtonDef, q as CardConfig, r as CardComponentDict, B as BasionAgentApp, s as Agent, J as JudgeHandler, t as MessageHandler } from './app-CfmWOkE7.js';
+export { u as AgentInfo, v as AgentInventoryTool, w as AgentRegistrationData, x as AgentSqlResult, y as AppOptions, z as ApproveDraftResult, E as AttachmentClient, K as BinaryResult, L as BraintrustConfig, P as BundleRenderOptions, Q as Capability, R as CapabilityItem, U as ChunkResult, W as ConnectionState, X as ConnectionStateListener, Y as Conversation, Z as ConversationClient, _ as ConversationData, $ as ConversationMessage, a0 as CreateIssuePayload, a1 as DEFAULT_RECONNECTION_OPTIONS, a2 as DraftDecision, a3 as DraftResult, a4 as Edge, a5 as Entity, a6 as ExpandValueSetResult, a7 as GenuiComponent, a8 as GenuiComponentDict, a9 as GetMessagesOptions, aa as GroupedMatch, ab as GroupedMatchEntry, ac as HeartbeatFailureCallback, ad as HeartbeatManager, ae as HeartbeatOptions, af as IngestResponse, ag as IssueData, ah as JudgeContext, ai as JudgeMetricDef, aj as JudgeRequestPayload, ak as JudgeVerdict, al as JudgeVerdictMetric, am as KafkaHeaders, an as KafkaMessage, ao as KnowledgeGraphTool, ap as LogEntry, aq as LogLevel, ar as LokiHandlerOptions, as as LokiLogHandler, at as LookupCodeResult, au as MatchingClient, av as MatchingTool, aw as Memory, ax as MemoryClient, ay as MemoryIngestOptions, az as MemoryMessage, aA as MemorySearchOptions, aB as MemorySearchResult, aC as MemoryV2, aD as MemoryV2Client, aE as MemoryV2IngestPayload, aF as MemoryV2SearchPayload, aG as Need, aH as NeedItem, aI as NeedWithMatches, aJ as PathStep, aK as PatientProfileClient, aL as PdfOptions, aM as ProduceAck, aN as Prompt, aO as QueryOptions, aP as ReconnectionOptions, aQ as RegisterJudgeOptions, aR as RegisterOptions, aS as RelatedPage, aT as RenderBufferResult, aU as RenderClient, aV as RenderOptions, aW as RenderResult, aX as SearchMatch, aY as SearchOptions, aZ as SearchResult, a_ as SenderFilter, a$ as SenderFilterOptions, b0 as SentryConfig, b1 as SentryLoggerProxy, b2 as SimilarDisease, b3 as StreamOptions, b4 as Streamer, b5 as StreamerOptions, b6 as Tools, b7 as UserSummary, b8 as ValidateCodeResult, b9 as createAttachmentInfo, ba as getSentryLogger, bb as isBraintrustEnabled, bc as isSentryEnabled, bd as reportPath } from './app-CfmWOkE7.js';
 export { V as VfsBatchOperation, a as VfsBranch, b as VfsClient, c as VfsCommit, d as VfsCreateBranchOptions, e as VfsCreateFilesystemOptions, f as VfsDeleteFileOptions, g as VfsDiffEntry, h as VfsDiffResult, i as VfsFilesystem, j as VfsMergeConflict, k as VfsMergeResult, l as VfsReadFileResult, m as VfsTreeEntry, n as VfsWriteFileOptions, o as VfsWriteFileResponse } from './vfs-client-CsHAFj1R.js';
 import 'zod';
 
@@ -783,6 +783,8 @@ declare const CONVERSATION_STORE_PATHS: {
     readonly CHECKPOINT_THREAD: (threadId: string) => string;
     /** Agent state by conversation ID */
     readonly AGENT_STATE: (conversationId: string) => string;
+    /** Issues on a conversation */
+    readonly ISSUES: (conversationId: string) => string;
 };
 /**
  * API paths for AI Memory service.

package/dist/index.js

@@ -400,7 +400,9 @@ var CONVERSATION_STORE_PATHS = {
   /** Checkpoint by thread ID */
   CHECKPOINT_THREAD: (threadId) => `/checkpoints/${threadId}`,
   /** Agent state by conversation ID */
-  AGENT_STATE: (conversationId) => `/agent-state/${conversationId}`
+  AGENT_STATE: (conversationId) => `/agent-state/${conversationId}`,
+  /** Issues on a conversation */
+  ISSUES: (conversationId) => `/conversations/${conversationId}/issues`
 };
 var MEMORY_PATHS = {
   /** User memory base */
@@ -3897,6 +3899,58 @@ var ConversationClient = class {
       throw new APIException(`Failed to update conversation: ${error}`);
     }
   }
+  /**
+   * Create an issue on a conversation (or a specific message).
+   *
+   * Sends no X-User-ID header, so conversation-store treats the caller as a
+   * trusted service/agent and honors body-supplied attribution.
+   */
+  async createIssue(conversationId, payload) {
+    const url = `${this.baseUrl}/conversations/${conversationId}/issues`;
+    const body = {
+      category: payload.category,
+      description: payload.description
+    };
+    if (payload.severity != null) body.severity = payload.severity;
+    if (payload.messageId != null) body.message_id = payload.messageId;
+    if (payload.creatorType != null) body.creator_type = payload.creatorType;
+    if (payload.createdByAgent != null) body.created_by_agent = payload.createdByAgent;
+    if (payload.createdBy != null) body.created_by = payload.createdBy;
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (response.status === 404) {
+        throw new APIException(`Conversation ${conversationId} not found`, 404);
+      }
+      if (!response.ok) {
+        throw new APIException(`Failed to create issue: ${response.status}`, response.status);
+      }
+      const raw = await response.json();
+      return {
+        id: raw.id,
+        conversationId: raw.conversation_id,
+        messageId: raw.message_id ?? null,
+        categoryId: raw.category_id,
+        severity: raw.severity,
+        status: raw.status,
+        description: raw.description,
+        resolutionNote: raw.resolution_note ?? null,
+        createdBy: raw.created_by ?? null,
+        createdByAgent: raw.created_by_agent ?? null,
+        creatorType: raw.creator_type,
+        resolvedBy: raw.resolved_by ?? null,
+        resolvedAt: raw.resolved_at ?? null,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at
+      };
+    } catch (error) {
+      if (error instanceof APIException) throw error;
+      throw new APIException(`Failed to create issue: ${error}`);
+    }
+  }
 };
 
 // src/memory-client.ts