@simulacra-ai/core 0.0.1

package/dist/workflows/workflow-manager.d.ts

@@ -0,0 +1,74 @@
+import { Conversation } from "../conversations/index.ts";
+import { WorkflowManagerEvents, WorkflowState } from "./types.ts";
+import { Workflow } from "./workflow.ts";
+/**
+ * Automatically manages workflow lifecycle for a conversation.
+ *
+ * The WorkflowManager creates a new Workflow instance whenever a message is sent
+ * to its associated conversation, eliminating the need for manual workflow management.
+ */
+export declare class WorkflowManager {
+    #private;
+    /**
+     * Creates a new workflow manager instance.
+     *
+     * @param conversation - The conversation to manage workflows for.
+     * @param options - Optional configuration.
+     * @param options.context_data - Custom data to pass to tools via ToolContext.
+     */
+    constructor(conversation: Conversation, options?: {
+        context_data?: Record<string, unknown>;
+    });
+    /**
+     * The current state of the workflow manager.
+     */
+    get state(): WorkflowState;
+    /**
+     * The conversation being managed.
+     */
+    get conversation(): Conversation;
+    /**
+     * The currently active workflow, if any.
+     */
+    get current_workflow(): Workflow | undefined;
+    /**
+     * Disposes the workflow manager and releases all resources.
+     *
+     * This method is called automatically when using the `using` keyword.
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Registers a one-time event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event to listen for.
+     * @param listener - The callback function to invoke when the event occurs.
+     * @returns This workflow manager instance for chaining.
+     */
+    once<E extends keyof WorkflowManagerEvents>(event: E, listener: E extends keyof WorkflowManagerEvents ? (...args: WorkflowManagerEvents[E]) => void : never): this;
+    /**
+     * Registers a persistent event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event to listen for.
+     * @param listener - The callback function to invoke when the event occurs.
+     * @returns This workflow manager instance for chaining.
+     */
+    on<E extends keyof WorkflowManagerEvents>(event: E, listener: E extends keyof WorkflowManagerEvents ? (...args: WorkflowManagerEvents[E]) => void : never): this;
+    /**
+     * Removes an event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event.
+     * @param listener - The callback function to remove.
+     * @returns This workflow manager instance for chaining.
+     */
+    off<E extends keyof WorkflowManagerEvents>(event: E, listener: E extends keyof WorkflowManagerEvents ? (...args: WorkflowManagerEvents[E]) => void : never): this;
+    /**
+     * Manually starts a workflow.
+     *
+     * This is typically not needed as workflows are started automatically when messages are sent.
+     */
+    start_workflow(): void;
+}
+//# sourceMappingURL=workflow-manager.d.ts.map

package/dist/workflows/workflow-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-manager.d.ts","sourceRoot":"","sources":["../../src/workflows/workflow-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAkB,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;;GAKG;AACH,qBAAa,eAAe;;IAQ1B;;;;;;OAMG;gBACS,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAS5F;;OAEG;IACH,IAAI,KAAK,kBAER;IAED;;OAEG;IACH,IAAI,YAAY,iBAEf;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,QAAQ,GAAG,SAAS,CAE3C;IAED;;;;OAIG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;IAUhB;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACxC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,SAAS,MAAM,qBAAqB,GAC3C,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,KAAK,GACR,IAAI;IASP;;;;;;;OAOG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,SAAS,MAAM,qBAAqB,GAC3C,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,KAAK,GACR,IAAI;IASP;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACvC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,SAAS,MAAM,qBAAqB,GAC3C,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,KAAK,GACR,IAAI;IAMP;;;;OAIG;IACH,cAAc;CAmEf"}

package/dist/workflows/workflow-manager.js

