@loopstack/agent-examples 0.1.1

package/README.md

@@ -0,0 +1,150 @@
+---
+title: Agent Examples
+description: Workflow examples for LLM agents in Loopstack — basic AgentWorkflow with custom tools, code-exploration agent, MCP-connected agent, and a from-scratch custom agent loop with error handling.
+---
+
+# @loopstack/agent-examples
+
+> LLM agent workflow examples for the [Loopstack](https://loopstack.ai) automation framework.
+
+Four ways to build agents in Loopstack — from the recommended `AgentWorkflow` shortcut to a from-scratch custom loop. Pick the right shape for your control vs. simplicity tradeoff.
+
+## Install as Source (Recommended)
+
+```bash
+npx giget@latest gh:loopstack-ai/loopstack/registry/examples/agent-examples src/agent-examples
+```
+
+Register the module:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { AgentExamplesModule } from './agent-examples/agent-examples.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), AgentExamplesModule],
+})
+export class AppModule {}
+```
+
+## Install as a Dependency
+
+```bash
+npm install @loopstack/agent-examples
+```
+
+```typescript
+import { AgentExamplesModule } from '@loopstack/agent-examples';
+```
+
+## Environment
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...
+LINEAR_MCP_TOKEN=...   # required only for the MCP Linear example
+```
+
+## Examples
+
+| Example                       | Studio title                   | Description                                                                          |
+| ----------------------------- | ------------------------------ | ------------------------------------------------------------------------------------ |
+| [Agent](#agent)               | `Agent - Basic Agent Example`  | Launch `AgentWorkflow` with custom tools — recommended starting point                |
+| [Code Agent](#code-agent)     | `Agent - Code Agent Example`   | Specialized codebase-exploration agent with `glob` / `grep` / `read`                 |
+| [MCP Linear](#mcp-linear)     | `Agent - MCP Linear Example`   | Chat agent connected to Linear's hosted MCP server via `mcp_list_tools` + `mcp_call` |
+| [Custom Agent](#custom-agent) | `Agent - Custom Agent Example` | Build an agent loop from scratch — delegate primitives, guards, error handling       |
+
+---
+
+## Agent
+
+Launches a generic `AgentWorkflow` as a sub-workflow with two custom tools (`weather_lookup`, `calculator`) and renders the agent's run inline in the parent view. The recommended starting point for agent workflows.
+
+### Files
+
+- `agent-example.workflow.ts` — workflow class
+- `tools/weather-lookup.tool.ts`, `tools/calculator.tool.ts` — custom tools
+- `templates/system.md` — agent system prompt
+
+## Code Agent
+
+Launches `AgentWorkflow` as a code-exploration agent with `glob`, `grep`, and `read` tools. Demonstrates configuring a domain-specific agent without building a custom loop.
+
+### Setup
+
+The `glob`, `grep`, and `read` tools execute on a **remote agent**, so the workspace must have a `sandbox` environment connected.
+
+**1. Run a remote agent.** The simplest option is `@loopstack/remote-server` on `localhost:3001` (see `services/remote-server/`).
+
+**2. Register an available environment in your app module:**
+
+```typescript
+import { RemoteClientModule } from '@loopstack/remote-client';
+
+@Module({
+  imports: [
+    LoopstackModule.forRoot(),
+    RemoteClientModule.forRoot({
+      environments: {
+        available: [
+          {
+            type: 'sandbox',
+            name: 'Local Remote Server',
+            connectionUrl: 'http://localhost:3080',
+            agentUrl: 'http://localhost:3001',
+            local: true,
+          },
+        ],
+      },
+    }),
+    AgentExamplesModule,
+  ],
+})
+export class AppModule {}
+```
+
+`AgentExamplesModule` itself declares the `sandbox` slot via `RemoteClientModule.forFeature(...)` — make sure you use the same type = sandbox.
+
+**3. Create a workspace from the Studio.** The environment is auto-selected from the matching `type` and persisted on creation.
+
+### Files
+
+- `code-agent-example.workflow.ts` — workflow class
+
+## MCP Linear
+
+Launches `ChatAgentWorkflow` configured with `mcp_list_tools` + `mcp_call`, pointing at Linear's hosted MCP server. The agent dynamically discovers Linear's tool surface at runtime and invokes the right one for the user's question.
+
+Requires `LINEAR_MCP_TOKEN` env var and configures `McpModule.forRoot` with an allowed-hosts policy.
+
+### Files
+
+- `mcp-linear-example.workflow.ts` — workflow class
+
+## Custom Agent
+
+A from-scratch agent loop using the delegate primitives (`LlmGenerateTextTool`, `LlmDelegateToolCallsTool`, `LlmUpdateToolResultTool`). Demonstrates the pattern `AgentWorkflow` encapsulates: LLM call → guard on `tool_use` vs `end_turn` → delegate tools → feed results back → loop.
+
+Also exercises error self-correction: the LLM is instructed to deliberately trigger validation errors (`strictSchema` with wrong args), runtime errors (`runtimeError`), and failed sub-workflows (`failingSubWorkflow`), then observe the `is_error` tool results and correct course.
+
+### When to use
+
+- You need finer control than `AgentWorkflow` provides (custom guards, cancellation logic, telemetry hooks)
+- You want to understand what `AgentWorkflow` does under the hood
+- You need a custom shape — multiple parallel LLMs, conditional tool sets per turn, etc.
+
+For the simple case, prefer `AgentWorkflow` (see [Basic Agent Example](../agent/README.md)).
+
+### Files
+
+- `custom-agent-example.workflow.ts` — workflow class
+- `custom-agent-example.ui.yaml` — Studio widget
+- `templates/system.md` — system prompt
+- `tools/{strict-schema,runtime-error,failing-sub-workflow}.tool.ts` — error-trigger tools
+- `failing-sub.workflow.ts` — sub-workflow that always fails (used by `failing-sub-workflow.tool`)
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: MIT

package/dist/agent-examples.module.d.ts

@@ -0,0 +1,3 @@
+export declare class AgentExamplesModule {
+}
+//# sourceMappingURL=agent-examples.module.d.ts.map

package/dist/agent-examples.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-examples.module.d.ts","sourceRoot":"","sources":["../src/agent-examples.module.ts"],"names":[],"mappings":"AAqBA,qBAkBa,mBAAmB;CAAG"}

package/dist/agent-examples.module.js

@@ -0,0 +1,52 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentExamplesModule = void 0;
+const common_1 = require("@nestjs/common");
+const agent_1 = require("@loopstack/agent");
+const claude_module_1 = require("@loopstack/claude-module");
+const code_agent_1 = require("@loopstack/code-agent");
+const common_2 = require("@loopstack/common");
+const mcp_module_1 = require("@loopstack/mcp-module");
+const remote_client_1 = require("@loopstack/remote-client");
+const calculator_tool_1 = require("./tools/calculator.tool");
+const weather_lookup_tool_1 = require("./tools/weather-lookup.tool");
+const agent_example_workflow_1 = require("./workflows/agent/agent-example.workflow");
+const code_agent_example_workflow_1 = require("./workflows/code-agent/code-agent-example.workflow");
+const custom_agent_example_workflow_1 = require("./workflows/custom-agent/custom-agent-example.workflow");
+const mcp_linear_example_workflow_1 = require("./workflows/mcp-linear/mcp-linear-example.workflow");
+const WORKFLOWS = [
+    agent_example_workflow_1.AgentExampleWorkflow,
+    code_agent_example_workflow_1.CodeAgentExampleWorkflow,
+    mcp_linear_example_workflow_1.McpLinearExampleWorkflow,
+    custom_agent_example_workflow_1.CustomAgentExampleWorkflow,
+];
+let AgentExamplesModule = class AgentExamplesModule {
+};
+exports.AgentExamplesModule = AgentExamplesModule;
+exports.AgentExamplesModule = AgentExamplesModule = __decorate([
+    (0, common_2.StudioApp)({
+        title: 'Agent Examples',
+        workflows: WORKFLOWS,
+    }),
+    (0, common_1.Module)({
+        imports: [
+            agent_1.AgentModule,
+            code_agent_1.CodeAgentModule,
+            claude_module_1.ClaudeModule,
+            mcp_module_1.McpModule.forRoot({
+                allowedHosts: ['mcp.linear.app'],
+                hostHeaderEnv: { 'mcp.linear.app': { Authorization: 'LINEAR_MCP_TOKEN' } },
+            }),
+            remote_client_1.RemoteClientModule.forFeature({ slots: [{ id: 'sandbox', type: 'sandbox', title: 'Sandbox' }] }),
+        ],
+        providers: [calculator_tool_1.CalculatorTool, weather_lookup_tool_1.WeatherLookupTool, ...WORKFLOWS],
+        exports: WORKFLOWS,
+    })
+], AgentExamplesModule);
+//# sourceMappingURL=agent-examples.module.js.map

package/dist/agent-examples.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-examples.module.js","sourceRoot":"","sources":["../src/agent-examples.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,4CAA+C;AAC/C,4DAAwD;AACxD,sDAAwD;AACxD,8CAA8C;AAC9C,sDAAkD;AAClD,4DAA8D;AAC9D,6DAAyD;AACzD,qEAAgE;AAChE,qFAAgF;AAChF,oGAA8F;AAC9F,0GAAoG;AACpG,oGAA8F;AAE9F,MAAM,SAAS,GAAG;IAChB,6CAAoB;IACpB,sDAAwB;IACxB,sDAAwB;IACxB,0DAA0B;CAC3B,CAAC;AAoBK,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAAG,CAAA;AAAtB,kDAAmB;8BAAnB,mBAAmB;IAlB/B,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,gBAAgB;QACvB,SAAS,EAAE,SAAS;KACrB,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,mBAAW;YACX,4BAAe;YACf,4BAAY;YACZ,sBAAS,CAAC,OAAO,CAAC;gBAChB,YAAY,EAAE,CAAC,gBAAgB,CAAC;gBAChC,aAAa,EAAE,EAAE,gBAAgB,EAAE,EAAE,aAAa,EAAE,kBAAkB,EAAE,EAAE;aAC3E,CAAC;YACF,kCAAkB,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;SACjG;QACD,SAAS,EAAE,CAAC,gCAAc,EAAE,uCAAiB,EAAE,GAAG,SAAS,CAAC;QAC5D,OAAO,EAAE,SAAS;KACnB,CAAC;GACW,mBAAmB,CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './agent-examples.module';
+export * from './workflows/agent/agent-example.workflow';
+export * from './workflows/code-agent/code-agent-example.workflow';
+export * from './workflows/mcp-linear/mcp-linear-example.workflow';
+export * from './workflows/custom-agent/custom-agent-example.workflow';
+//# 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,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC;AACzD,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,wDAAwD,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agent-examples.module"), exports);
+__exportStar(require("./workflows/agent/agent-example.workflow"), exports);
+__exportStar(require("./workflows/code-agent/code-agent-example.workflow"), exports);
+__exportStar(require("./workflows/mcp-linear/mcp-linear-example.workflow"), exports);
+__exportStar(require("./workflows/custom-agent/custom-agent-example.workflow"), exports);
+//# 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,0DAAwC;AACxC,2EAAyD;AACzD,qFAAmE;AACnE,qFAAmE;AACnE,yFAAuE"}

package/dist/tools/calculator.tool.d.ts

@@ -0,0 +1,15 @@
+import { BaseTool, ToolEnvelope } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+export type CalculatorResult = string;
+export declare class CalculatorTool extends BaseTool<{
+    operation: string;
+    a: number;
+    b: number;
+}, object, CalculatorResult> {
+    protected handle(args: {
+        operation: string;
+        a: number;
+        b: number;
+    }, _ctx: RunContext): Promise<ToolEnvelope<CalculatorResult>>;
+}
+//# sourceMappingURL=calculator.tool.d.ts.map

package/dist/tools/calculator.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.tool.d.ts","sourceRoot":"","sources":["../../src/tools/calculator.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAQ,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,qBASa,cAAe,SAAQ,QAAQ,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC;cACjG,MAAM,CACpB,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EACjD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;CA2B3C"}

package/dist/tools/calculator.tool.js

@@ -0,0 +1,51 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalculatorTool = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+let CalculatorTool = class CalculatorTool extends common_1.BaseTool {
+    async handle(args, _ctx) {
+        let result;
+        switch (args.operation) {
+            case 'add':
+                result = args.a + args.b;
+                break;
+            case 'subtract':
+                result = args.a - args.b;
+                break;
+            case 'multiply':
+                result = args.a * args.b;
+                break;
+            case 'divide':
+                if (args.b === 0) {
+                    return { data: 'Error: Division by zero', error: 'Cannot divide by zero' };
+                }
+                result = args.a / args.b;
+                break;
+            default:
+                return { data: `Unknown operation: ${args.operation}`, error: 'Unsupported operation' };
+        }
+        return {
+            data: `${args.a} ${args.operation} ${args.b} = ${result}`,
+        };
+    }
+};
+exports.CalculatorTool = CalculatorTool;
+exports.CalculatorTool = CalculatorTool = __decorate([
+    (0, common_1.Tool)({
+        name: 'calculator',
+        description: 'Perform a basic arithmetic calculation. Supports add, subtract, multiply, divide.',
+        schema: zod_1.z.object({
+            operation: zod_1.z.enum(['add', 'subtract', 'multiply', 'divide']).describe('The arithmetic operation.'),
+            a: zod_1.z.number().describe('First operand.'),
+            b: zod_1.z.number().describe('Second operand.'),
+        }),
+    })
+], CalculatorTool);
+//# sourceMappingURL=calculator.tool.js.map

package/dist/tools/calculator.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.tool.js","sourceRoot":"","sources":["../../src/tools/calculator.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAAiE;AAc1D,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,iBAA+E;IACvG,KAAK,CAAC,MAAM,CACpB,IAAiD,EACjD,IAAgB;QAEhB,IAAI,MAAc,CAAC;QAEnB,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,KAAK;gBACR,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjB,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;gBAC7E,CAAC;gBACD,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACzB,MAAM;YACR;gBACE,OAAO,EAAE,IAAI,EAAE,sBAAsB,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAC5F,CAAC;QAED,OAAO;YACL,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,MAAM,MAAM,EAAE;SAC1D,CAAC;IACJ,CAAC;CACF,CAAA;AA/BY,wCAAc;yBAAd,cAAc;IAT1B,IAAA,aAAI,EAAC;QACJ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,mFAAmF;QAChG,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAClG,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACxC,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SAC1C,CAAC;KACH,CAAC;GACW,cAAc,CA+B1B"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export * from './weather-lookup.tool';
+export * from './calculator.tool';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./weather-lookup.tool"), exports);
+__exportStar(require("./calculator.tool"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,oDAAkC"}

package/dist/tools/weather-lookup.tool.d.ts

@@ -0,0 +1,10 @@
+import { BaseTool, ToolEnvelope } from '@loopstack/common';
+export type WeatherLookupResult = string;
+export declare class WeatherLookupTool extends BaseTool<{
+    city: string;
+}, object, WeatherLookupResult> {
+    protected handle(args: {
+        city: string;
+    }): Promise<ToolEnvelope<WeatherLookupResult>>;
+}
+//# sourceMappingURL=weather-lookup.tool.d.ts.map

package/dist/tools/weather-lookup.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather-lookup.tool.d.ts","sourceRoot":"","sources":["../../src/tools/weather-lookup.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAQ,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,qBAOa,iBAAkB,SAAQ,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,mBAAmB,CAAC;cAC5E,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;CAe3F"}

package/dist/tools/weather-lookup.tool.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeatherLookupTool = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+let WeatherLookupTool = class WeatherLookupTool extends common_1.BaseTool {
+    async handle(args) {
+        const forecasts = {
+            london: '14°C, cloudy with light rain',
+            tokyo: '22°C, sunny with clear skies',
+            'new york': '18°C, partly cloudy',
+        };
+        const key = args.city.toLowerCase();
+        const weather = forecasts[key] ?? `21°C, pleasant conditions`;
+        return Promise.resolve({
+            data: `Weather in ${args.city}: ${weather}`,
+        });
+    }
+};
+exports.WeatherLookupTool = WeatherLookupTool;
+exports.WeatherLookupTool = WeatherLookupTool = __decorate([
+    (0, common_1.Tool)({
+        name: 'weather_lookup',
+        description: 'Look up the current weather for a given city. Returns a simulated forecast.',
+        schema: zod_1.z.object({
+            city: zod_1.z.string().describe('The city name to look up weather for.'),
+        }),
+    })
+], WeatherLookupTool);
+//# sourceMappingURL=weather-lookup.tool.js.map

package/dist/tools/weather-lookup.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather-lookup.tool.js","sourceRoot":"","sources":["../../src/tools/weather-lookup.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAAiE;AAW1D,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,iBAAuD;IAClF,KAAK,CAAC,MAAM,CAAC,IAAsB;QAE3C,MAAM,SAAS,GAA2B;YACxC,MAAM,EAAE,8BAA8B;YACtC,KAAK,EAAE,8BAA8B;YACrC,UAAU,EAAE,qBAAqB;SAClC,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,2BAA2B,CAAC;QAE9D,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,cAAc,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAhBY,8CAAiB;4BAAjB,iBAAiB;IAP7B,IAAA,aAAI,EAAC;QACJ,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,6EAA6E;QAC1F,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACnE,CAAC;KACH,CAAC;GACW,iBAAiB,CAgB7B"}

package/dist/workflows/agent/agent-example.workflow.d.ts

@@ -0,0 +1,9 @@
+import { type AgentResult, AgentWorkflow } from '@loopstack/agent';
+import { BaseWorkflow, type TransitionInput } from '@loopstack/common';
+export declare class AgentExampleWorkflow extends BaseWorkflow {
+    private readonly agentWorkflow;
+    constructor(agentWorkflow: AgentWorkflow);
+    start(): Promise<void>;
+    agentComplete(_state: Record<string, unknown>, input: TransitionInput<AgentResult>): Promise<void>;
+}
+//# sourceMappingURL=agent-example.workflow.d.ts.map

package/dist/workflows/agent/agent-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/agent/agent-example.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAqB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAc,KAAK,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAG7F,qBAKa,oBAAqB,SAAQ,YAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAKnD,KAAK;IAiBL,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC;CAMzF"}

package/dist/workflows/agent/agent-example.workflow.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentExampleWorkflow = void 0;
+const node_path_1 = require("node:path");
+const agent_1 = require("@loopstack/agent");
+const common_1 = require("@loopstack/common");
+const llm_provider_module_1 = require("@loopstack/llm-provider-module");
+let AgentExampleWorkflow = class AgentExampleWorkflow extends common_1.BaseWorkflow {
+    agentWorkflow;
+    constructor(agentWorkflow) {
+        super();
+        this.agentWorkflow = agentWorkflow;
+    }
+    async start() {
+        await this.agentWorkflow.run({
+            system: this.render((0, node_path_1.join)(__dirname, 'templates', 'system.md')),
+            tools: ['weather_lookup', 'calculator'],
+            userMessage: "What's the weather in Tokyo? Also, what is 42 * 17?",
+        }, { callback: { transition: 'agentComplete' }, show: 'inline', label: 'Subagent' });
+    }
+    async agentComplete(_state, input) {
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, {
+            role: 'assistant',
+            text: input.data.response,
+        });
+    }
+};
+exports.AgentExampleWorkflow = AgentExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'running' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AgentExampleWorkflow.prototype, "start", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'running',
+        to: 'end',
+        wait: true,
+        schema: agent_1.AgentResultSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentExampleWorkflow.prototype, "agentComplete", null);
+exports.AgentExampleWorkflow = AgentExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'Agent - Basic Agent Example',
+        description: 'Launches a generic AgentWorkflow as a sub-workflow with weather and calculator tools. Recommended starting point.',
+    }),
+    __metadata("design:paramtypes", [agent_1.AgentWorkflow])
+], AgentExampleWorkflow);
+//# sourceMappingURL=agent-example.workflow.js.map

