@simulacra-ai/core 0.0.6 → 0.0.9

package/README.md

@@ -90,13 +90,29 @@ class WeatherTool {
 
 The workflow engine drives the tool call loop and enables agentic behaviors. The `WorkflowManager` sits on top of the conversation object, managing workflow state and executing tools on the model's behalf, running them in parallel when possible, and feeding results back until the model produces a final response.
 
-The workflow manager emits events throughout its lifecycle, making it possible to observe the full agentic loop.
+### Running a Workflow
+
+`manager.run()` sends a prompt and returns a promise that resolves when the full workflow completes, including all tool execution rounds.
+
+```typescript
+using conversation = new Conversation(provider);
+using manager = new WorkflowManager(conversation);
+
+conversation.toolkit = [WeatherTool];
+
+const result = await manager.run("What's the weather in Tokyo?");
+// result.reason is "complete", "cancel", or "error"
+```
+
+This is different from `conversation.prompt()`, which resolves after a single model response. If the model responds with tool calls, `prompt()` returns after that first response while the workflow continues executing tools in the background. `manager.run()` waits for the entire loop to finish.
+
+### Events
+
+The workflow manager also emits events throughout its lifecycle, making it possible to observe the full agentic loop without `run()`.
 
 ```typescript
-// create a conversation and workflow manager
 using manager = new WorkflowManager(conversation);
 
-// log the final message when the workflow completes
 manager.once("workflow_begin", (workflow) =>
   workflow.once("workflow_end", () => {
     console.log(conversation.messages.at(-1));

package/dist/index.cjs

@@ -599,6 +599,9 @@ var RETRYABLE_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
 var RETRYABLE_HTTP_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504, 529]);
 function defaultRetryable(result) {
   const error = result.error;
+  if (error instanceof OperationCanceledError) {
+    return false;
+  }
   if (error !== null && error !== void 0 && typeof error === "object" && "status" in error) {
     const status = error.status;
     if (typeof status === "number") {
@@ -620,7 +623,7 @@ function defaultRetryable(result) {
   }
   if (error instanceof Error) {
     const msg = error.message.toLowerCase();
-    if (msg.includes("timeout") || msg.includes("econnreset") || msg.includes("econnrefused") || msg.includes("socket hang up") || msg.includes("network error") || msg.includes("fetch failed")) {
+    if (msg.includes("timeout") || msg.includes("econnreset") || msg.includes("econnrefused") || msg.includes("socket hang up") || msg.includes("network error") || msg.includes("fail")) {
       return true;
     }
   }
@@ -666,6 +669,7 @@ var RetryPolicy = class _RetryPolicy extends Policy {
           metadata
         };
       } catch (error) {
+        cancellation_token.throw_if_cancellation_requested();
         metadata.attempts = attempt;
         const result = {
           result: false,
@@ -2160,6 +2164,26 @@ var WorkflowManager = class {
       throw new Error("invalid state");
     }
   }
+  async run(input) {
+    if (this.#state !== "idle") {
+      throw new Error("invalid state");
+    }
+    const workflow_end = new Promise((resolve) => {
+      const handler = (event) => {
+        if (event.event_name === "workflow_end") {
+          this.off("workflow_event", handler);
+          resolve(event.event_args[0]);
+        }
+      };
+      this.on("workflow_event", handler);
+    });
+    if (typeof input === "string") {
+      await this.#conversation.prompt(input);
+    } else {
+      await this.#conversation.send_message(input);
+    }
+    return workflow_end;
+  }
   #on_prompt_send = ({ message }) => {
     if (this.#current_workflow) {
       return;
@@ -2219,8 +2243,8 @@ function defined_keys(obj) {
   return Object.keys(obj).filter((key) => obj[key] !== void 0);
 }
 function undefined_if_empty(obj) {
-  if (!obj) {
-    return obj;
+  if (obj === null || obj === void 0) {
+    return void 0;
   }
   if (Array.isArray(obj)) {
     return obj.length === 0 ? void 0 : obj;