@swirls/looms 0.0.1

package/dist/agent/definitions.js

@@ -0,0 +1,74 @@
+export function normalizeTools(tools = []) {
+    return tools.map((entry) => {
+        if (entry.kind === 'function' || entry.kind === 'thread' || entry.kind === 'effects') {
+            // SAFETY: kind discriminant matches ToolLike.
+            return entry;
+        }
+        return asThreadTool({
+            child: { kind: entry.kind, name: entry.name },
+            description: 'instructions' in entry && entry.instructions
+                ? entry.instructions
+                : 'description' in entry && entry.description
+                    ? entry.description
+                    : entry.name,
+            input: 'input' in entry ? entry.input : undefined,
+        });
+    });
+}
+export function defineTool(def) {
+    // SAFETY: factory fields match FunctionTool.
+    return { kind: 'function', ...def, input: def.input };
+}
+export function defineAgent(def) {
+    // SAFETY: factory fields match AgentDefinition.
+    return {
+        kind: 'agent',
+        ...def,
+        input: def.input,
+        tools: def.tools ? normalizeTools(def.tools) : undefined,
+    };
+}
+export function asThreadTool(def) {
+    return {
+        kind: 'thread',
+        name: def.name ?? def.child.name,
+        description: def.description ?? def.child.name,
+        input: def.input,
+        inputSchema: def.inputSchema,
+        childKind: def.child.kind,
+        childName: def.child.name,
+        child: def.child,
+        mapInput: def.mapInput,
+    };
+}
+export function asAgentTool(def) {
+    return asThreadTool({
+        name: def.name,
+        description: def.description ?? def.agent.instructions,
+        input: def.input ?? def.agent.input,
+        inputSchema: def.inputSchema ?? def.agent.inputSchema,
+        child: { kind: 'agent', name: def.agent.name },
+        mapInput: def.mapInput,
+    });
+}
+export function asWorkflowTool(def) {
+    return asThreadTool({
+        name: def.name,
+        description: def.description ?? def.workflow.description,
+        input: def.input ?? def.workflow.input,
+        inputSchema: def.inputSchema ?? def.workflow.inputSchema,
+        child: { kind: 'workflow', name: def.workflow.name },
+        mapInput: def.mapInput,
+    });
+}
+export function asEffectsTool(def) {
+    return {
+        kind: 'effects',
+        name: def.name,
+        description: def.description,
+        input: def.input,
+        inputSchema: def.inputSchema,
+        effects: def.effects,
+        waitOn: def.waitOn,
+    };
+}

package/dist/agent/effects.d.ts