package/dist/workflows/agent/agent-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/agent/agent-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAiC;AACjC,4CAAsF;AACtF,8CAA6F;AAC7F,wEAAoE;AAO7D,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,qBAAY;IACvB;IAA7B,YAA6B,aAA4B;QACvD,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAAe;IAEzD,CAAC;IAGK,AAAN,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAC1B;YACE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;YAC9D,KAAK,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAC;YACvC,WAAW,EAAE,qDAAqD;SACnE,EACD,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CACjF,CAAC;IACJ,CAAC;IAQK,AAAN,KAAK,CAAC,aAAa,CAAC,MAA+B,EAAE,KAAmC;QACtF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wCAAkB,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA7BY,oDAAoB;AAMzB;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;;;;iDAU7B;AAQK;IANL,IAAA,mBAAU,EAAC;QACV,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,yBAAiB;KAC1B,CAAC;;;;yDAMD;+BA5BU,oBAAoB;IALhC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,mHAAmH;KACtH,CAAC;qCAE4C,qBAAa;GAD9C,oBAAoB,CA6BhC"}

package/dist/workflows/agent/templates/system.md

@@ -0,0 +1,4 @@
+You are a helpful assistant with access to a weather lookup tool and a calculator.
+When the user asks about weather, use the weatherLookup tool.
+When the user asks for calculations, use the calculator tool.
+Provide a concise, helpful response summarizing the results.

