@upstash/workflow 0.2.5-agents → 0.2.5-agents-2

package/index.js

@@ -839,29 +839,16 @@ var triggerWorkflowDelete = async (workflowContext, debug, cancel = false) => {
   await debug?.log("SUBMIT", "SUBMIT_CLEANUP", {
     deletedWorkflowRunId: workflowContext.workflowRunId
   });
-  try {
-    await workflowContext.qstashClient.http.request({
-      path: ["v2", "workflows", "runs", `${workflowContext.workflowRunId}?cancel=${cancel}`],
-      method: "DELETE",
-      parseResponseAsJson: false
-    });
-    await debug?.log(
-      "SUBMIT",
-      "SUBMIT_CLEANUP",
-      `workflow run ${workflowContext.workflowRunId} deleted.`
-    );
-    return { deleted: true };
-  } catch (error) {
-    if (error instanceof import_qstash3.QstashError && error.status === 404) {
-      await debug?.log("WARN", "SUBMIT_CLEANUP", {
-        message: `Failed to remove workflow run ${workflowContext.workflowRunId} as it doesn't exist.`,
-        name: error.name,
-        errorMessage: error.message
-      });
-      return { deleted: false };
-    }
-    throw error;
-  }
+  await workflowContext.qstashClient.http.request({
+    path: ["v2", "workflows", "runs", `${workflowContext.workflowRunId}?cancel=${cancel}`],
+    method: "DELETE",
+    parseResponseAsJson: false
+  });
+  await debug?.log(
+    "SUBMIT",
+    "SUBMIT_CLEANUP",
+    `workflow run ${workflowContext.workflowRunId} deleted.`
+  );
 };
 var recreateUserHeaders = (headers) => {
   const filteredHeaders = new Headers();
@@ -1648,7 +1635,22 @@ var WorkflowApi = class extends BaseWorkflowApi {
 // src/agents/adapters.ts
 var import_openai2 = require("@ai-sdk/openai");
 var import_ai = require("ai");
+
+// src/agents/constants.ts
 var AGENT_NAME_HEADER = "upstash-agent-name";
+var MANAGER_AGENT_PROMPT = `You are an agent orchestrating other AI Agents.
+
+These other agents have tools available to them.
+
+Given a prompt, utilize these agents to address requests.
+
+Don't always call all the agents provided to you at the same time. You can call one and use it's response to call another.
+
+Avoid calling the same agent twice in one turn. Instead, prefer to call it once but provide everything
+you need from that agent.
+`;
+
+// src/agents/adapters.ts
 var createWorkflowOpenAI = (context) => {
   return (0, import_openai2.createOpenAI)({
     compatibility: "strict",
@@ -1715,8 +1717,7 @@ var convertLangchainTool = (langchainTool) => {
   return (0, import_ai.tool)({
     description: langchainTool.description,
     parameters: langchainTool.schema,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    execute: async (param) => langchainTool.invoke(param)
+    execute: async (...param) => langchainTool.invoke(...param)
   });
 };
 
@@ -1729,16 +1730,24 @@ var Agent = class {
   maxSteps;
   background;
   model;
-  constructor({ tools, maxSteps, background, name, model }) {
+  temparature;
+  constructor({ tools, maxSteps, background, name, model, temparature = 0.1 }) {
     this.name = name;
     this.tools = tools ?? {};
     this.maxSteps = maxSteps;
     this.background = background;
     this.model = model;
+    this.temparature = temparature;
   }
+  /**
+   * Trigger the agent by passing a prompt
+   *
+   * @param prompt task to assign to the agent
+   * @returns Response as `{ text: string }`
+   */
   async call({ prompt }) {
     try {
-      return await (0, import_ai2.generateText)({
+      const result = await (0, import_ai2.generateText)({
         model: this.model,
         tools: this.tools,
         maxSteps: this.maxSteps,
@@ -1746,8 +1755,10 @@ var Agent = class {
         prompt,
         headers: {
           [AGENT_NAME_HEADER]: this.name
-        }
+        },
+        temperature: this.temparature
       });
+      return { text: result.text };
     } catch (error) {
       if (error instanceof import_ai2.ToolExecutionError) {
         if (error.cause instanceof Error && error.cause.name === "WorkflowAbort") {
@@ -1762,6 +1773,11 @@ var Agent = class {
       }
     }
   }
+  /**
+   * Convert the agent to a tool which can be used by other agents.
+   *
+   * @returns the agent as a tool
+   */
   asTool() {
     const toolDescriptions = Object.values(this.tools).map((tool3) => tool3.description).join("\n");
     return (0, import_ai2.tool)({
@@ -1773,18 +1789,25 @@ var Agent = class {
     });
   }
 };
-var MANAGER_AGENT_PROMPT = `You are an AI agent who orchestrates other AI Agents.
-These other agents have tools available to them.
-Given a prompt, utilize these agents to address requests.
-Don't always call all the agents provided to you at the same time. You can call one and use it's response to call another. 
-`;
 var ManagerAgent = class extends Agent {
   agents;
+  /**
+   * A manager agent which coordinates agents available to it to achieve a
+   * given task
+   *
+   * @param name Name of the agent
+   * @param background Background of the agent. If not passed, default will be used.
+   * @param model LLM model to use
+   * @param agents: List of agents available to the agent
+   * @param maxSteps number of times the manager agent can call the LLM at most.
+   *   If the agent abruptly stops execution after calling other agents, you may
+   *   need to increase maxSteps
+   */
   constructor({
-    maxSteps,
-    background = MANAGER_AGENT_PROMPT,
     agents,
+    background = MANAGER_AGENT_PROMPT,
     model,
+    maxSteps,
     name = "manager llm"
   }) {
     super({
@@ -1809,6 +1832,11 @@ var Task = class {
     this.context = context;
     this.taskParameters = taskParameters;
   }
+  /**
+   * Run the agents to complete the task
+   *
+   * @returns Result of the task as { text: string }
+   */
   async run() {
     const { prompt, ...otherParams } = this.taskParameters;
     const safePrompt = await this.context.run("Get Prompt", () => prompt);
@@ -1839,6 +1867,29 @@ var WorkflowAgents = class {
   constructor({ context }) {
     this.context = context;
   }
+  /**
+   * Defines an agent
+   *
+   * ```ts
+   * const researcherAgent = context.agents.agent({
+   *   model,
+   *   name: 'academic',
+   *   maxSteps: 2,
+   *   tools: {
+   *     wikiTool: new WikipediaQueryRun({
+   *       topKResults: 1,
+   *       maxDocContentLength: 500,
+   *     })
+   *   },
+   *   background:
+   *     'You are researcher agent with access to Wikipedia. ' +
+   *     'Utilize Wikipedia as much as possible for correct information',
+   * });
+   * ```
+   *
+   * @param params agent parameters
+   * @returns
+   */
   agent(params) {
     const wrappedTools = wrapTools({ context: this.context, tools: params.tools });
     return new Agent({
@@ -1849,6 +1900,9 @@ var WorkflowAgents = class {
   task(taskParameters) {
     return new Task({ context: this.context, taskParameters });
   }
+  /**
+   * creates an openai model for agents
+   */
   openai(...params) {
     const openai2 = createWorkflowOpenAI(this.context);
     return openai2(...params);
@@ -2449,7 +2503,6 @@ var checkIfLastOneIsDuplicate = async (steps, debug) => {
     if (step.stepId === lastStepId && step.targetStep === lastTargetStepId) {
       const message = `Upstash Workflow: The step '${step.stepName}' with id '${step.stepId}'  has run twice during workflow execution. Rest of the workflow will continue running as usual.`;
       await debug?.log("WARN", "RESPONSE_DEFAULT", message);
-      console.log(steps);
       console.warn(message);
       return true;
     }

package/index.mjs

@@ -9,8 +9,7 @@ import {
   makeNotifyRequest,
   serve,
   triggerFirstInvocation
-} from "./chunk-RFX5YRRT.mjs";
-import "./chunk-PU5J4TNC.mjs";
+} from "./chunk-VOM3CFYZ.mjs";
 
 // src/client/index.ts
 import { Client as QStashClient } from "@upstash/qstash";

package/nextjs.d.mts

@@ -1,9 +1,8 @@
 import { NextApiHandler } from 'next';
-import { R as RouteFunction, j as PublicServeOptions } from './types-BEyIoCRe.mjs';
+import { R as RouteFunction, j as PublicServeOptions } from './types-D9gwTj2n.mjs';
 import '@upstash/qstash';
 import 'ai';
 import '@ai-sdk/openai';
-import 'langchain/tools';
 
 /**
  * Serve method to serve a Upstash Workflow in a Nextjs project

package/nextjs.d.ts

@@ -1,9 +1,8 @@
 import { NextApiHandler } from 'next';
-import { R as RouteFunction, j as PublicServeOptions } from './types-BEyIoCRe.js';
+import { R as RouteFunction, j as PublicServeOptions } from './types-D9gwTj2n.js';
 import '@upstash/qstash';
 import 'ai';
 import '@ai-sdk/openai';
-import 'langchain/tools';
 
 /**
  * Serve method to serve a Upstash Workflow in a Nextjs project

package/nextjs.js

@@ -827,29 +827,16 @@ var triggerWorkflowDelete = async (workflowContext, debug, cancel = false) => {
   await debug?.log("SUBMIT", "SUBMIT_CLEANUP", {
     deletedWorkflowRunId: workflowContext.workflowRunId
   });
-  try {
-    await workflowContext.qstashClient.http.request({
-      path: ["v2", "workflows", "runs", `${workflowContext.workflowRunId}?cancel=${cancel}`],
-      method: "DELETE",
-      parseResponseAsJson: false
-    });
-    await debug?.log(
-      "SUBMIT",
-      "SUBMIT_CLEANUP",
-      `workflow run ${workflowContext.workflowRunId} deleted.`
-    );
-    return { deleted: true };
-  } catch (error) {
-    if (error instanceof import_qstash3.QstashError && error.status === 404) {
-      await debug?.log("WARN", "SUBMIT_CLEANUP", {
-        message: `Failed to remove workflow run ${workflowContext.workflowRunId} as it doesn't exist.`,
-        name: error.name,
-        errorMessage: error.message
-      });
-      return { deleted: false };
-    }
-    throw error;
-  }
+  await workflowContext.qstashClient.http.request({
+    path: ["v2", "workflows", "runs", `${workflowContext.workflowRunId}?cancel=${cancel}`],
+    method: "DELETE",
+    parseResponseAsJson: false
+  });
+  await debug?.log(
+    "SUBMIT",
+    "SUBMIT_CLEANUP",
+    `workflow run ${workflowContext.workflowRunId} deleted.`
+  );
 };
 var recreateUserHeaders = (headers) => {
   const filteredHeaders = new Headers();
@@ -1636,7 +1623,22 @@ var WorkflowApi = class extends BaseWorkflowApi {
 // src/agents/adapters.ts
 var import_openai2 = require("@ai-sdk/openai");
 var import_ai = require("ai");
+
+// src/agents/constants.ts
 var AGENT_NAME_HEADER = "upstash-agent-name";
+var MANAGER_AGENT_PROMPT = `You are an agent orchestrating other AI Agents.
+
+These other agents have tools available to them.
+
+Given a prompt, utilize these agents to address requests.
+
+Don't always call all the agents provided to you at the same time. You can call one and use it's response to call another.
+
+Avoid calling the same agent twice in one turn. Instead, prefer to call it once but provide everything
+you need from that agent.
+`;
+
+// src/agents/adapters.ts
 var createWorkflowOpenAI = (context) => {
   return (0, import_openai2.createOpenAI)({
     compatibility: "strict",
@@ -1703,8 +1705,7 @@ var convertLangchainTool = (langchainTool) => {
   return (0, import_ai.tool)({
     description: langchainTool.description,
     parameters: langchainTool.schema,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    execute: async (param) => langchainTool.invoke(param)
+    execute: async (...param) => langchainTool.invoke(...param)
   });
 };
 
@@ -1717,16 +1718,24 @@ var Agent = class {
   maxSteps;
   background;
   model;
-  constructor({ tools, maxSteps, background, name, model }) {
+  temparature;
+  constructor({ tools, maxSteps, background, name, model, temparature = 0.1 }) {
     this.name = name;
     this.tools = tools ?? {};
     this.maxSteps = maxSteps;
     this.background = background;
     this.model = model;
+    this.temparature = temparature;
   }
+  /**
+   * Trigger the agent by passing a prompt
+   *
+   * @param prompt task to assign to the agent
+   * @returns Response as `{ text: string }`
+   */
   async call({ prompt }) {
     try {
-      return await (0, import_ai2.generateText)({
+      const result = await (0, import_ai2.generateText)({
         model: this.model,
         tools: this.tools,
         maxSteps: this.maxSteps,
@@ -1734,8 +1743,10 @@ var Agent = class {
         prompt,
         headers: {
           [AGENT_NAME_HEADER]: this.name
-        }
+        },
+        temperature: this.temparature
       });
+      return { text: result.text };
     } catch (error) {
       if (error instanceof import_ai2.ToolExecutionError) {
         if (error.cause instanceof Error && error.cause.name === "WorkflowAbort") {
@@ -1750,6 +1761,11 @@ var Agent = class {
       }
     }
   }
+  /**
+   * Convert the agent to a tool which can be used by other agents.
+   *
+   * @returns the agent as a tool
+   */
   asTool() {
     const toolDescriptions = Object.values(this.tools).map((tool3) => tool3.description).join("\n");
     return (0, import_ai2.tool)({
@@ -1761,18 +1777,25 @@ var Agent = class {
     });
   }
 };
-var MANAGER_AGENT_PROMPT = `You are an AI agent who orchestrates other AI Agents.
-These other agents have tools available to them.
-Given a prompt, utilize these agents to address requests.
-Don't always call all the agents provided to you at the same time. You can call one and use it's response to call another. 
-`;
 var ManagerAgent = class extends Agent {
   agents;
+  /**
+   * A manager agent which coordinates agents available to it to achieve a
+   * given task
+   *
+   * @param name Name of the agent
+   * @param background Background of the agent. If not passed, default will be used.
+   * @param model LLM model to use
+   * @param agents: List of agents available to the agent
+   * @param maxSteps number of times the manager agent can call the LLM at most.
+   *   If the agent abruptly stops execution after calling other agents, you may
+   *   need to increase maxSteps
+   */
   constructor({
-    maxSteps,
-    background = MANAGER_AGENT_PROMPT,
     agents,
+    background = MANAGER_AGENT_PROMPT,
     model,
+    maxSteps,
     name = "manager llm"
   }) {
     super({
@@ -1797,6 +1820,11 @@ var Task = class {
     this.context = context;
     this.taskParameters = taskParameters;
   }
+  /**
+   * Run the agents to complete the task
+   *
+   * @returns Result of the task as { text: string }
+   */
   async run() {
     const { prompt, ...otherParams } = this.taskParameters;
     const safePrompt = await this.context.run("Get Prompt", () => prompt);
@@ -1827,6 +1855,29 @@ var WorkflowAgents = class {
   constructor({ context }) {
     this.context = context;
   }
+  /**
+   * Defines an agent
+   *
+   * ```ts
+   * const researcherAgent = context.agents.agent({
+   *   model,
+   *   name: 'academic',
+   *   maxSteps: 2,
+   *   tools: {
+   *     wikiTool: new WikipediaQueryRun({
+   *       topKResults: 1,
+   *       maxDocContentLength: 500,
+   *     })
+   *   },
+   *   background:
+   *     'You are researcher agent with access to Wikipedia. ' +
+   *     'Utilize Wikipedia as much as possible for correct information',
+   * });
+   * ```
+   *
+   * @param params agent parameters
+   * @returns
+   */
   agent(params) {
     const wrappedTools = wrapTools({ context: this.context, tools: params.tools });
     return new Agent({
@@ -1837,6 +1888,9 @@ var WorkflowAgents = class {
   task(taskParameters) {
     return new Task({ context: this.context, taskParameters });
   }
+  /**
+   * creates an openai model for agents
+   */
   openai(...params) {
     const openai2 = createWorkflowOpenAI(this.context);
     return openai2(...params);
@@ -2437,7 +2491,6 @@ var checkIfLastOneIsDuplicate = async (steps, debug) => {
     if (step.stepId === lastStepId && step.targetStep === lastTargetStepId) {
       const message = `Upstash Workflow: The step '${step.stepName}' with id '${step.stepId}'  has run twice during workflow execution. Rest of the workflow will continue running as usual.`;
       await debug?.log("WARN", "RESPONSE_DEFAULT", message);
-      console.log(steps);
       console.warn(message);
       return true;
     }

package/nextjs.mjs

@@ -1,8 +1,7 @@
 import {
   SDK_TELEMETRY,
   serveBase
-} from "./chunk-RFX5YRRT.mjs";
-import "./chunk-PU5J4TNC.mjs";
+} from "./chunk-VOM3CFYZ.mjs";
 
 // platforms/nextjs.ts
 var serve = (routeFunction, options) => {

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/workflow","version":"v0.2.5-agents","description":"Durable, Reliable and Performant Serverless Functions","main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"},"./astro":{"import":"./astro.mjs","require":"./astro.js"},"./express":{"import":"./express.mjs","require":"./express.js"},"./agents":{"import":"./agents.mjs","require":"./agents.js"}},"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"repository":{"type":"git","url":"git+https://github.com/upstash/workflow-ts.git"},"keywords":["upstash","qstash","workflow","serverless"],"author":"Cahid Arda Oz","license":"MIT","bugs":{"url":"https://github.com/upstash/workflow-ts/issues"},"homepage":"https://github.com/upstash/workflow-ts#readme","devDependencies":{"@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@eslint/js":"^9.11.1","@solidjs/start":"^1.0.8","@sveltejs/kit":"^2.6.1","@types/bun":"^1.1.10","@types/express":"^5.0.0","astro":"^4.16.7","eslint":"^9.11.1","eslint-plugin-unicorn":"^55.0.0","express":"^4.21.1","globals":"^15.10.0","h3":"^1.12.0","hono":"^4.6.3","husky":"^9.1.6","next":"^14.2.14","prettier":"3.3.3","tsup":"^8.3.0","typescript":"^5.7.2","typescript-eslint":"^8.18.0"},"dependencies":{"@ai-sdk/openai":"^1.0.15","@upstash/qstash":"^2.7.20","ai":"^4.0.30","langchain":"^0.3.11","zod":"^3.24.1"},"directories":{"example":"examples"}}
+{"name":"@upstash/workflow","version":"v0.2.5-agents-2","description":"Durable, Reliable and Performant Serverless Functions","main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"},"./astro":{"import":"./astro.mjs","require":"./astro.js"},"./express":{"import":"./express.mjs","require":"./express.js"}},"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"repository":{"type":"git","url":"git+https://github.com/upstash/workflow-ts.git"},"keywords":["upstash","qstash","workflow","serverless"],"author":"Cahid Arda Oz","license":"MIT","bugs":{"url":"https://github.com/upstash/workflow-ts/issues"},"homepage":"https://github.com/upstash/workflow-ts#readme","devDependencies":{"@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@eslint/js":"^9.11.1","@solidjs/start":"^1.0.8","@sveltejs/kit":"^2.6.1","@types/bun":"^1.1.10","@types/express":"^5.0.0","astro":"^4.16.7","eslint":"^9.11.1","eslint-plugin-unicorn":"^55.0.0","express":"^4.21.1","globals":"^15.10.0","h3":"^1.12.0","hono":"^4.6.3","husky":"^9.1.6","next":"^14.2.14","prettier":"3.3.3","tsup":"^8.3.0","typescript":"^5.7.2","typescript-eslint":"^8.18.0"},"dependencies":{"@ai-sdk/openai":"^1.0.15","@upstash/qstash":"^2.7.20","ai":"^4.0.30","zod":"^3.24.1"},"directories":{"example":"examples"}}

package/solidjs.d.mts

@@ -1,9 +1,8 @@
 import { APIEvent } from '@solidjs/start/server';
-import { R as RouteFunction, j as PublicServeOptions } from './types-BEyIoCRe.mjs';
+import { R as RouteFunction, j as PublicServeOptions } from './types-D9gwTj2n.mjs';
 import '@upstash/qstash';
 import 'ai';
 import '@ai-sdk/openai';
-import 'langchain/tools';
 
 /**
  * Serve method to serve a Upstash Workflow in a Nextjs project

package/solidjs.d.ts

@@ -1,9 +1,8 @@
 import { APIEvent } from '@solidjs/start/server';
-import { R as RouteFunction, j as PublicServeOptions } from './types-BEyIoCRe.js';
+import { R as RouteFunction, j as PublicServeOptions } from './types-D9gwTj2n.js';
 import '@upstash/qstash';
 import 'ai';
 import '@ai-sdk/openai';
-import 'langchain/tools';
 
 /**
  * Serve method to serve a Upstash Workflow in a Nextjs project