experimental-agent 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import * as _vercel_sandbox from '@vercel/sandbox';
-import { S as SandboxBinding, a as SandboxSetupFields, b as SandboxInstance, W as WithConfig, c as LoggingConfig, E as ExecResult, U as UploadableFile } from './steps-BnkRQKlc.js';
-export { d as SandboxAgentRef } from './steps-BnkRQKlc.js';
-import { L as LocalBindingConfig, a as LocalBindingMetadata, V as VercelBindingConfig, b as VercelBindingMetadata, D as DockerBindingConfig, c as DockerBindingMetadata } from './entry-BmQ8FO-5.js';
+import { S as SandboxBinding, a as SandboxSetupFields, b as SandboxInstance, W as WithConfig, c as LoggingConfig, E as ExecResult, U as UploadableFile } from './steps-DShnXBLf.js';
+export { d as SandboxAgentRef } from './steps-DShnXBLf.js';
+import { L as LocalBindingConfig, a as LocalBindingMetadata, V as VercelBindingConfig, b as VercelBindingMetadata, D as DockerBindingConfig, c as DockerBindingMetadata } from './entry-BrWOmEK2.js';
 import * as ai from 'ai';
 import { InferToolInput, ModelMessage, ToolSet, UIMessage, InferUITools, GatewayModelId } from 'ai';
-import { b as Session, e as Storage, i as StorageInput } from './adapter-BigchkkI.js';
 import { z } from 'zod';
+import { c as Session, f as Storage, j as SkillInput, k as StorageInput } from './adapter-zgOel4wW.js';
+export { l as GitSkillEntry, m as GitSkillInput, H as HostSkillEntry, n as HostSkillInput, I as InlineSkillEntry, o as InlineSkillInput, p as SandboxSkillEntry, q as SandboxSkillInput, r as SkillEntry, s as SkillSourceType } from './adapter-zgOel4wW.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 import * as errore from 'errore';
 
@@ -59,16 +60,6 @@ type SessionUsage = {
     byMessageId: Record<string, UsageSummary | null>;
 };
 
