blink 0.1.72 → 0.1.73

package/dist/browser/control/index.cjs

@@ -0,0 +1 @@
+const e=require(`../validator-CvSEfFnI.cjs`),t=(e,t)=>e.json({error:t},400),n=e=>{let t=e.req.param(`key`);return!t||t===``?{key:t,err:`Key is required`}:t.length>475?{key:t,err:`Key is too long. Max length is 475 characters.`}:{key:t}},r=()=>new e.Hono,i=r().get(`/:key`,async e=>{let{key:r,err:i}=n(e);if(i)return t(e,i);let a=await e.env.context.store.get(r);return e.json({value:a},200)}).post(`/:key`,e.validator(`json`,(e,n)=>{let r=e.value;return r?typeof r==`string`?r.length>2e4?t(n,`Value is too long. Max length is 20,000 characters.`):{value:r}:t(n,`Value must be a string`):t(n,`Value is required`)}),async e=>{let{key:r,err:i}=n(e);if(i)return t(e,i);let{value:a}=e.req.valid(`json`);return await e.env.context.store.set(r,a),e.body(null,204)}).delete(`/:key`,async e=>{let{key:r,err:i}=n(e);return i?t(e,i):(await e.env.context.store.delete(r),e.body(null,204))}).get(`/`,async e=>{let{cursor:t,limit:n,prefix:r}=e.req.query(),{entries:i,cursor:a}=await e.env.context.store.list(r,{cursor:t?String(t):void 0,limit:n?Number(n):100});return e.json({entries:i,cursor:a})}),a=e=>{let t=e.req.param(`key`);return t?t.length>475?{key:t,err:`Key is too long. Max length is 475 characters.`}:{key:t}:{key:t,err:`Key is required`}},o=r().basePath(`/:key`).post(`/`,async e=>{let{key:n,err:r}=a(e);return r?t(e,r):e.json(await e.env.context.chat.ensure(n),200)}).post(`/sendMessages`,e.validator(`json`,(e,t)=>({message:e.message,options:e.options})),async e=>{let{key:n,err:r}=a(e);if(r)return t(e,r);let{message:i,options:o}=e.req.valid(`json`);try{await e.env.context.chat.message(n,i,o)}catch(n){return t(e,n instanceof Error?n.message:`Unknown error`)}return e.body(null,204)}),s=new e.Hono().route(`/kv`,i).route(`/chat`,o);exports.api=s;

package/dist/browser/control/index.d.cts

