@alquimia-ai/tools 2.7.0 → 2.8.0

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sdk/index.ts","../../src/sdk/alquimia-sdk.ts"],"sourcesContent":["export { default as AlquimiaSDK } from './alquimia-sdk';","import axios, { AxiosInstance } from 'axios';\nimport {\n  StableDiffusionProvider,\n  WhisperProvider,\n  CharacterizationProvider,\n  RatingsProvider,\n  LoggerProvider,\n} from '../providers';\nimport {\n  AttachmentPayload,\n  TTSResult,\n  type CommonAttributes,\n  type Content,\n  type RuntimeBlob,\n} from '../types';\nimport type { AlquimiaAdapter, AlquimiaSDKOptions } from '../adapters';\nimport type { ToolExecutionResponse } from '../genui/types';\n\n/** Per-turn options for {@link AlquimiaSDK.sendMessage}. */\nexport interface SendMessageOptions {\n  /** W3C traceparent, so infer and stream share one trace. */\n  traceParent?: string;\n  /**\n   * Audio input for this turn (runtime v0.5.1). Upload it with\n   * {@link AlquimiaSDK.uploadAttachment} first and pass the blob it returns.\n   * May be sent with or instead of `query`.\n   */\n  inputAudio?: RuntimeBlob;\n  /**\n   * Set to `false` to force a text-only reply from an audio-enabled agent.\n   * The runtime defaults to `true`, so leaving this unset keeps its behaviour.\n   */\n  outputAudio?: boolean;\n}\n\nclass AlquimiaSDK {\n  private adapter: AlquimiaAdapter;\n  private assistantId: string;\n  private axiosInstance: AxiosInstance;\n  private conversationId: string | null = null;\n  private sessionId: string | null = null;\n  // Internal subscription id from infer (`taskid` on the wire).\n  private streamId: string | null = null;\n  // W3C traceparent for the current turn, so infer and stream share one trace.\n  private traceParent: string | null = null;\n  // Registry version tag resolved by the runtime for this task (v0.5.1), so\n  // the tool-completion half of the turn lands on the same agentspace version.\n  private versionTag: string | null = null;\n  private tools: any = [];\n  private extraInstructions: Record<string, string> | null = null;\n  private assistantConfig: any = null;\n  private userId: string | null = null;\n  private whisperProvider?: WhisperProvider;\n  private stableDiffusionProvider?: StableDiffusionProvider;\n  private analyzeCharacterizationProvider?: CharacterizationProvider;\n  private ratingsProvider?: RatingsProvider;\n  private loggerProvider?: LoggerProvider;\n  private enforceCharacterization?: boolean;\n  private attachments: AttachmentPayload[] = [];\n  private attachmentResponses: string[] = [];\n\n  constructor(\n    assistantId: string,\n    adapter: AlquimiaAdapter,\n    options: AlquimiaSDKOptions = {}\n  ) {\n    if (!assistantId) {\n      throw new Error('AlquimiaSDK: assistantId is required');\n    }\n    if (!adapter) {\n      throw new Error(\n        'AlquimiaSDK: adapter is required. Use createNextJsAdapter() or createFetchAdapter()'\n      );\n    }\n\n    this.assistantId = assistantId;\n    this.adapter = adapter;\n    this.enforceCharacterization = options.enforceCharacterization ?? true;\n\n    this.axiosInstance = axios.create();\n    this.axiosInstance.interceptors.response.use(\n      (response) => response,\n      async (error) => {\n        if (error.response?.status && this.loggerProvider) {\n          await this.loggerProvider.logError('Server Error', error, {\n            url: error.config.url,\n            method: error.config.method,\n            data: error.config.data,\n            status: error.response.status,\n            responseData: error.response.data,\n          });\n        }\n        return Promise.reject(error);\n      }\n    );\n\n    this.textToSpeech = this.textToSpeech.bind(this);\n    this.speechToText = this.speechToText.bind(this);\n  }\n\n  withConversationId(conversationId: string): AlquimiaSDK {\n    this.conversationId = conversationId;\n    return this;\n  }\n\n  withAttachments(attachments: AttachmentPayload[]): AlquimiaSDK {\n    this.attachments = attachments;\n    return this;\n  }\n\n  withWhisperProvider(provider: WhisperProvider): AlquimiaSDK {\n    this.whisperProvider = provider;\n    return this;\n  }\n\n  withStableDiffusionProvider(provider: StableDiffusionProvider): AlquimiaSDK {\n    this.stableDiffusionProvider = provider;\n    return this;\n  }\n\n  withAnalyzeCharacterizationProvider(provider: CharacterizationProvider): AlquimiaSDK {\n    this.analyzeCharacterizationProvider = provider;\n    return this;\n  }\n\n  withRatingsProvider(provider: RatingsProvider): AlquimiaSDK {\n    this.ratingsProvider = provider;\n    return this;\n  }\n\n  withLoggerProvider(provider: LoggerProvider): AlquimiaSDK {\n    this.loggerProvider = provider;\n    return this;\n  }\n\n  withTools(tools: any): AlquimiaSDK {\n    this.tools = tools;\n    return this;\n  }\n\n  withExtraInstructions(extraInstructions: Record<string, string>): AlquimiaSDK {\n    this.extraInstructions = extraInstructions;\n    return this;\n  }\n\n  withAssistantConfig(assistantConfig: any): AlquimiaSDK {\n    this.assistantConfig = assistantConfig;\n    return this;\n  }\n\n  withUserId(userId: string): AlquimiaSDK {\n    this.userId = userId;\n    return this;\n  }\n\n  /**\n   * Pin inference to a cached registry version. Sent as the `version_tag`\n   * query parameter, which `POST /event/infer/{assistant_id}` accepts from\n   * **runtime v0.5.2** onward; older runtimes ignore it.\n   *\n   * Works on every version: pass a versioned assistant ref\n   * (`<agentspace>/<assistant>[:<tag>]`) as the `assistantId` instead — the\n   * runtime parses the tag out of the path itself.\n   */\n  withVersionTag(versionTag: string): AlquimiaSDK {\n    this.versionTag = versionTag;\n    return this;\n  }\n\n  getEnforceCharacterization(): boolean {\n    return this.enforceCharacterization ?? true;\n  }\n\n  textToSpeech(text: string): Promise<TTSResult> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.textToSpeech(text);\n  }\n\n  speechToText(audio: string): Promise<string> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.speechToText(audio);\n  }\n\n  async sendMessage(\n    query?: Content,\n    options: string | SendMessageOptions = {}\n  ): Promise<AlquimiaSDK> {\n    if (!this.conversationId) {\n      throw new Error(\n        'Conversation not initialized. Call withConversationId() before sendMessage()'\n      );\n    }\n\n    // Backwards-compat: the previous signature was sendMessage(query, traceParent?).\n    const opts: SendMessageOptions =\n      typeof options === 'string' ? { traceParent: options } : options;\n\n    if (query === undefined && !opts.inputAudio) {\n      throw new Error(\n        'AlquimiaSDK: sendMessage needs a query, an inputAudio blob, or both'\n      );\n    }\n\n    const baseInferUrl = this.adapter.resolveInferUrl(this.assistantId);\n    // `version_tag` is a query parameter on infer (runtime v0.5.2+), never a\n    // header — the runtime reads it with `Query(...)`.\n    const inferUrl = this.versionTag\n      ? `${baseInferUrl}${baseInferUrl.includes('?') ? '&' : '?'}version_tag=${encodeURIComponent(this.versionTag)}`\n      : baseInferUrl;\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n\n    const hasClientTools = Array.isArray(this.tools) && this.tools.length > 0;\n\n    const initMessage: Record<string, unknown> = {\n      ...(query !== undefined && { query }),\n      session_id: this.conversationId,\n      user_id: this.userId,\n      ...(opts.inputAudio && { input_audio: opts.inputAudio }),\n      // Only sent when set: the runtime defaults `output_audio` to true.\n      ...(opts.outputAudio !== undefined && { output_audio: opts.outputAudio }),\n      ...(this.extraInstructions && { extra_instructions: this.extraInstructions }),\n      ...(this.assistantConfig && { config: this.assistantConfig }),\n      ...(hasClientTools && {\n        evaluation_strategy: {\n          evaluation_strategy_id: 'native',\n          tool_schemas: this.tools,\n        },\n      }),\n    };\n\n    const result = (\n      await this.axiosInstance.post(inferUrl, initMessage, {\n        headers: {\n          'Content-Type': 'application/json',\n          ...(opts.traceParent && { 'x-trace-parent': opts.traceParent }),\n          ...adapterHeaders,\n          ...this.buildIdentityHeaders(),\n        },\n      })\n    ).data as CommonAttributes;\n\n    this.traceParent = opts.traceParent ?? null;\n    this.streamId = result.taskid ?? null;\n    this.versionTag = result.versiontag ?? this.versionTag;\n    this.attachmentResponses = result.attachments ?? [];\n    this.attachments = [];\n\n    return this;\n  }\n\n  /**\n   * Complete a pending client-tool execution (the missing \"submit half\" of the\n   * client-tool loop). POSTs a {@link ToolExecutionResponse} to the runtime's\n   * `/event/tool-completion`. For interactive `render_ui` surfaces `result` is\n   * the user's data; for display-only surfaces the SDK sends `{ shown: true }`.\n   * The pending call is correlated by `control_id` in the body + the\n   * `context-metadata` header (taskid + sessionid).\n   */\n  async submitToolResult(response: ToolExecutionResponse): Promise<void> {\n    const url = this.adapter.resolveToolCompletionUrl?.();\n    if (!url) {\n      throw new Error(\n        'AlquimiaSDK: adapter does not support tool completion (resolveToolCompletionUrl missing)'\n      );\n    }\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      assistantid: this.assistantId,\n      ...(this.streamId && { taskid: this.streamId }),\n      ...(this.conversationId && { sessionid: this.conversationId }),\n      ...(this.userId && { userid: this.userId }),\n      ...(this.versionTag && { versiontag: this.versionTag }),\n      ...adapterHeaders,\n    };\n    await this.axiosInstance.post(url, response, { headers });\n  }\n\n  async generateImage(query: string): Promise<string> {\n    if (!this.stableDiffusionProvider) {\n      throw new Error('Stable Diffusion provider not initialized');\n    }\n    return this.stableDiffusionProvider.generateImage(query);\n  }\n\n  async analyzeCharacterization(text: string): Promise<Record<string, any>> {\n    if (!this.analyzeCharacterizationProvider) {\n      throw new Error('Analyze characterization provider not initialized');\n    }\n    return this.analyzeCharacterizationProvider.analyzeCharacterization(text);\n  }\n\n  async rate(data: any): Promise<Record<string, any>> {\n    if (!this.ratingsProvider) {\n      throw new Error('Ratings provider not initialized');\n    }\n    return this.ratingsProvider.rate(data);\n  }\n\n  async logInfo(message: string, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logInfo(message, data);\n  }\n\n  async logError(message: string, error: Error, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logError(message, error, data);\n  }\n\n  /**\n   * @deprecated The runtime no longer returns attachment IDs from the infer\n   * response — attachments are uploaded as standalone blobs and linked to the\n   * session via headers. Always returns `[]`; kept for source compatibility.\n   */\n  getAttachmentResponses(): string[] {\n    return this.attachmentResponses;\n  }\n\n  /**\n   * Upload a file into the session context. Returns the runtime {@link RuntimeBlob},\n   * which is what `sendMessage`'s `inputAudio` expects for audio inference.\n   */\n  async uploadAttachment(file: File, _attachmentId?: string): Promise<RuntimeBlob> {\n    void _attachmentId;\n    const url = this.adapter.resolveBlobUploadUrl();\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n    const formData = new FormData();\n    formData.append('file', file);\n    const response = await this.axiosInstance.post(url, formData, {\n      headers: {\n        'Content-Type': 'multipart/form-data',\n        ...adapterHeaders,\n        ...this.buildIdentityHeaders(),\n      },\n    });\n    return response.data as RuntimeBlob;\n  }\n\n  /**\n   * Identity headers (kebab-case) required by `/context/blob/upload` and\n   * the rest of the runtime's internal endpoints introduced in v0.2.0→next.\n   */\n  private buildIdentityHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'assistant-id': this.assistantId,\n    };\n    if (this.conversationId) headers['session-id'] = this.conversationId;\n    if (this.userId) headers['user-id'] = this.userId;\n    if (this.streamId) headers['task-id'] = this.streamId;\n    return headers;\n  }\n\n  getUrlStream(): string {\n    if (!this.streamId) {\n      throw new Error('Stream ID not initialized. Call sendMessage() first');\n    }\n\n    const url = this.adapter.resolveStreamUrl(this.streamId);\n    if (!this.traceParent) return url;\n\n    // `EventSource` cannot set request headers, so the turn's traceparent rides\n    // the URL. The proxy turns it back into `x-trace-parent` and does not pass\n    // the param upstream; without this the stream leg — where the whole\n    // inference actually happens — lands in a different trace than the infer.\n    const separator = url.includes('?') ? '&' : '?';\n    return `${url}${separator}trace_parent=${encodeURIComponent(this.traceParent)}`;\n  }\n\n  getStreamId(): string | null {\n    return this.streamId;\n  }\n\n  /** Alias for {@link getStreamId} — same value as infer `taskid`. */\n  getTaskId(): string | null {\n    return this.streamId;\n  }\n\n  /** Registry version tag resolved by the runtime for the current task, if any. */\n  getVersionTag(): string | null {\n    return this.versionTag;\n  }\n}\n\nexport default AlquimiaSDK;\n"],"mappings":"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","names":["axios"]}
+{"version":3,"sources":["../../src/sdk/index.ts","../../src/sdk/alquimia-sdk.ts"],"sourcesContent":["export { default as AlquimiaSDK } from './alquimia-sdk';","import axios, { AxiosInstance } from 'axios';\nimport {\n  StableDiffusionProvider,\n  WhisperProvider,\n  CharacterizationProvider,\n  RatingsProvider,\n  LoggerProvider,\n} from '../providers';\nimport {\n  AttachmentPayload,\n  TTSResult,\n  type CommonAttributes,\n  type Content,\n  type RuntimeBlob,\n  type ToolApprovalEvent,\n  type ToolApprovalOutcome,\n  type ToolApprovalResult,\n} from '../types';\nimport type { AlquimiaAdapter, AlquimiaSDKOptions } from '../adapters';\nimport type { ToolExecutionResponse } from '../genui/types';\n\n/** Per-turn options for {@link AlquimiaSDK.sendMessage}. */\nexport interface SendMessageOptions {\n  /** W3C traceparent, so infer and stream share one trace. */\n  traceParent?: string;\n  /**\n   * Audio input for this turn (runtime v0.5.1). Upload it with\n   * {@link AlquimiaSDK.uploadAttachment} first and pass the blob it returns.\n   * May be sent with or instead of `query`.\n   */\n  inputAudio?: RuntimeBlob;\n  /**\n   * Set to `false` to force a text-only reply from an audio-enabled agent.\n   * The runtime defaults to `true`, so leaving this unset keeps its behaviour.\n   */\n  outputAudio?: boolean;\n}\n\nclass AlquimiaSDK {\n  private adapter: AlquimiaAdapter;\n  private assistantId: string;\n  private axiosInstance: AxiosInstance;\n  private conversationId: string | null = null;\n  private sessionId: string | null = null;\n  // Internal subscription id from infer (`taskid` on the wire).\n  private streamId: string | null = null;\n  // W3C traceparent for the current turn, so infer and stream share one trace.\n  private traceParent: string | null = null;\n  // Registry version tag resolved by the runtime for this task (v0.5.1), so\n  // the tool-completion half of the turn lands on the same agentspace version.\n  private versionTag: string | null = null;\n  // Agentspace the runtime resolved for this task. Tool completion and\n  // approval authorize a non-admin caller against it, so it is echoed back.\n  private agentspaceId: string | null = null;\n  private tools: any = [];\n  private extraInstructions: Record<string, string> | null = null;\n  private assistantConfig: any = null;\n  private userId: string | null = null;\n  private whisperProvider?: WhisperProvider;\n  private stableDiffusionProvider?: StableDiffusionProvider;\n  private analyzeCharacterizationProvider?: CharacterizationProvider;\n  private ratingsProvider?: RatingsProvider;\n  private loggerProvider?: LoggerProvider;\n  private enforceCharacterization?: boolean;\n  private attachments: AttachmentPayload[] = [];\n  private attachmentResponses: string[] = [];\n\n  constructor(\n    assistantId: string,\n    adapter: AlquimiaAdapter,\n    options: AlquimiaSDKOptions = {}\n  ) {\n    if (!assistantId) {\n      throw new Error('AlquimiaSDK: assistantId is required');\n    }\n    if (!adapter) {\n      throw new Error(\n        'AlquimiaSDK: adapter is required. Use createNextJsAdapter() or createFetchAdapter()'\n      );\n    }\n\n    this.assistantId = assistantId;\n    this.adapter = adapter;\n    this.enforceCharacterization = options.enforceCharacterization ?? true;\n\n    this.axiosInstance = axios.create();\n    this.axiosInstance.interceptors.response.use(\n      (response) => response,\n      async (error) => {\n        if (error.response?.status && this.loggerProvider) {\n          await this.loggerProvider.logError('Server Error', error, {\n            url: error.config.url,\n            method: error.config.method,\n            data: error.config.data,\n            status: error.response.status,\n            responseData: error.response.data,\n          });\n        }\n        return Promise.reject(error);\n      }\n    );\n\n    this.textToSpeech = this.textToSpeech.bind(this);\n    this.speechToText = this.speechToText.bind(this);\n  }\n\n  withConversationId(conversationId: string): AlquimiaSDK {\n    this.conversationId = conversationId;\n    return this;\n  }\n\n  withAttachments(attachments: AttachmentPayload[]): AlquimiaSDK {\n    this.attachments = attachments;\n    return this;\n  }\n\n  withWhisperProvider(provider: WhisperProvider): AlquimiaSDK {\n    this.whisperProvider = provider;\n    return this;\n  }\n\n  withStableDiffusionProvider(provider: StableDiffusionProvider): AlquimiaSDK {\n    this.stableDiffusionProvider = provider;\n    return this;\n  }\n\n  withAnalyzeCharacterizationProvider(provider: CharacterizationProvider): AlquimiaSDK {\n    this.analyzeCharacterizationProvider = provider;\n    return this;\n  }\n\n  withRatingsProvider(provider: RatingsProvider): AlquimiaSDK {\n    this.ratingsProvider = provider;\n    return this;\n  }\n\n  withLoggerProvider(provider: LoggerProvider): AlquimiaSDK {\n    this.loggerProvider = provider;\n    return this;\n  }\n\n  withTools(tools: any): AlquimiaSDK {\n    this.tools = tools;\n    return this;\n  }\n\n  withExtraInstructions(extraInstructions: Record<string, string>): AlquimiaSDK {\n    this.extraInstructions = extraInstructions;\n    return this;\n  }\n\n  withAssistantConfig(assistantConfig: any): AlquimiaSDK {\n    this.assistantConfig = assistantConfig;\n    return this;\n  }\n\n  withUserId(userId: string): AlquimiaSDK {\n    this.userId = userId;\n    return this;\n  }\n\n  /**\n   * Pin inference to a cached registry version. Sent as the `version_tag`\n   * query parameter, which `POST /event/infer/{assistant_id}` accepts from\n   * **runtime v0.5.2** onward; older runtimes ignore it.\n   *\n   * Works on every version: pass a versioned assistant ref\n   * (`<agentspace>/<assistant>[:<tag>]`) as the `assistantId` instead — the\n   * runtime parses the tag out of the path itself.\n   */\n  withVersionTag(versionTag: string): AlquimiaSDK {\n    this.versionTag = versionTag;\n    return this;\n  }\n\n  getEnforceCharacterization(): boolean {\n    return this.enforceCharacterization ?? true;\n  }\n\n  textToSpeech(text: string): Promise<TTSResult> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.textToSpeech(text);\n  }\n\n  speechToText(audio: string): Promise<string> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.speechToText(audio);\n  }\n\n  async sendMessage(\n    query?: Content,\n    options: string | SendMessageOptions = {}\n  ): Promise<AlquimiaSDK> {\n    if (!this.conversationId) {\n      throw new Error(\n        'Conversation not initialized. Call withConversationId() before sendMessage()'\n      );\n    }\n\n    // Backwards-compat: the previous signature was sendMessage(query, traceParent?).\n    const opts: SendMessageOptions =\n      typeof options === 'string' ? { traceParent: options } : options;\n\n    if (query === undefined && !opts.inputAudio) {\n      throw new Error(\n        'AlquimiaSDK: sendMessage needs a query, an inputAudio blob, or both'\n      );\n    }\n\n    const baseInferUrl = this.adapter.resolveInferUrl(this.assistantId);\n    // `version_tag` is a query parameter on infer (runtime v0.5.2+), never a\n    // header — the runtime reads it with `Query(...)`.\n    const inferUrl = this.versionTag\n      ? `${baseInferUrl}${baseInferUrl.includes('?') ? '&' : '?'}version_tag=${encodeURIComponent(this.versionTag)}`\n      : baseInferUrl;\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n\n    const hasClientTools = Array.isArray(this.tools) && this.tools.length > 0;\n\n    const initMessage: Record<string, unknown> = {\n      ...(query !== undefined && { query }),\n      session_id: this.conversationId,\n      user_id: this.userId,\n      ...(opts.inputAudio && { input_audio: opts.inputAudio }),\n      // Only sent when set: the runtime defaults `output_audio` to true.\n      ...(opts.outputAudio !== undefined && { output_audio: opts.outputAudio }),\n      ...(this.extraInstructions && { extra_instructions: this.extraInstructions }),\n      ...(this.assistantConfig && { config: this.assistantConfig }),\n      ...(hasClientTools && {\n        evaluation_strategy: {\n          evaluation_strategy_id: 'native',\n          tool_schemas: this.tools,\n        },\n      }),\n    };\n\n    const result = (\n      await this.axiosInstance.post(inferUrl, initMessage, {\n        headers: {\n          'Content-Type': 'application/json',\n          ...(opts.traceParent && { 'x-trace-parent': opts.traceParent }),\n          ...adapterHeaders,\n          ...this.buildIdentityHeaders(),\n        },\n      })\n    ).data as CommonAttributes;\n\n    this.traceParent = opts.traceParent ?? null;\n    this.streamId = result.taskid ?? null;\n    this.versionTag = result.versiontag ?? this.versionTag;\n    this.agentspaceId = result.agentspaceid ?? null;\n    this.attachmentResponses = result.attachments ?? [];\n    this.attachments = [];\n\n    return this;\n  }\n\n  /**\n   * Complete a pending client-tool execution (the missing \"submit half\" of the\n   * client-tool loop). POSTs a {@link ToolExecutionResponse} to the runtime's\n   * `/event/tool-completion`. For interactive `render_ui` surfaces `result` is\n   * the user's data; for display-only surfaces the SDK sends `{ shown: true }`.\n   * The pending call is correlated by `control_id` in the body + the\n   * `context-metadata` header (taskid + sessionid).\n   */\n  async submitToolResult(response: ToolExecutionResponse): Promise<void> {\n    const url = this.adapter.resolveToolCompletionUrl?.();\n    if (!url) {\n      throw new Error(\n        'AlquimiaSDK: adapter does not support tool completion (resolveToolCompletionUrl missing)'\n      );\n    }\n    await this.axiosInstance.post(url, response, { headers: this.buildDecisionHeaders() });\n  }\n\n  /**\n   * Answer a `HumanApprovalRequired` gate: POSTs a {@link ToolApprovalEvent} to\n   * the runtime's `/event/tool-approval`. `controlId` is the gate's own control\n   * id (the `HumanApprovalRequired` record's), not the parked tool call's.\n   *\n   * Never throws for a runtime refusal — each 409 means something different to\n   * the UI, so the answer comes back classified as a {@link ToolApprovalResult}.\n   * It does throw when the adapter has no approval route, which is a wiring bug\n   * rather than a runtime answer.\n   */\n  async submitToolApproval(\n    controlId: string,\n    approved: boolean,\n    message?: string\n  ): Promise<ToolApprovalResult> {\n    const url = this.adapter.resolveToolApprovalUrl?.();\n    if (!url) {\n      throw new Error(\n        'AlquimiaSDK: adapter does not support tool approval (resolveToolApprovalUrl missing)'\n      );\n    }\n\n    const event: ToolApprovalEvent = {\n      event_class: 'ToolApprovalEvent',\n      control_id: controlId,\n      result: approved,\n      ...(message && { message }),\n    };\n\n    try {\n      await this.axiosInstance.post(url, event, { headers: this.buildDecisionHeaders() });\n      return { outcome: 'accepted' };\n    } catch (error) {\n      return classifyApprovalError(error);\n    }\n  }\n\n  async generateImage(query: string): Promise<string> {\n    if (!this.stableDiffusionProvider) {\n      throw new Error('Stable Diffusion provider not initialized');\n    }\n    return this.stableDiffusionProvider.generateImage(query);\n  }\n\n  async analyzeCharacterization(text: string): Promise<Record<string, any>> {\n    if (!this.analyzeCharacterizationProvider) {\n      throw new Error('Analyze characterization provider not initialized');\n    }\n    return this.analyzeCharacterizationProvider.analyzeCharacterization(text);\n  }\n\n  async rate(data: any): Promise<Record<string, any>> {\n    if (!this.ratingsProvider) {\n      throw new Error('Ratings provider not initialized');\n    }\n    return this.ratingsProvider.rate(data);\n  }\n\n  async logInfo(message: string, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logInfo(message, data);\n  }\n\n  async logError(message: string, error: Error, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logError(message, error, data);\n  }\n\n  /**\n   * @deprecated The runtime no longer returns attachment IDs from the infer\n   * response — attachments are uploaded as standalone blobs and linked to the\n   * session via headers. Always returns `[]`; kept for source compatibility.\n   */\n  getAttachmentResponses(): string[] {\n    return this.attachmentResponses;\n  }\n\n  /**\n   * Upload a file into the session context. Returns the runtime {@link RuntimeBlob},\n   * which is what `sendMessage`'s `inputAudio` expects for audio inference.\n   */\n  async uploadAttachment(file: File, _attachmentId?: string): Promise<RuntimeBlob> {\n    void _attachmentId;\n    const url = this.adapter.resolveBlobUploadUrl();\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n    const formData = new FormData();\n    formData.append('file', file);\n    const response = await this.axiosInstance.post(url, formData, {\n      headers: {\n        'Content-Type': 'multipart/form-data',\n        ...adapterHeaders,\n        ...this.buildIdentityHeaders(),\n      },\n    });\n    return response.data as RuntimeBlob;\n  }\n\n  /**\n   * Identity headers (kebab-case) required by `/context/blob/upload` and\n   * the rest of the runtime's internal endpoints introduced in v0.2.0→next.\n   */\n  private buildIdentityHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'assistant-id': this.assistantId,\n    };\n    if (this.conversationId) headers['session-id'] = this.conversationId;\n    if (this.userId) headers['user-id'] = this.userId;\n    if (this.streamId) headers['task-id'] = this.streamId;\n    return headers;\n  }\n\n  /**\n   * Correlation headers for tool-completion and tool-approval: the runtime's\n   * `CommonAttributes` header aliases, with no separator. Not interchangeable\n   * with the kebab-case set in {@link buildIdentityHeaders}.\n   */\n  private buildDecisionHeaders(): Record<string, string> {\n    return {\n      'Content-Type': 'application/json',\n      assistantid: this.assistantId,\n      ...(this.streamId && { taskid: this.streamId }),\n      ...(this.conversationId && { sessionid: this.conversationId }),\n      ...(this.userId && { userid: this.userId }),\n      ...(this.agentspaceId && { agentspaceid: this.agentspaceId }),\n      ...(this.versionTag && { versiontag: this.versionTag }),\n      ...(this.adapter.getHeaders?.() ?? {}),\n    };\n  }\n\n  getUrlStream(): string {\n    if (!this.streamId) {\n      throw new Error('Stream ID not initialized. Call sendMessage() first');\n    }\n\n    const url = this.adapter.resolveStreamUrl(this.streamId);\n    if (!this.traceParent) return url;\n\n    // `EventSource` cannot set request headers, so the turn's traceparent rides\n    // the URL. The proxy turns it back into `x-trace-parent` and does not pass\n    // the param upstream; without this the stream leg — where the whole\n    // inference actually happens — lands in a different trace than the infer.\n    const separator = url.includes('?') ? '&' : '?';\n    return `${url}${separator}trace_parent=${encodeURIComponent(this.traceParent)}`;\n  }\n\n  getStreamId(): string | null {\n    return this.streamId;\n  }\n\n  /** Alias for {@link getStreamId} — same value as infer `taskid`. */\n  getTaskId(): string | null {\n    return this.streamId;\n  }\n\n  /** Registry version tag resolved by the runtime for the current task, if any. */\n  getVersionTag(): string | null {\n    return this.versionTag;\n  }\n\n  /** Agentspace the runtime resolved for the current task, if any. */\n  getAgentspaceId(): string | null {\n    return this.agentspaceId;\n  }\n}\n\n/**\n * Map a failed `/event/tool-approval` call onto an outcome. The runtime's 409s\n * share a status and differ only in `detail` (`routers/event.py`), so matching\n * the text is the contract, not a shortcut.\n */\nfunction classifyApprovalError(error: unknown): ToolApprovalResult {\n  const response = (error as { response?: { status?: number; data?: unknown } })?.response;\n  const status = response?.status;\n  const data = response?.data as { detail?: unknown; error?: unknown } | string | undefined;\n  const rawDetail =\n    typeof data === 'string' ? data : data?.detail ?? data?.error ?? (error as Error)?.message;\n  const detail = typeof rawDetail === 'string' ? rawDetail : JSON.stringify(rawDetail ?? '');\n\n  let outcome: ToolApprovalOutcome = 'error';\n  if (status === 409) {\n    if (/original channel/i.test(detail)) outcome = 'wrong-channel';\n    else if (/already been recorded/i.test(detail)) outcome = 'already-decided';\n    else if (/no pending approval/i.test(detail)) outcome = 'not-pending';\n  } else if (status === 401 || status === 403) {\n    outcome = 'forbidden';\n  } else if (status === 404) {\n    outcome = 'not-found';\n  }\n\n  return { outcome, ...(status !== undefined && { status }), detail };\n}\n\nexport default AlquimiaSDK;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAqC;AAsCrC,IAAM,cAAN,MAAkB;AAAA,EA6BhB,YACE,aACA,SACA,UAA8B,CAAC,GAC/B;AA7BF,SAAQ,iBAAgC;AACxC,SAAQ,YAA2B;AAEnC;AAAA,SAAQ,WAA0B;AAElC;AAAA,SAAQ,cAA6B;AAGrC;AAAA;AAAA,SAAQ,aAA4B;AAGpC;AAAA;AAAA,SAAQ,eAA8B;AACtC,SAAQ,QAAa,CAAC;AACtB,SAAQ,oBAAmD;AAC3D,SAAQ,kBAAuB;AAC/B,SAAQ,SAAwB;AAOhC,SAAQ,cAAmC,CAAC;AAC5C,SAAQ,sBAAgC,CAAC;AAOvC,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AACA,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,SAAK,cAAc;AACnB,SAAK,UAAU;AACf,SAAK,0BAA0B,QAAQ,2BAA2B;AAElE,SAAK,gBAAgB,aAAAA,QAAM,OAAO;AAClC,SAAK,cAAc,aAAa,SAAS;AAAA,MACvC,CAAC,aAAa;AAAA,MACd,OAAO,UAAU;AACf,YAAI,MAAM,UAAU,UAAU,KAAK,gBAAgB;AACjD,gBAAM,KAAK,eAAe,SAAS,gBAAgB,OAAO;AAAA,YACxD,KAAK,MAAM,OAAO;AAAA,YAClB,QAAQ,MAAM,OAAO;AAAA,YACrB,MAAM,MAAM,OAAO;AAAA,YACnB,QAAQ,MAAM,SAAS;AAAA,YACvB,cAAc,MAAM,SAAS;AAAA,UAC/B,CAAC;AAAA,QACH;AACA,eAAO,QAAQ,OAAO,KAAK;AAAA,MAC7B;AAAA,IACF;AAEA,SAAK,eAAe,KAAK,aAAa,KAAK,IAAI;AAC/C,SAAK,eAAe,KAAK,aAAa,KAAK,IAAI;AAAA,EACjD;AAAA,EAEA,mBAAmB,gBAAqC;AACtD,SAAK,iBAAiB;AACtB,WAAO;AAAA,EACT;AAAA,EAEA,gBAAgB,aAA+C;AAC7D,SAAK,cAAc;AACnB,WAAO;AAAA,EACT;AAAA,EAEA,oBAAoB,UAAwC;AAC1D,SAAK,kBAAkB;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,4BAA4B,UAAgD;AAC1E,SAAK,0BAA0B;AAC/B,WAAO;AAAA,EACT;AAAA,EAEA,oCAAoC,UAAiD;AACnF,SAAK,kCAAkC;AACvC,WAAO;AAAA,EACT;AAAA,EAEA,oBAAoB,UAAwC;AAC1D,SAAK,kBAAkB;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,mBAAmB,UAAuC;AACxD,SAAK,iBAAiB;AACtB,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,OAAyB;AACjC,SAAK,QAAQ;AACb,WAAO;AAAA,EACT;AAAA,EAEA,sBAAsB,mBAAwD;AAC5E,SAAK,oBAAoB;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,oBAAoB,iBAAmC;AACrD,SAAK,kBAAkB;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,WAAW,QAA6B;AACtC,SAAK,SAAS;AACd,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,eAAe,YAAiC;AAC9C,SAAK,aAAa;AAClB,WAAO;AAAA,EACT;AAAA,EAEA,6BAAsC;AACpC,WAAO,KAAK,2BAA2B;AAAA,EACzC;AAAA,EAEA,aAAa,MAAkC;AAC7C,QAAI,CAAC,KAAK,iBAAiB;AACzB,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AACA,WAAO,KAAK,gBAAgB,aAAa,IAAI;AAAA,EAC/C;AAAA,EAEA,aAAa,OAAgC;AAC3C,QAAI,CAAC,KAAK,iBAAiB;AACzB,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AACA,WAAO,KAAK,gBAAgB,aAAa,KAAK;AAAA,EAChD;AAAA,EAEA,MAAM,YACJ,OACA,UAAuC,CAAC,GAClB;AACtB,QAAI,CAAC,KAAK,gBAAgB;AACxB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAGA,UAAM,OACJ,OAAO,YAAY,WAAW,EAAE,aAAa,QAAQ,IAAI;AAE3D,QAAI,UAAU,UAAa,CAAC,KAAK,YAAY;AAC3C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM,eAAe,KAAK,QAAQ,gBAAgB,KAAK,WAAW;AAGlE,UAAM,WAAW,KAAK,aAClB,GAAG,YAAY,GAAG,aAAa,SAAS,GAAG,IAAI,MAAM,GAAG,eAAe,mBAAmB,KAAK,UAAU,CAAC,KAC1G;AACJ,UAAM,iBAAiB,KAAK,QAAQ,aAAa,KAAK,CAAC;AAEvD,UAAM,iBAAiB,MAAM,QAAQ,KAAK,KAAK,KAAK,KAAK,MAAM,SAAS;AAExE,UAAM,cAAuC;AAAA,MAC3C,GAAI,UAAU,UAAa,EAAE,MAAM;AAAA,MACnC,YAAY,KAAK;AAAA,MACjB,SAAS,KAAK;AAAA,MACd,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,WAAW;AAAA;AAAA,MAEtD,GAAI,KAAK,gBAAgB,UAAa,EAAE,cAAc,KAAK,YAAY;AAAA,MACvE,GAAI,KAAK,qBAAqB,EAAE,oBAAoB,KAAK,kBAAkB;AAAA,MAC3E,GAAI,KAAK,mBAAmB,EAAE,QAAQ,KAAK,gBAAgB;AAAA,MAC3D,GAAI,kBAAkB;AAAA,QACpB,qBAAqB;AAAA,UACnB,wBAAwB;AAAA,UACxB,cAAc,KAAK;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AAEA,UAAM,UACJ,MAAM,KAAK,cAAc,KAAK,UAAU,aAAa;AAAA,MACnD,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAI,KAAK,eAAe,EAAE,kBAAkB,KAAK,YAAY;AAAA,QAC7D,GAAG;AAAA,QACH,GAAG,KAAK,qBAAqB;AAAA,MAC/B;AAAA,IACF,CAAC,GACD;AAEF,SAAK,cAAc,KAAK,eAAe;AACvC,SAAK,WAAW,OAAO,UAAU;AACjC,SAAK,aAAa,OAAO,cAAc,KAAK;AAC5C,SAAK,eAAe,OAAO,gBAAgB;AAC3C,SAAK,sBAAsB,OAAO,eAAe,CAAC;AAClD,SAAK,cAAc,CAAC;AAEpB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,iBAAiB,UAAgD;AACrE,UAAM,MAAM,KAAK,QAAQ,2BAA2B;AACpD,QAAI,CAAC,KAAK;AACR,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,UAAM,KAAK,cAAc,KAAK,KAAK,UAAU,EAAE,SAAS,KAAK,qBAAqB,EAAE,CAAC;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,mBACJ,WACA,UACA,SAC6B;AAC7B,UAAM,MAAM,KAAK,QAAQ,yBAAyB;AAClD,QAAI,CAAC,KAAK;AACR,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAA2B;AAAA,MAC/B,aAAa;AAAA,MACb,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,GAAI,WAAW,EAAE,QAAQ;AAAA,IAC3B;AAEA,QAAI;AACF,YAAM,KAAK,cAAc,KAAK,KAAK,OAAO,EAAE,SAAS,KAAK,qBAAqB,EAAE,CAAC;AAClF,aAAO,EAAE,SAAS,WAAW;AAAA,IAC/B,SAAS,OAAO;AACd,aAAO,sBAAsB,KAAK;AAAA,IACpC;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,OAAgC;AAClD,QAAI,CAAC,KAAK,yBAAyB;AACjC,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,WAAO,KAAK,wBAAwB,cAAc,KAAK;AAAA,EACzD;AAAA,EAEA,MAAM,wBAAwB,MAA4C;AACxE,QAAI,CAAC,KAAK,iCAAiC;AACzC,YAAM,IAAI,MAAM,mDAAmD;AAAA,IACrE;AACA,WAAO,KAAK,gCAAgC,wBAAwB,IAAI;AAAA,EAC1E;AAAA,EAEA,MAAM,KAAK,MAAyC;AAClD,QAAI,CAAC,KAAK,iBAAiB;AACzB,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AACA,WAAO,KAAK,gBAAgB,KAAK,IAAI;AAAA,EACvC;AAAA,EAEA,MAAM,QAAQ,SAAiB,MAA0B;AACvD,QAAI,CAAC,KAAK,gBAAgB;AACxB,YAAM,IAAI,MAAM,iCAAiC;AAAA,IACnD;AACA,WAAO,KAAK,eAAe,QAAQ,SAAS,IAAI;AAAA,EAClD;AAAA,EAEA,MAAM,SAAS,SAAiB,OAAc,MAA0B;AACtE,QAAI,CAAC,KAAK,gBAAgB;AACxB,YAAM,IAAI,MAAM,iCAAiC;AAAA,IACnD;AACA,WAAO,KAAK,eAAe,SAAS,SAAS,OAAO,IAAI;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,yBAAmC;AACjC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,iBAAiB,MAAY,eAA8C;AAE/E,UAAM,MAAM,KAAK,QAAQ,qBAAqB;AAC9C,UAAM,iBAAiB,KAAK,QAAQ,aAAa,KAAK,CAAC;AACvD,UAAM,WAAW,IAAI,SAAS;AAC9B,aAAS,OAAO,QAAQ,IAAI;AAC5B,UAAM,WAAW,MAAM,KAAK,cAAc,KAAK,KAAK,UAAU;AAAA,MAC5D,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,QACH,GAAG,KAAK,qBAAqB;AAAA,MAC/B;AAAA,IACF,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,uBAA+C;AACrD,UAAM,UAAkC;AAAA,MACtC,gBAAgB,KAAK;AAAA,IACvB;AACA,QAAI,KAAK,eAAgB,SAAQ,YAAY,IAAI,KAAK;AACtD,QAAI,KAAK,OAAQ,SAAQ,SAAS,IAAI,KAAK;AAC3C,QAAI,KAAK,SAAU,SAAQ,SAAS,IAAI,KAAK;AAC7C,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,uBAA+C;AACrD,WAAO;AAAA,MACL,gBAAgB;AAAA,MAChB,aAAa,KAAK;AAAA,MAClB,GAAI,KAAK,YAAY,EAAE,QAAQ,KAAK,SAAS;AAAA,MAC7C,GAAI,KAAK,kBAAkB,EAAE,WAAW,KAAK,eAAe;AAAA,MAC5D,GAAI,KAAK,UAAU,EAAE,QAAQ,KAAK,OAAO;AAAA,MACzC,GAAI,KAAK,gBAAgB,EAAE,cAAc,KAAK,aAAa;AAAA,MAC3D,GAAI,KAAK,cAAc,EAAE,YAAY,KAAK,WAAW;AAAA,MACrD,GAAI,KAAK,QAAQ,aAAa,KAAK,CAAC;AAAA,IACtC;AAAA,EACF;AAAA,EAEA,eAAuB;AACrB,QAAI,CAAC,KAAK,UAAU;AAClB,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AAEA,UAAM,MAAM,KAAK,QAAQ,iBAAiB,KAAK,QAAQ;AACvD,QAAI,CAAC,KAAK,YAAa,QAAO;AAM9B,UAAM,YAAY,IAAI,SAAS,GAAG,IAAI,MAAM;AAC5C,WAAO,GAAG,GAAG,GAAG,SAAS,gBAAgB,mBAAmB,KAAK,WAAW,CAAC;AAAA,EAC/E;AAAA,EAEA,cAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,YAA2B;AACzB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,gBAA+B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,kBAAiC;AAC/B,WAAO,KAAK;AAAA,EACd;AACF;AAOA,SAAS,sBAAsB,OAAoC;AACjE,QAAM,WAAY,OAA8D;AAChF,QAAM,SAAS,UAAU;AACzB,QAAM,OAAO,UAAU;AACvB,QAAM,YACJ,OAAO,SAAS,WAAW,OAAO,MAAM,UAAU,MAAM,SAAU,OAAiB;AACrF,QAAM,SAAS,OAAO,cAAc,WAAW,YAAY,KAAK,UAAU,aAAa,EAAE;AAEzF,MAAI,UAA+B;AACnC,MAAI,WAAW,KAAK;AAClB,QAAI,oBAAoB,KAAK,MAAM,EAAG,WAAU;AAAA,aACvC,yBAAyB,KAAK,MAAM,EAAG,WAAU;AAAA,aACjD,uBAAuB,KAAK,MAAM,EAAG,WAAU;AAAA,EAC1D,WAAW,WAAW,OAAO,WAAW,KAAK;AAC3C,cAAU;AAAA,EACZ,WAAW,WAAW,KAAK;AACzB,cAAU;AAAA,EACZ;AAEA,SAAO,EAAE,SAAS,GAAI,WAAW,UAAa,EAAE,OAAO,GAAI,OAAO;AACpE;AAEA,IAAO,uBAAQ;","names":["axios"]}

package/dist/sdk/index.mjs

@@ -11,6 +11,9 @@ var AlquimiaSDK = class {
     // Registry version tag resolved by the runtime for this task (v0.5.1), so
     // the tool-completion half of the turn lands on the same agentspace version.
     this.versionTag = null;
+    // Agentspace the runtime resolved for this task. Tool completion and
+    // approval authorize a non-admin caller against it, so it is echoed back.
+    this.agentspaceId = null;
     this.tools = [];
     this.extraInstructions = null;
     this.assistantConfig = null;
@@ -162,6 +165,7 @@ var AlquimiaSDK = class {
     this.traceParent = opts.traceParent ?? null;
     this.streamId = result.taskid ?? null;
     this.versionTag = result.versiontag ?? this.versionTag;
+    this.agentspaceId = result.agentspaceid ?? null;
     this.attachmentResponses = result.attachments ?? [];
     this.attachments = [];
     return this;
@@ -181,17 +185,37 @@ var AlquimiaSDK = class {
         "AlquimiaSDK: adapter does not support tool completion (resolveToolCompletionUrl missing)"
       );
     }
-    const adapterHeaders = this.adapter.getHeaders?.() ?? {};
-    const headers = {
-      "Content-Type": "application/json",
-      assistantid: this.assistantId,
-      ...this.streamId && { taskid: this.streamId },
-      ...this.conversationId && { sessionid: this.conversationId },
-      ...this.userId && { userid: this.userId },
-      ...this.versionTag && { versiontag: this.versionTag },
-      ...adapterHeaders
+    await this.axiosInstance.post(url, response, { headers: this.buildDecisionHeaders() });
+  }
+  /**
+   * Answer a `HumanApprovalRequired` gate: POSTs a {@link ToolApprovalEvent} to
+   * the runtime's `/event/tool-approval`. `controlId` is the gate's own control
+   * id (the `HumanApprovalRequired` record's), not the parked tool call's.
+   *
+   * Never throws for a runtime refusal — each 409 means something different to
+   * the UI, so the answer comes back classified as a {@link ToolApprovalResult}.
+   * It does throw when the adapter has no approval route, which is a wiring bug
+   * rather than a runtime answer.
+   */
+  async submitToolApproval(controlId, approved, message) {
+    const url = this.adapter.resolveToolApprovalUrl?.();
+    if (!url) {
+      throw new Error(
+        "AlquimiaSDK: adapter does not support tool approval (resolveToolApprovalUrl missing)"
+      );
+    }
+    const event = {
+      event_class: "ToolApprovalEvent",
+      control_id: controlId,
+      result: approved,
+      ...message && { message }
     };
-    await this.axiosInstance.post(url, response, { headers });
+    try {
+      await this.axiosInstance.post(url, event, { headers: this.buildDecisionHeaders() });
+      return { outcome: "accepted" };
+    } catch (error) {
+      return classifyApprovalError(error);
+    }
   }
   async generateImage(query) {
     if (!this.stableDiffusionProvider) {
@@ -262,6 +286,23 @@ var AlquimiaSDK = class {
     if (this.streamId) headers["task-id"] = this.streamId;
     return headers;
   }
+  /**
+   * Correlation headers for tool-completion and tool-approval: the runtime's
+   * `CommonAttributes` header aliases, with no separator. Not interchangeable
+   * with the kebab-case set in {@link buildIdentityHeaders}.
+   */
+  buildDecisionHeaders() {
+    return {
+      "Content-Type": "application/json",
+      assistantid: this.assistantId,
+      ...this.streamId && { taskid: this.streamId },
+      ...this.conversationId && { sessionid: this.conversationId },
+      ...this.userId && { userid: this.userId },
+      ...this.agentspaceId && { agentspaceid: this.agentspaceId },
+      ...this.versionTag && { versiontag: this.versionTag },
+      ...this.adapter.getHeaders?.() ?? {}
+    };
+  }
   getUrlStream() {
     if (!this.streamId) {
       throw new Error("Stream ID not initialized. Call sendMessage() first");
@@ -282,7 +323,29 @@ var AlquimiaSDK = class {
   getVersionTag() {
     return this.versionTag;
   }
+  /** Agentspace the runtime resolved for the current task, if any. */
+  getAgentspaceId() {
+    return this.agentspaceId;
+  }
 };
+function classifyApprovalError(error) {
+  const response = error?.response;
+  const status = response?.status;
+  const data = response?.data;
+  const rawDetail = typeof data === "string" ? data : data?.detail ?? data?.error ?? error?.message;
+  const detail = typeof rawDetail === "string" ? rawDetail : JSON.stringify(rawDetail ?? "");
+  let outcome = "error";
+  if (status === 409) {
+    if (/original channel/i.test(detail)) outcome = "wrong-channel";
+    else if (/already been recorded/i.test(detail)) outcome = "already-decided";
+    else if (/no pending approval/i.test(detail)) outcome = "not-pending";
+  } else if (status === 401 || status === 403) {
+    outcome = "forbidden";
+  } else if (status === 404) {
+    outcome = "not-found";
+  }
+  return { outcome, ...status !== void 0 && { status }, detail };
+}
 var alquimia_sdk_default = AlquimiaSDK;
 export {
   alquimia_sdk_default as AlquimiaSDK

package/dist/sdk/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sdk/alquimia-sdk.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport {\n  StableDiffusionProvider,\n  WhisperProvider,\n  CharacterizationProvider,\n  RatingsProvider,\n  LoggerProvider,\n} from '../providers';\nimport {\n  AttachmentPayload,\n  TTSResult,\n  type CommonAttributes,\n  type Content,\n  type RuntimeBlob,\n} from '../types';\nimport type { AlquimiaAdapter, AlquimiaSDKOptions } from '../adapters';\nimport type { ToolExecutionResponse } from '../genui/types';\n\n/** Per-turn options for {@link AlquimiaSDK.sendMessage}. */\nexport interface SendMessageOptions {\n  /** W3C traceparent, so infer and stream share one trace. */\n  traceParent?: string;\n  /**\n   * Audio input for this turn (runtime v0.5.1). Upload it with\n   * {@link AlquimiaSDK.uploadAttachment} first and pass the blob it returns.\n   * May be sent with or instead of `query`.\n   */\n  inputAudio?: RuntimeBlob;\n  /**\n   * Set to `false` to force a text-only reply from an audio-enabled agent.\n   * The runtime defaults to `true`, so leaving this unset keeps its behaviour.\n   */\n  outputAudio?: boolean;\n}\n\nclass AlquimiaSDK {\n  private adapter: AlquimiaAdapter;\n  private assistantId: string;\n  private axiosInstance: AxiosInstance;\n  private conversationId: string | null = null;\n  private sessionId: string | null = null;\n  // Internal subscription id from infer (`taskid` on the wire).\n  private streamId: string | null = null;\n  // W3C traceparent for the current turn, so infer and stream share one trace.\n  private traceParent: string | null = null;\n  // Registry version tag resolved by the runtime for this task (v0.5.1), so\n  // the tool-completion half of the turn lands on the same agentspace version.\n  private versionTag: string | null = null;\n  private tools: any = [];\n  private extraInstructions: Record<string, string> | null = null;\n  private assistantConfig: any = null;\n  private userId: string | null = null;\n  private whisperProvider?: WhisperProvider;\n  private stableDiffusionProvider?: StableDiffusionProvider;\n  private analyzeCharacterizationProvider?: CharacterizationProvider;\n  private ratingsProvider?: RatingsProvider;\n  private loggerProvider?: LoggerProvider;\n  private enforceCharacterization?: boolean;\n  private attachments: AttachmentPayload[] = [];\n  private attachmentResponses: string[] = [];\n\n  constructor(\n    assistantId: string,\n    adapter: AlquimiaAdapter,\n    options: AlquimiaSDKOptions = {}\n  ) {\n    if (!assistantId) {\n      throw new Error('AlquimiaSDK: assistantId is required');\n    }\n    if (!adapter) {\n      throw new Error(\n        'AlquimiaSDK: adapter is required. Use createNextJsAdapter() or createFetchAdapter()'\n      );\n    }\n\n    this.assistantId = assistantId;\n    this.adapter = adapter;\n    this.enforceCharacterization = options.enforceCharacterization ?? true;\n\n    this.axiosInstance = axios.create();\n    this.axiosInstance.interceptors.response.use(\n      (response) => response,\n      async (error) => {\n        if (error.response?.status && this.loggerProvider) {\n          await this.loggerProvider.logError('Server Error', error, {\n            url: error.config.url,\n            method: error.config.method,\n            data: error.config.data,\n            status: error.response.status,\n            responseData: error.response.data,\n          });\n        }\n        return Promise.reject(error);\n      }\n    );\n\n    this.textToSpeech = this.textToSpeech.bind(this);\n    this.speechToText = this.speechToText.bind(this);\n  }\n\n  withConversationId(conversationId: string): AlquimiaSDK {\n    this.conversationId = conversationId;\n    return this;\n  }\n\n  withAttachments(attachments: AttachmentPayload[]): AlquimiaSDK {\n    this.attachments = attachments;\n    return this;\n  }\n\n  withWhisperProvider(provider: WhisperProvider): AlquimiaSDK {\n    this.whisperProvider = provider;\n    return this;\n  }\n\n  withStableDiffusionProvider(provider: StableDiffusionProvider): AlquimiaSDK {\n    this.stableDiffusionProvider = provider;\n    return this;\n  }\n\n  withAnalyzeCharacterizationProvider(provider: CharacterizationProvider): AlquimiaSDK {\n    this.analyzeCharacterizationProvider = provider;\n    return this;\n  }\n\n  withRatingsProvider(provider: RatingsProvider): AlquimiaSDK {\n    this.ratingsProvider = provider;\n    return this;\n  }\n\n  withLoggerProvider(provider: LoggerProvider): AlquimiaSDK {\n    this.loggerProvider = provider;\n    return this;\n  }\n\n  withTools(tools: any): AlquimiaSDK {\n    this.tools = tools;\n    return this;\n  }\n\n  withExtraInstructions(extraInstructions: Record<string, string>): AlquimiaSDK {\n    this.extraInstructions = extraInstructions;\n    return this;\n  }\n\n  withAssistantConfig(assistantConfig: any): AlquimiaSDK {\n    this.assistantConfig = assistantConfig;\n    return this;\n  }\n\n  withUserId(userId: string): AlquimiaSDK {\n    this.userId = userId;\n    return this;\n  }\n\n  /**\n   * Pin inference to a cached registry version. Sent as the `version_tag`\n   * query parameter, which `POST /event/infer/{assistant_id}` accepts from\n   * **runtime v0.5.2** onward; older runtimes ignore it.\n   *\n   * Works on every version: pass a versioned assistant ref\n   * (`<agentspace>/<assistant>[:<tag>]`) as the `assistantId` instead — the\n   * runtime parses the tag out of the path itself.\n   */\n  withVersionTag(versionTag: string): AlquimiaSDK {\n    this.versionTag = versionTag;\n    return this;\n  }\n\n  getEnforceCharacterization(): boolean {\n    return this.enforceCharacterization ?? true;\n  }\n\n  textToSpeech(text: string): Promise<TTSResult> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.textToSpeech(text);\n  }\n\n  speechToText(audio: string): Promise<string> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.speechToText(audio);\n  }\n\n  async sendMessage(\n    query?: Content,\n    options: string | SendMessageOptions = {}\n  ): Promise<AlquimiaSDK> {\n    if (!this.conversationId) {\n      throw new Error(\n        'Conversation not initialized. Call withConversationId() before sendMessage()'\n      );\n    }\n\n    // Backwards-compat: the previous signature was sendMessage(query, traceParent?).\n    const opts: SendMessageOptions =\n      typeof options === 'string' ? { traceParent: options } : options;\n\n    if (query === undefined && !opts.inputAudio) {\n      throw new Error(\n        'AlquimiaSDK: sendMessage needs a query, an inputAudio blob, or both'\n      );\n    }\n\n    const baseInferUrl = this.adapter.resolveInferUrl(this.assistantId);\n    // `version_tag` is a query parameter on infer (runtime v0.5.2+), never a\n    // header — the runtime reads it with `Query(...)`.\n    const inferUrl = this.versionTag\n      ? `${baseInferUrl}${baseInferUrl.includes('?') ? '&' : '?'}version_tag=${encodeURIComponent(this.versionTag)}`\n      : baseInferUrl;\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n\n    const hasClientTools = Array.isArray(this.tools) && this.tools.length > 0;\n\n    const initMessage: Record<string, unknown> = {\n      ...(query !== undefined && { query }),\n      session_id: this.conversationId,\n      user_id: this.userId,\n      ...(opts.inputAudio && { input_audio: opts.inputAudio }),\n      // Only sent when set: the runtime defaults `output_audio` to true.\n      ...(opts.outputAudio !== undefined && { output_audio: opts.outputAudio }),\n      ...(this.extraInstructions && { extra_instructions: this.extraInstructions }),\n      ...(this.assistantConfig && { config: this.assistantConfig }),\n      ...(hasClientTools && {\n        evaluation_strategy: {\n          evaluation_strategy_id: 'native',\n          tool_schemas: this.tools,\n        },\n      }),\n    };\n\n    const result = (\n      await this.axiosInstance.post(inferUrl, initMessage, {\n        headers: {\n          'Content-Type': 'application/json',\n          ...(opts.traceParent && { 'x-trace-parent': opts.traceParent }),\n          ...adapterHeaders,\n          ...this.buildIdentityHeaders(),\n        },\n      })\n    ).data as CommonAttributes;\n\n    this.traceParent = opts.traceParent ?? null;\n    this.streamId = result.taskid ?? null;\n    this.versionTag = result.versiontag ?? this.versionTag;\n    this.attachmentResponses = result.attachments ?? [];\n    this.attachments = [];\n\n    return this;\n  }\n\n  /**\n   * Complete a pending client-tool execution (the missing \"submit half\" of the\n   * client-tool loop). POSTs a {@link ToolExecutionResponse} to the runtime's\n   * `/event/tool-completion`. For interactive `render_ui` surfaces `result` is\n   * the user's data; for display-only surfaces the SDK sends `{ shown: true }`.\n   * The pending call is correlated by `control_id` in the body + the\n   * `context-metadata` header (taskid + sessionid).\n   */\n  async submitToolResult(response: ToolExecutionResponse): Promise<void> {\n    const url = this.adapter.resolveToolCompletionUrl?.();\n    if (!url) {\n      throw new Error(\n        'AlquimiaSDK: adapter does not support tool completion (resolveToolCompletionUrl missing)'\n      );\n    }\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      assistantid: this.assistantId,\n      ...(this.streamId && { taskid: this.streamId }),\n      ...(this.conversationId && { sessionid: this.conversationId }),\n      ...(this.userId && { userid: this.userId }),\n      ...(this.versionTag && { versiontag: this.versionTag }),\n      ...adapterHeaders,\n    };\n    await this.axiosInstance.post(url, response, { headers });\n  }\n\n  async generateImage(query: string): Promise<string> {\n    if (!this.stableDiffusionProvider) {\n      throw new Error('Stable Diffusion provider not initialized');\n    }\n    return this.stableDiffusionProvider.generateImage(query);\n  }\n\n  async analyzeCharacterization(text: string): Promise<Record<string, any>> {\n    if (!this.analyzeCharacterizationProvider) {\n      throw new Error('Analyze characterization provider not initialized');\n    }\n    return this.analyzeCharacterizationProvider.analyzeCharacterization(text);\n  }\n\n  async rate(data: any): Promise<Record<string, any>> {\n    if (!this.ratingsProvider) {\n      throw new Error('Ratings provider not initialized');\n    }\n    return this.ratingsProvider.rate(data);\n  }\n\n  async logInfo(message: string, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logInfo(message, data);\n  }\n\n  async logError(message: string, error: Error, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logError(message, error, data);\n  }\n\n  /**\n   * @deprecated The runtime no longer returns attachment IDs from the infer\n   * response — attachments are uploaded as standalone blobs and linked to the\n   * session via headers. Always returns `[]`; kept for source compatibility.\n   */\n  getAttachmentResponses(): string[] {\n    return this.attachmentResponses;\n  }\n\n  /**\n   * Upload a file into the session context. Returns the runtime {@link RuntimeBlob},\n   * which is what `sendMessage`'s `inputAudio` expects for audio inference.\n   */\n  async uploadAttachment(file: File, _attachmentId?: string): Promise<RuntimeBlob> {\n    void _attachmentId;\n    const url = this.adapter.resolveBlobUploadUrl();\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n    const formData = new FormData();\n    formData.append('file', file);\n    const response = await this.axiosInstance.post(url, formData, {\n      headers: {\n        'Content-Type': 'multipart/form-data',\n        ...adapterHeaders,\n        ...this.buildIdentityHeaders(),\n      },\n    });\n    return response.data as RuntimeBlob;\n  }\n\n  /**\n   * Identity headers (kebab-case) required by `/context/blob/upload` and\n   * the rest of the runtime's internal endpoints introduced in v0.2.0→next.\n   */\n  private buildIdentityHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'assistant-id': this.assistantId,\n    };\n    if (this.conversationId) headers['session-id'] = this.conversationId;\n    if (this.userId) headers['user-id'] = this.userId;\n    if (this.streamId) headers['task-id'] = this.streamId;\n    return headers;\n  }\n\n  getUrlStream(): string {\n    if (!this.streamId) {\n      throw new Error('Stream ID not initialized. Call sendMessage() first');\n    }\n\n    const url = this.adapter.resolveStreamUrl(this.streamId);\n    if (!this.traceParent) return url;\n\n    // `EventSource` cannot set request headers, so the turn's traceparent rides\n    // the URL. The proxy turns it back into `x-trace-parent` and does not pass\n    // the param upstream; without this the stream leg — where the whole\n    // inference actually happens — lands in a different trace than the infer.\n    const separator = url.includes('?') ? '&' : '?';\n    return `${url}${separator}trace_parent=${encodeURIComponent(this.traceParent)}`;\n  }\n\n  getStreamId(): string | null {\n    return this.streamId;\n  }\n\n  /** Alias for {@link getStreamId} — same value as infer `taskid`. */\n  getTaskId(): string | null {\n    return this.streamId;\n  }\n\n  /** Registry version tag resolved by the runtime for the current task, if any. */\n  getVersionTag(): string | null {\n    return this.versionTag;\n  }\n}\n\nexport default AlquimiaSDK;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/sdk/alquimia-sdk.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport {\n  StableDiffusionProvider,\n  WhisperProvider,\n  CharacterizationProvider,\n  RatingsProvider,\n  LoggerProvider,\n} from '../providers';\nimport {\n  AttachmentPayload,\n  TTSResult,\n  type CommonAttributes,\n  type Content,\n  type RuntimeBlob,\n  type ToolApprovalEvent,\n  type ToolApprovalOutcome,\n  type ToolApprovalResult,\n} from '../types';\nimport type { AlquimiaAdapter, AlquimiaSDKOptions } from '../adapters';\nimport type { ToolExecutionResponse } from '../genui/types';\n\n/** Per-turn options for {@link AlquimiaSDK.sendMessage}. */\nexport interface SendMessageOptions {\n  /** W3C traceparent, so infer and stream share one trace. */\n  traceParent?: string;\n  /**\n   * Audio input for this turn (runtime v0.5.1). Upload it with\n   * {@link AlquimiaSDK.uploadAttachment} first and pass the blob it returns.\n   * May be sent with or instead of `query`.\n   */\n  inputAudio?: RuntimeBlob;\n  /**\n   * Set to `false` to force a text-only reply from an audio-enabled agent.\n   * The runtime defaults to `true`, so leaving this unset keeps its behaviour.\n   */\n  outputAudio?: boolean;\n}\n\nclass AlquimiaSDK {\n  private adapter: AlquimiaAdapter;\n  private assistantId: string;\n  private axiosInstance: AxiosInstance;\n  private conversationId: string | null = null;\n  private sessionId: string | null = null;\n  // Internal subscription id from infer (`taskid` on the wire).\n  private streamId: string | null = null;\n  // W3C traceparent for the current turn, so infer and stream share one trace.\n  private traceParent: string | null = null;\n  // Registry version tag resolved by the runtime for this task (v0.5.1), so\n  // the tool-completion half of the turn lands on the same agentspace version.\n  private versionTag: string | null = null;\n  // Agentspace the runtime resolved for this task. Tool completion and\n  // approval authorize a non-admin caller against it, so it is echoed back.\n  private agentspaceId: string | null = null;\n  private tools: any = [];\n  private extraInstructions: Record<string, string> | null = null;\n  private assistantConfig: any = null;\n  private userId: string | null = null;\n  private whisperProvider?: WhisperProvider;\n  private stableDiffusionProvider?: StableDiffusionProvider;\n  private analyzeCharacterizationProvider?: CharacterizationProvider;\n  private ratingsProvider?: RatingsProvider;\n  private loggerProvider?: LoggerProvider;\n  private enforceCharacterization?: boolean;\n  private attachments: AttachmentPayload[] = [];\n  private attachmentResponses: string[] = [];\n\n  constructor(\n    assistantId: string,\n    adapter: AlquimiaAdapter,\n    options: AlquimiaSDKOptions = {}\n  ) {\n    if (!assistantId) {\n      throw new Error('AlquimiaSDK: assistantId is required');\n    }\n    if (!adapter) {\n      throw new Error(\n        'AlquimiaSDK: adapter is required. Use createNextJsAdapter() or createFetchAdapter()'\n      );\n    }\n\n    this.assistantId = assistantId;\n    this.adapter = adapter;\n    this.enforceCharacterization = options.enforceCharacterization ?? true;\n\n    this.axiosInstance = axios.create();\n    this.axiosInstance.interceptors.response.use(\n      (response) => response,\n      async (error) => {\n        if (error.response?.status && this.loggerProvider) {\n          await this.loggerProvider.logError('Server Error', error, {\n            url: error.config.url,\n            method: error.config.method,\n            data: error.config.data,\n            status: error.response.status,\n            responseData: error.response.data,\n          });\n        }\n        return Promise.reject(error);\n      }\n    );\n\n    this.textToSpeech = this.textToSpeech.bind(this);\n    this.speechToText = this.speechToText.bind(this);\n  }\n\n  withConversationId(conversationId: string): AlquimiaSDK {\n    this.conversationId = conversationId;\n    return this;\n  }\n\n  withAttachments(attachments: AttachmentPayload[]): AlquimiaSDK {\n    this.attachments = attachments;\n    return this;\n  }\n\n  withWhisperProvider(provider: WhisperProvider): AlquimiaSDK {\n    this.whisperProvider = provider;\n    return this;\n  }\n\n  withStableDiffusionProvider(provider: StableDiffusionProvider): AlquimiaSDK {\n    this.stableDiffusionProvider = provider;\n    return this;\n  }\n\n  withAnalyzeCharacterizationProvider(provider: CharacterizationProvider): AlquimiaSDK {\n    this.analyzeCharacterizationProvider = provider;\n    return this;\n  }\n\n  withRatingsProvider(provider: RatingsProvider): AlquimiaSDK {\n    this.ratingsProvider = provider;\n    return this;\n  }\n\n  withLoggerProvider(provider: LoggerProvider): AlquimiaSDK {\n    this.loggerProvider = provider;\n    return this;\n  }\n\n  withTools(tools: any): AlquimiaSDK {\n    this.tools = tools;\n    return this;\n  }\n\n  withExtraInstructions(extraInstructions: Record<string, string>): AlquimiaSDK {\n    this.extraInstructions = extraInstructions;\n    return this;\n  }\n\n  withAssistantConfig(assistantConfig: any): AlquimiaSDK {\n    this.assistantConfig = assistantConfig;\n    return this;\n  }\n\n  withUserId(userId: string): AlquimiaSDK {\n    this.userId = userId;\n    return this;\n  }\n\n  /**\n   * Pin inference to a cached registry version. Sent as the `version_tag`\n   * query parameter, which `POST /event/infer/{assistant_id}` accepts from\n   * **runtime v0.5.2** onward; older runtimes ignore it.\n   *\n   * Works on every version: pass a versioned assistant ref\n   * (`<agentspace>/<assistant>[:<tag>]`) as the `assistantId` instead — the\n   * runtime parses the tag out of the path itself.\n   */\n  withVersionTag(versionTag: string): AlquimiaSDK {\n    this.versionTag = versionTag;\n    return this;\n  }\n\n  getEnforceCharacterization(): boolean {\n    return this.enforceCharacterization ?? true;\n  }\n\n  textToSpeech(text: string): Promise<TTSResult> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.textToSpeech(text);\n  }\n\n  speechToText(audio: string): Promise<string> {\n    if (!this.whisperProvider) {\n      throw new Error('Whisper provider not initialized');\n    }\n    return this.whisperProvider.speechToText(audio);\n  }\n\n  async sendMessage(\n    query?: Content,\n    options: string | SendMessageOptions = {}\n  ): Promise<AlquimiaSDK> {\n    if (!this.conversationId) {\n      throw new Error(\n        'Conversation not initialized. Call withConversationId() before sendMessage()'\n      );\n    }\n\n    // Backwards-compat: the previous signature was sendMessage(query, traceParent?).\n    const opts: SendMessageOptions =\n      typeof options === 'string' ? { traceParent: options } : options;\n\n    if (query === undefined && !opts.inputAudio) {\n      throw new Error(\n        'AlquimiaSDK: sendMessage needs a query, an inputAudio blob, or both'\n      );\n    }\n\n    const baseInferUrl = this.adapter.resolveInferUrl(this.assistantId);\n    // `version_tag` is a query parameter on infer (runtime v0.5.2+), never a\n    // header — the runtime reads it with `Query(...)`.\n    const inferUrl = this.versionTag\n      ? `${baseInferUrl}${baseInferUrl.includes('?') ? '&' : '?'}version_tag=${encodeURIComponent(this.versionTag)}`\n      : baseInferUrl;\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n\n    const hasClientTools = Array.isArray(this.tools) && this.tools.length > 0;\n\n    const initMessage: Record<string, unknown> = {\n      ...(query !== undefined && { query }),\n      session_id: this.conversationId,\n      user_id: this.userId,\n      ...(opts.inputAudio && { input_audio: opts.inputAudio }),\n      // Only sent when set: the runtime defaults `output_audio` to true.\n      ...(opts.outputAudio !== undefined && { output_audio: opts.outputAudio }),\n      ...(this.extraInstructions && { extra_instructions: this.extraInstructions }),\n      ...(this.assistantConfig && { config: this.assistantConfig }),\n      ...(hasClientTools && {\n        evaluation_strategy: {\n          evaluation_strategy_id: 'native',\n          tool_schemas: this.tools,\n        },\n      }),\n    };\n\n    const result = (\n      await this.axiosInstance.post(inferUrl, initMessage, {\n        headers: {\n          'Content-Type': 'application/json',\n          ...(opts.traceParent && { 'x-trace-parent': opts.traceParent }),\n          ...adapterHeaders,\n          ...this.buildIdentityHeaders(),\n        },\n      })\n    ).data as CommonAttributes;\n\n    this.traceParent = opts.traceParent ?? null;\n    this.streamId = result.taskid ?? null;\n    this.versionTag = result.versiontag ?? this.versionTag;\n    this.agentspaceId = result.agentspaceid ?? null;\n    this.attachmentResponses = result.attachments ?? [];\n    this.attachments = [];\n\n    return this;\n  }\n\n  /**\n   * Complete a pending client-tool execution (the missing \"submit half\" of the\n   * client-tool loop). POSTs a {@link ToolExecutionResponse} to the runtime's\n   * `/event/tool-completion`. For interactive `render_ui` surfaces `result` is\n   * the user's data; for display-only surfaces the SDK sends `{ shown: true }`.\n   * The pending call is correlated by `control_id` in the body + the\n   * `context-metadata` header (taskid + sessionid).\n   */\n  async submitToolResult(response: ToolExecutionResponse): Promise<void> {\n    const url = this.adapter.resolveToolCompletionUrl?.();\n    if (!url) {\n      throw new Error(\n        'AlquimiaSDK: adapter does not support tool completion (resolveToolCompletionUrl missing)'\n      );\n    }\n    await this.axiosInstance.post(url, response, { headers: this.buildDecisionHeaders() });\n  }\n\n  /**\n   * Answer a `HumanApprovalRequired` gate: POSTs a {@link ToolApprovalEvent} to\n   * the runtime's `/event/tool-approval`. `controlId` is the gate's own control\n   * id (the `HumanApprovalRequired` record's), not the parked tool call's.\n   *\n   * Never throws for a runtime refusal — each 409 means something different to\n   * the UI, so the answer comes back classified as a {@link ToolApprovalResult}.\n   * It does throw when the adapter has no approval route, which is a wiring bug\n   * rather than a runtime answer.\n   */\n  async submitToolApproval(\n    controlId: string,\n    approved: boolean,\n    message?: string\n  ): Promise<ToolApprovalResult> {\n    const url = this.adapter.resolveToolApprovalUrl?.();\n    if (!url) {\n      throw new Error(\n        'AlquimiaSDK: adapter does not support tool approval (resolveToolApprovalUrl missing)'\n      );\n    }\n\n    const event: ToolApprovalEvent = {\n      event_class: 'ToolApprovalEvent',\n      control_id: controlId,\n      result: approved,\n      ...(message && { message }),\n    };\n\n    try {\n      await this.axiosInstance.post(url, event, { headers: this.buildDecisionHeaders() });\n      return { outcome: 'accepted' };\n    } catch (error) {\n      return classifyApprovalError(error);\n    }\n  }\n\n  async generateImage(query: string): Promise<string> {\n    if (!this.stableDiffusionProvider) {\n      throw new Error('Stable Diffusion provider not initialized');\n    }\n    return this.stableDiffusionProvider.generateImage(query);\n  }\n\n  async analyzeCharacterization(text: string): Promise<Record<string, any>> {\n    if (!this.analyzeCharacterizationProvider) {\n      throw new Error('Analyze characterization provider not initialized');\n    }\n    return this.analyzeCharacterizationProvider.analyzeCharacterization(text);\n  }\n\n  async rate(data: any): Promise<Record<string, any>> {\n    if (!this.ratingsProvider) {\n      throw new Error('Ratings provider not initialized');\n    }\n    return this.ratingsProvider.rate(data);\n  }\n\n  async logInfo(message: string, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logInfo(message, data);\n  }\n\n  async logError(message: string, error: Error, data: any): Promise<void> {\n    if (!this.loggerProvider) {\n      throw new Error('Logger provider not initialized');\n    }\n    return this.loggerProvider.logError(message, error, data);\n  }\n\n  /**\n   * @deprecated The runtime no longer returns attachment IDs from the infer\n   * response — attachments are uploaded as standalone blobs and linked to the\n   * session via headers. Always returns `[]`; kept for source compatibility.\n   */\n  getAttachmentResponses(): string[] {\n    return this.attachmentResponses;\n  }\n\n  /**\n   * Upload a file into the session context. Returns the runtime {@link RuntimeBlob},\n   * which is what `sendMessage`'s `inputAudio` expects for audio inference.\n   */\n  async uploadAttachment(file: File, _attachmentId?: string): Promise<RuntimeBlob> {\n    void _attachmentId;\n    const url = this.adapter.resolveBlobUploadUrl();\n    const adapterHeaders = this.adapter.getHeaders?.() ?? {};\n    const formData = new FormData();\n    formData.append('file', file);\n    const response = await this.axiosInstance.post(url, formData, {\n      headers: {\n        'Content-Type': 'multipart/form-data',\n        ...adapterHeaders,\n        ...this.buildIdentityHeaders(),\n      },\n    });\n    return response.data as RuntimeBlob;\n  }\n\n  /**\n   * Identity headers (kebab-case) required by `/context/blob/upload` and\n   * the rest of the runtime's internal endpoints introduced in v0.2.0→next.\n   */\n  private buildIdentityHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'assistant-id': this.assistantId,\n    };\n    if (this.conversationId) headers['session-id'] = this.conversationId;\n    if (this.userId) headers['user-id'] = this.userId;\n    if (this.streamId) headers['task-id'] = this.streamId;\n    return headers;\n  }\n\n  /**\n   * Correlation headers for tool-completion and tool-approval: the runtime's\n   * `CommonAttributes` header aliases, with no separator. Not interchangeable\n   * with the kebab-case set in {@link buildIdentityHeaders}.\n   */\n  private buildDecisionHeaders(): Record<string, string> {\n    return {\n      'Content-Type': 'application/json',\n      assistantid: this.assistantId,\n      ...(this.streamId && { taskid: this.streamId }),\n      ...(this.conversationId && { sessionid: this.conversationId }),\n      ...(this.userId && { userid: this.userId }),\n      ...(this.agentspaceId && { agentspaceid: this.agentspaceId }),\n      ...(this.versionTag && { versiontag: this.versionTag }),\n      ...(this.adapter.getHeaders?.() ?? {}),\n    };\n  }\n\n  getUrlStream(): string {\n    if (!this.streamId) {\n      throw new Error('Stream ID not initialized. Call sendMessage() first');\n    }\n\n    const url = this.adapter.resolveStreamUrl(this.streamId);\n    if (!this.traceParent) return url;\n\n    // `EventSource` cannot set request headers, so the turn's traceparent rides\n    // the URL. The proxy turns it back into `x-trace-parent` and does not pass\n    // the param upstream; without this the stream leg — where the whole\n    // inference actually happens — lands in a different trace than the infer.\n    const separator = url.includes('?') ? '&' : '?';\n    return `${url}${separator}trace_parent=${encodeURIComponent(this.traceParent)}`;\n  }\n\n  getStreamId(): string | null {\n    return this.streamId;\n  }\n\n  /** Alias for {@link getStreamId} — same value as infer `taskid`. */\n  getTaskId(): string | null {\n    return this.streamId;\n  }\n\n  /** Registry version tag resolved by the runtime for the current task, if any. */\n  getVersionTag(): string | null {\n    return this.versionTag;\n  }\n\n  /** Agentspace the runtime resolved for the current task, if any. */\n  getAgentspaceId(): string | null {\n    return this.agentspaceId;\n  }\n}\n\n/**\n * Map a failed `/event/tool-approval` call onto an outcome. The runtime's 409s\n * share a status and differ only in `detail` (`routers/event.py`), so matching\n * the text is the contract, not a shortcut.\n */\nfunction classifyApprovalError(error: unknown): ToolApprovalResult {\n  const response = (error as { response?: { status?: number; data?: unknown } })?.response;\n  const status = response?.status;\n  const data = response?.data as { detail?: unknown; error?: unknown } | string | undefined;\n  const rawDetail =\n    typeof data === 'string' ? data : data?.detail ?? data?.error ?? (error as Error)?.message;\n  const detail = typeof rawDetail === 'string' ? rawDetail : JSON.stringify(rawDetail ?? '');\n\n  let outcome: ToolApprovalOutcome = 'error';\n  if (status === 409) {\n    if (/original channel/i.test(detail)) outcome = 'wrong-channel';\n    else if (/already been recorded/i.test(detail)) outcome = 'already-decided';\n    else if (/no pending approval/i.test(detail)) outcome = 'not-pending';\n  } else if (status === 401 || status === 403) {\n    outcome = 'forbidden';\n  } else if (status === 404) {\n    outcome = 'not-found';\n  }\n\n  return { outcome, ...(status !== undefined && { status }), detail };\n}\n\nexport default AlquimiaSDK;\n"],"mappings":"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","names":[]}

package/dist/services/index.d.mts

@@ -1,5 +1,5 @@
 import { Transaction } from '@elastic/apm-rum';
-import { A as ApmSpan } from '../type-61gaZga-.mjs';
+import { A as ApmSpan } from '../type-C_sKpIM1.mjs';
 import 'ai';
 import '../types-CMVbyEv8.mjs';
 

package/dist/services/index.d.ts

@@ -1,5 +1,5 @@
 import { Transaction } from '@elastic/apm-rum';
-import { A as ApmSpan } from '../type-D-JaSMkV.js';
+import { A as ApmSpan } from '../type-BFtGEEb4.js';
 import 'ai';
 import '../types-CMVbyEv8.js';
 

package/dist/{type-D-JaSMkV.d.ts → type-BFtGEEb4.d.ts}

@@ -353,4 +353,4 @@ interface GenuiSurfaceItem {
     dismissedWith?: string;
 }
 
-export { type ApmSpan as A, type BaseAPIConfig as B, type CommonAttributes as C, type DocumentSearchResult as D, type ElevenLabsRequestSpecs as E, type ToolEvent as F, type GenuiSurfaceItem as G, ToolFactory as H, type IToolSpec as I, type ToolOutput as J, type ToolSummary as K, type Tooler as L, type NativeToolsEvaluationStrategy as N, type OneShootEvaluationStrategy as O, type RatingData as R, type TTSResult as T, type UsageMetadata as U, type AIMessageChunk as a, type AIMessageChunkData as b, type ActionResponse as c, type AlquimiaEventData as d, type AlquimiaMessage as e, type ApiError as f, type AssistantInferenceResponse as g, type AssistantResponseData as h, type AttachmentPayload as i, type Content as j, type ContentPart as k, type ConversationsMap as l, type ElevenLabsVoiceSettings as m, type EvaluationStrategy as n, type ExpertInferenceResponse as o, type ExtraDataContext as p, type ITooler as q, type ImageContentPart as r, type InferInitResponse as s, type NonStandardContentPart as t, type RawToolsEvaluationStrategy as u, type ResponseMetadata as v, type RuntimeBlob as w, type TextContentPart as x, type ThinkingsInferenceResponse as y, type TokenUsage as z };
+export { type ApmSpan as A, type BaseAPIConfig as B, type Content as C, type DocumentSearchResult as D, type ElevenLabsRequestSpecs as E, type TokenUsage as F, type GenuiSurfaceItem as G, ToolFactory as H, type IToolSpec as I, type ToolOutput as J, type ToolSummary as K, type Tooler as L, type NativeToolsEvaluationStrategy as N, type OneShootEvaluationStrategy as O, type RatingData as R, type TTSResult as T, type UsageMetadata as U, type AlquimiaMessage as a, type ToolEvent as b, type AIMessageChunk as c, type AttachmentPayload as d, type RuntimeBlob as e, type AIMessageChunkData as f, type ActionResponse as g, type AlquimiaEventData as h, type ApiError as i, type AssistantInferenceResponse as j, type AssistantResponseData as k, type CommonAttributes as l, type ContentPart as m, type ConversationsMap as n, type ElevenLabsVoiceSettings as o, type EvaluationStrategy as p, type ExpertInferenceResponse as q, type ExtraDataContext as r, type ITooler as s, type ImageContentPart as t, type InferInitResponse as u, type NonStandardContentPart as v, type RawToolsEvaluationStrategy as w, type ResponseMetadata as x, type TextContentPart as y, type ThinkingsInferenceResponse as z };

package/dist/{type-61gaZga-.d.mts → type-C_sKpIM1.d.mts}

@@ -353,4 +353,4 @@ interface GenuiSurfaceItem {
     dismissedWith?: string;
 }
 
-export { type ApmSpan as A, type BaseAPIConfig as B, type CommonAttributes as C, type DocumentSearchResult as D, type ElevenLabsRequestSpecs as E, type ToolEvent as F, type GenuiSurfaceItem as G, ToolFactory as H, type IToolSpec as I, type ToolOutput as J, type ToolSummary as K, type Tooler as L, type NativeToolsEvaluationStrategy as N, type OneShootEvaluationStrategy as O, type RatingData as R, type TTSResult as T, type UsageMetadata as U, type AIMessageChunk as a, type AIMessageChunkData as b, type ActionResponse as c, type AlquimiaEventData as d, type AlquimiaMessage as e, type ApiError as f, type AssistantInferenceResponse as g, type AssistantResponseData as h, type AttachmentPayload as i, type Content as j, type ContentPart as k, type ConversationsMap as l, type ElevenLabsVoiceSettings as m, type EvaluationStrategy as n, type ExpertInferenceResponse as o, type ExtraDataContext as p, type ITooler as q, type ImageContentPart as r, type InferInitResponse as s, type NonStandardContentPart as t, type RawToolsEvaluationStrategy as u, type ResponseMetadata as v, type RuntimeBlob as w, type TextContentPart as x, type ThinkingsInferenceResponse as y, type TokenUsage as z };
+export { type ApmSpan as A, type BaseAPIConfig as B, type Content as C, type DocumentSearchResult as D, type ElevenLabsRequestSpecs as E, type TokenUsage as F, type GenuiSurfaceItem as G, ToolFactory as H, type IToolSpec as I, type ToolOutput as J, type ToolSummary as K, type Tooler as L, type NativeToolsEvaluationStrategy as N, type OneShootEvaluationStrategy as O, type RatingData as R, type TTSResult as T, type UsageMetadata as U, type AlquimiaMessage as a, type ToolEvent as b, type AIMessageChunk as c, type AttachmentPayload as d, type RuntimeBlob as e, type AIMessageChunkData as f, type ActionResponse as g, type AlquimiaEventData as h, type ApiError as i, type AssistantInferenceResponse as j, type AssistantResponseData as k, type CommonAttributes as l, type ContentPart as m, type ConversationsMap as n, type ElevenLabsVoiceSettings as o, type EvaluationStrategy as p, type ExpertInferenceResponse as q, type ExtraDataContext as r, type ITooler as s, type ImageContentPart as t, type InferInitResponse as u, type NonStandardContentPart as v, type RawToolsEvaluationStrategy as w, type ResponseMetadata as x, type TextContentPart as y, type ThinkingsInferenceResponse as z };

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-export { a as AIMessageChunk, b as AIMessageChunkData, c as ActionResponse, d as AlquimiaEventData, e as AlquimiaMessage, f as ApiError, A as ApmSpan, g as AssistantInferenceResponse, h as AssistantResponseData, i as AttachmentPayload, B as BaseAPIConfig, C as CommonAttributes, j as Content, k as ContentPart, l as ConversationsMap, D as DocumentSearchResult, E as ElevenLabsRequestSpecs, m as ElevenLabsVoiceSettings, n as EvaluationStrategy, o as ExpertInferenceResponse, p as ExtraDataContext, G as GenuiSurfaceItem, I as IToolSpec, q as ITooler, r as ImageContentPart, s as InferInitResponse, N as NativeToolsEvaluationStrategy, t as NonStandardContentPart, O as OneShootEvaluationStrategy, R as RatingData, u as RawToolsEvaluationStrategy, v as ResponseMetadata, w as RuntimeBlob, T as TTSResult, x as TextContentPart, y as ThinkingsInferenceResponse, z as TokenUsage, F as ToolEvent, H as ToolFactory, J as ToolOutput, K as ToolSummary, L as Tooler, U as UsageMetadata } from '../type-61gaZga-.mjs';
+export { c as AIMessageChunk, f as AIMessageChunkData, g as ActionResponse, h as AlquimiaEventData, a as AlquimiaMessage, i as ApiError, A as ApmSpan, j as AssistantInferenceResponse, k as AssistantResponseData, d as AttachmentPayload, B as BaseAPIConfig, l as CommonAttributes, C as Content, m as ContentPart, n as ConversationsMap, D as DocumentSearchResult, E as ElevenLabsRequestSpecs, o as ElevenLabsVoiceSettings, p as EvaluationStrategy, q as ExpertInferenceResponse, r as ExtraDataContext, G as GenuiSurfaceItem, I as IToolSpec, s as ITooler, t as ImageContentPart, u as InferInitResponse, N as NativeToolsEvaluationStrategy, v as NonStandardContentPart, O as OneShootEvaluationStrategy, R as RatingData, w as RawToolsEvaluationStrategy, x as ResponseMetadata, e as RuntimeBlob, T as TTSResult, y as TextContentPart, z as ThinkingsInferenceResponse, F as TokenUsage, b as ToolEvent, H as ToolFactory, J as ToolOutput, K as ToolSummary, L as Tooler, U as UsageMetadata } from '../type-C_sKpIM1.mjs';
 import { T as ToolExecutionResponse } from '../types-CMVbyEv8.mjs';
 import { W as WorklogRecord } from '../types-lOliroPw.mjs';
 import '@elastic/apm-rum';
@@ -62,6 +62,27 @@ interface ToolApprovalEvent extends RuntimeEventBase {
     /** Optional reason or note attached to the decision. */
     message?: string;
 }
+/**
+ * How the runtime answered a {@link ToolApprovalEvent}. `POST /event/tool-approval`
+ * answers every refusal with a 409 and only the `detail` text tells them apart,
+ * so the SDK classifies it once here instead of every caller string-matching.
+ *
+ * - `accepted` — the decision was recorded and the parked tool call resumes (or is dropped).
+ * - `already-decided` — someone else (another operator, the originating channel) answered first.
+ * - `wrong-channel` — the gate must be answered on the channel that raised it; HTTP never will.
+ * - `not-pending` — the control id is stale or already resolved.
+ * - `forbidden` — the caller lacks an approver role or is not bound to the task's agentspace.
+ * - `not-found` — the task is gone (finished or expired).
+ * - `error` — anything else: transport failure, 5xx, an unrecognized 409.
+ */
+type ToolApprovalOutcome = "accepted" | "already-decided" | "wrong-channel" | "not-pending" | "forbidden" | "not-found" | "error";
+interface ToolApprovalResult {
+    outcome: ToolApprovalOutcome;
+    /** HTTP status, when a response came back at all. */
+    status?: number;
+    /** The runtime's `detail`, verbatim, for anything but `accepted`. */
+    detail?: string;
+}
 /** POST /event/tool-completion (client-side tool execution result). */
 interface ToolCompletionEvent extends ToolExecutionResponse {
     event_class: "ToolCompletionEvent";
@@ -85,4 +106,4 @@ interface HeartbeatEvent extends RuntimeEventBase {
 /** Discriminated union of all runtime v0.5.1 event payloads. */
 type RuntimeEvent = SessionStartEvent | SessionEndEvent | UserMessageEvent | AgentMessageEvent | ToolApprovalEvent | ToolCompletionEvent | RuntimeErrorEvent | BusModeEvent | HeartbeatEvent;
 
-export type { AgentMessageEvent, BusModeEvent, HeartbeatEvent, RuntimeErrorEvent, RuntimeEvent, RuntimeEventBase, SessionEndEvent, SessionStartEvent, ToolApprovalEvent, ToolCompletionEvent, UserMessageEvent };
+export type { AgentMessageEvent, BusModeEvent, HeartbeatEvent, RuntimeErrorEvent, RuntimeEvent, RuntimeEventBase, SessionEndEvent, SessionStartEvent, ToolApprovalEvent, ToolApprovalOutcome, ToolApprovalResult, ToolCompletionEvent, UserMessageEvent };

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { a as AIMessageChunk, b as AIMessageChunkData, c as ActionResponse, d as AlquimiaEventData, e as AlquimiaMessage, f as ApiError, A as ApmSpan, g as AssistantInferenceResponse, h as AssistantResponseData, i as AttachmentPayload, B as BaseAPIConfig, C as CommonAttributes, j as Content, k as ContentPart, l as ConversationsMap, D as DocumentSearchResult, E as ElevenLabsRequestSpecs, m as ElevenLabsVoiceSettings, n as EvaluationStrategy, o as ExpertInferenceResponse, p as ExtraDataContext, G as GenuiSurfaceItem, I as IToolSpec, q as ITooler, r as ImageContentPart, s as InferInitResponse, N as NativeToolsEvaluationStrategy, t as NonStandardContentPart, O as OneShootEvaluationStrategy, R as RatingData, u as RawToolsEvaluationStrategy, v as ResponseMetadata, w as RuntimeBlob, T as TTSResult, x as TextContentPart, y as ThinkingsInferenceResponse, z as TokenUsage, F as ToolEvent, H as ToolFactory, J as ToolOutput, K as ToolSummary, L as Tooler, U as UsageMetadata } from '../type-D-JaSMkV.js';
+export { c as AIMessageChunk, f as AIMessageChunkData, g as ActionResponse, h as AlquimiaEventData, a as AlquimiaMessage, i as ApiError, A as ApmSpan, j as AssistantInferenceResponse, k as AssistantResponseData, d as AttachmentPayload, B as BaseAPIConfig, l as CommonAttributes, C as Content, m as ContentPart, n as ConversationsMap, D as DocumentSearchResult, E as ElevenLabsRequestSpecs, o as ElevenLabsVoiceSettings, p as EvaluationStrategy, q as ExpertInferenceResponse, r as ExtraDataContext, G as GenuiSurfaceItem, I as IToolSpec, s as ITooler, t as ImageContentPart, u as InferInitResponse, N as NativeToolsEvaluationStrategy, v as NonStandardContentPart, O as OneShootEvaluationStrategy, R as RatingData, w as RawToolsEvaluationStrategy, x as ResponseMetadata, e as RuntimeBlob, T as TTSResult, y as TextContentPart, z as ThinkingsInferenceResponse, F as TokenUsage, b as ToolEvent, H as ToolFactory, J as ToolOutput, K as ToolSummary, L as Tooler, U as UsageMetadata } from '../type-BFtGEEb4.js';
 import { T as ToolExecutionResponse } from '../types-CMVbyEv8.js';
 import { W as WorklogRecord } from '../types-lOliroPw.js';
 import '@elastic/apm-rum';
@@ -62,6 +62,27 @@ interface ToolApprovalEvent extends RuntimeEventBase {
     /** Optional reason or note attached to the decision. */
     message?: string;
 }
+/**
+ * How the runtime answered a {@link ToolApprovalEvent}. `POST /event/tool-approval`
+ * answers every refusal with a 409 and only the `detail` text tells them apart,
+ * so the SDK classifies it once here instead of every caller string-matching.
+ *
+ * - `accepted` — the decision was recorded and the parked tool call resumes (or is dropped).
+ * - `already-decided` — someone else (another operator, the originating channel) answered first.
+ * - `wrong-channel` — the gate must be answered on the channel that raised it; HTTP never will.
+ * - `not-pending` — the control id is stale or already resolved.
+ * - `forbidden` — the caller lacks an approver role or is not bound to the task's agentspace.
+ * - `not-found` — the task is gone (finished or expired).
+ * - `error` — anything else: transport failure, 5xx, an unrecognized 409.
+ */
+type ToolApprovalOutcome = "accepted" | "already-decided" | "wrong-channel" | "not-pending" | "forbidden" | "not-found" | "error";
+interface ToolApprovalResult {
+    outcome: ToolApprovalOutcome;
+    /** HTTP status, when a response came back at all. */
+    status?: number;
+    /** The runtime's `detail`, verbatim, for anything but `accepted`. */
+    detail?: string;
+}
 /** POST /event/tool-completion (client-side tool execution result). */
 interface ToolCompletionEvent extends ToolExecutionResponse {
     event_class: "ToolCompletionEvent";
@@ -85,4 +106,4 @@ interface HeartbeatEvent extends RuntimeEventBase {
 /** Discriminated union of all runtime v0.5.1 event payloads. */
 type RuntimeEvent = SessionStartEvent | SessionEndEvent | UserMessageEvent | AgentMessageEvent | ToolApprovalEvent | ToolCompletionEvent | RuntimeErrorEvent | BusModeEvent | HeartbeatEvent;
 
-export type { AgentMessageEvent, BusModeEvent, HeartbeatEvent, RuntimeErrorEvent, RuntimeEvent, RuntimeEventBase, SessionEndEvent, SessionStartEvent, ToolApprovalEvent, ToolCompletionEvent, UserMessageEvent };
+export type { AgentMessageEvent, BusModeEvent, HeartbeatEvent, RuntimeErrorEvent, RuntimeEvent, RuntimeEventBase, SessionEndEvent, SessionStartEvent, ToolApprovalEvent, ToolApprovalOutcome, ToolApprovalResult, ToolCompletionEvent, UserMessageEvent };

package/dist/utils/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BaseAPIConfig, y as ThinkingsInferenceResponse, L as Tooler, F as ToolEvent, l as ConversationsMap } from '../type-61gaZga-.mjs';
+import { B as BaseAPIConfig, z as ThinkingsInferenceResponse, L as Tooler, b as ToolEvent, n as ConversationsMap } from '../type-C_sKpIM1.mjs';
 import { C as CatalogManifest } from '../registry-Bcu_ZYL1.mjs';
 import '@elastic/apm-rum';
 import 'ai';

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { B as BaseAPIConfig, y as ThinkingsInferenceResponse, L as Tooler, F as ToolEvent, l as ConversationsMap } from '../type-D-JaSMkV.js';
+import { B as BaseAPIConfig, z as ThinkingsInferenceResponse, L as Tooler, b as ToolEvent, n as ConversationsMap } from '../type-BFtGEEb4.js';
 import { C as CatalogManifest } from '../registry-Bcu_ZYL1.js';
 import '@elastic/apm-rum';
 import 'ai';

package/dist/worklog/index.d.mts

@@ -1,5 +1,6 @@
 import { E as EventInterpreter, W as WorklogRecord, a as WorklogState } from '../types-lOliroPw.mjs';
 export { b as EventRole, N as NodeKind, c as NodeStatus, R as RunStatus, d as WorklogDetail, e as WorklogEventDetail, f as WorklogEventPage, g as WorklogNode, h as WorklogPage, i as WorklogSummary, j as WorklogVerificationResult, k as initialWorklogState } from '../types-lOliroPw.mjs';
+export { a as ApprovalDecision, A as ApprovalRequest, b as ApprovalsState, f as foldApprovals, i as initialApprovalsState, l as listApprovals, p as pendingApprovals, r as reduceApprovals } from '../approvals-dn4sd_Ot.mjs';
 
 declare const EVENT_REGISTRY: Record<string, EventInterpreter>;
 declare function resolveInterpreter(eventClass: string): EventInterpreter;

package/dist/worklog/index.d.ts

@@ -1,5 +1,6 @@
 import { E as EventInterpreter, W as WorklogRecord, a as WorklogState } from '../types-lOliroPw.js';
 export { b as EventRole, N as NodeKind, c as NodeStatus, R as RunStatus, d as WorklogDetail, e as WorklogEventDetail, f as WorklogEventPage, g as WorklogNode, h as WorklogPage, i as WorklogSummary, j as WorklogVerificationResult, k as initialWorklogState } from '../types-lOliroPw.js';
+export { a as ApprovalDecision, A as ApprovalRequest, b as ApprovalsState, f as foldApprovals, i as initialApprovalsState, l as listApprovals, p as pendingApprovals, r as reduceApprovals } from '../approvals-CcnmqUkQ.js';
 
 declare const EVENT_REGISTRY: Record<string, EventInterpreter>;
 declare function resolveInterpreter(eventClass: string): EventInterpreter;

package/dist/worklog/index.js

@@ -21,9 +21,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var worklog_exports = {};
 __export(worklog_exports, {
   EVENT_REGISTRY: () => EVENT_REGISTRY,
+  foldApprovals: () => foldApprovals,
   foldWorklog: () => foldWorklog,
   frameToRecord: () => frameToRecord,
+  initialApprovalsState: () => initialApprovalsState,
   initialWorklogState: () => initialWorklogState,
+  listApprovals: () => listApprovals,
+  pendingApprovals: () => pendingApprovals,
+  reduceApprovals: () => reduceApprovals,
   reduceWorklog: () => reduceWorklog,
   resolveInterpreter: () => resolveInterpreter,
   useWorklog: () => useWorklog
@@ -46,6 +51,10 @@ var agentTitle = (r) => {
   return typeof name === "string" && name.length > 0 ? `Agent: ${name}` : "Agent-to-agent";
 };
 var constTitle = (label) => () => label;
+var approvalTitle = (r) => {
+  const name = asRecord(asRecord(r.data).parameters).name;
+  return typeof name === "string" && name.length > 0 ? `Approval required: ${name}` : "Human approval required";
+};
 var shieldBlockTitle = (r) => {
   const id = asRecord(r.data).shield_id;
   return typeof id === "string" && id.length > 0 ? `Blocked by ${id}` : "Blocked by safeguard";
@@ -97,7 +106,7 @@ var EVENT_REGISTRY = {
   HumanApprovalRequired: {
     kind: "tool",
     role: "open",
-    title: constTitle("Human approval required"),
+    title: approvalTitle,
     pending: true
   },
   HumanApprovalRequiredResponse: { kind: "tool", role: "close", title: constTitle("Human approval") }
@@ -186,7 +195,12 @@ function reduceWorklog(state, record) {
   const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : void 0;
   if (pos != null) {
     const existing = next.nodes[pos];
-    next.nodes[pos] = { ...existing, raw: [...existing.raw, record] };
+    next.nodes[pos] = {
+      ...existing,
+      command: existing.command ?? record.data,
+      title: existing.command === void 0 ? interp.title(record) : existing.title,
+      raw: [...existing.raw, record]
+    };
   } else {
     next.index[key] = next.nodes.length;
     next.nodes.push(makeOpenNode(record, interp, key));
@@ -236,4 +250,63 @@ function frameToRecord(frame) {
     previous_hash: frame.previous_hash ?? null
   };
 }
+
+// src/worklog/approvals.ts
+function initialApprovalsState() {
+  return { order: [], byId: {} };
+}
+var asObject = (v) => v && typeof v === "object" && !Array.isArray(v) ? v : null;
+var MCP_APPROVAL_EXTENSION = "mcp_approval";
+function describeRequest(record) {
+  const execution = asObject(asObject(record.data)?.parameters) ?? {};
+  const name = execution.name;
+  const callId = execution.control_id;
+  const args = execution.tool_call_parameters !== void 0 && execution.tool_call_parameters !== null ? execution.tool_call_parameters : execution.parameters;
+  const extensions = asObject(execution.parameters)?.runtime_extensions;
+  return {
+    toolName: typeof name === "string" && name.length > 0 ? name : null,
+    toolCallId: typeof callId === "string" ? callId : null,
+    arguments: args ?? null,
+    channelOwned: Array.isArray(extensions) && extensions.includes(MCP_APPROVAL_EXTENSION)
+  };
+}
+function describeDecision(record) {
+  const approved = record.data === true;
+  return {
+    approved,
+    reason: !approved && typeof record.data === "string" && record.data.length > 0 ? record.data : null,
+    decidedAt: record.date_submitted
+  };
+}
+var blank = (controlId) => ({
+  controlId,
+  toolName: null,
+  toolCallId: null,
+  arguments: null,
+  channelOwned: false,
+  requestedAt: null,
+  decision: null
+});
+function reduceApprovals(state, record) {
+  const isRequest = record.event_class === "HumanApprovalRequired";
+  const isResponse = record.event_class === "HumanApprovalRequiredResponse";
+  if (!isRequest && !isResponse || !record.control_id) return state;
+  const id = record.control_id;
+  const known = state.byId[id];
+  const current = known ?? blank(id);
+  const next = isRequest ? { ...current, ...describeRequest(record), requestedAt: record.date_submitted } : { ...current, decision: current.decision ?? describeDecision(record) };
+  return {
+    order: known ? state.order : [...state.order, id],
+    byId: { ...state.byId, [id]: next }
+  };
+}
+function foldApprovals(records) {
+  return records.reduce(reduceApprovals, initialApprovalsState());
+}
+function listApprovals(state) {
+  return state.order.map((id) => state.byId[id]);
+}
+function pendingApprovals(state) {
+  return listApprovals(state).filter((a) => a.decision === null);
+}
 //# sourceMappingURL=index.js.map