@@ -0,0 +1,165 @@
+import { EventEmitter } from "node:events";
+import { setImmediate } from "node:timers/promises";
+import { Workflow } from "./workflow.js";
+/**
+ * Automatically manages workflow lifecycle for a conversation.
+ *
+ * The WorkflowManager creates a new Workflow instance whenever a message is sent
+ * to its associated conversation, eliminating the need for manual workflow management.
+ */
+export class WorkflowManager {
+    #event_emitter = new EventEmitter();
+    #conversation;
+    #context_data;
+    #state = "idle";
+    #current_workflow;
+    /**
+     * Creates a new workflow manager instance.
+     *
+     * @param conversation - The conversation to manage workflows for.
+     * @param options - Optional configuration.
+     * @param options.context_data - Custom data to pass to tools via ToolContext.
+     */
+    constructor(conversation, options) {
+        this.#conversation = conversation;
+        this.#context_data = options?.context_data ?? {};
+        this.#conversation.on("prompt_send", this.#on_prompt_send);
+        this.#conversation.on("checkpoint_begin", this.#on_checkpoint_begin);
+        this.#conversation.once("dispose", this.#on_conversation_dispose);
+    }
+    /**
+     * The current state of the workflow manager.
+     */
+    get state() {
+        return this.#state;
+    }
+    /**
+     * The conversation being managed.
+     */
+    get conversation() {
+        return this.#conversation;
+    }
+    /**
+     * The currently active workflow, if any.
+     */
+    get current_workflow() {
+        return this.#current_workflow;
+    }
+    /**
+     * Disposes the workflow manager and releases all resources.
+     *
+     * This method is called automatically when using the `using` keyword.
+     */
+    [Symbol.dispose]() {
+        this.#conversation.off("prompt_send", this.#on_prompt_send);
+        this.#conversation.off("checkpoint_begin", this.#on_checkpoint_begin);
+        this.#conversation.off("dispose", this.#on_conversation_dispose);
+        this.#event_emitter.emit("dispose", this);
+        this.#set_state("disposed");
+        this.#event_emitter.removeAllListeners();
+    }
+    /**
+     * Registers a one-time event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event to listen for.
+     * @param listener - The callback function to invoke when the event occurs.
+     * @returns This workflow manager instance for chaining.
+     */
+    once(event, listener) {
+        if (this.#state === "disposed") {
+            throw new Error("invalid state");
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.#event_emitter.once(event, listener);
+        return this;
+    }
+    /**
+     * Registers a persistent event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event to listen for.
+     * @param listener - The callback function to invoke when the event occurs.
+     * @returns This workflow manager instance for chaining.
+     */
+    on(event, listener) {
+        if (this.#state === "disposed") {
+            throw new Error("invalid state");
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.#event_emitter.on(event, listener);
+        return this;
+    }
+    /**
+     * Removes an event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event.
+     * @param listener - The callback function to remove.
+     * @returns This workflow manager instance for chaining.
+     */
+    off(event, listener) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.#event_emitter.off(event, listener);
+        return this;
+    }
+    /**
+     * Manually starts a workflow.
+     *
+     * This is typically not needed as workflows are started automatically when messages are sent.
+     */
+    start_workflow() {
+        if (this.#state !== "idle") {
+            throw new Error("invalid state");
+        }
+    }
+    #on_prompt_send = ({ message }) => {
+        if (this.#current_workflow) {
+            return;
+        }
+        this.#current_workflow = new Workflow(this.#conversation, { context_data: this.#context_data });
+        this.#attach_workflow_event(this.#current_workflow, "state_change");
+        this.#attach_workflow_event(this.#current_workflow, "workflow_update");
+        this.#attach_workflow_event(this.#current_workflow, "workflow_end");
+        this.#attach_workflow_event(this.#current_workflow, "child_workflow_begin");
+        this.#attach_workflow_event(this.#current_workflow, "child_workflow_event");
+        this.#attach_workflow_event(this.#current_workflow, "message_queued");
+        this.#attach_workflow_event(this.#current_workflow, "message_dequeued");
+        this.#attach_workflow_event(this.#current_workflow, "queue_cleared");
+        this.#attach_workflow_event(this.#current_workflow, "lifecycle_error");
+        this.#attach_workflow_event(this.#current_workflow, "dispose");
+        this.#current_workflow.once("dispose", () => {
+            this.#current_workflow = undefined;
+            this.#set_state("idle");
+        });
+        this.#set_state("busy");
+        this.#event_emitter.emit("workflow_begin", this.#current_workflow, this);
+        this.#current_workflow.start(message);
+    };
+    #set_state(state) {
+        if (this.#state === state) {
+            return;
+        }
+        const previous = this.state;
+        this.#state = state;
+        this.#event_emitter.emit("state_change", { previous, current: this.#state }, this);
+    }
+    #attach_workflow_event(workflow, event_name) {
+        const handler = (...args) => {
+            this.#event_emitter.emit("workflow_event", {
+                event_name,
+                event_args: args,
+            }, this);
+        };
+        workflow.on(event_name, handler);
+        workflow.once("dispose", () => setImmediate(() => workflow.off(event_name, handler)));
+    }
+    #on_checkpoint_begin = (child) => {
+        this.#set_state("busy");
+        child.once("dispose", () => {
+            this.#set_state("idle");
+        });
+    };
+    #on_conversation_dispose = () => this[Symbol.dispose]();
+}
+//# sourceMappingURL=workflow-manager.js.map

package/dist/workflows/workflow-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-manager.js","sourceRoot":"","sources":["../../src/workflows/workflow-manager.ts"],"names":[],"mappings":"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"}

package/dist/workflows/workflow.d.ts