-type StreamOptions = {
-    messageId?: string;
-    startIndex?: number;
-};
-type WorkflowRunLike = {
-    getReadable(options?: {
-        startIndex?: number;
-    }): ReadableStream;
-};
-
 type ToolContext<TContext = Record<string, unknown>> = {
     session: Session;
     sandbox: SandboxInstance;
@@ -231,14 +222,45 @@ type NeedsApprovalMap<Tools> = {
 };
 type InferUIMessage<A> = A extends {
     tools: infer T extends ToolSet;
+    $UIMessage: UIMessage<infer M>;
+} ? UIMessage<M, AgentDataTypes, InferUITools<T>> : A extends {
+    tools: infer T extends ToolSet;
 } ? UIMessage<unknown, AgentDataTypes, InferUITools<T>> : UIMessage<unknown, AgentDataTypes>;
-type TypedUIMessage<Tools extends ToolSet = ToolSet> = UIMessage<unknown, AgentDataTypes, InferUITools<Tools>>;
+type TypedUIMessage<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet> = UIMessage<TMessageMetadata, AgentDataTypes, InferUITools<Tools>>;
+
+type StreamOptions = {
+    messageId?: string;
+    startIndex?: number;
+};
+type WorkflowRunLike = {
+    getReadable(options?: {
+        startIndex?: number;
+    }): ReadableStream;
+};
 
 type UpdateOptions<Tools extends ToolSet> = Partial<Omit<Session, "id" | "activeTools" | "model"> & {
     model?: GatewayModelId;
     activeTools?: (Extract<keyof Tools, string> | BuiltInToolName)[];
 }>;
 
+type ApprovalData = {
+    approvalId: string;
+    approved: boolean;
+    reason?: string;
+};
+type MessageData<Tools extends ToolSet> = UIMessage | {
+    role?: TypedUIMessage<unknown, Tools>["role"];
+    parts: TypedUIMessage<unknown, Tools>["parts"];
+    metadata?: Record<string, unknown> | null;
+    id?: string;
+};
+type SendInput<Tools extends ToolSet> = string | MessageData<Tools> | {
+    type: "message";
+    message: MessageData<Tools>;
+} | {
+    type: "approval";
+    approval: ApprovalData;
+};
 type SendOptions<Tools extends ToolSet, TContext> = {
     interruptIfStreaming?: boolean | {
         lastPart: {
@@ -266,7 +288,7 @@ type SessionDefaults<Tools extends ToolSet = ToolSet> = {
     system?: string;
     generation?: Session["generation"];
     activeTools?: (Extract<keyof Tools, string> | BuiltInToolName)[];
-    skillsDir?: string | string[];
+    skills?: SkillInput[];
 };
 type AgentOptions<Tools extends ToolSet = any, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> = SessionDefaults<Tools> & {
     storage?: StorageInput;
@@ -277,10 +299,10 @@ type AgentOptions<Tools extends ToolSet = any, TSandboxBindings extends SandboxB
     contextSchema?: z.ZodType<TContext>;
     logging?: Omit<LoggingConfig, "name">;
 };
-type AnyAgent = Agent<any, any, any>;
+type AnyAgent = Agent<any, any, any, any>;
 type InferSession<Agent extends AnyAgent = AnyAgent> = ReturnType<Agent["session"]>;
 type SessionSendArgs<Agent extends AnyAgent, Session extends InferSession<Agent> = InferSession<Agent>> = Parameters<Session["send"]>;
-declare class Agent<Tools extends ToolSet, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> {
+declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> {
     readonly name: string;
     options: AgentOptions<Tools, TSandboxBindings, TContext>;
     constructor(name: string, options?: AgentOptions<Tools, TSandboxBindings, TContext>);
@@ -290,7 +312,7 @@ declare class Agent<Tools extends ToolSet, TSandboxBindings extends SandboxBindi
     static [WORKFLOW_DESERIALIZE](data: {
         name: string;
     }): AnyAgent;
-    private _storageWarned;
+    private _resolvedStorage;
     get storage(): Storage;
     get tools(): typeof builtInTools & Tools;
     get sessionDefaults(): SessionDefaults;
@@ -299,43 +321,7 @@ declare class Agent<Tools extends ToolSet, TSandboxBindings extends SandboxBindi
         id?: string;
     } | undefined) => {
         id: string;
-        send: (input: (string | {
-            type: "approval";
-            approval: {
-                approvalId: string;
-                approved: boolean;
-                reason?: string;
-            };
-        } | (UIMessage<unknown, ai.UIDataTypes, ai.UITools> | {
-            role?: TypedUIMessage<Tools_1>["role"];
-            parts: ai.UIMessagePart<AgentDataTypes, InferUITools<Tools>>[];
-            id?: string;
-        }) | {
-            type: "message";
-            message: UIMessage<unknown, ai.UIDataTypes, ai.UITools> | {
-                role?: TypedUIMessage<Tools_1>["role"];
-                parts: ai.UIMessagePart<AgentDataTypes, InferUITools<Tools>>[];
-                id?: string;
-            };
-        }) | (string | {
-            type: "approval";
-            approval: {
-                approvalId: string;
-                approved: boolean;
-                reason?: string;
-            };
-        } | (UIMessage<unknown, ai.UIDataTypes, ai.UITools> | {
-            role?: TypedUIMessage<Tools_1>["role"];
-            parts: ai.UIMessagePart<AgentDataTypes, InferUITools<Tools>>[];
-            id?: string;
-        }) | {
-            type: "message";
-            message: UIMessage<unknown, ai.UIDataTypes, ai.UITools> | {
-                role?: TypedUIMessage<Tools_1>["role"];
-                parts: ai.UIMessagePart<AgentDataTypes, InferUITools<Tools>>[];
-                id?: string;
-            };
-        })[], opts?: SendOptions<Tools, TContext> | undefined) => Promise<SendResult>;
+        send: (input: SendInput<Tools> | SendInput<Tools>[], opts?: SendOptions<Tools, TContext> | undefined) => Promise<SendResult>;
         stream: (runOrOpts?: WorkflowRunLike | StreamOptions | undefined) => Promise<ReadableStream<ai.UIMessageChunk>>;
         history: () => Promise<{
             messages: UIMessage<unknown, AgentDataTypes, InferUITools<Tools>>[];
@@ -398,9 +384,9 @@ declare class Agent<Tools extends ToolSet, TSandboxBindings extends SandboxBindi
         } | undefined) => Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
     };
     /** Phantom property for type inference. Use `typeof myAgent.$UIMessage` to get the typed UIMessage. */
-    readonly $UIMessage: UIMessage<unknown, AgentDataTypes, InferUITools<typeof builtInTools & Tools>>;
+    readonly $UIMessage: UIMessage<TMessageMetadata, AgentDataTypes, InferUITools<typeof builtInTools & Tools>>;
 }
-declare function agent<Tools extends ToolSet, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>>(name: string, options?: AgentOptions<Tools, TSandboxBindings, TContext>): Agent<Tools, TSandboxBindings, TContext>;
+declare function agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>>(name: string, options?: AgentOptions<Tools, TSandboxBindings, TContext>): Agent<TMessageMetadata, Tools, TSandboxBindings, TContext>;
 
 declare const SessionNotFoundError_base: errore.FactoryTaggedErrorClass<"SessionNotFoundError", "Session $id not found", Error>;
 declare class SessionNotFoundError extends SessionNotFoundError_base {
@@ -421,4 +407,4 @@ declare const MessageNotFoundError_base: errore.FactoryTaggedErrorClass<"Message
 declare class MessageNotFoundError extends MessageNotFoundError_base {
 }
 
-export { type AgentDataTypes, type AgentHooks, type AgentOptions, AgentStatus, type AnyAgent, type BuiltInToolName, ExecResult, type InferSession, type InferUIMessage, MessageNotFoundError, type NeedsApprovalMap, SandboxBinding, SandboxError, SandboxInstance, SandboxNotFoundError, SandboxSetupFields, type SessionDefaults, SessionNotFoundError, type SessionSendArgs, type StepUsage, StorageConflictError, StorageError, type ToolContext, UploadableFile, type UsageSummary, type WorkflowRunLike, agent, builtinToolNames };
+export { type AgentDataTypes, type AgentHooks, type AgentOptions, AgentStatus, type AnyAgent, type ApprovalData, type BuiltInToolName, ExecResult, type InferSession, type InferUIMessage, MessageNotFoundError, type NeedsApprovalMap, SandboxBinding, SandboxError, SandboxInstance, SandboxNotFoundError, SandboxSetupFields, type SendInput, type SessionDefaults, SessionNotFoundError, type SessionSendArgs, SkillInput, type StepUsage, StorageConflictError, StorageError, type ToolContext, UploadableFile, type UsageSummary, type WorkflowRunLike, agent, builtinToolNames };