blink 0.1.60 → 0.1.62

package/dist/{index-IWju3eNc.d.cts → index-E064W90j.d.ts}

@@ -1,7 +1,7 @@
-import * as _ai_sdk_provider0 from "@ai-sdk/provider";
-import * as ai0 from "ai";
-import { AsyncIterableStream, InferUIMessageChunk, Tool, ToolSet, UIDataTypes, UIMessage, UIMessagePart, UITools } from "ai";
 import http from "http";
+import * as ai0 from "ai";
+import { AsyncIterableStream, InferToolInput, InferToolOutput, InferUIMessageChunk, Tool, ToolSet, UIDataTypes, UIMessage, UIMessagePart, UITools } from "ai";
+import * as _ai_sdk_provider0 from "@ai-sdk/provider";
 
 //#region src/api/chat.d.ts
 interface Chat {
@@ -39,6 +39,31 @@ declare const chat: Readonly<{
 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.
  */
@@ -67,7 +92,7 @@ declare const tools: {
    *
    * @returns Tools that should be sent in `streamText`.
    */
-  withApproval<TOOLS extends ToolSet, MESSAGE extends UIMessage>(options: {
+  withApproval<TOOLSET extends ToolSet, TOOLS extends ToolSetWithApproval<TOOLSET>, MESSAGE extends UIMessage>(options: {
     messages: MESSAGE[];
     tools: TOOLS;
     abortSignal?: AbortSignal;
@@ -169,6 +194,45 @@ type ExperimentalCompletion = {
   replace?: [number, number];
 };
 type ExperimentalProvideCompletionsResponse = ReadableStream<ExperimentalCompletion> | Promise<ReadableStream<ExperimentalCompletion>> | Promise<ExperimentalCompletion> | ExperimentalCompletion;
+type ProvideOptionsRequest<MESSAGE extends UIMessage = UIMessage> = {
+  /**
+   * Options that are actively selected by the user.
+   *
+   * Use this to provide custom options based on previous selections.
+   */
+  readonly selectedOptions?: ExtractUIOptions<MESSAGE>;
+};
+type OptionSelectValue<ID extends string = string> = {
+  readonly id: ID;
+  readonly label: string;
+};
+type OptionSelect<Values extends readonly OptionSelectValue[] = readonly OptionSelectValue[]> = {
+  readonly type: "select";
+  readonly label: string;
+  readonly values: Values;
+  readonly defaultValue: Values[number]["id"];
+};
+type Options = Record<string, string>;
+type WithUIOptions<OPTIONS extends Options, MESSAGE extends UIMessage = UIMessage> = MESSAGE & {
+  readonly role: "user";
+  readonly metadata: MESSAGE["metadata"] & {
+    readonly options: OPTIONS;
+  };
+};
+type ExtractUIOptions<M> = M extends WithUIOptions<infer O> ? O : never;
+type OptionsSchema<OPTIONS extends Options> = { [K in keyof OPTIONS]: OptionSelect<Array<{
+  id: OPTIONS[K];
+  label: string;
+}>> };
+/**
+ * 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;
 interface AgentOptions<MESSAGE extends UIMessage = UIMessage> {
   /**
    * sendMessages is called when the agent is streaming chat messages.
@@ -196,14 +260,24 @@ interface AgentOptions<MESSAGE extends UIMessage = UIMessage> {
    * @returns A stream of completions, or a single completion.
    */
   experimental_provideCompletions?(options: ExperimentalProvideCompletionsOptions<MESSAGE>): ExperimentalProvideCompletionsResponse;
+  /**
+   * provideUIOptions is called when the agent is asked to provide
+   * user-selectable options.
+   *
+   * To provide options, use:
+   * @example
+   * ```ts
+   * blink.agent<blink.WithUIOptions<{
+   *   model: "gpt-5" | "sonnet"
+   * }>>({
+   *   // ...
+   * })
+   * ```
+   *
+   * @returns A schema for the options.
+   */
+  provideUIOptions?(options: ProvideOptionsRequest<MESSAGE>): Promise<OptionsSchema<ExtractUIOptions<MESSAGE>>> | OptionsSchema<ExtractUIOptions<MESSAGE>>;
 }
-/**
- * A Blink agent is simply an HTTP handler with a reserved
- * "/_agent/" path used for agent-specific requests.
- *
- * The environment variable "BLINK_API_SERVER_URL" is used
- * to serve responses to the `blink.*` API. (e.g. blink.chat.upsert).
- */
 interface Agent {
   /**
    * fetch is the HTTP handler for the agent.
@@ -221,9 +295,6 @@ interface Agent {
    */
   serve(options?: ServeOptions): http.Server;
 }
-/**
- * ServeOptions is the options for the `.serve()` method.
- */
 type ServeOptions = {
   readonly host?: string;
   readonly port?: number;
@@ -274,7 +345,7 @@ declare const _default: {
         withContext(context: unknown): ai0.Tool;
       };
     }>(tools: TOOLS, context: ContextFromTools<TOOLS>): { [K in keyof TOOLS]: ai0.Tool };
-    withApproval<TOOLS extends ai0.ToolSet, MESSAGE extends UIMessage>(options: {
+    withApproval<TOOLSET extends ai0.ToolSet, TOOLS extends ToolSetWithApproval<TOOLSET>, MESSAGE extends UIMessage>(options: {
       messages: MESSAGE[];
       tools: TOOLS;
       abortSignal?: AbortSignal;
@@ -283,4 +354,4 @@ declare const _default: {
   };
 };
 //#endregion
-export { Agent, AgentOptions, Chat, ChatBehavior, ContextFromTools, ExperimentalCompletion, ExperimentalProvideCompletionsOptions, ExperimentalProvideCompletionsResponse, Message, MessageOptions, SendMessagesOptions, SendMessagesResponse, ServeOptions, StreamResponseFormat, ToolApprovalOutput, ToolWithContext, _default, agent, chat, isToolApprovalOutput, model, storage, tools, withResponseFormat };
+export { Agent, AgentOptions, Chat, ChatBehavior, ContextFromTools, ExperimentalCompletion, ExperimentalProvideCompletionsOptions, ExperimentalProvideCompletionsResponse, ExtractUIOptions, Message, MessageOptions, OptionSelect, OptionSelectValue, Options, OptionsSchema, ProvideOptionsRequest, SendMessagesOptions, SendMessagesResponse, ServeOptions, StreamResponseFormat, ToolApprovalOutput, ToolSetWithApproval, ToolWithApproval, ToolWithContext, WithUIOptions, _default, agent, chat, isToolApprovalOutput, lastUIOptions, model, storage, toolWithApproval, tools, withResponseFormat };

package/dist/{index-9U4QN9Pz.d.ts → index-y1u5VC2_.d.ts}

@@ -1,4 +1,4 @@
-import { Chat, ExperimentalCompletion } from "./index-CIUoZVwP.js";
+import { Chat, ExperimentalCompletion, OptionsSchema, ProvideOptionsRequest, WithUIOptions } from "./index-E064W90j.js";
 import { UIMessage, UIMessageChunk } from "ai";
 
 //#region src/http/async-iterable-stream.d.ts
@@ -60,6 +60,7 @@ interface ExperimentalProvideCompletionsRequest {
 interface CapabilitiesResponse {
   readonly requests: boolean;
   readonly completions: boolean;
+  readonly options: boolean;
 }
 interface ClientOptions {
   readonly baseUrl: string;
@@ -90,6 +91,12 @@ declare class Client {
    * This is used to check if the agent supports requests and completions.
    */
   capabilities(): Promise<CapabilitiesResponse>;
+  /**
+   * provideUIOptions provides selectable options to the user.
+   */
+  provideUIOptions(request: ProvideOptionsRequest<WithUIOptions<Record<string, any>>>, options?: {
+    signal?: AbortSignal;
+  }): Promise<OptionsSchema<any>>;
   /**
    * health simply returns a 200 response.
    * This is used to check if the agent is running.
@@ -99,4 +106,8 @@ declare class Client {
 }
 declare const streamSSE: <T>(resp: Response) => ReadableStream<T>;
 //#endregion
-export { APIServerURLEnvironmentVariable, AsyncIterableStream$1 as AsyncIterableStream, CapabilitiesResponse, Client, ClientOptions, ExperimentalProvideCompletionsRequest, SendMessagesRequest, StreamResponseFormatHeader, createAsyncIterableStream, streamSSE };
+//#region src/http/convert-response-to-ui-message-stream.d.ts
+type StreamResponseFormat = "ui-message" | "openai-chat" | "openai-response" | "anthropic" | "google" | "xai";
+declare function convertResponseToUIMessageStream(response: Response): ReadableStream<UIMessageChunk>;
+//#endregion
+export { APIServerURLEnvironmentVariable, AsyncIterableStream$1 as AsyncIterableStream, CapabilitiesResponse, Client, ClientOptions, ExperimentalProvideCompletionsRequest, SendMessagesRequest, StreamResponseFormat, StreamResponseFormatHeader, convertResponseToUIMessageStream, createAsyncIterableStream, streamSSE };

package/dist/test.d.cts

@@ -1,5 +1,5 @@
-import "./index-IWju3eNc.cjs";
-import { Client } from "./index-D4ib-Sj-.cjs";
+import "./index-BdS2C_9A.cjs";
+import { Client } from "./index-DXNEroA1.cjs";
 
 //#region src/test.d.ts
 interface CreateOptions {

package/dist/test.d.ts

@@ -1,5 +1,5 @@
-import "./index-CIUoZVwP.js";
-import { Client } from "./index-9U4QN9Pz.js";
+import "./index-E064W90j.js";
+import { Client } from "./index-y1u5VC2_.js";
 
 //#region src/test.d.ts
 interface CreateOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blink",
-  "version": "0.1.60",
+  "version": "0.1.62",
   "description": "Blink is a JavaScript runtime for building and deploying AI agents.",
   "type": "module",
   "bin": {

package/dist/cli/login-KHDcJ0iZ.js

@@ -1 +0,0 @@
-import{login as e}from"./auth-Dw-wJ1IM.js";import"./dist-CN69Y-yA.js";import"./open-Cr8lEmcs.js";async function t(){await e()}export{t as default};