@@ -0,0 +1,187 @@
+import { Context, MessageOptions } from "../chat-B5eFQu26.cjs";
+import { UIMessage } from "ai";
+import * as hono_utils_http_status0 from "hono/utils/http-status";
+import * as hono_types0 from "hono/types";
+import * as hono_hono_base0 from "hono/hono-base";
+
+//#region src/control/index.d.ts
+
+/**
+ * To implement your own API bindings, you can use Hono's
+ * `createServerAdapter` to create a server that will
+ * handle requests to the API.
+ *
+ * ```ts
+ * const server = createHTTPServer(
+ *   createServerAdapter((req) => {
+ *     return api.fetch(req, <your-bindings>);
+ *   })
+ * );
+ * server.listen(options.port);
+ * ```
+ */
+declare const api: hono_hono_base0.HonoBase<{
+  Bindings: {
+    context: Context;
+  };
+}, hono_types0.BlankSchema | hono_types0.MergeSchemaPath<{
+  "/:key": {
+    $get: {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        value: string | undefined;
+      };
+      outputFormat: "json";
+      status: 200;
+    };
+  };
+} & {
+  "/:key": {
+    $post: {
+      input: {
+        json: {
+          value: string;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        json: {
+          value: string;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: null;
+      outputFormat: "body";
+      status: 204;
+    };
+  };
+} & {
+  "/:key": {
+    $delete: {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: null;
+      outputFormat: "body";
+      status: 204;
+    };
+  };
+} & {
+  "/": {
+    $get: {
+      input: {};
+      output: {
+        entries: {
+          key: string;
+          ttl?: number | undefined;
+        }[];
+        cursor: string | undefined;
+      };
+      outputFormat: "json";
+      status: hono_utils_http_status0.ContentfulStatusCode;
+    };
+  };
+}, "/kv"> | hono_types0.MergeSchemaPath<{
+  "/:key": {
+    $post: {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        readonly created: boolean;
+        readonly key: string;
+      };
+      outputFormat: "json";
+      status: 200;
+    };
+  };
+} & {
+  "/:key/sendMessages": {
+    $post: {
+      input: {
+        json: {
+          message: Omit<UIMessage, "id">;
+          options: MessageOptions;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        json: {
+          message: Omit<UIMessage, "id">;
+          options: MessageOptions;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: null;
+      outputFormat: "body";
+      status: 204;
+    };
+  };
+}, "/chat">, "/">;
+//#endregion
+export { api };

package/dist/browser/control/index.d.ts

@@ -0,0 +1,187 @@
+import { Context, MessageOptions } from "../chat-BN7SYTWY.js";
+import { UIMessage } from "ai";
+import * as hono_utils_http_status0 from "hono/utils/http-status";
+import * as hono_types0 from "hono/types";
+import * as hono_hono_base0 from "hono/hono-base";
+
+//#region src/control/index.d.ts
+
+/**
+ * To implement your own API bindings, you can use Hono's
+ * `createServerAdapter` to create a server that will
+ * handle requests to the API.
+ *
+ * ```ts
+ * const server = createHTTPServer(
+ *   createServerAdapter((req) => {
+ *     return api.fetch(req, <your-bindings>);
+ *   })
+ * );
+ * server.listen(options.port);
+ * ```
+ */
+declare const api: hono_hono_base0.HonoBase<{
+  Bindings: {
+    context: Context;
+  };
+}, hono_types0.BlankSchema | hono_types0.MergeSchemaPath<{
+  "/:key": {
+    $get: {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        value: string | undefined;
+      };
+      outputFormat: "json";
+      status: 200;
+    };
+  };
+} & {
+  "/:key": {
+    $post: {
+      input: {
+        json: {
+          value: string;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        json: {
+          value: string;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: null;
+      outputFormat: "body";
+      status: 204;
+    };
+  };
+} & {
+  "/:key": {
+    $delete: {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: null;
+      outputFormat: "body";
+      status: 204;
+    };
+  };
+} & {
+  "/": {
+    $get: {
+      input: {};
+      output: {
+        entries: {
+          key: string;
+          ttl?: number | undefined;
+        }[];
+        cursor: string | undefined;
+      };
+      outputFormat: "json";
+      status: hono_utils_http_status0.ContentfulStatusCode;
+    };
+  };
+}, "/kv"> | hono_types0.MergeSchemaPath<{
+  "/:key": {
+    $post: {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        readonly created: boolean;
+        readonly key: string;
+      };
+      outputFormat: "json";
+      status: 200;
+    };
+  };
+} & {
+  "/:key/sendMessages": {
+    $post: {
+      input: {
+        json: {
+          message: Omit<UIMessage, "id">;
+          options: MessageOptions;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: {
+        error: string;
+      };
+      outputFormat: "json";
+      status: 400;
+    } | {
+      input: {
+        json: {
+          message: Omit<UIMessage, "id">;
+          options: MessageOptions;
+        };
+      } & {
+        param: {
+          key: string;
+        };
+      };
+      output: null;
+      outputFormat: "body";
+      status: 204;
+    };
+  };
+}, "/chat">, "/">;
+//#endregion
+export { api };

package/dist/browser/control/index.js

@@ -0,0 +1 @@
+import{Hono as e,validator as t}from"../validator-DOrmtI_l.js";const n=(e,t)=>e.json({error:t},400),r=e=>{let t=e.req.param(`key`);return!t||t===``?{key:t,err:`Key is required`}:t.length>475?{key:t,err:`Key is too long. Max length is 475 characters.`}:{key:t}},i=()=>new e,a=i().get(`/:key`,async e=>{let{key:t,err:i}=r(e);if(i)return n(e,i);let a=await e.env.context.store.get(t);return e.json({value:a},200)}).post(`/:key`,t(`json`,(e,t)=>{let r=e.value;return r?typeof r==`string`?r.length>2e4?n(t,`Value is too long. Max length is 20,000 characters.`):{value:r}:n(t,`Value must be a string`):n(t,`Value is required`)}),async e=>{let{key:t,err:i}=r(e);if(i)return n(e,i);let{value:a}=e.req.valid(`json`);return await e.env.context.store.set(t,a),e.body(null,204)}).delete(`/:key`,async e=>{let{key:t,err:i}=r(e);return i?n(e,i):(await e.env.context.store.delete(t),e.body(null,204))}).get(`/`,async e=>{let{cursor:t,limit:n,prefix:r}=e.req.query(),{entries:i,cursor:a}=await e.env.context.store.list(r,{cursor:t?String(t):void 0,limit:n?Number(n):100});return e.json({entries:i,cursor:a})}),o=e=>{let t=e.req.param(`key`);return t?t.length>475?{key:t,err:`Key is too long. Max length is 475 characters.`}:{key:t}:{key:t,err:`Key is required`}},s=i().basePath(`/:key`).post(`/`,async e=>{let{key:t,err:r}=o(e);return r?n(e,r):e.json(await e.env.context.chat.ensure(t),200)}).post(`/sendMessages`,t(`json`,(e,t)=>({message:e.message,options:e.options})),async e=>{let{key:t,err:r}=o(e);if(r)return n(e,r);let{message:i,options:a}=e.req.valid(`json`);try{await e.env.context.chat.message(t,i,a)}catch(t){return n(e,t instanceof Error?t.message:`Unknown error`)}return e.body(null,204)}),c=new e().route(`/kv`,a).route(`/chat`,s);export{c as api};

package/dist/browser/index-B5faDAC2.d.ts

@@ -0,0 +1,53 @@
+import { Chat } from "./chat-BN7SYTWY.js";
+import { UIOptions, UIOptionsSchema } from "./index.browser-BUMCZUeQ.js";
+import { UIMessage, UIMessageChunk } from "ai";
+
+//#region src/agent/client/index.d.ts
+declare const APIServerURLEnvironmentVariable = "BLINK_API_URL";
+interface ClientOptions {
+  readonly baseUrl: string;
+  readonly headers?: Record<string, string>;
+}
+type CapabilitiesResponse = Awaited<ReturnType<Client["capabilities"]>>;
+/**
+ * Client is a client for the Blink agent HTTP API.
+ */
+declare class Client {
+  readonly baseUrl: string;
+  private readonly client;
+  constructor(options: ClientOptions);
+  /**
+   * chat starts chatting with the agent.
+   */
+  chat(request: {
+    messages: UIMessage[];
+    chat: Chat;
+  }, options?: {
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+  }): Promise<ReadableStream<UIMessageChunk>>;
+  /**
+   * capabilities returns the capabilities of the agent.
+   * This is used to check if the agent supports requests and completions.
+   */
+  capabilities(): Promise<{
+    ui: boolean;
+    chat: boolean;
+    request: boolean;
+    error: boolean;
+  }>;
+  ui(request: {
+    selectedOptions?: UIOptions;
+  }, options?: {
+    signal?: AbortSignal;
+  }): Promise<UIOptionsSchema>;
+  /**
+   * health simply returns a 200 response.
+   * This is used to check if the agent is running.
+   */
+  health(): Promise<void>;
+  private handleError;
+}
+declare const streamSSE: <T>(resp: Response) => ReadableStream<T>;
+//#endregion
+export { APIServerURLEnvironmentVariable, CapabilitiesResponse, Client, ClientOptions, streamSSE };

package/dist/browser/index-C-GJWB97.d.cts

@@ -0,0 +1,53 @@
+import { Chat } from "./chat-B5eFQu26.cjs";
+import { UIOptions, UIOptionsSchema } from "./index.browser-CnGab8Yp.cjs";
+import { UIMessage, UIMessageChunk } from "ai";
+
+//#region src/agent/client/index.d.ts
+declare const APIServerURLEnvironmentVariable = "BLINK_API_URL";
+interface ClientOptions {
+  readonly baseUrl: string;
+  readonly headers?: Record<string, string>;
+}
+type CapabilitiesResponse = Awaited<ReturnType<Client["capabilities"]>>;
+/**
+ * Client is a client for the Blink agent HTTP API.
+ */
+declare class Client {
+  readonly baseUrl: string;
+  private readonly client;
+  constructor(options: ClientOptions);
+  /**
+   * chat starts chatting with the agent.
+   */
+  chat(request: {
+    messages: UIMessage[];
+    chat: Chat;
+  }, options?: {
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+  }): Promise<ReadableStream<UIMessageChunk>>;
+  /**
+   * capabilities returns the capabilities of the agent.
+   * This is used to check if the agent supports requests and completions.
+   */
+  capabilities(): Promise<{
+    ui: boolean;
+    chat: boolean;
+    request: boolean;
+    error: boolean;
+  }>;
+  ui(request: {
+    selectedOptions?: UIOptions;
+  }, options?: {
+    signal?: AbortSignal;
+  }): Promise<UIOptionsSchema>;
+  /**
+   * health simply returns a 200 response.
+   * This is used to check if the agent is running.
+   */
+  health(): Promise<void>;
+  private handleError;
+}
+declare const streamSSE: <T>(resp: Response) => ReadableStream<T>;
+//#endregion
+export { APIServerURLEnvironmentVariable, CapabilitiesResponse, Client, ClientOptions, streamSSE };

package/dist/browser/index.browser-09e-NXpn.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`ai`);c=s(c);function l(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}var u=class extends Error{constructor(e,t){super(e),this.response=t}};function d(e){return e}const f=Object.freeze({withContext(e,t){let n={};for(let r of Object.keys(e)){let i=e[r];n[r]=i.withContext(t)}return n},with(e,t){let n={};for(let r of Object.keys(e)){let i=e[r];n[r]=i.withContext(t)}return n},async withApproval(e){let t={};for(let[n,r]of Object.entries(e.tools)){let e=r.execute;t[n]={...r,execute:async(t,n)=>{if(r.autoApprove&&e){let i=await r.autoApprove(t);if(i)return e(t,n)}let i={type:`tool-approval`,outcome:`pending`};return i}}}let n=e.messages[e.messages.length-1];if(!n?.parts)return t;let r=[];for(let t of n.parts){if(!(0,c.isToolUIPart)(t))continue;let n=(0,c.getToolName)(t),i=e.tools[n];if(!i||t.state!==`output-available`||!i.execute||!p(t.output))continue;t.output.outcome===`approved`&&r.push({toolName:(0,c.getToolName)(t),tool:i,input:t.input,toolCallId:t.toolCallId})}if(r.length>0){let t=(0,c.createUIMessageStream)({execute:async({writer:t})=>{t.write({type:`start-step`}),await Promise.all(r.map(async n=>{if(!n.tool.execute)throw Error(`Tool does not support execute.`);t.write({type:`tool-input-available`,toolCallId:n.toolCallId,toolName:n.toolName,input:n.input});try{let r=await n.tool.execute(n.input,{toolCallId:n.toolCallId,messages:(0,c.convertToModelMessages)(e.messages,{tools:e.tools}),abortSignal:e.abortSignal});if(l(r))for await(let e of r)t.write({type:`tool-output-available`,toolCallId:n.toolCallId,output:e,preliminary:!0});t.write({type:`tool-output-available`,toolCallId:n.toolCallId,output:r})}catch(e){t.write({type:`tool-output-error`,toolCallId:n.toolCallId,errorText:e instanceof Error?e.message:String(e)})}})),t.write({type:`finish`})}});throw new u(`Executing tools`,t)}return t},prefix(e,t){let n={};for(let[r,i]of Object.entries(e))n[`${t}${r}`]=i;return n}});function p(e){return typeof e==`object`&&!!e&&`type`in e&&e.type===`tool-approval`}function m(e){for(let t=e.length-1;t>=0;t--){let n=e[t];if(n!==void 0&&n.role===`user`&&!(typeof n.metadata!=`object`||n.metadata===null)&&`options`in n.metadata)return n.metadata.options}}const h=`x-blink-stream-response-format`;function g(e,t){let n=new Headers(e.headers);return n.set(h,t),new Response(e.body,{status:e.status,statusText:e.statusText,headers:n})}Object.defineProperty(exports,`CustomChatResponseError`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`StreamResponseFormatHeader`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`__toESM`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`isToolApprovalOutput`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`lastUIOptions`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`toolWithApproval`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`tools`,{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,`withResponseFormat`,{enumerable:!0,get:function(){return g}});

package/dist/browser/index.browser-0KfCzcI7.js

@@ -0,0 +1 @@
+import{convertToModelMessages as e,createUIMessageStream as t,getToolName as n,isToolUIPart as r}from"ai";function i(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}var a=class extends Error{constructor(e,t){super(e),this.response=t}};function o(e){return e}const s=Object.freeze({withContext(e,t){let n={};for(let r of Object.keys(e)){let i=e[r];n[r]=i.withContext(t)}return n},with(e,t){let n={};for(let r of Object.keys(e)){let i=e[r];n[r]=i.withContext(t)}return n},async withApproval(o){let s={};for(let[e,t]of Object.entries(o.tools)){let n=t.execute;s[e]={...t,execute:async(e,r)=>{if(t.autoApprove&&n){let i=await t.autoApprove(e);if(i)return n(e,r)}let i={type:`tool-approval`,outcome:`pending`};return i}}}let l=o.messages[o.messages.length-1];if(!l?.parts)return s;let u=[];for(let e of l.parts){if(!r(e))continue;let t=n(e),i=o.tools[t];if(!i||e.state!==`output-available`||!i.execute||!c(e.output))continue;e.output.outcome===`approved`&&u.push({toolName:n(e),tool:i,input:e.input,toolCallId:e.toolCallId})}if(u.length>0){let n=t({execute:async({writer:t})=>{t.write({type:`start-step`}),await Promise.all(u.map(async n=>{if(!n.tool.execute)throw Error(`Tool does not support execute.`);t.write({type:`tool-input-available`,toolCallId:n.toolCallId,toolName:n.toolName,input:n.input});try{let r=await n.tool.execute(n.input,{toolCallId:n.toolCallId,messages:e(o.messages,{tools:o.tools}),abortSignal:o.abortSignal});if(i(r))for await(let e of r)t.write({type:`tool-output-available`,toolCallId:n.toolCallId,output:e,preliminary:!0});t.write({type:`tool-output-available`,toolCallId:n.toolCallId,output:r})}catch(e){t.write({type:`tool-output-error`,toolCallId:n.toolCallId,errorText:e instanceof Error?e.message:String(e)})}})),t.write({type:`finish`})}});throw new a(`Executing tools`,n)}return s},prefix(e,t){let n={};for(let[r,i]of Object.entries(e))n[`${t}${r}`]=i;return n}});function c(e){return typeof e==`object`&&!!e&&`type`in e&&e.type===`tool-approval`}function l(e){for(let t=e.length-1;t>=0;t--){let n=e[t];if(n!==void 0&&n.role===`user`&&!(typeof n.metadata!=`object`||n.metadata===null)&&`options`in n.metadata)return n.metadata.options}}const u=`x-blink-stream-response-format`;function d(e,t){let n=new Headers(e.headers);return n.set(u,t),new Response(e.body,{status:e.status,statusText:e.statusText,headers:n})}export{a as CustomChatResponseError,u as StreamResponseFormatHeader,c as isToolApprovalOutput,l as lastUIOptions,o as toolWithApproval,s as tools,d as withResponseFormat};

package/dist/browser/index.browser-BUMCZUeQ.d.ts

@@ -0,0 +1,180 @@
+import { Promisable } from "./chat-BN7SYTWY.js";
+import { InferToolInput, InferToolOutput, Tool, ToolSet, UIMessage } from "ai";
+
+//#region src/agent/ui.d.ts
+type UIOptionIcon = `lucide:${string}` | `simple-icons:${string}`;
+type UIOptionSelectValue<ID extends string = string> = {
+  readonly id: ID;
+  readonly label: string;
+  /**
+   * description will provide additional context to the user in the UI.
+   */
+  readonly description?: string | Array<{
+    readonly text: string;
+    readonly color?: "primary" | "muted" | "warning";
+  }>;
+  /**
+   * icon is a slug of a Lucide or SimpleIcons icon.
+   * This will only be rendered in a web-based UI.
+   *
+   * Find icons:
+   * - https://simpleicons.org/
+   * - https://lucide.dev/icons/
+   */
+  readonly icon?: UIOptionIcon;
+};
+type UIOptionSelect<Values extends readonly UIOptionSelectValue[] = readonly UIOptionSelectValue[]> = {
+  readonly type: "select";
+  /**
+   * label indicates the purpose of the option.
+   * If omitted, it will not be displayed in the UI.
+   */
+  readonly label?: string;
+  /**
+   * icon is a slug of a Lucide or SimpleIcons icon.
+   * This will only be rendered in a web-based UI.
+   *
+   * Find icons:
+   * - https://simpleicons.org/
+   * - https://lucide.dev/icons/
+   */
+  readonly icon?: UIOptionIcon;
+  /**
+   * defaultValue is the default value for the option.
+   * If omitted, the option will not be selected by default.
+   */
+  readonly defaultValue: Values[number]["id"];
+  readonly values: Values;
+};
+type UIOptions = Record<string, string>;
+type WithUIOptions<OPTIONS extends UIOptions, MESSAGE extends UIMessage = UIMessage> = MESSAGE & {
+  readonly role: "user";
+  readonly metadata: MESSAGE["metadata"] & {
+    readonly options: OPTIONS;
+  };
+};
+type ExtractUIOptions<M> = M extends WithUIOptions<infer O> ? O : UIOptions;
+type UIOptionsSchema<OPTIONS extends UIOptions = UIOptions> = { [K in keyof OPTIONS]: UIOptionSelect<Array<UIOptionSelectValue<OPTIONS[K]>>> };
+interface UIEvent<MESSAGE extends UIMessage> {
+  readonly selectedOptions?: ExtractUIOptions<MESSAGE>;
+}
+type UIHandler<MESSAGE extends UIMessage> = (event: UIEvent<MESSAGE>) => Promisable<UIOptionsSchema<ExtractUIOptions<MESSAGE>> | void>;
+/**
+ * lastUIOptions finds the last user message with options.
+ * Options are stored in message metadata to preserve the history
+ * of changing options.
+ *
+ * @param messages - The messages to search.
+ * @returns The last user message with options, or undefined if no such message exists.
+ */
+declare function lastUIOptions<MESSAGE extends UIMessage>(messages: MESSAGE[]): ExtractUIOptions<MESSAGE> | undefined;
+//#endregion
+//#region src/agent/tools.d.ts
+/**
+ * ToolWithContext is a tool that supports the "withContext" method.
+ *
+ * @param CONTEXT The context type.
+ * @param TOOL The tool type.
+ * @returns The tool with the given context.
+ */
+type ToolWithContext<CONTEXT, TOOL extends Tool> = TOOL & {
+  withContext(context: CONTEXT): TOOL;
+};
+/**
+ * ToolWithApproval is a tool that supports the "autoApprove" method.
+ *
+ * @param TOOL The tool type.
+ * @returns The tool with the given approval.
+ */
+type ToolWithApproval<INPUT, OUTPUT> = Tool<INPUT, OUTPUT> & {
+  /**
+   * autoApprove is a function that can be used to automatically approve
+   * an approval tool call based on the input.
+   *
+   * @param input The input to the tool.
+   * @returns Whether the tool call should be approved.
+   */
+  autoApprove?: (input: INPUT) => Promise<boolean> | boolean;
+};
+type ToolSetWithApproval<TOOLS extends ToolSet> = { [K in keyof TOOLS]: ToolWithApproval<InferToolInput<TOOLS[K]>, InferToolOutput<TOOLS[K]>> };
+/**
+ * toolWithApproval is a helper for inferring the execute and autoApprove
+ * arguments of a tool.
+ *
+ * @param tool The tool to wrap.
+ * @returns The wrapped tool.
+ */
+declare function toolWithApproval<INPUT, OUTPUT>(tool: ToolWithApproval<INPUT, OUTPUT>): ToolWithApproval<INPUT, OUTPUT>;
+/**
+ * Tools are helpers for managing tools.
+ */
+declare const tools: Readonly<{
+  /**
+   * withContext adds context to a set of tools that supports the "withContext" method.
+   *
+   * @param context
+   * @param tools
+   * @returns
+   */
+  withContext<const TOOLS extends ToolsWithContext>(tools: TOOLS, context: ContextFromTools<TOOLS>): { [K in keyof TOOLS]: Tool };
+  /**
+   * @internal
+   * @deprecated Use withContext instead - it's the same thing.
+   */
+  with<const TOOLS extends ToolsWithContext>(tools: TOOLS, context: ContextFromTools<TOOLS>): { [K in keyof TOOLS]: Tool };
+  /**
+   * withApproval ensures a set of tools need explicit user approval
+   * before they are executed.
+   *
+   * This works by replacing the execution of all provided tools with
+   * special output that interfaces must handle.
+   *
+   * On approval, the tool will be executed with the verbatim input.
+   *
+   * @returns Tools that should be sent in `streamText`.
+   */
+  withApproval<TOOLSET extends ToolSet, TOOLS extends ToolSetWithApproval<TOOLSET>, MESSAGE extends UIMessage>(options: {
+    messages: MESSAGE[];
+    tools: TOOLS;
+    abortSignal?: AbortSignal;
+  }): Promise<TOOLS>;
+  /**
+   * prefix adds a prefix to all the tools in a tool set.
+   *
+   * @param tools The tool set to prefix.
+   * @param prefix The prefix to add to the tools.
+   * @returns The prefixed tool set.
+   */
+  prefix(tools: ToolSet, prefix: string): ToolSet;
+}>;
+type ToolsWithContext = Record<string, Tool & {
+  withContext(context: unknown): Tool;
+}>;
+type ContextFromTools<TOOLS extends ToolsWithContext> = TOOLS[keyof TOOLS] extends {
+  withContext(context: infer C): any;
+} ? C : never;
+/**
+ * ToolApprovalOutput is the output of a tool that requires approval.
+ *
+ * This should be consumed by the UI to display an approval prompt.
+ */
+interface ToolApprovalOutput {
+  type: "tool-approval";
+  outcome: "pending" | "approved" | "rejected";
+  reason?: string;
+}
+/**
+ * isToolApprovalOutput checks if an output is a tool approval output.
+ */
+declare function isToolApprovalOutput(output: unknown): output is ToolApprovalOutput;
+//#endregion
+//#region src/agent/index.browser.d.ts
+type StreamResponseFormat = "ui-message" | "openai-chat" | "openai-response" | "anthropic" | "google" | "xai";
+/**
+ * StreamResponseFormatHeader indicates to a client the stream response
+ * format that the agent is using.
+ */
+declare const StreamResponseFormatHeader = "x-blink-stream-response-format";
+declare function withResponseFormat(response: Response, format: StreamResponseFormat): Response;
+//#endregion
+export { ContextFromTools, ExtractUIOptions, StreamResponseFormat, StreamResponseFormatHeader, ToolApprovalOutput, ToolSetWithApproval, ToolWithApproval, ToolWithContext, UIEvent, UIHandler, UIOptionSelect, UIOptionSelectValue, UIOptions, UIOptionsSchema, WithUIOptions, isToolApprovalOutput, lastUIOptions, toolWithApproval, tools, withResponseFormat };