@@ -0,0 +1,425 @@
+import { Schema } from 'effect';
+import { type JsonValue } from '@swirls/looms/core';
+import { AgentDefinitionsTag } from './definitions-store';
+import { LlmTag } from './llm';
+import { type ToolCall } from './types';
+export declare const callLlmEffect: NoInfer<import("@swirls/looms/core").EffectDefinition<{
+    readonly turn: number;
+    readonly definitionName?: string | undefined;
+    readonly messages?: readonly {
+        readonly role: "assistant" | "system" | "tool" | "user";
+        readonly content: string;
+        readonly toolCallId?: string | undefined;
+        readonly name?: string | undefined;
+        readonly toolCalls?: {
+            readonly id: string;
+            readonly name: string;
+            readonly arguments: Schema.Json;
+        }[] | undefined;
+    }[] | undefined;
+    readonly input?: Schema.Json | undefined;
+}, AgentDefinitionsTag | LlmTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.effects.requested";
+    readonly payload: {
+        readonly toolCallId: string;
+        readonly effects: readonly import("@swirls/looms/core").RuntimeEffect[];
+        readonly waitOn?: {
+            readonly type: string | readonly string[];
+            readonly match?: Schema.Json | undefined;
+        } | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.message";
+    readonly payload: {
+        readonly turn: number;
+        readonly message: {
+            readonly role: "assistant" | "system" | "tool" | "user";
+            readonly content: string;
+            readonly toolCallId?: string | undefined;
+            readonly name?: string | undefined;
+            readonly toolCalls?: {
+                readonly id: string;
+                readonly name: string;
+                readonly arguments: Schema.Json;
+            }[] | undefined;
+        };
+        readonly usage?: {
+            readonly input: number;
+            readonly output: number;
+        } | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.message.received";
+    readonly payload: {
+        readonly message: {
+            readonly role: "assistant" | "system" | "tool" | "user";
+            readonly content: string;
+            readonly toolCallId?: string | undefined;
+            readonly name?: string | undefined;
+            readonly toolCalls?: {
+                readonly id: string;
+                readonly name: string;
+                readonly arguments: Schema.Json;
+            }[] | undefined;
+        };
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.spawn.requested";
+    readonly payload: {
+        readonly childThreadId: string;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly toolCallId: string;
+        readonly input: Schema.Json;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.steered";
+    readonly payload: {
+        readonly turn: number;
+        readonly message: {
+            readonly role: "assistant" | "system" | "tool" | "user";
+            readonly content: string;
+            readonly toolCallId?: string | undefined;
+            readonly name?: string | undefined;
+            readonly toolCalls?: {
+                readonly id: string;
+                readonly name: string;
+                readonly arguments: Schema.Json;
+            }[] | undefined;
+        };
+        readonly interrupt?: boolean | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.tool.result";
+    readonly payload: {
+        readonly turn: number;
+        readonly toolCallId: string;
+        readonly name: string;
+        readonly result: Schema.Json;
+        readonly error: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.tool_call.requested";
+    readonly payload: {
+        readonly turn: number;
+        readonly toolCall: {
+            readonly id: string;
+            readonly name: string;
+            readonly arguments: Schema.Json;
+        };
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.turn.started";
+    readonly payload: {
+        readonly turn: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.turn.text_delta";
+    readonly payload: {
+        readonly turn: number;
+        readonly delta: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.failed";
+    readonly payload: {
+        readonly effectId: string;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.completed";
+    readonly payload: {
+        readonly output: Schema.Json;
+        readonly error: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.started";
+    readonly payload: {
+        readonly rootThreadId?: string | undefined;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly input: Schema.Json;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.signal.received";
+    readonly payload: {
+        readonly signalType: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.snapshot.taken";
+    readonly payload: {
+        readonly seq: number;
+        readonly stateHash: string;
+        readonly state?: Schema.Json | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.cancelled";
+    readonly payload: {
+        readonly threadId: string;
+        readonly reason?: string | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.completed";
+    readonly payload: {
+        readonly threadId: string;
+        readonly output: Schema.Json;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.failed";
+    readonly payload: {
+        readonly threadId: string;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.started";
+    readonly payload: {
+        readonly threadId: string;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly input: Schema.Json;
+        readonly parentThreadId: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.timer.fired";
+    readonly payload: {
+        readonly timerId: string;
+        readonly waitId: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.timer.set";
+    readonly payload: {
+        readonly timerId: string;
+        readonly waitId: string;
+        readonly wakeAt: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.wait.registered";
+    readonly payload: {
+        readonly waitId: string;
+        readonly threadId?: string | undefined;
+        readonly on: {
+            readonly type: string | readonly string[];
+            readonly match?: Schema.Json | undefined;
+        } | {
+            readonly timerAt: number;
+        };
+        readonly tag?: Schema.Json | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.wait.satisfied";
+    readonly payload: {
+        readonly waitId: string;
+        readonly tag?: Schema.Json | undefined;
+        readonly event: {
+            readonly id: string;
+            readonly type: string;
+            readonly payload: Schema.Json;
+        };
+    };
+})>>;
+export declare const executeToolEffect: NoInfer<import("@swirls/looms/core").EffectDefinition<{
+    readonly turn: number;
+    readonly definitionName?: string | undefined;
+    readonly toolCall: {
+        readonly id: string;
+        readonly name: string;
+        readonly arguments: Schema.Json;
+    };
+}, AgentDefinitionsTag, (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.effects.requested";
+    readonly payload: {
+        readonly toolCallId: string;
+        readonly effects: readonly import("@swirls/looms/core").RuntimeEffect[];
+        readonly waitOn?: {
+            readonly type: string | readonly string[];
+            readonly match?: Schema.Json | undefined;
+        } | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.message";
+    readonly payload: {
+        readonly turn: number;
+        readonly message: {
+            readonly role: "assistant" | "system" | "tool" | "user";
+            readonly content: string;
+            readonly toolCallId?: string | undefined;
+            readonly name?: string | undefined;
+            readonly toolCalls?: {
+                readonly id: string;
+                readonly name: string;
+                readonly arguments: Schema.Json;
+            }[] | undefined;
+        };
+        readonly usage?: {
+            readonly input: number;
+            readonly output: number;
+        } | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.message.received";
+    readonly payload: {
+        readonly message: {
+            readonly role: "assistant" | "system" | "tool" | "user";
+            readonly content: string;
+            readonly toolCallId?: string | undefined;
+            readonly name?: string | undefined;
+            readonly toolCalls?: {
+                readonly id: string;
+                readonly name: string;
+                readonly arguments: Schema.Json;
+            }[] | undefined;
+        };
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.spawn.requested";
+    readonly payload: {
+        readonly childThreadId: string;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly toolCallId: string;
+        readonly input: Schema.Json;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.steered";
+    readonly payload: {
+        readonly turn: number;
+        readonly message: {
+            readonly role: "assistant" | "system" | "tool" | "user";
+            readonly content: string;
+            readonly toolCallId?: string | undefined;
+            readonly name?: string | undefined;
+            readonly toolCalls?: {
+                readonly id: string;
+                readonly name: string;
+                readonly arguments: Schema.Json;
+            }[] | undefined;
+        };
+        readonly interrupt?: boolean | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.tool.result";
+    readonly payload: {
+        readonly turn: number;
+        readonly toolCallId: string;
+        readonly name: string;
+        readonly result: Schema.Json;
+        readonly error: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.tool_call.requested";
+    readonly payload: {
+        readonly turn: number;
+        readonly toolCall: {
+            readonly id: string;
+            readonly name: string;
+            readonly arguments: Schema.Json;
+        };
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.turn.started";
+    readonly payload: {
+        readonly turn: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "agent.turn.text_delta";
+    readonly payload: {
+        readonly turn: number;
+        readonly delta: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.effect.failed";
+    readonly payload: {
+        readonly effectId: string;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.completed";
+    readonly payload: {
+        readonly output: Schema.Json;
+        readonly error: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.run.started";
+    readonly payload: {
+        readonly rootThreadId?: string | undefined;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly input: Schema.Json;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.signal.received";
+    readonly payload: {
+        readonly signalType: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.snapshot.taken";
+    readonly payload: {
+        readonly seq: number;
+        readonly stateHash: string;
+        readonly state?: Schema.Json | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.cancelled";
+    readonly payload: {
+        readonly threadId: string;
+        readonly reason?: string | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.completed";
+    readonly payload: {
+        readonly threadId: string;
+        readonly output: Schema.Json;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.failed";
+    readonly payload: {
+        readonly threadId: string;
+        readonly error: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.thread.started";
+    readonly payload: {
+        readonly threadId: string;
+        readonly kind: string;
+        readonly definitionName: string;
+        readonly input: Schema.Json;
+        readonly parentThreadId: string | null;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.timer.fired";
+    readonly payload: {
+        readonly timerId: string;
+        readonly waitId: string;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.timer.set";
+    readonly payload: {
+        readonly timerId: string;
+        readonly waitId: string;
+        readonly wakeAt: number;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.wait.registered";
+    readonly payload: {
+        readonly waitId: string;
+        readonly threadId?: string | undefined;
+        readonly on: {
+            readonly type: string | readonly string[];
+            readonly match?: Schema.Json | undefined;
+        } | {
+            readonly timerAt: number;
+        };
+        readonly tag?: Schema.Json | undefined;
+    };
+}) | (Omit<import("@swirls/looms/core").EventInput, "payload" | "type"> & {
+    readonly type: "runtime.wait.satisfied";
+    readonly payload: {
+        readonly waitId: string;
+        readonly tag?: Schema.Json | undefined;
+        readonly event: {
+            readonly id: string;
+            readonly type: string;
+            readonly payload: Schema.Json;
+        };
+    };
+})>>;
+export declare function readToolCall(value: JsonValue): ToolCall | null;