package/dist/workflows/code-agent/code-agent-example.workflow.d.ts

@@ -0,0 +1,12 @@
+import { type AgentResult, AgentWorkflow } from '@loopstack/agent';
+import { BaseWorkflow, type TransitionInput } from '@loopstack/common';
+import { EnvironmentService } from '@loopstack/remote-client';
+export declare class CodeAgentExampleWorkflow extends BaseWorkflow {
+    private readonly agentWorkflow;
+    private readonly environments;
+    constructor(agentWorkflow: AgentWorkflow, environments: EnvironmentService);
+    verifyEnvironment(_state: Record<string, unknown>): Promise<void>;
+    startExploration(_state: Record<string, unknown>): Promise<void>;
+    exploreComplete(_state: Record<string, unknown>, input: TransitionInput<AgentResult>): Promise<void>;
+}
+//# sourceMappingURL=code-agent-example.workflow.d.ts.map

package/dist/workflows/code-agent/code-agent-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/code-agent/code-agent-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAqB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAA+B,KAAK,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAY9D,qBAIa,wBAAyB,SAAQ,YAAY;IAEtD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,kBAAkB;IAM7C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKjD,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBhD,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC;CAM3F"}

package/dist/workflows/code-agent/code-agent-example.workflow.js

@@ -0,0 +1,75 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeAgentExampleWorkflow = void 0;
+const agent_1 = require("@loopstack/agent");
+const common_1 = require("@loopstack/common");
+const remote_client_1 = require("@loopstack/remote-client");
+const EXPLORE_INSTRUCTIONS = `Find the entry-point module of this project and list the
+top-level providers it registers. Return a short bulleted summary.`;
+let CodeAgentExampleWorkflow = class CodeAgentExampleWorkflow extends common_1.BaseWorkflow {
+    agentWorkflow;
+    environments;
+    constructor(agentWorkflow, environments) {
+        super();
+        this.agentWorkflow = agentWorkflow;
+        this.environments = environments;
+    }
+    async verifyEnvironment(_state) {
+        await this.environments.assertReachable('sandbox');
+    }
+    async startExploration(_state) {
+        await this.agentWorkflow.run({
+            system: 'You are a codebase exploration agent. Search and read source code to answer the question thoroughly.',
+            tools: ['glob', 'grep', 'read'],
+            userMessage: EXPLORE_INSTRUCTIONS,
+        }, { callback: { transition: 'exploreComplete' }, show: 'inline', label: 'Exploring codebase...' });
+    }
+    async exploreComplete(_state, input) {
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: input.data.response,
+        });
+    }
+};
+exports.CodeAgentExampleWorkflow = CodeAgentExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'verified' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], CodeAgentExampleWorkflow.prototype, "verifyEnvironment", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'verified', to: 'exploring' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], CodeAgentExampleWorkflow.prototype, "startExploration", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'exploring',
+        to: 'end',
+        wait: true,
+        schema: agent_1.AgentResultSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CodeAgentExampleWorkflow.prototype, "exploreComplete", null);
+exports.CodeAgentExampleWorkflow = CodeAgentExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'Agent - Code Agent Example',
+        description: 'Launches AgentWorkflow as a codebase-exploration agent with glob, grep, and read tools.',
+    }),
+    __metadata("design:paramtypes", [agent_1.AgentWorkflow,
+        remote_client_1.EnvironmentService])
+], CodeAgentExampleWorkflow);
+//# sourceMappingURL=code-agent-example.workflow.js.map

