@synergenius/flowweaver-pack-weaver 0.1.0

package/dist/bot/system-prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds the Weaver expert system prompt from flow-weaver's doc-metadata.
+ * This ensures Weaver's knowledge stays in sync with the installed flow-weaver version.
+ */
+export declare function buildSystemPrompt(): Promise<string>;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/bot/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/bot/system-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyLH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBzD"}

package/dist/bot/system-prompt.js

@@ -0,0 +1,161 @@
+/**
+ * Builds the Weaver expert system prompt from flow-weaver's doc-metadata.
+ * This ensures Weaver's knowledge stays in sync with the installed flow-weaver version.
+ */
+let cachedPrompt = null;
+function formatAnnotations(annotations) {
+    // Group by category, show syntax + description
+    const groups = new Map();
+    for (const a of annotations) {
+        const list = groups.get(a.category) ?? [];
+        list.push(a);
+        groups.set(a.category, list);
+    }
+    const lines = [];
+    for (const [category, items] of groups) {
+        lines.push(`[${category}]`);
+        for (const item of items) {
+            lines.push(`  ${item.syntax}  -- ${item.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatModifiers(portMods, nodeMods) {
+    const lines = [];
+    if (portMods.length > 0) {
+        lines.push('Port modifiers (after port name):');
+        for (const m of portMods) {
+            lines.push(`  ${m.syntax}  -- ${m.description}`);
+        }
+    }
+    if (nodeMods.length > 0) {
+        lines.push('Node instance modifiers (in @node declaration):');
+        for (const m of nodeMods) {
+            lines.push(`  ${m.syntax}  -- ${m.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatErrors(codes) {
+    const errors = codes.filter((c) => c.severity === 'error').slice(0, 15);
+    return errors
+        .map((c) => `  ${c.code}: ${c.title} -- ${c.description}`)
+        .join('\n');
+}
+function formatCliCommands(commands) {
+    const top = commands.filter((c) => !c.group);
+    return top
+        .map((c) => `  flow-weaver ${c.name} -- ${c.description}`)
+        .join('\n');
+}
+function buildPromptFromMetadata(annotations, portModifiers, nodeModifiers, validationCodes, cliCommands) {
+    return `You are Weaver, an expert AI companion for Flow Weaver workflows. You have deep knowledge of the entire Flow Weaver ecosystem: annotation grammar, compilation, CLI tools, node patterns, error diagnosis, and the Genesis self-evolution protocol.
+
+## Core Mental Model
+
+The code IS the workflow. Flow Weaver workflows are plain TypeScript files with JSDoc annotations above functions. The compiler reads annotations and generates deterministic execution code between @flow-weaver-body-start/end markers. Compiled code is standalone with no runtime dependency on flow-weaver.
+
+Three block types:
+- @flowWeaver nodeType: A reusable function (node) with typed inputs/outputs
+- @flowWeaver workflow: A DAG orchestration that wires node instances together
+- @flowWeaver pattern: A reusable fragment with boundary ports (IN/OUT instead of Start/Exit)
+
+## Annotation Grammar
+
+${formatAnnotations(annotations)}
+
+${formatModifiers(portModifiers, nodeModifiers)}
+
+## Node Execution Model
+
+Expression nodes (@expression):
+- No execute/onSuccess/onFailure params. Just inputs and return value.
+- throw = failure path, return = success path
+- Synchronous. Use execSync for shell commands.
+- Preferred for deterministic operations.
+
+Standard nodes:
+- execute: boolean param gates execution
+- Return { onSuccess: boolean, onFailure: boolean, ...outputs }
+- Can be async for I/O operations
+
+Async agent nodes:
+- Use (globalThis as any).__fw_agent_channel__ to pause workflow
+- Call channel.request({ agentId, context, prompt }) which returns a Promise
+- Workflow suspends until agent responds
+- NOT @expression (must be async)
+
+Pass-through pattern:
+- FW auto-connects ports by matching names on adjacent nodes
+- To forward data through intermediate nodes, declare it as both @input and @output with the same name
+- For non-adjacent wiring, use @connect sourceNode.port -> targetNode.port
+
+Data flow:
+- @path A -> B -> C: Linear execution path (sugar for multiple @connect)
+- @autoConnect: Auto-wire all nodes in declaration order
+- @connect: Explicit port-to-port wiring
+- Merge strategies for fan-in: FIRST, LAST, COLLECT, MERGE, CONCAT
+
+## CLI Commands
+
+${formatCliCommands(cliCommands)}
+
+Key workflows:
+  flow-weaver compile <file>  -- Generate executable code (in-place)
+  flow-weaver validate <file> -- Check for errors without compiling
+  flow-weaver modify <op> --file <f> -- Structural changes (addNode, removeNode, addConnection, removeConnection)
+  flow-weaver implement <file> -- Replace declare stubs with implementations
+  flow-weaver diff <a> <b> -- Semantic diff between two workflow versions
+  flow-weaver diagram <file> -f ascii-compact -- Generate ASCII diagram
+
+## Validation Errors
+
+${formatErrors(validationCodes)}
+
+When you encounter validation errors, suggest the specific fix. Common resolutions:
+- UNKNOWN_NODE_TYPE: Ensure the referenced function has @flowWeaver nodeType annotation
+- MISSING_REQUIRED_INPUT: Add a @connect from a source port or make the input optional with [brackets]
+- UNKNOWN_SOURCE_PORT / UNKNOWN_TARGET_PORT: Check port name spelling in @connect
+- CYCLE_DETECTED: Break the cycle; use scoped iteration (@scope, @map) instead of circular dependencies
+
+## Genesis Protocol
+
+Genesis is a 17-step self-evolving workflow engine:
+1. Load config (.genesis/config.json with intent, focus, constraints, approval thresholds)
+2. Observe project (fingerprint: files, package.json, git, CI, tests, existing FW workflows)
+3. Load task workflow (genesis-task.ts)
+4. Diff fingerprint against last cycle
+5. Check stabilize mode (3+ rollbacks/rejections = read-only, or explicit flag)
+6. Wait for agent (YOU decide what evolutions to propose)
+7. Propose evolution (map your decisions to FwModifyOperation[])
+8. Validate proposal (budget: max 3 cost units per cycle. addNode=1, removeNode=1, addConnection=1, removeConnection=1, implementNode=2)
+9. Snapshot current task workflow for rollback
+10. Apply changes via flow-weaver CLI
+11. Compile and validate (auto-rollback on failure)
+12. Diff workflow (semantic diff)
+13. Check approval threshold (CRITICAL > BREAKING > MINOR > COSMETIC)
+14. Wait for approval (if impact >= threshold)
+15. Commit or rollback based on approval
+16. Update history (.genesis/history.json)
+17. Report summary
+
+When stabilize mode is active, only fix-up operations are allowed: removeNode, removeConnection, implementNode. No new nodes or connections.
+
+## Response Format
+
+Return ONLY valid JSON. No markdown, no code fences, no explanation outside the JSON structure. Your response must parse with JSON.parse() directly.`;
+}
+export async function buildSystemPrompt() {
+    if (cachedPrompt)
+        return cachedPrompt;
+    try {
+        const docMeta = await import('@synergenius/flow-weaver/doc-metadata');
+        cachedPrompt = buildPromptFromMetadata(docMeta.ALL_ANNOTATIONS ?? [], docMeta.PORT_MODIFIERS ?? [], docMeta.NODE_MODIFIERS ?? [], docMeta.VALIDATION_CODES ?? [], docMeta.CLI_COMMANDS ?? []);
+    }
+    catch {
+        // Fallback if doc-metadata not available (e.g., older flow-weaver version)
+        cachedPrompt = buildPromptFromMetadata([], [], [], [], []);
+    }
+    return cachedPrompt;
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/bot/system-prompt.js.map

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

package/dist/bot/types.d.ts

@@ -0,0 +1,44 @@
+export type ProviderName = 'anthropic' | 'claude-cli' | 'copilot-cli';
+export interface BotProviderConfig {
+    name: ProviderName;
+    model?: string;
+    maxTokens?: number;
+}
+export interface BotApprovalConfig {
+    mode: 'auto' | 'timeout-auto';
+    timeoutSeconds?: number;
+}
+export interface BotNotifyConfig {
+    channel: 'discord' | 'slack' | 'webhook';
+    url: string;
+    events?: NotificationEventType[];
+    headers?: Record<string, string>;
+}
+export type NotificationEventType = 'workflow-start' | 'workflow-complete' | 'cycle-start' | 'cycle-complete' | 'approval-needed' | 'error';
+export interface NotificationEvent {
+    type: NotificationEventType;
+    workflowFile?: string;
+    cycle?: number;
+    projectDir: string;
+    summary?: string;
+    proposal?: Record<string, unknown>;
+    diff?: Record<string, unknown>;
+    outcome?: string;
+    error?: string;
+}
+export interface BotConfig {
+    provider: 'auto' | ProviderName | BotProviderConfig;
+    approval?: 'auto' | 'timeout-auto' | BotApprovalConfig;
+    notify?: BotNotifyConfig | BotNotifyConfig[];
+    target?: string;
+}
+/** Standalone Weaver config (same schema as BotConfig, used in .weaver.json) */
+export type WeaverConfig = BotConfig;
+export interface WorkflowResult {
+    success: boolean;
+    summary: string;
+    outcome: string;
+    functionName?: string;
+    executionTime?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bot/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,iBAAiB,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACvD,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/bot/types.js

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

package/dist/bot/types.js.map

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

package/dist/docs/docs/weaver-config.md

@@ -0,0 +1,141 @@
+# Weaver Configuration Reference
+
+Weaver is a Flow Weaver workflow template that runs any other workflow autonomously. It auto-detects AI providers, resolves the target workflow, executes it with an agent channel, and sends notifications.
+
+Weaver has deep knowledge of the full flow-weaver ecosystem: annotation grammar, CLI tools, node patterns, error diagnosis, and the genesis protocol (loaded dynamically from `@synergenius/flow-weaver/doc-metadata`).
+
+## Getting started
+
+Scaffold via `flow-weaver init` and select the "AI Workflow Runner" use case, or use it programmatically:
+
+```typescript
+import { weaverTemplate } from '@synergenius/flowweaver-pack-weaver/templates';
+const source = weaverTemplate.generate({ projectDir: '.' });
+```
+
+Then compile and run:
+
+```bash
+flow-weaver compile weaver.ts
+tsx weaver.ts
+```
+
+Or run via MCP: `fw_execute_workflow` pointing at the compiled `weaver.ts`.
+
+## .weaver.json
+
+Place a `.weaver.json` in your project root to configure the weaver workflow:
+
+```json
+{
+  "provider": "auto",
+  "target": "scripts/my-pipeline.ts",
+  "notify": [
+    { "channel": "discord", "url": "https://discord.com/api/webhooks/ID/TOKEN" }
+  ]
+}
+```
+
+## Provider options
+
+**Auto-detect** (tries each in order):
+```json
+{ "provider": "auto" }
+```
+
+**Anthropic API** (best quality, requires API key):
+```json
+{ "provider": "anthropic" }
+```
+
+**Claude CLI** (uses your CLI subscription, no API key needed):
+```json
+{ "provider": "claude-cli" }
+```
+
+**GitHub Copilot CLI** (uses your Copilot subscription):
+```json
+{ "provider": "copilot-cli" }
+```
+
+## Workflow nodes
+
+The weaver workflow has 6 nodes, visible and editable in Studio:
+
+1. **Load Config** - Reads `.weaver.json`, falls back to `{ provider: 'auto' }`
+2. **Detect Provider** - Auto-detects installed CLIs and API keys
+3. **Resolve Target** - Finds the workflow to run (from config or by scanning)
+4. **Execute Target** - Runs the target with an AI agent channel
+5. **Notify Result** - Sends Discord/Slack/webhook notifications
+6. **Report** - Prints summary to console
+
+You can customize any node, add pre/post-processing steps, or insert approval gates in Studio.
+
+## Full .weaver.json reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `provider` | string or object | `"auto"` | AI provider (see options above) |
+| `target` | string | auto-scan | Path to target workflow file |
+| `approval` | `"auto"` / `"timeout-auto"` / object | `"auto"` | Approval gate behavior |
+| `notify` | array | `[]` | Webhook notification channels |
+
+### Provider (verbose form)
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `name` | `"anthropic"` / `"claude-cli"` / `"copilot-cli"` | required | Provider name |
+| `model` | string | `"claude-sonnet-4-6"` | Model to use (Anthropic only) |
+| `maxTokens` | number | `4096` | Max response tokens (Anthropic only) |
+
+Shorthand values:
+
+- `"anthropic"` requires `ANTHROPIC_API_KEY` env var and `@anthropic-ai/sdk` package
+- `"claude-cli"` uses the Claude Code CLI (`claude -p`), requires Claude CLI installed
+- `"copilot-cli"` uses GitHub Copilot CLI (`copilot -p`), requires Copilot CLI installed
+- `"auto"` auto-detects in order: `ANTHROPIC_API_KEY` > `claude` CLI > `copilot` CLI
+
+### Approval
+
+How approval gates are handled.
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `mode` | `"auto"` / `"timeout-auto"` | `"auto"` | `auto`: approve immediately. `timeout-auto`: wait, then approve |
+| `timeoutSeconds` | number | `300` | Seconds to wait before auto-approving (timeout-auto only) |
+
+### Notifications
+
+Webhook notifications. Array of notification targets. Supports Discord, Slack, and custom webhooks.
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `channel` | `"discord"` / `"slack"` / `"webhook"` | required | Notification target |
+| `url` | string | required | Webhook URL |
+| `events` | array | all events | Event types to send: `workflow-start`, `workflow-complete`, `error` |
+| `headers` | object | `{}` | Extra HTTP headers (custom webhooks only) |
+
+Discord notifications use rich embeds with color-coded outcomes. Slack uses Block Kit formatting.
+
+## Programmatic usage
+
+The pack also exports library functions for building custom runners:
+
+```typescript
+import {
+  createProvider,
+  detectProvider,
+  runWorkflow,
+  BotAgentChannel,
+} from '@synergenius/flowweaver-pack-weaver';
+
+// Auto-detect and run
+const result = await runWorkflow('path/to/workflow.ts', { verbose: true });
+
+// Or build a custom agent channel
+const providerConfig = detectProvider();
+const provider = createProvider(providerConfig);
+const channel = new BotAgentChannel(provider, { ... });
+```
+
+Scheduling is left to the user: cron, GitHub Actions, git hooks, etc.

package/dist/docs/weaver-config.md

@@ -0,0 +1,141 @@
+# Weaver Configuration Reference
+
+Weaver is a Flow Weaver workflow template that runs any other workflow autonomously. It auto-detects AI providers, resolves the target workflow, executes it with an agent channel, and sends notifications.
+
+Weaver has deep knowledge of the full flow-weaver ecosystem: annotation grammar, CLI tools, node patterns, error diagnosis, and the genesis protocol (loaded dynamically from `@synergenius/flow-weaver/doc-metadata`).
+
+## Getting started
+
+Scaffold via `flow-weaver init` and select the "AI Workflow Runner" use case, or use it programmatically:
+
+```typescript
+import { weaverTemplate } from '@synergenius/flowweaver-pack-weaver/templates';
+const source = weaverTemplate.generate({ projectDir: '.' });
+```
+
+Then compile and run:
+
+```bash
+flow-weaver compile weaver.ts
+tsx weaver.ts
+```
+
+Or run via MCP: `fw_execute_workflow` pointing at the compiled `weaver.ts`.
+
+## .weaver.json
+
+Place a `.weaver.json` in your project root to configure the weaver workflow:
+
+```json
+{
+  "provider": "auto",
+  "target": "scripts/my-pipeline.ts",
+  "notify": [
+    { "channel": "discord", "url": "https://discord.com/api/webhooks/ID/TOKEN" }
+  ]
+}
+```
+
+## Provider options
+
+**Auto-detect** (tries each in order):
+```json
+{ "provider": "auto" }
+```
+
+**Anthropic API** (best quality, requires API key):
+```json
+{ "provider": "anthropic" }
+```
+
+**Claude CLI** (uses your CLI subscription, no API key needed):
+```json
+{ "provider": "claude-cli" }
+```
+
+**GitHub Copilot CLI** (uses your Copilot subscription):
+```json
+{ "provider": "copilot-cli" }
+```
+
+## Workflow nodes
+
+The weaver workflow has 6 nodes, visible and editable in Studio:
+
+1. **Load Config** - Reads `.weaver.json`, falls back to `{ provider: 'auto' }`
+2. **Detect Provider** - Auto-detects installed CLIs and API keys
+3. **Resolve Target** - Finds the workflow to run (from config or by scanning)
+4. **Execute Target** - Runs the target with an AI agent channel
+5. **Notify Result** - Sends Discord/Slack/webhook notifications
+6. **Report** - Prints summary to console
+
+You can customize any node, add pre/post-processing steps, or insert approval gates in Studio.
+
+## Full .weaver.json reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `provider` | string or object | `"auto"` | AI provider (see options above) |
+| `target` | string | auto-scan | Path to target workflow file |
+| `approval` | `"auto"` / `"timeout-auto"` / object | `"auto"` | Approval gate behavior |
+| `notify` | array | `[]` | Webhook notification channels |
+
+### Provider (verbose form)
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `name` | `"anthropic"` / `"claude-cli"` / `"copilot-cli"` | required | Provider name |
+| `model` | string | `"claude-sonnet-4-6"` | Model to use (Anthropic only) |
+| `maxTokens` | number | `4096` | Max response tokens (Anthropic only) |
+
+Shorthand values:
+
+- `"anthropic"` requires `ANTHROPIC_API_KEY` env var and `@anthropic-ai/sdk` package
+- `"claude-cli"` uses the Claude Code CLI (`claude -p`), requires Claude CLI installed
+- `"copilot-cli"` uses GitHub Copilot CLI (`copilot -p`), requires Copilot CLI installed
+- `"auto"` auto-detects in order: `ANTHROPIC_API_KEY` > `claude` CLI > `copilot` CLI
+
+### Approval
+
+How approval gates are handled.
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `mode` | `"auto"` / `"timeout-auto"` | `"auto"` | `auto`: approve immediately. `timeout-auto`: wait, then approve |
+| `timeoutSeconds` | number | `300` | Seconds to wait before auto-approving (timeout-auto only) |
+
+### Notifications
+
+Webhook notifications. Array of notification targets. Supports Discord, Slack, and custom webhooks.
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `channel` | `"discord"` / `"slack"` / `"webhook"` | required | Notification target |
+| `url` | string | required | Webhook URL |
+| `events` | array | all events | Event types to send: `workflow-start`, `workflow-complete`, `error` |
+| `headers` | object | `{}` | Extra HTTP headers (custom webhooks only) |
+
+Discord notifications use rich embeds with color-coded outcomes. Slack uses Block Kit formatting.
+
+## Programmatic usage
+
+The pack also exports library functions for building custom runners:
+
+```typescript
+import {
+  createProvider,
+  detectProvider,
+  runWorkflow,
+  BotAgentChannel,
+} from '@synergenius/flowweaver-pack-weaver';
+
+// Auto-detect and run
+const result = await runWorkflow('path/to/workflow.ts', { verbose: true });
+
+// Or build a custom agent channel
+const providerConfig = detectProvider();
+const provider = createProvider(providerConfig);
+const channel = new BotAgentChannel(provider, { ... });
+```
+
+Scheduling is left to the user: cron, GitHub Actions, git hooks, etc.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { BotConfig, BotProviderConfig, BotApprovalConfig, BotNotifyConfig, NotificationEvent, NotificationEventType, WeaverConfig, WorkflowResult, ProviderName, } from './bot/types.js';
+export type { BotAgentProvider, BotChannelContext } from './bot/index.js';
+export { AnthropicAgentProvider, CliAgentProvider, resolveProviderConfig, createProvider, detectProvider, } from './bot/index.js';
+export { BotAgentChannel } from './bot/index.js';
+export { WebhookNotificationChannel, createNotifier, } from './bot/index.js';
+export type { NotificationChannel } from './bot/index.js';
+export { buildSystemPrompt } from './bot/index.js';
+export { runWorkflow } from './bot/index.js';
+//# 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":"AACA,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,0BAA0B,EAC1B,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { AnthropicAgentProvider, CliAgentProvider, resolveProviderConfig, createProvider, detectProvider, } from './bot/index.js';
+// Agent channel & notifications
+export { BotAgentChannel } from './bot/index.js';
+export { WebhookNotificationChannel, createNotifier, } from './bot/index.js';
+// System prompt
+export { buildSystemPrompt } from './bot/index.js';
+// Runner
+export { runWorkflow } from './bot/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,gCAAgC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,0BAA0B,EAC1B,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/templates/index.d.ts

@@ -0,0 +1,5 @@
+import { weaverTemplate } from './weaver-template.js';
+export type { WorkflowTemplate } from './weaver-template.js';
+export { weaverTemplate };
+export declare const workflowTemplates: import("./weaver-template.js").WorkflowTemplate[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,eAAO,MAAM,iBAAiB,mDAAmB,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,4 @@
+import { weaverTemplate } from './weaver-template.js';
+export { weaverTemplate };
+export const workflowTemplates = [weaverTemplate];
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,cAAc,CAAC,CAAC"}

package/dist/templates/weaver-template.d.ts

@@ -0,0 +1,11 @@
+export interface WorkflowTemplate {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    generate: (opts: {
+        projectDir?: string;
+    }) => string;
+}
+export declare const weaverTemplate: WorkflowTemplate;
+//# sourceMappingURL=weaver-template.d.ts.map

package/dist/templates/weaver-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaver-template.d.ts","sourceRoot":"","sources":["../../src/templates/weaver-template.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CACrD;AAED,eAAO,MAAM,cAAc,EAAE,gBA8pB5B,CAAC"}