@@ -0,0 +1,116 @@
+import { Conversation, Message } from "../conversations/index.ts";
+import { WorkflowEvents } from "./types.ts";
+import { WorkflowState } from "./index.ts";
+import { UserMessage } from "../conversations/types.ts";
+/**
+ * Manages an agentic workflow with automatic tool execution.
+ *
+ * A Workflow wraps a Conversation and automatically executes tools requested
+ * by the model, continuing the conversation until completion or error.
+ */
+export declare class Workflow {
+    #private;
+    /**
+     * Creates a new workflow instance.
+     *
+     * @param conversation - The conversation to manage.
+     * @param options - Optional configuration.
+     * @param options.context_data - Custom data to pass to tools via ToolContext.
+     * @param options.parent - Parent workflow if this is a child workflow.
+     */
+    constructor(conversation: Conversation, options?: {
+        context_data?: Record<string, unknown>;
+        parent?: Workflow;
+    });
+    /**
+     * The unique identifier for this workflow.
+     */
+    get id(): string;
+    set id(value: string);
+    /**
+     * The current state of the workflow.
+     */
+    get state(): WorkflowState;
+    /**
+     * The conversation being managed by this workflow.
+     */
+    get conversation(): Conversation;
+    /**
+     * The parent workflow, if this is a child workflow.
+     */
+    get parent(): Workflow | undefined;
+    /**
+     * The message history tracked by this workflow.
+     */
+    get messages(): readonly Readonly<Message>[];
+    /**
+     * Messages queued for sending after the current response completes.
+     */
+    get queued_messages(): string[];
+    /**
+     * Disposes the workflow and releases all resources.
+     *
+     * This method is called automatically when using the `using` keyword.
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Registers a one-time event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event to listen for.
+     * @param listener - The callback function to invoke when the event occurs.
+     * @returns This workflow instance for chaining.
+     */
+    once<E extends keyof WorkflowEvents>(event: E, listener: E extends keyof WorkflowEvents ? (...args: WorkflowEvents[E]) => void : never): this;
+    /**
+     * Registers a persistent event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event to listen for.
+     * @param listener - The callback function to invoke when the event occurs.
+     * @returns This workflow instance for chaining.
+     */
+    on<E extends keyof WorkflowEvents>(event: E, listener: E extends keyof WorkflowEvents ? (...args: WorkflowEvents[E]) => void : never): this;
+    /**
+     * Removes an event listener.
+     *
+     * @template E - The event name type.
+     * @param event - The name of the event.
+     * @param listener - The callback function to remove.
+     * @returns This workflow instance for chaining.
+     */
+    off<E extends keyof WorkflowEvents>(event: E, listener: E extends keyof WorkflowEvents ? (...args: WorkflowEvents[E]) => void : never): this;
+    /**
+     * Starts the workflow execution.
+     *
+     * @param message - Optional initial user message to begin the workflow.
+     */
+    start(message?: UserMessage): void;
+    /**
+     * Cancels the workflow execution.
+     *
+     * This will cancel any in-progress model response and emit a workflow_end event.
+     */
+    cancel(): void;
+    /**
+     * Creates a child workflow with a different conversation.
+     *
+     * Child events are propagated to the parent as "child_workflow_event" events.
+     *
+     * @param conversation - The conversation for the child workflow.
+     * @param id - Optional custom ID for the child workflow.
+     * @returns The newly created child workflow.
+     */
+    spawn_child(conversation: Conversation, id?: string): Workflow;
+    /**
+     * Adds a message to the queue for sending after the current response completes.
+     *
+     * @param message - The text message to queue.
+     */
+    queue_message(message: string): void;
+    /**
+     * Clears all queued messages.
+     */
+    clear_queue(): void;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflows/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/workflows/workflow.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,YAAY,EAEZ,OAAO,EAGR,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAoB,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,QAAQ;;IAYnB;;;;;;;OAOG;gBAED,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAE;IAgBzE;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IACD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAEnB;IAED;;OAEG;IACH,IAAI,KAAK,kBAER;IAED;;OAEG;IACH,IAAI,YAAY,iBAEf;IAED;;OAEG;IACH,IAAI,MAAM,yBAET;IAED;;OAEG;IACH,IAAI,QAAQ,iCAEX;IAED;;OAEG;IACH,IAAI,eAAe,aAElB;IAED;;;;OAIG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;IAYhB;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,cAAc,EACjC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,SAAS,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,KAAK,GACtF,IAAI;IASP;;;;;;;OAOG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,SAAS,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,KAAK,GACtF,IAAI;IASP;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAChC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,SAAS,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,KAAK,GACtF,IAAI;IAMP;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW;IAW3B;;;;OAIG;IACH,MAAM;IAeN;;;;;;;;OAQG;IACH,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,MAAM;IAyBnD;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM;IAQ7B;;OAEG;IACH,WAAW;CAiKZ"}