@alquimia-ai/tools 2.5.0 → 2.8.0

package/dist/adapters/fetch.js

@@ -28,6 +28,7 @@ function createFetchAdapter(options) {
   const streamPath = options.streamPath ?? "/stream";
   const blobUploadPath = options.blobUploadPath ?? "/blob/upload";
   const toolCompletionPath = options.toolCompletionPath ?? "/tool-completion";
+  const toolApprovalPath = options.toolApprovalPath ?? "/tool-approval";
   const busMode = options.busMode ?? false;
   const baseUrl = options.baseUrl.replace(/\/$/, "");
   return {
@@ -44,6 +45,9 @@ function createFetchAdapter(options) {
     resolveToolCompletionUrl() {
       return `${baseUrl}${toolCompletionPath}`;
     },
+    resolveToolApprovalUrl() {
+      return `${baseUrl}${toolApprovalPath}`;
+    },
     getHeaders: options.getHeaders
   };
 }

package/dist/adapters/fetch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/fetch.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface FetchAdapterOptions {\n  baseUrl: string;\n  getHeaders?: () => Record<string, string>;\n  inferPath?: string;             // default: '/chat'\n  streamPath?: string;            // default: '/stream'\n  blobUploadPath?: string;        // default: '/blob/upload'\n  toolCompletionPath?: string;    // default: '/tool-completion'\n  busMode?: boolean;              // default: false\n}\n\nexport function createFetchAdapter(options: FetchAdapterOptions): AlquimiaAdapter {\n  const inferPath = options.inferPath ?? '/chat';\n  const streamPath = options.streamPath ?? '/stream';\n  const blobUploadPath = options.blobUploadPath ?? '/blob/upload';\n  const toolCompletionPath = options.toolCompletionPath ?? '/tool-completion';\n  const busMode = options.busMode ?? false;\n  const baseUrl = options.baseUrl.replace(/\\/$/, '');\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${baseUrl}${inferPath}/${assistantId}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${baseUrl}${streamPath}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return `${baseUrl}${blobUploadPath}`;\n    },\n    resolveToolCompletionUrl(): string {\n      return `${baseUrl}${toolCompletionPath}`;\n    },\n    getHeaders: options.getHeaders,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAYO,SAAS,mBAAmB,SAA+C;AAChF,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,qBAAqB,QAAQ,sBAAsB;AACzD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAEjD,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,OAAO,GAAG,SAAS,IAAI,WAAW;AAAA,IAC9C;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,OAAO,GAAG,UAAU,IAAI,QAAQ;AAC/C,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO,GAAG,OAAO,GAAG,cAAc;AAAA,IACpC;AAAA,IACA,2BAAmC;AACjC,aAAO,GAAG,OAAO,GAAG,kBAAkB;AAAA,IACxC;AAAA,IACA,YAAY,QAAQ;AAAA,EACtB;AACF;","names":[]}
+{"version":3,"sources":["../../src/adapters/fetch.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface FetchAdapterOptions {\n  baseUrl: string;\n  getHeaders?: () => Record<string, string>;\n  inferPath?: string;             // default: '/chat'\n  streamPath?: string;            // default: '/stream'\n  blobUploadPath?: string;        // default: '/blob/upload'\n  toolCompletionPath?: string;    // default: '/tool-completion'\n  toolApprovalPath?: string;      // default: '/tool-approval'\n  busMode?: boolean;              // default: false\n}\n\nexport function createFetchAdapter(options: FetchAdapterOptions): AlquimiaAdapter {\n  const inferPath = options.inferPath ?? '/chat';\n  const streamPath = options.streamPath ?? '/stream';\n  const blobUploadPath = options.blobUploadPath ?? '/blob/upload';\n  const toolCompletionPath = options.toolCompletionPath ?? '/tool-completion';\n  const toolApprovalPath = options.toolApprovalPath ?? '/tool-approval';\n  const busMode = options.busMode ?? false;\n  const baseUrl = options.baseUrl.replace(/\\/$/, '');\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${baseUrl}${inferPath}/${assistantId}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${baseUrl}${streamPath}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return `${baseUrl}${blobUploadPath}`;\n    },\n    resolveToolCompletionUrl(): string {\n      return `${baseUrl}${toolCompletionPath}`;\n    },\n    resolveToolApprovalUrl(): string {\n      return `${baseUrl}${toolApprovalPath}`;\n    },\n    getHeaders: options.getHeaders,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,mBAAmB,SAA+C;AAChF,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,qBAAqB,QAAQ,sBAAsB;AACzD,QAAM,mBAAmB,QAAQ,oBAAoB;AACrD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAEjD,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,OAAO,GAAG,SAAS,IAAI,WAAW;AAAA,IAC9C;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,OAAO,GAAG,UAAU,IAAI,QAAQ;AAC/C,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO,GAAG,OAAO,GAAG,cAAc;AAAA,IACpC;AAAA,IACA,2BAAmC;AACjC,aAAO,GAAG,OAAO,GAAG,kBAAkB;AAAA,IACxC;AAAA,IACA,yBAAiC;AAC/B,aAAO,GAAG,OAAO,GAAG,gBAAgB;AAAA,IACtC;AAAA,IACA,YAAY,QAAQ;AAAA,EACtB;AACF;","names":[]}

package/dist/adapters/fetch.mjs

@@ -4,6 +4,7 @@ function createFetchAdapter(options) {
   const streamPath = options.streamPath ?? "/stream";
   const blobUploadPath = options.blobUploadPath ?? "/blob/upload";
   const toolCompletionPath = options.toolCompletionPath ?? "/tool-completion";
+  const toolApprovalPath = options.toolApprovalPath ?? "/tool-approval";
   const busMode = options.busMode ?? false;
   const baseUrl = options.baseUrl.replace(/\/$/, "");
   return {
@@ -20,6 +21,9 @@ function createFetchAdapter(options) {
     resolveToolCompletionUrl() {
       return `${baseUrl}${toolCompletionPath}`;
     },
+    resolveToolApprovalUrl() {
+      return `${baseUrl}${toolApprovalPath}`;
+    },
     getHeaders: options.getHeaders
   };
 }

package/dist/adapters/fetch.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/fetch.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface FetchAdapterOptions {\n  baseUrl: string;\n  getHeaders?: () => Record<string, string>;\n  inferPath?: string;             // default: '/chat'\n  streamPath?: string;            // default: '/stream'\n  blobUploadPath?: string;        // default: '/blob/upload'\n  toolCompletionPath?: string;    // default: '/tool-completion'\n  busMode?: boolean;              // default: false\n}\n\nexport function createFetchAdapter(options: FetchAdapterOptions): AlquimiaAdapter {\n  const inferPath = options.inferPath ?? '/chat';\n  const streamPath = options.streamPath ?? '/stream';\n  const blobUploadPath = options.blobUploadPath ?? '/blob/upload';\n  const toolCompletionPath = options.toolCompletionPath ?? '/tool-completion';\n  const busMode = options.busMode ?? false;\n  const baseUrl = options.baseUrl.replace(/\\/$/, '');\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${baseUrl}${inferPath}/${assistantId}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${baseUrl}${streamPath}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return `${baseUrl}${blobUploadPath}`;\n    },\n    resolveToolCompletionUrl(): string {\n      return `${baseUrl}${toolCompletionPath}`;\n    },\n    getHeaders: options.getHeaders,\n  };\n}\n"],"mappings":";AAYO,SAAS,mBAAmB,SAA+C;AAChF,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,qBAAqB,QAAQ,sBAAsB;AACzD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAEjD,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,OAAO,GAAG,SAAS,IAAI,WAAW;AAAA,IAC9C;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,OAAO,GAAG,UAAU,IAAI,QAAQ;AAC/C,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO,GAAG,OAAO,GAAG,cAAc;AAAA,IACpC;AAAA,IACA,2BAAmC;AACjC,aAAO,GAAG,OAAO,GAAG,kBAAkB;AAAA,IACxC;AAAA,IACA,YAAY,QAAQ;AAAA,EACtB;AACF;","names":[]}
+{"version":3,"sources":["../../src/adapters/fetch.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface FetchAdapterOptions {\n  baseUrl: string;\n  getHeaders?: () => Record<string, string>;\n  inferPath?: string;             // default: '/chat'\n  streamPath?: string;            // default: '/stream'\n  blobUploadPath?: string;        // default: '/blob/upload'\n  toolCompletionPath?: string;    // default: '/tool-completion'\n  toolApprovalPath?: string;      // default: '/tool-approval'\n  busMode?: boolean;              // default: false\n}\n\nexport function createFetchAdapter(options: FetchAdapterOptions): AlquimiaAdapter {\n  const inferPath = options.inferPath ?? '/chat';\n  const streamPath = options.streamPath ?? '/stream';\n  const blobUploadPath = options.blobUploadPath ?? '/blob/upload';\n  const toolCompletionPath = options.toolCompletionPath ?? '/tool-completion';\n  const toolApprovalPath = options.toolApprovalPath ?? '/tool-approval';\n  const busMode = options.busMode ?? false;\n  const baseUrl = options.baseUrl.replace(/\\/$/, '');\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${baseUrl}${inferPath}/${assistantId}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${baseUrl}${streamPath}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return `${baseUrl}${blobUploadPath}`;\n    },\n    resolveToolCompletionUrl(): string {\n      return `${baseUrl}${toolCompletionPath}`;\n    },\n    resolveToolApprovalUrl(): string {\n      return `${baseUrl}${toolApprovalPath}`;\n    },\n    getHeaders: options.getHeaders,\n  };\n}\n"],"mappings":";AAaO,SAAS,mBAAmB,SAA+C;AAChF,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,qBAAqB,QAAQ,sBAAsB;AACzD,QAAM,mBAAmB,QAAQ,oBAAoB;AACrD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAEjD,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,OAAO,GAAG,SAAS,IAAI,WAAW;AAAA,IAC9C;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,OAAO,GAAG,UAAU,IAAI,QAAQ;AAC/C,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO,GAAG,OAAO,GAAG,cAAc;AAAA,IACpC;AAAA,IACA,2BAAmC;AACjC,aAAO,GAAG,OAAO,GAAG,kBAAkB;AAAA,IACxC;AAAA,IACA,yBAAiC;AAC/B,aAAO,GAAG,OAAO,GAAG,gBAAgB;AAAA,IACtC;AAAA,IACA,YAAY,QAAQ;AAAA,EACtB;AACF;","names":[]}

package/dist/adapters/index.d.mts

@@ -3,6 +3,7 @@ interface AlquimiaAdapter {
     resolveStreamUrl(_streamId: string): string;
     resolveBlobUploadUrl(): string;
     resolveToolCompletionUrl?(): string;
+    resolveToolApprovalUrl?(): string;
     getHeaders?(): Record<string, string>;
 }
 interface AlquimiaSDKOptions {

package/dist/adapters/index.d.ts

@@ -3,6 +3,7 @@ interface AlquimiaAdapter {
     resolveStreamUrl(_streamId: string): string;
     resolveBlobUploadUrl(): string;
     resolveToolCompletionUrl?(): string;
+    resolveToolApprovalUrl?(): string;
     getHeaders?(): Record<string, string>;
 }
 interface AlquimiaSDKOptions {

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/index.ts"],"sourcesContent":["export interface AlquimiaAdapter {\n  resolveInferUrl(_assistantId: string): string;\n  resolveStreamUrl(_streamId: string): string;\n  resolveBlobUploadUrl(): string;\n  resolveToolCompletionUrl?(): string;\n  getHeaders?(): Record<string, string>;\n}\n\nexport interface AlquimiaSDKOptions {\n  enforceCharacterization?: boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/adapters/index.ts"],"sourcesContent":["export interface AlquimiaAdapter {\n  resolveInferUrl(_assistantId: string): string;\n  resolveStreamUrl(_streamId: string): string;\n  resolveBlobUploadUrl(): string;\n  resolveToolCompletionUrl?(): string;\n  resolveToolApprovalUrl?(): string;\n  getHeaders?(): Record<string, string>;\n}\n\nexport interface AlquimiaSDKOptions {\n  enforceCharacterization?: boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/adapters/next.d.mts

@@ -5,6 +5,7 @@ interface NextJsAdapterOptions {
     streamRoute?: string;
     blobUploadRoute?: string;
     toolCompletionRoute?: string;
+    toolApprovalRoute?: string;
     busMode?: boolean;
 }
 declare function createNextJsAdapter(options?: NextJsAdapterOptions): AlquimiaAdapter;

package/dist/adapters/next.d.ts

@@ -5,6 +5,7 @@ interface NextJsAdapterOptions {
     streamRoute?: string;
     blobUploadRoute?: string;
     toolCompletionRoute?: string;
+    toolApprovalRoute?: string;
     busMode?: boolean;
 }
 declare function createNextJsAdapter(options?: NextJsAdapterOptions): AlquimiaAdapter;

package/dist/adapters/next.js

@@ -28,6 +28,7 @@ function createNextJsAdapter(options) {
   const streamRoute = options?.streamRoute ?? "/api/stream";
   const blobUploadRoute = options?.blobUploadRoute ?? "/api/blob/upload";
   const toolCompletionRoute = options?.toolCompletionRoute ?? "/api/tool-completion";
+  const toolApprovalRoute = options?.toolApprovalRoute ?? "/api/tool-approval";
   const busMode = options?.busMode ?? false;
   return {
     resolveInferUrl(assistantId) {
@@ -42,6 +43,9 @@ function createNextJsAdapter(options) {
     },
     resolveToolCompletionUrl() {
       return toolCompletionRoute;
+    },
+    resolveToolApprovalUrl() {
+      return toolApprovalRoute;
     }
   };
 }

package/dist/adapters/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/next.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface NextJsAdapterOptions {\n  inferRoute?: string;            // default: '/api/chat'\n  streamRoute?: string;           // default: '/api/stream'\n  blobUploadRoute?: string;       // default: '/api/blob/upload'\n  toolCompletionRoute?: string;   // default: '/api/tool-completion'\n  busMode?: boolean;              // default: false\n}\n\nexport function createNextJsAdapter(options?: NextJsAdapterOptions): AlquimiaAdapter {\n  const inferRoute = options?.inferRoute ?? '/api/chat';\n  const streamRoute = options?.streamRoute ?? '/api/stream';\n  const blobUploadRoute = options?.blobUploadRoute ?? '/api/blob/upload';\n  const toolCompletionRoute = options?.toolCompletionRoute ?? '/api/tool-completion';\n  const busMode = options?.busMode ?? false;\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${inferRoute.replace(/\\/$/, '')}/${encodeURIComponent(assistantId)}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${streamRoute}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return blobUploadRoute;\n    },\n    resolveToolCompletionUrl(): string {\n      return toolCompletionRoute;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUO,SAAS,oBAAoB,SAAiD;AACnF,QAAM,aAAa,SAAS,cAAc;AAC1C,QAAM,cAAc,SAAS,eAAe;AAC5C,QAAM,kBAAkB,SAAS,mBAAmB;AACpD,QAAM,sBAAsB,SAAS,uBAAuB;AAC5D,QAAM,UAAU,SAAS,WAAW;AAEpC,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,WAAW,QAAQ,OAAO,EAAE,CAAC,IAAI,mBAAmB,WAAW,CAAC;AAAA,IAC5E;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,WAAW,IAAI,QAAQ;AACtC,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO;AAAA,IACT;AAAA,IACA,2BAAmC;AACjC,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/adapters/next.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface NextJsAdapterOptions {\n  inferRoute?: string;            // default: '/api/chat'\n  streamRoute?: string;           // default: '/api/stream'\n  blobUploadRoute?: string;       // default: '/api/blob/upload'\n  toolCompletionRoute?: string;   // default: '/api/tool-completion'\n  toolApprovalRoute?: string;     // default: '/api/tool-approval'\n  busMode?: boolean;              // default: false\n}\n\nexport function createNextJsAdapter(options?: NextJsAdapterOptions): AlquimiaAdapter {\n  const inferRoute = options?.inferRoute ?? '/api/chat';\n  const streamRoute = options?.streamRoute ?? '/api/stream';\n  const blobUploadRoute = options?.blobUploadRoute ?? '/api/blob/upload';\n  const toolCompletionRoute = options?.toolCompletionRoute ?? '/api/tool-completion';\n  const toolApprovalRoute = options?.toolApprovalRoute ?? '/api/tool-approval';\n  const busMode = options?.busMode ?? false;\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${inferRoute.replace(/\\/$/, '')}/${encodeURIComponent(assistantId)}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${streamRoute}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return blobUploadRoute;\n    },\n    resolveToolCompletionUrl(): string {\n      return toolCompletionRoute;\n    },\n    resolveToolApprovalUrl(): string {\n      return toolApprovalRoute;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,SAAS,oBAAoB,SAAiD;AACnF,QAAM,aAAa,SAAS,cAAc;AAC1C,QAAM,cAAc,SAAS,eAAe;AAC5C,QAAM,kBAAkB,SAAS,mBAAmB;AACpD,QAAM,sBAAsB,SAAS,uBAAuB;AAC5D,QAAM,oBAAoB,SAAS,qBAAqB;AACxD,QAAM,UAAU,SAAS,WAAW;AAEpC,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,WAAW,QAAQ,OAAO,EAAE,CAAC,IAAI,mBAAmB,WAAW,CAAC;AAAA,IAC5E;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,WAAW,IAAI,QAAQ;AACtC,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO;AAAA,IACT;AAAA,IACA,2BAAmC;AACjC,aAAO;AAAA,IACT;AAAA,IACA,yBAAiC;AAC/B,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/adapters/next.mjs

@@ -4,6 +4,7 @@ function createNextJsAdapter(options) {
   const streamRoute = options?.streamRoute ?? "/api/stream";
   const blobUploadRoute = options?.blobUploadRoute ?? "/api/blob/upload";
   const toolCompletionRoute = options?.toolCompletionRoute ?? "/api/tool-completion";
+  const toolApprovalRoute = options?.toolApprovalRoute ?? "/api/tool-approval";
   const busMode = options?.busMode ?? false;
   return {
     resolveInferUrl(assistantId) {
@@ -18,6 +19,9 @@ function createNextJsAdapter(options) {
     },
     resolveToolCompletionUrl() {
       return toolCompletionRoute;
+    },
+    resolveToolApprovalUrl() {
+      return toolApprovalRoute;
     }
   };
 }

package/dist/adapters/next.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/next.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface NextJsAdapterOptions {\n  inferRoute?: string;            // default: '/api/chat'\n  streamRoute?: string;           // default: '/api/stream'\n  blobUploadRoute?: string;       // default: '/api/blob/upload'\n  toolCompletionRoute?: string;   // default: '/api/tool-completion'\n  busMode?: boolean;              // default: false\n}\n\nexport function createNextJsAdapter(options?: NextJsAdapterOptions): AlquimiaAdapter {\n  const inferRoute = options?.inferRoute ?? '/api/chat';\n  const streamRoute = options?.streamRoute ?? '/api/stream';\n  const blobUploadRoute = options?.blobUploadRoute ?? '/api/blob/upload';\n  const toolCompletionRoute = options?.toolCompletionRoute ?? '/api/tool-completion';\n  const busMode = options?.busMode ?? false;\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${inferRoute.replace(/\\/$/, '')}/${encodeURIComponent(assistantId)}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${streamRoute}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return blobUploadRoute;\n    },\n    resolveToolCompletionUrl(): string {\n      return toolCompletionRoute;\n    },\n  };\n}\n"],"mappings":";AAUO,SAAS,oBAAoB,SAAiD;AACnF,QAAM,aAAa,SAAS,cAAc;AAC1C,QAAM,cAAc,SAAS,eAAe;AAC5C,QAAM,kBAAkB,SAAS,mBAAmB;AACpD,QAAM,sBAAsB,SAAS,uBAAuB;AAC5D,QAAM,UAAU,SAAS,WAAW;AAEpC,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,WAAW,QAAQ,OAAO,EAAE,CAAC,IAAI,mBAAmB,WAAW,CAAC;AAAA,IAC5E;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,WAAW,IAAI,QAAQ;AACtC,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO;AAAA,IACT;AAAA,IACA,2BAAmC;AACjC,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/adapters/next.ts"],"sourcesContent":["import type { AlquimiaAdapter } from './index';\n\nexport interface NextJsAdapterOptions {\n  inferRoute?: string;            // default: '/api/chat'\n  streamRoute?: string;           // default: '/api/stream'\n  blobUploadRoute?: string;       // default: '/api/blob/upload'\n  toolCompletionRoute?: string;   // default: '/api/tool-completion'\n  toolApprovalRoute?: string;     // default: '/api/tool-approval'\n  busMode?: boolean;              // default: false\n}\n\nexport function createNextJsAdapter(options?: NextJsAdapterOptions): AlquimiaAdapter {\n  const inferRoute = options?.inferRoute ?? '/api/chat';\n  const streamRoute = options?.streamRoute ?? '/api/stream';\n  const blobUploadRoute = options?.blobUploadRoute ?? '/api/blob/upload';\n  const toolCompletionRoute = options?.toolCompletionRoute ?? '/api/tool-completion';\n  const toolApprovalRoute = options?.toolApprovalRoute ?? '/api/tool-approval';\n  const busMode = options?.busMode ?? false;\n\n  return {\n    resolveInferUrl(assistantId: string): string {\n      return `${inferRoute.replace(/\\/$/, '')}/${encodeURIComponent(assistantId)}`;\n    },\n    resolveStreamUrl(streamId: string): string {\n      const url = `${streamRoute}/${streamId}`;\n      return busMode ? `${url}${url.includes('?') ? '&' : '?'}bus_mode=true` : url;\n    },\n    resolveBlobUploadUrl(): string {\n      return blobUploadRoute;\n    },\n    resolveToolCompletionUrl(): string {\n      return toolCompletionRoute;\n    },\n    resolveToolApprovalUrl(): string {\n      return toolApprovalRoute;\n    },\n  };\n}\n"],"mappings":";AAWO,SAAS,oBAAoB,SAAiD;AACnF,QAAM,aAAa,SAAS,cAAc;AAC1C,QAAM,cAAc,SAAS,eAAe;AAC5C,QAAM,kBAAkB,SAAS,mBAAmB;AACpD,QAAM,sBAAsB,SAAS,uBAAuB;AAC5D,QAAM,oBAAoB,SAAS,qBAAqB;AACxD,QAAM,UAAU,SAAS,WAAW;AAEpC,SAAO;AAAA,IACL,gBAAgB,aAA6B;AAC3C,aAAO,GAAG,WAAW,QAAQ,OAAO,EAAE,CAAC,IAAI,mBAAmB,WAAW,CAAC;AAAA,IAC5E;AAAA,IACA,iBAAiB,UAA0B;AACzC,YAAM,MAAM,GAAG,WAAW,IAAI,QAAQ;AACtC,aAAO,UAAU,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,kBAAkB;AAAA,IAC3E;AAAA,IACA,uBAA+B;AAC7B,aAAO;AAAA,IACT;AAAA,IACA,2BAAmC;AACjC,aAAO;AAAA,IACT;AAAA,IACA,yBAAiC;AAC/B,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/approvals-CcnmqUkQ.d.ts

@@ -0,0 +1,59 @@
+import { W as WorklogRecord } from './types-lOliroPw.js';
+
+/**
+ * Human-approval gates, derived from the worklog.
+ *
+ * When the runtime's authz policy resolves a tool call to `REQUIRE_APPROVAL`,
+ * core parks the call and records a `HumanApprovalRequired` whose `data` is the
+ * command minus its conversation: `{ parameters: <the tool execution> }`. The
+ * gate closes with a `HumanApprovalRequiredResponse` under the same
+ * `control_id`, whichever channel the decision came through — so the stream,
+ * not the local submit, is the source of truth for "settled".
+ */
+/** A decision as the worklog records it. */
+interface ApprovalDecision {
+    approved: boolean;
+    /**
+     * Rejection reason. Core records `result or message` as the response data,
+     * so an approval never carries one and a rejection carries the reason when
+     * the approver gave it.
+     */
+    reason: string | null;
+    decidedAt: string;
+}
+/** One approval gate, pending or settled. */
+interface ApprovalRequest {
+    /** The `HumanApprovalRequired` control id — the one `/event/tool-approval` expects. */
+    controlId: string;
+    /** Name of the parked tool call; `null` until the request record is seen. */
+    toolName: string | null;
+    /** Control id of the parked tool execution itself (distinct from `controlId`). */
+    toolCallId: string | null;
+    /** Arguments the tool would be called with. What is actually being approved. */
+    arguments: unknown;
+    /**
+     * The gate belongs to an MCP server that runs its own approval over the
+     * task's originating channel (the `mcp_approval` runtime extension). The
+     * runtime refuses an HTTP decision for it with a 409, so offering buttons
+     * would be a lie.
+     */
+    channelOwned: boolean;
+    requestedAt: string | null;
+    /** `null` while pending. */
+    decision: ApprovalDecision | null;
+}
+interface ApprovalsState {
+    /** Gates in the order they were first seen. */
+    order: string[];
+    byId: Record<string, ApprovalRequest>;
+}
+declare function initialApprovalsState(): ApprovalsState;
+/** Fold one worklog record into the approvals state. Records of other classes are a no-op. */
+declare function reduceApprovals(state: ApprovalsState, record: WorklogRecord): ApprovalsState;
+declare function foldApprovals(records: WorklogRecord[]): ApprovalsState;
+/** All gates, in first-seen order. */
+declare function listApprovals(state: ApprovalsState): ApprovalRequest[];
+/** Gates with no recorded decision yet. */
+declare function pendingApprovals(state: ApprovalsState): ApprovalRequest[];
+
+export { type ApprovalRequest as A, type ApprovalDecision as a, type ApprovalsState as b, foldApprovals as f, initialApprovalsState as i, listApprovals as l, pendingApprovals as p, reduceApprovals as r };

package/dist/approvals-dn4sd_Ot.d.mts

@@ -0,0 +1,59 @@
+import { W as WorklogRecord } from './types-lOliroPw.mjs';
+
+/**
+ * Human-approval gates, derived from the worklog.
+ *
+ * When the runtime's authz policy resolves a tool call to `REQUIRE_APPROVAL`,
+ * core parks the call and records a `HumanApprovalRequired` whose `data` is the
+ * command minus its conversation: `{ parameters: <the tool execution> }`. The
+ * gate closes with a `HumanApprovalRequiredResponse` under the same
+ * `control_id`, whichever channel the decision came through — so the stream,
+ * not the local submit, is the source of truth for "settled".
+ */
+/** A decision as the worklog records it. */
+interface ApprovalDecision {
+    approved: boolean;
+    /**
+     * Rejection reason. Core records `result or message` as the response data,
+     * so an approval never carries one and a rejection carries the reason when
+     * the approver gave it.
+     */
+    reason: string | null;
+    decidedAt: string;
+}
+/** One approval gate, pending or settled. */
+interface ApprovalRequest {
+    /** The `HumanApprovalRequired` control id — the one `/event/tool-approval` expects. */
+    controlId: string;
+    /** Name of the parked tool call; `null` until the request record is seen. */
+    toolName: string | null;
+    /** Control id of the parked tool execution itself (distinct from `controlId`). */
+    toolCallId: string | null;
+    /** Arguments the tool would be called with. What is actually being approved. */
+    arguments: unknown;
+    /**
+     * The gate belongs to an MCP server that runs its own approval over the
+     * task's originating channel (the `mcp_approval` runtime extension). The
+     * runtime refuses an HTTP decision for it with a 409, so offering buttons
+     * would be a lie.
+     */
+    channelOwned: boolean;
+    requestedAt: string | null;
+    /** `null` while pending. */
+    decision: ApprovalDecision | null;
+}
+interface ApprovalsState {
+    /** Gates in the order they were first seen. */
+    order: string[];
+    byId: Record<string, ApprovalRequest>;
+}
+declare function initialApprovalsState(): ApprovalsState;
+/** Fold one worklog record into the approvals state. Records of other classes are a no-op. */
+declare function reduceApprovals(state: ApprovalsState, record: WorklogRecord): ApprovalsState;
+declare function foldApprovals(records: WorklogRecord[]): ApprovalsState;
+/** All gates, in first-seen order. */
+declare function listApprovals(state: ApprovalsState): ApprovalRequest[];
+/** Gates with no recorded decision yet. */
+declare function pendingApprovals(state: ApprovalsState): ApprovalRequest[];
+
+export { type ApprovalRequest as A, type ApprovalDecision as a, type ApprovalsState as b, foldApprovals as f, initialApprovalsState as i, listApprovals as l, pendingApprovals as p, reduceApprovals as r };

package/dist/hooks/index.d.mts

@@ -1,11 +1,13 @@
 import * as react from 'react';
 import { AlquimiaSDK } from '../sdk/index.mjs';
 import { AlquimiaAdapter } from '../adapters/index.mjs';
-import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-DiR9cgyo.mjs';
-import { G as GenuiSurfaceItem, e as AlquimiaMessage, u as ToolEvent, a as AIMessageChunk, R as RatingData } from '../type-DqX3-9QS.mjs';
-import { T as ToolExecutionResponse } from '../types-CMVbyEv8.mjs';
-import { a as WorklogState } from '../types-C-6fgK1_.mjs';
+import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-YKiEag2L.mjs';
+import { G as GenuiSurfaceItem, a as AlquimiaMessage, b as ToolEvent, c as AIMessageChunk, R as RatingData } from '../type-C_sKpIM1.mjs';
+import { ToolApprovalResult } from '../types/index.mjs';
 import { createMessageId } from '../utils/index.mjs';
+import { a as WorklogState } from '../types-lOliroPw.mjs';
+import { A as ApprovalRequest } from '../approvals-dn4sd_Ot.mjs';
+import { T as ToolExecutionResponse } from '../types-CMVbyEv8.mjs';
 import { C as CatalogManifest } from '../registry-Bcu_ZYL1.mjs';
 import { U as UIAction } from '../actions-BjDPJdyA.mjs';
 import '@elastic/apm-rum';
@@ -40,11 +42,40 @@ interface UseAlquimiaConfig {
         source?: 'client' | 'agent';
     };
 }
+/**
+ * A human-approval gate as the hook exposes it: what the worklog says, overlaid
+ * with this client's own submission.
+ */
+interface ToolApproval extends ApprovalRequest {
+    /**
+     * `pending` until someone decides; `submitting` while this client's call is
+     * in flight; `approved`/`rejected` once the runtime accepted a decision —
+     * this client's (optimistically, before the stream confirms) or anyone's.
+     */
+    status: 'pending' | 'submitting' | 'approved' | 'rejected';
+    /** Rejection reason, from the worklog or from this client's submission. */
+    reason: string | null;
+    /** `true` when the accepted decision was made from this client. */
+    decidedHere: boolean;
+    /**
+     * Whether offering Approve / Reject here can still work. `false` for a
+     * channel-owned gate, and after the runtime refused this client with a 409,
+     * 403 or 404 — retrying those can only fail the same way.
+     */
+    canAnswer: boolean;
+    /** The runtime's answer to this client's last submission, if any. */
+    lastResult: ToolApprovalResult | null;
+    /** Message count the gate was raised after, for anchoring it in the chat. */
+    afterCount: number;
+}
 declare function useAlquimia(config: UseAlquimiaConfig): {
     sdk: AlquimiaSDK;
     activeTool: any;
     pendingClientTool: PendingClientTool | null;
     completeToolExecution: (controlId: string, result: ToolExecutionResponse) => Promise<void>;
+    toolApprovals: ToolApproval[];
+    pendingApprovals: ToolApproval[];
+    approveTool: (controlId: string, approved: boolean, message?: string) => Promise<ToolApprovalResult>;
     genui: {
         surfaces: GenuiSurfaceItem[];
         onAgentAction: (controlId: string) => (action: UIAction) => void;
@@ -105,4 +136,4 @@ declare function useRatings({ assistantId, sendRating, topicId, onError }: UseRa
     hasReviewed: boolean;
 };
 
-export { useAlquimia, useRatings };
+export { type ToolApproval, type UseAlquimiaConfig, useAlquimia, useRatings };

package/dist/hooks/index.d.ts

@@ -1,11 +1,13 @@
 import * as react from 'react';
 import { AlquimiaSDK } from '../sdk/index.js';
 import { AlquimiaAdapter } from '../adapters/index.js';
-import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-b5_yMyMo.js';
-import { G as GenuiSurfaceItem, e as AlquimiaMessage, u as ToolEvent, a as AIMessageChunk, R as RatingData } from '../type-xksRnBUW.js';
-import { T as ToolExecutionResponse } from '../types-CMVbyEv8.js';
-import { a as WorklogState } from '../types-C-6fgK1_.js';
+import { W as WhisperProvider, S as StableDiffusionProvider, C as CharacterizationProvider, R as RatingsProvider, L as LoggerProvider } from '../providers-J_Z9rQ3Q.js';
+import { G as GenuiSurfaceItem, a as AlquimiaMessage, b as ToolEvent, c as AIMessageChunk, R as RatingData } from '../type-BFtGEEb4.js';
+import { ToolApprovalResult } from '../types/index.js';
 import { createMessageId } from '../utils/index.js';
+import { a as WorklogState } from '../types-lOliroPw.js';
+import { A as ApprovalRequest } from '../approvals-CcnmqUkQ.js';
+import { T as ToolExecutionResponse } from '../types-CMVbyEv8.js';
 import { C as CatalogManifest } from '../registry-Bcu_ZYL1.js';
 import { U as UIAction } from '../actions-CP1d4Ye1.js';
 import '@elastic/apm-rum';
@@ -40,11 +42,40 @@ interface UseAlquimiaConfig {
         source?: 'client' | 'agent';
     };
 }
+/**
+ * A human-approval gate as the hook exposes it: what the worklog says, overlaid
+ * with this client's own submission.
+ */
+interface ToolApproval extends ApprovalRequest {
+    /**
+     * `pending` until someone decides; `submitting` while this client's call is
+     * in flight; `approved`/`rejected` once the runtime accepted a decision —
+     * this client's (optimistically, before the stream confirms) or anyone's.
+     */
+    status: 'pending' | 'submitting' | 'approved' | 'rejected';
+    /** Rejection reason, from the worklog or from this client's submission. */
+    reason: string | null;
+    /** `true` when the accepted decision was made from this client. */
+    decidedHere: boolean;
+    /**
+     * Whether offering Approve / Reject here can still work. `false` for a
+     * channel-owned gate, and after the runtime refused this client with a 409,
+     * 403 or 404 — retrying those can only fail the same way.
+     */
+    canAnswer: boolean;
+    /** The runtime's answer to this client's last submission, if any. */
+    lastResult: ToolApprovalResult | null;
+    /** Message count the gate was raised after, for anchoring it in the chat. */
+    afterCount: number;
+}
 declare function useAlquimia(config: UseAlquimiaConfig): {
     sdk: AlquimiaSDK;
     activeTool: any;
     pendingClientTool: PendingClientTool | null;
     completeToolExecution: (controlId: string, result: ToolExecutionResponse) => Promise<void>;
+    toolApprovals: ToolApproval[];
+    pendingApprovals: ToolApproval[];
+    approveTool: (controlId: string, approved: boolean, message?: string) => Promise<ToolApprovalResult>;
     genui: {
         surfaces: GenuiSurfaceItem[];
         onAgentAction: (controlId: string) => (action: UIAction) => void;
@@ -105,4 +136,4 @@ declare function useRatings({ assistantId, sendRating, topicId, onError }: UseRa
     hasReviewed: boolean;
 };
 
-export { useAlquimia, useRatings };
+export { type ToolApproval, type UseAlquimiaConfig, useAlquimia, useRatings };