shrimsource 0.1.0

package/README.md

@@ -0,0 +1,178 @@
+# Shrimsource
+
+**Build AI agents in minutes.**
+
+Shrimsource is a tiny open-source runtime for building agent workflows with tools, plugins, and templates.
+
+It is designed for developers who want the fastest path from idea to a working AI agent.
+
+---
+
+## Two commands to your first agent
+
+```bash
+npx create-aquarium research-agent
+npm run agent
+```
+
+Create a working agent project from a template, then run it instantly.
+
+---
+
+## What is Shrimsource?
+
+Shrimsource is a minimal runtime for building AI agents.
+
+It helps developers:
+
+- create agents
+- define workflows
+- run workflows
+- register plugins
+- use tools
+
+Aquarium is intentionally small.  
+The goal is to make building and running agents extremely simple.
+
+---
+
+## Core API
+
+Shrimsource exposes only five core functions:
+
+```
+createAgent()
+createWorkflow()
+runWorkflow()
+registerPlugin()
+useTool()
+```
+
+That's the whole mental model.
+
+---
+
+## Example: Company Research Agent
+
+Input:
+
+```
+stripe.com
+```
+
+Workflow:
+
+```
+1. research company
+2. analyze product
+3. summarize business model
+4. generate report
+```
+
+Output:
+
+```
+Company: Stripe
+
+Industry: Fintech
+Core Product: Online payment infrastructure
+
+Key offerings:
+- Payment processing
+- Billing
+- Marketplace infrastructure
+
+Summary:
+Stripe provides developer-first financial infrastructure for internet businesses.
+```
+
+This entire workflow can be created and run with Aquarium.
+
+---
+
+## Why Aquarium?
+
+Shrimsource focuses on developer experience.
+
+- **Tiny core**  
+  No framework monster.
+
+- **Fast start**  
+  Create a working agent with one command.
+
+- **Template-first**  
+  Download real working workflows instantly.
+
+- **Extensible**  
+  Add tools and plugins easily.
+
+- **Open ecosystem**  
+  Built for future developer ecosystems.
+
+---
+
+## Repositories
+
+Aquarium Source is organized into multiple repositories.
+
+```
+aquarium-core
+→ tiny runtime for agent workflows
+
+aquarium-templates
+→ ready-to-run agent templates
+
+awesome-aquarium
+→ curated ecosystem resources
+```
+
+---
+
+## Developer Path
+
+Typical developer workflow:
+
+```
+1. Pick a template
+2. Create your agent project
+3. Run it instantly
+4. Modify the workflow
+5. Build your own agent
+```
+
+Aquarium aims to reduce the time from idea to working agent to minutes.
+
+---
+
+## Philosophy
+
+Shrimsource is intentionally minimal.
+
+Instead of building a huge framework, Aquarium focuses on:
+
+- a tiny runtime
+- simple workflows
+- instant templates
+- fast experimentation
+
+The ecosystem can grow later through templates, tools, and plugins.
+
+---
+
+## Status
+
+Shrimsource is in early development.
+
+The project focuses on:
+
+- core runtime stability
+- developer experience
+- template ecosystem
+
+Contributions and feedback are welcome.
+
+---
+
+## License
+
+MIT License

package/dist/agent.d.ts

@@ -0,0 +1,3 @@
+import { Agent, RuntimeHooks } from "./types";
+export declare function createAgent(hooks?: RuntimeHooks): Agent;
+//# 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":"AACA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE7C,wBAAgB,WAAW,CAAC,KAAK,GAAE,YAAiB,GAAG,KAAK,CAO3D"}

package/dist/agent.js

@@ -0,0 +1,10 @@
+import { createMemory } from "./memory";
+export function createAgent(hooks = {}) {
+    return {
+        tools: new Map(),
+        memory: createMemory(),
+        plugins: new Set(),
+        hooks
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,MAAM,UAAU,WAAW,CAAC,QAAsB,EAAE;IAChD,OAAO;QACH,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,MAAM,EAAE,YAAY,EAAE;QACtB,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,KAAK;KACR,CAAA;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createAgent } from "./agent";
+export { createWorkflow } from "./workflow";
+export { runWorkflow } from "./runtime";
+export { registerPlugin } from "./plugin";
+export { useTool } from "./tool";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAEhC,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createAgent } from "./agent";
+export { createWorkflow } from "./workflow";
+export { runWorkflow } from "./runtime";
+export { registerPlugin } from "./plugin";
+export { useTool } from "./tool";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAEhC,cAAc,SAAS,CAAA"}

package/dist/memory.d.ts

@@ -0,0 +1,3 @@
+import { AgentMemory } from "./types";
+export declare function createMemory(): AgentMemory;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,wBAAgB,YAAY,IAAI,WAAW,CAE1C"}

package/dist/memory.js