package/dist/workflows/code-agent/code-agent-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/code-agent/code-agent-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4CAAsF;AACtF,8CAA8G;AAC9G,4DAA8D;AAE9D,MAAM,oBAAoB,GAAG;mEACsC,CAAC;AAa7D,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,qBAAY;IAErC;IACA;IAFnB,YACmB,aAA4B,EAC5B,YAAgC;QAEjD,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAAe;QAC5B,iBAAY,GAAZ,YAAY,CAAoB;IAGnD,CAAC;IAGK,AAAN,KAAK,CAAC,iBAAiB,CAAC,MAA+B;QACrD,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAGK,AAAN,KAAK,CAAC,gBAAgB,CAAC,MAA+B;QACpD,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAC1B;YACE,MAAM,EAAE,sGAAsG;YAC9G,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,WAAW,EAAE,oBAAoB;SAClC,EACD,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAChG,CAAC;IACJ,CAAC;IAQK,AAAN,KAAK,CAAC,eAAe,CAAC,MAA+B,EAAE,KAAmC;QACxF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wBAAe,EAAE;YAC7C,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AArCY,4DAAwB;AAS7B;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;;;;iEAG9B;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;;;;gEAUjD;AAQK;IANL,IAAA,mBAAU,EAAC;QACV,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,yBAAiB;KAC1B,CAAC;;;;+DAMD;mCApCU,wBAAwB;IAJpC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,yFAAyF;KACvG,CAAC;qCAGkC,qBAAa;QACd,kCAAkB;GAHxC,wBAAwB,CAqCpC"}