@rudderjs/ai 0.0.1

package/dist/agent.d.ts

@@ -0,0 +1,74 @@
+import { QueuedPromptBuilder } from './queue-job.js';
+import type { AgentPromptOptions, AiMessage, AiMiddleware, AgentResponse, AgentStep, AgentStreamResponse, AnyTool, ConversationStore, HasMiddleware, HasTools, PrepareStepResult, StopCondition } from './types.js';
+/** Stop after N steps */
+export declare function stepCountIs(n: number): StopCondition;
+/** Stop when a specific tool is called in the latest step */
+export declare function hasToolCall(toolName: string): StopCondition;
+export declare abstract class Agent {
+    /** System instructions for this agent */
+    abstract instructions(): string;
+    /** Model string (e.g. 'anthropic/claude-sonnet-4-5'). Defaults to registry default. */
+    model(): string | undefined;
+    /** Failover provider/model strings */
+    failover(): string[];
+    /** Maximum iterations for the tool loop (default: 20) */
+    maxSteps(): number;
+    /** Per-step control — override model, tools, messages per iteration */
+    prepareStep?(_ctx: {
+        stepNumber: number;
+        steps: AgentStep[];
+        messages: AiMessage[];
+    }): PrepareStepResult | Promise<PrepareStepResult>;
+    /** Stop conditions — combine with array (OR logic) */
+    stopWhen(): StopCondition | StopCondition[];
+    /** Temperature (0-1) */
+    temperature(): number | undefined;
+    /** Max tokens for response */
+    maxTokens(): number | undefined;
+    /** Run the agent with a prompt (non-streaming) */
+    prompt(input: string, options?: AgentPromptOptions): Promise<AgentResponse>;
+    /** Run the agent with a prompt (streaming) */
+    stream(input: string, options?: AgentPromptOptions): AgentStreamResponse;
+    /** Queue the prompt for background execution */
+    queue(input: string, options?: AgentPromptOptions): QueuedPromptBuilder;
+    /** Set the user scope for conversation persistence */
+    forUser(userId: string): ConversableAgent;
+    /** Continue an existing conversation */
+    continue(conversationId: string): ConversableAgent;
+}
+/**
+ * Wraps an Agent to add conversation memory.
+ * Created via `agent.forUser(id)` or `agent.continue(id)`.
+ */
+export declare class ConversableAgent {
+    private readonly agent;
+    private _userId;
+    private _conversationId;
+    constructor(agent: Agent);
+    forUser(userId: string): this;
+    continue(conversationId: string): this;
+    prompt(input: string, options?: AgentPromptOptions): Promise<AgentResponse>;
+    stream(input: string, options?: AgentPromptOptions): AgentStreamResponse;
+}
+/**
+ * Create an anonymous agent inline.
+ *
+ * @example
+ * const response = await agent('You are helpful.').prompt('Hello')
+ *
+ * @example
+ * const response = await agent({
+ *   instructions: 'You are a search assistant.',
+ *   tools: [searchTool],
+ *   model: 'anthropic/claude-sonnet-4-5',
+ * }).prompt('Find users named John')
+ */
+export declare function agent(instructionsOrOptions: string | {
+    instructions: string;
+    tools?: AnyTool[] | undefined;
+    model?: string | undefined;
+    middleware?: AiMiddleware[] | undefined;
+}): Agent & HasTools & HasMiddleware;
+/** Set the global conversation store (called by service provider or manually) */
+export declare function setConversationStore(store: ConversationStore): void;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAWpD,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,YAAY,EAEZ,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,OAAO,EAEP,iBAAiB,EAEjB,aAAa,EACb,QAAQ,EAER,iBAAiB,EAEjB,aAAa,EAQd,MAAM,YAAY,CAAA;AAInB,yBAAyB;AACzB,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAEpD;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAK3D;AAID,8BAAsB,KAAK;IACzB,yCAAyC;IACzC,QAAQ,CAAC,YAAY,IAAI,MAAM;IAE/B,uFAAuF;IACvF,KAAK,IAAI,MAAM,GAAG,SAAS;IAE3B,sCAAsC;IACtC,QAAQ,IAAI,MAAM,EAAE;IAEpB,yDAAyD;IACzD,QAAQ,IAAI,MAAM;IAElB,uEAAuE;IACvE,WAAW,CAAC,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,QAAQ,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAErI,sDAAsD;IACtD,QAAQ,IAAI,aAAa,GAAG,aAAa,EAAE;IAI3C,wBAAwB;IACxB,WAAW,IAAI,MAAM,GAAG,SAAS;IAEjC,8BAA8B;IAC9B,SAAS,IAAI,MAAM,GAAG,SAAS;IAE/B,kDAAkD;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjF,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,mBAAmB;IAIxE,gDAAgD;IAChD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,mBAAmB;IAIvE,sDAAsD;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAIzC,wCAAwC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB;CAGnD;AAID;;;GAGG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,eAAe,CAAoB;gBAEd,KAAK,EAAE,KAAK;IAEzC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAKhC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgCjF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,mBAAmB;CA0DzE;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CACnB,qBAAqB,EAAE,MAAM,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,UAAU,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAA;CACxC,GACA,KAAK,GAAG,QAAQ,GAAG,aAAa,CAKlC;AAQD,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAEnE"}