@@ -0,0 +1,4 @@
+export function createMemory() {
+    return new Map();
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY;IACxB,OAAO,IAAI,GAAG,EAAmB,CAAA;AACrC,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,3 @@
+import { Agent, Plugin } from "./types";
+export declare function registerPlugin(agent: Agent, plugin: Plugin): Agent;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEvC,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAYlE"}

package/dist/plugin.js

@@ -0,0 +1,11 @@
+export function registerPlugin(agent, plugin) {
+    if (agent.plugins.has(plugin.name)) {
+        return agent;
+    }
+    agent.plugins.add(plugin.name);
+    for (const tool of plugin.tools ?? []) {
+        agent.tools.set(tool.name, tool);
+    }
+    return agent;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,MAAc;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,3 @@
+import { Agent, RunWorkflowOptions, Workflow, WorkflowRunResult } from "./types";
+export declare function runWorkflow(agent: Agent, workflow: Workflow, input: unknown, options?: RunWorkflowOptions): Promise<WorkflowRunResult>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EACL,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EAEpB,MAAM,SAAS,CAAA;AAkEhB,wBAAsB,WAAW,CAC7B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CA4D5B"}

package/dist/runtime.js

@@ -0,0 +1,87 @@
+import { retry, withTimeout } from "./utils";
+function canRunStep(step, completed) {
+    return (step.dependsOn ?? []).every((dep) => completed.has(dep));
+}
+async function executeStep(agent, workflow, step, state) {
+    const tool = agent.tools.get(step.tool);
+    if (!tool) {
+        throw new Error(`Tool not found: ${step.tool}`);
+    }
+    await agent.hooks.onStepStart?.({
+        workflowId: workflow.id,
+        stepId: step.id,
+        tool: step.tool
+    });
+    try {
+        const result = await retry(() => withTimeout(tool.run({
+            input: step.input ?? state,
+            state,
+            memory: agent.memory,
+            stepId: step.id,
+            workflowId: workflow.id
+        }), step.timeoutMs), step.retry ?? 0);
+        state[step.id] = result;
+        await agent.hooks.onStepEnd?.({
+            workflowId: workflow.id,
+            stepId: step.id,
+            tool: step.tool,
+            result
+        });
+        return result;
+    }
+    catch (error) {
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        await agent.hooks.onStepError?.({
+            workflowId: workflow.id,
+            stepId: step.id,
+            tool: step.tool,
+            error: normalized
+        });
+        throw normalized;
+    }
+}
+export async function runWorkflow(agent, workflow, input, options = {}) {
+    const state = {
+        input,
+        ...(options.state ?? {})
+    };
+    const completed = new Set();
+    const pending = new Map(workflow.steps.map((step) => [step.id, step]));
+    await agent.hooks.onWorkflowStart?.({
+        workflowId: workflow.id
+    });
+    while (pending.size > 0) {
+        const runnable = [];
+        for (const step of pending.values()) {
+            if (canRunStep(step, completed)) {
+                runnable.push(step);
+            }
+        }
+        if (runnable.length === 0) {
+            throw new Error("Workflow deadlock detected. Check dependsOn relationships.");
+        }
+        const parallelSteps = runnable.filter((step) => step.parallel);
+        const sequentialSteps = runnable.filter((step) => !step.parallel);
+        for (const step of sequentialSteps) {
+            await executeStep(agent, workflow, step, state);
+            completed.add(step.id);
+            pending.delete(step.id);
+        }
+        if (parallelSteps.length > 0) {
+            await Promise.all(parallelSteps.map((step) => executeStep(agent, workflow, step, state)));
+            for (const step of parallelSteps) {
+                completed.add(step.id);
+                pending.delete(step.id);
+            }
+        }
+    }
+    await agent.hooks.onWorkflowEnd?.({
+        workflowId: workflow.id
+    });
+    return {
+        workflowId: workflow.id,
+        state,
+        completedSteps: [...completed]
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,3 @@
+import { Agent, Tool } from "./types";
+export declare function useTool(agent: Agent, tool: Tool): Agent;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAErC,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,KAAK,CAGvD"}

package/dist/tool.js

@@ -0,0 +1,5 @@
+export function useTool(agent, tool) {
+    agent.tools.set(tool.name, tool);
+    return agent;
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,OAAO,CAAC,KAAY,EAAE,IAAU;IAC5C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAChC,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type AgentState = Record<string, unknown>;
+export type AgentMemory = Map<string, unknown>;
+export type ToolContext = {
+    input: unknown;
+    state: AgentState;
+    memory: AgentMemory;
+    stepId: string;
+    workflowId: string;
+};
+export type ToolResult = unknown;
+export type Tool = {
+    name: string;
+    description?: string;
+    run: (ctx: ToolContext) => Promise<ToolResult>;
+};
+export type Plugin = {
+    name: string;
+    version?: string;
+    tools?: Tool[];
+};
+export type WorkflowStep = {
+    id: string;
+    tool: string;
+    input?: unknown;
+    parallel?: boolean;
+    dependsOn?: string[];
+    retry?: number;
+    timeoutMs?: number;
+};
+export type Workflow = {
+    id: string;
+    steps: WorkflowStep[];
+};
+export type RuntimeHookPayload = {
+    workflowId: string;
+    stepId?: string;
+    tool?: string;
+    error?: Error;
+    result?: unknown;
+};
+export type RuntimeHooks = {
+    onWorkflowStart?: (payload: RuntimeHookPayload) => void | Promise<void>;
+    onWorkflowEnd?: (payload: RuntimeHookPayload) => void | Promise<void>;
+    onStepStart?: (payload: RuntimeHookPayload) => void | Promise<void>;
+    onStepEnd?: (payload: RuntimeHookPayload) => void | Promise<void>;
+    onStepError?: (payload: RuntimeHookPayload) => void | Promise<void>;
+};
+export type Agent = {
+    tools: Map<string, Tool>;
+    memory: AgentMemory;
+    plugins: Set<string>;
+    hooks: RuntimeHooks;
+};
+export type RunWorkflowOptions = {
+    state?: AgentState;
+};
+export type WorkflowRunResult = {
+    workflowId: string;
+    state: AgentState;
+    completedSteps: string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACf,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAElC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE9C,MAAM,MAAM,WAAW,GAAG;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,CAAA;AAEhC,MAAM,MAAM,IAAI,GAAG;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtE,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACxB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,KAAK,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,CAAC,EAAE,UAAU,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,UAAU,CAAA;IACjB,cAAc,EAAE,MAAM,EAAE,CAAA;CAC3B,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs?: number): Promise<T>;
+export declare function retry<T>(fn: () => Promise<T>, retryCount: number): Promise<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAsB,WAAW,CAAC,CAAC,EAC/B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED,wBAAsB,KAAK,CAAC,CAAC,EACzB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/utils.js

@@ -0,0 +1,31 @@
+export async function withTimeout(promise, timeoutMs) {
+    if (!timeoutMs || timeoutMs <= 0) {
+        return promise;
+    }
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            reject(new Error(`Execution timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+export async function retry(fn, retryCount) {
+    let lastError;
+    for (let attempt = 0; attempt <= retryCount; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,OAAmB,EACnB,SAAkB;IAElB,IAAI,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAA;IAClB,CAAC;IAED,IAAI,KAAgD,CAAA;IAEpD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAChD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,SAAS,IAAI,CAAC,CAAC,CAAA;QACjE,CAAC,EAAE,SAAS,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAA;IACxD,CAAC;YAAS,CAAC;QACP,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CACvB,EAAoB,EACpB,UAAkB;IAElB,IAAI,SAAkB,CAAA;IAEtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAK,CAAA;QACrB,CAAC;IACL,CAAC;IAED,MAAM,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;AAC/E,CAAC"}

package/dist/workflow.d.ts

@@ -0,0 +1,3 @@
+import { Workflow, WorkflowStep } from "./types";
+export declare function createWorkflow(steps: WorkflowStep[], workflowId?: string): Workflow;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AA8BhD,wBAAgB,cAAc,CAC1B,KAAK,EAAE,YAAY,EAAE,EACrB,UAAU,SAAa,GACxB,QAAQ,CAOV"}

package/dist/workflow.js

@@ -0,0 +1,30 @@
+function validateWorkflowSteps(steps) {
+    const ids = new Set();
+    for (const step of steps) {
+        if (!step.id) {
+            throw new Error("Each workflow step must have an id");
+        }
+        if (!step.tool) {
+            throw new Error(`Workflow step "${step.id}" must have a tool`);
+        }
+        if (ids.has(step.id)) {
+            throw new Error(`Duplicate workflow step id: ${step.id}`);
+        }
+        ids.add(step.id);
+    }
+    for (const step of steps) {
+        for (const dep of step.dependsOn ?? []) {
+            if (!ids.has(dep)) {
+                throw new Error(`Step "${step.id}" depends on missing step "${dep}"`);
+            }
+        }
+    }
+}
+export function createWorkflow(steps, workflowId = "workflow") {
+    validateWorkflowSteps(steps);
+    return {
+        id: workflowId,
+        steps
+    };
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAEA,SAAS,qBAAqB,CAAC,KAAqB;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACzD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QAC7D,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,8BAA8B,GAAG,GAAG,CAAC,CAAA;YACzE,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAC1B,KAAqB,EACrB,UAAU,GAAG,UAAU;IAEvB,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAE5B,OAAO;QACH,EAAE,EAAE,UAAU;QACd,KAAK;KACR,CAAA;AACL,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "shrimsource",
+    "version": "0.1.0",
+    "description": "A lightweight AI agent workflow framework",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "typecheck": "tsc --noEmit"
+    },
+    "devDependencies": {
+        "@types/node": "^25.3.5",
+        "typescript": "^5.7.0",
+        "vitest": "^3.0.0"
+    },
+    "license": "MIT"
+}