blink 0.1.64 → 0.1.66

package/dist/node/index.browser-D1y2mwdW.d.ts

@@ -0,0 +1,281 @@
+import { AsyncIterableStream, InferToolInput, InferToolOutput, InferUIMessageChunk, Tool, ToolSet, UIDataTypes, UIMessage, UIMessagePart, UITools } from "ai";
+
+//#region src/api/chat.d.ts
+interface Chat {
+  readonly id: string;
+}
+type ChatBehavior = "enqueue" | "interrupt" | "append";
+interface MessageOptions {
+  /**
+   * behavior of the chat when sending this message.
+   *
+   * - "enqueue" will add messages to the chat and start the chat eventually.
+   * - "interrupt" will interrupt the chat if running and send messages.
+   * - "append" will add messages to the chat.
+   */
+  readonly behavior?: ChatBehavior;
+}
+interface Message<METADATA = unknown, DATA_TYPES extends UIDataTypes = UIDataTypes, TOOLS extends UITools = UITools> {
+  readonly role: UIMessage["role"];
+  readonly parts: UIMessagePart<DATA_TYPES, TOOLS>[];
+  readonly metadata?: METADATA;
+}
+declare const chat: Readonly<{
+  upsert: (id: string) => Promise<Chat>;
+  message: (id: string, message: Message, options?: MessageOptions) => Promise<void>;
+}>;
+//#endregion
+//#region src/api/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: {
+  /**
+   * 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/api/storage.d.ts
+/**
+ * Storage allows agents to persist data.
+ * Every agent has it's own persistent storage namespace.
+ */
+declare const storage: Readonly<{
+  kv: Readonly<{
+    get: (key: string) => Promise<string | undefined>;
+    set: (key: string, value: string) => Promise<void>;
+    del: (key: string) => Promise<void>;
+  }>;
+}>;
+//#endregion
+//#region src/api/index.browser.d.ts
+/**
+ * SendMessagesResponse is the response of the sendMessages function.
+ * It can be a stream of messages or an arbitrary response.
+ */
+type SendMessagesResponse = {
+  toUIMessageStream(): AsyncIterableStream<InferUIMessageChunk<UIMessage>>;
+} | Response | ReadableStream<InferUIMessageChunk<UIMessage>>;
+/**
+ * SendMessagesOptions is the options for the sendMessages function.
+ */
+interface SendMessagesOptions<MESSAGE extends UIMessage = UIMessage> {
+  /**
+   * Messages are all messages for the history of the chat.
+   * It is the user's responsibility to manage context for the chat.
+   */
+  readonly messages: MESSAGE[];
+  /**
+   * Chat is the associated chat for the messages.
+   */
+  readonly chat: Chat;
+  /**
+   * abortSignal can be used to terminate streaming operations
+   * immediately when the streaming request ends.
+   */
+  readonly abortSignal?: AbortSignal;
+}
+interface ExperimentalProvideCompletionsOptions<MESSAGE extends UIMessage = UIMessage> {
+  /**
+   * The chat for the completions.
+   * Omitted if there is no chat.
+   */
+  readonly chat?: Chat;
+  /**
+   * Messages that are part of the current chat.
+   * Omitted if there is no chat.
+   */
+  readonly messages?: MESSAGE[];
+  readonly input: string;
+  readonly caret: number;
+  readonly selection?: [number, number];
+  readonly abortSignal?: AbortSignal;
+}
+type ExperimentalCompletion = {
+  text: string;
+  replace?: [number, number];
+} | {
+  id: string;
+  label: string;
+  detail?: string;
+  insertText?: string;
+  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.
+   * This is invoked on chat creation, and can be programatically
+   * invoked at any time with `blink.chat.message`.
+   */
+  sendMessages(options: SendMessagesOptions<MESSAGE>): Promise<SendMessagesResponse> | SendMessagesResponse;
+  /**
+   * onRequest is called when the agent receives a request.
+   * This is for handling webhooks, or incoming client payloads
+   * that warrant a response.
+   *
+   * @param request The request received by the agent.
+   * @returns A response to the request. If void, the agent will
+   *          respond with a 404.
+   */
+  onRequest?(request: Request): Promise<Response | void>;
+  /**
+   * experimental_provideCompletions is called when the user is typing in the chat input.
+   * This is used to provide completions to the user.
+   *
+   * *NOTE*: This *only* works in the browser at the moment.
+   *
+   * @param options The options for the completions.
+   * @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>>;
+}
+type StreamResponseFormat = "ui-message" | "openai-chat" | "openai-response" | "anthropic" | "google" | "xai";
+declare function withResponseFormat(response: Response, format: StreamResponseFormat): Response;
+//#endregion
+export { AgentOptions, Chat, ChatBehavior, ContextFromTools, ExperimentalCompletion, ExperimentalProvideCompletionsOptions, ExperimentalProvideCompletionsResponse, ExtractUIOptions, Message, MessageOptions, OptionSelect, OptionSelectValue, Options, OptionsSchema, ProvideOptionsRequest, SendMessagesOptions, SendMessagesResponse, StreamResponseFormat, ToolApprovalOutput, ToolSetWithApproval, ToolWithApproval, ToolWithContext, WithUIOptions, chat, isToolApprovalOutput, lastUIOptions, storage, toolWithApproval, tools, withResponseFormat };

package/dist/node/index.browser-wBJ4jcnM.d.cts

@@ -0,0 +1,281 @@
+import { AsyncIterableStream, InferToolInput, InferToolOutput, InferUIMessageChunk, Tool, ToolSet, UIDataTypes, UIMessage, UIMessagePart, UITools } from "ai";
+
+//#region src/api/chat.d.ts
+interface Chat {
+  readonly id: string;
+}
+type ChatBehavior = "enqueue" | "interrupt" | "append";
+interface MessageOptions {
+  /**
+   * behavior of the chat when sending this message.
+   *
+   * - "enqueue" will add messages to the chat and start the chat eventually.
+   * - "interrupt" will interrupt the chat if running and send messages.
+   * - "append" will add messages to the chat.
+   */
+  readonly behavior?: ChatBehavior;
+}
+interface Message<METADATA = unknown, DATA_TYPES extends UIDataTypes = UIDataTypes, TOOLS extends UITools = UITools> {
+  readonly role: UIMessage["role"];
+  readonly parts: UIMessagePart<DATA_TYPES, TOOLS>[];
+  readonly metadata?: METADATA;
+}
+declare const chat: Readonly<{
+  upsert: (id: string) => Promise<Chat>;
+  message: (id: string, message: Message, options?: MessageOptions) => Promise<void>;
+}>;
+//#endregion
+//#region src/api/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: {
+  /**
+   * 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/api/storage.d.ts
+/**
+ * Storage allows agents to persist data.
+ * Every agent has it's own persistent storage namespace.
+ */
+declare const storage: Readonly<{
+  kv: Readonly<{
+    get: (key: string) => Promise<string | undefined>;
+    set: (key: string, value: string) => Promise<void>;
+    del: (key: string) => Promise<void>;
+  }>;
+}>;
+//#endregion
+//#region src/api/index.browser.d.ts
+/**
+ * SendMessagesResponse is the response of the sendMessages function.
+ * It can be a stream of messages or an arbitrary response.
+ */
+type SendMessagesResponse = {
+  toUIMessageStream(): AsyncIterableStream<InferUIMessageChunk<UIMessage>>;
+} | Response | ReadableStream<InferUIMessageChunk<UIMessage>>;
+/**
+ * SendMessagesOptions is the options for the sendMessages function.
+ */
+interface SendMessagesOptions<MESSAGE extends UIMessage = UIMessage> {
+  /**
+   * Messages are all messages for the history of the chat.
+   * It is the user's responsibility to manage context for the chat.
+   */
+  readonly messages: MESSAGE[];
+  /**
+   * Chat is the associated chat for the messages.
+   */
+  readonly chat: Chat;
+  /**
+   * abortSignal can be used to terminate streaming operations
+   * immediately when the streaming request ends.
+   */
+  readonly abortSignal?: AbortSignal;
+}
+interface ExperimentalProvideCompletionsOptions<MESSAGE extends UIMessage = UIMessage> {
+  /**
+   * The chat for the completions.
+   * Omitted if there is no chat.
+   */
+  readonly chat?: Chat;
+  /**
+   * Messages that are part of the current chat.
+   * Omitted if there is no chat.
+   */
+  readonly messages?: MESSAGE[];
+  readonly input: string;
+  readonly caret: number;
+  readonly selection?: [number, number];
+  readonly abortSignal?: AbortSignal;
+}
+type ExperimentalCompletion = {
+  text: string;
+  replace?: [number, number];
+} | {
+  id: string;
+  label: string;
+  detail?: string;
+  insertText?: string;
+  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.
+   * This is invoked on chat creation, and can be programatically
+   * invoked at any time with `blink.chat.message`.
+   */
+  sendMessages(options: SendMessagesOptions<MESSAGE>): Promise<SendMessagesResponse> | SendMessagesResponse;
+  /**
+   * onRequest is called when the agent receives a request.
+   * This is for handling webhooks, or incoming client payloads
+   * that warrant a response.
+   *
+   * @param request The request received by the agent.
+   * @returns A response to the request. If void, the agent will
+   *          respond with a 404.
+   */
+  onRequest?(request: Request): Promise<Response | void>;
+  /**
+   * experimental_provideCompletions is called when the user is typing in the chat input.
+   * This is used to provide completions to the user.
+   *
+   * *NOTE*: This *only* works in the browser at the moment.
+   *
+   * @param options The options for the completions.
+   * @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>>;
+}
+type StreamResponseFormat = "ui-message" | "openai-chat" | "openai-response" | "anthropic" | "google" | "xai";
+declare function withResponseFormat(response: Response, format: StreamResponseFormat): Response;
+//#endregion
+export { AgentOptions, Chat, ChatBehavior, ContextFromTools, ExperimentalCompletion, ExperimentalProvideCompletionsOptions, ExperimentalProvideCompletionsResponse, ExtractUIOptions, Message, MessageOptions, OptionSelect, OptionSelectValue, Options, OptionsSchema, ProvideOptionsRequest, SendMessagesOptions, SendMessagesResponse, StreamResponseFormat, ToolApprovalOutput, ToolSetWithApproval, ToolWithApproval, ToolWithContext, WithUIOptions, chat, isToolApprovalOutput, lastUIOptions, storage, toolWithApproval, tools, withResponseFormat };

package/dist/node/test.d.cts

@@ -0,0 +1,88 @@
+import { Chat, ExperimentalCompletion, OptionsSchema, ProvideOptionsRequest, WithUIOptions } from "./index.browser-wBJ4jcnM.cjs";
+import { UIMessage, UIMessageChunk } from "ai";
+
+//#region src/http/client.d.ts
+
+/**
+ * SendMessagesRequest is the request format of the `/_agent/send-messages` endpoint.
+ *
+ * It executes the `sendMessages` function.
+ */
+interface SendMessagesRequest {
+  readonly messages: UIMessage[];
+  readonly chat: Chat;
+}
+/**
+ * ExperimentalProvideCompletionsRequest is the request format of the `/_agent/completions` endpoint.
+ *
+ * It executes the `experimental_provideCompletions` function.
+ */
+interface ExperimentalProvideCompletionsRequest {
+  readonly messages: UIMessage[];
+  readonly chat?: Chat;
+  readonly input: string;
+  readonly caret: number;
+  readonly selection?: [number, number];
+}
+/**
+ * CapabilitiesResponse is the response format of the `/_agent/capabilities` endpoint.
+ *
+ * It indicates whether the agent supports requests and completions.
+ */
+interface CapabilitiesResponse {
+  readonly requests: boolean;
+  readonly completions: boolean;
+  readonly options: boolean;
+}
+interface ClientOptions {
+  readonly baseUrl: string;
+  readonly headers?: Record<string, string>;
+}
+/**
+ * Client is a client for the Blink agent HTTP API.
+ */
+declare class Client {
+  private readonly options;
+  constructor(options: ClientOptions);
+  get baseUrl(): string;
+  /**
+   * sendMessages sends messages to the agent.
+   *
+   * The response format is automatically converted to a UI message stream.
+   */
+  sendMessages(request: SendMessagesRequest, options?: {
+    signal?: AbortSignal;
+  }): Promise<ReadableStream<UIMessageChunk>>;
+  /**
+   * experimental_provideCompletions provides completions to the user.
+   * This is used to provide completions to the user.
+   */
+  experimental_provideCompletions(request: ExperimentalProvideCompletionsRequest): Promise<ReadableStream<ExperimentalCompletion>>;
+  /**
+   * capabilities returns the capabilities of the agent.
+   * 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.
+   */
+  health(): Promise<void>;
+  private handleError;
+}
+//#endregion
+//#region src/test.d.ts
+interface CreateOptions {
+  readonly entrypoint?: string;
+  readonly cwd?: string;
+  readonly env?: Record<string, string>;
+}
+declare function create(options?: CreateOptions): Promise<Client>;
+//#endregion
+export { CreateOptions, create };