@marktoflow/core 2.0.0-alpha.12

package/README.md

@@ -0,0 +1,307 @@
+# @marktoflow/core
+
+> **Author:** Scott Glover <scottgl@gmail.com>
+
+Core engine for marktoflow - parser, executor, and state management.
+
+## Overview
+
+`@marktoflow/core` is the foundation of the marktoflow automation framework. It provides the core workflow engine, state management, scheduling, and execution infrastructure.
+
+## Features
+
+- **Workflow Parser** - Parse markdown + YAML workflow definitions
+- **Execution Engine** - Step-by-step workflow execution with retry and error handling
+- **State Management** - SQLite-based persistent state tracking
+- **Scheduling** - Cron-based workflow scheduling
+- **Queue System** - Support for Redis, RabbitMQ, and in-memory queues
+- **Webhooks** - HTTP webhook trigger support
+- **File Watching** - Monitor files for changes and trigger workflows
+- **Security** - RBAC, approval workflows, and audit logging
+- **Cost Tracking** - Track and manage API usage costs
+- **Plugin System** - Extensible plugin architecture with 17 hook types
+- **Templates** - Reusable workflow templates with variables
+- **Tool Registry** - Support for MCP, OpenAPI, and custom tools
+- **Agent Routing** - Multi-agent workflow support with routing strategies
+
+## Installation
+
+```bash
+npm install @marktoflow/core
+```
+
+## Usage
+
+### Basic Workflow Execution
+
+```typescript
+import { WorkflowParser, WorkflowEngine } from '@marktoflow/core';
+
+// Parse workflow
+const parser = new WorkflowParser();
+const workflow = await parser.parseWorkflow('workflow.md');
+
+// Execute workflow
+const engine = new WorkflowEngine();
+const result = await engine.execute(workflow, {
+  inputs: { message: 'Hello World' },
+});
+
+console.log(result);
+```
+
+### With State Management
+
+```typescript
+import { WorkflowEngine, StateManager } from '@marktoflow/core';
+
+// Initialize state manager
+const stateManager = new StateManager({
+  dbPath: '.marktoflow/state.db',
+});
+
+// Execute workflow with state
+const engine = new WorkflowEngine({ stateManager });
+const result = await engine.execute(workflow);
+
+// Query state
+const history = await stateManager.getWorkflowHistory(workflow.id);
+```
+
+### Scheduling
+
+```typescript
+import { Scheduler } from '@marktoflow/core';
+
+// Create scheduler
+const scheduler = new Scheduler();
+
+// Schedule workflow (cron format)
+await scheduler.schedule({
+  workflowId: 'daily-report',
+  cron: '0 9 * * 1-5', // 9 AM weekdays
+  workflowPath: './workflows/daily-report.md',
+});
+
+// Start scheduler
+await scheduler.start();
+```
+
+### Webhooks
+
+```typescript
+import { WebhookServer } from '@marktoflow/core';
+
+// Create webhook server
+const webhookServer = new WebhookServer({ port: 3000 });
+
+// Register webhook
+await webhookServer.registerWebhook({
+  path: '/github',
+  workflowPath: './workflows/github-pr.md',
+  secret: process.env.GITHUB_WEBHOOK_SECRET,
+});
+
+// Start server
+await webhookServer.start();
+```
+
+### Plugin System
+
+```typescript
+import { PluginRegistry } from '@marktoflow/core';
+
+// Register plugin
+const registry = new PluginRegistry();
+await registry.register({
+  name: 'my-plugin',
+  hooks: {
+    beforeWorkflowStart: async (context) => {
+      console.log('Starting workflow:', context.workflow.id);
+    },
+    afterStepComplete: async (context) => {
+      console.log('Completed step:', context.step.action);
+    },
+  },
+});
+```
+
+## Workflow Format
+
+Workflows are written in markdown with YAML frontmatter:
+
+```markdown
+---
+workflow:
+  id: example
+  name: Example Workflow
+
+tools:
+  slack:
+    sdk: '@slack/web-api'
+    auth:
+      token: '${SLACK_BOT_TOKEN}'
+
+triggers:
+  - type: schedule
+    cron: '0 9 * * *'
+
+inputs:
+  message:
+    type: string
+    required: true
+
+outputs:
+  result:
+    type: string
+---
+
+# Example Workflow
+
+This workflow posts a message to Slack.
+
+## Step 1: Post Message
+
+\`\`\`yaml
+action: slack.chat.postMessage
+inputs:
+channel: '#general'
+text: '{{ inputs.message }}'
+output_variable: result
+\`\`\`
+```
+
+## Architecture
+
+### Core Components
+
+1. **Parser** (`parser.ts`) - Parse markdown + YAML workflow definitions
+2. **Engine** (`engine.ts`) - Execute workflows with retry/circuit breaker
+3. **State Manager** (`state.ts`) - SQLite-based state persistence
+4. **Scheduler** (`scheduler.ts`) - Cron-based workflow scheduling
+5. **Queue** (`queue.ts`) - Redis/RabbitMQ/InMemory queue support
+6. **Webhook** (`webhook.ts`) - HTTP webhook triggers
+7. **File Watcher** (`filewatcher.ts`) - File change monitoring
+8. **Security** (`security.ts`) - RBAC and audit logging
+9. **Cost Tracker** (`costs.ts`) - API usage cost management
+10. **Plugin System** (`plugins.ts`) - Extensible hooks
+11. **Templates** (`templates.ts`) - Reusable workflow patterns
+12. **Tool Registry** (`tool-registry.ts`) - MCP/OpenAPI/Custom tools
+13. **Agent Routing** (`routing.ts`) - Multi-agent coordination
+
+### Execution Flow
+
+```
+Parser → Validate → Security Check → Execute Steps → Save State → Output
+           ↓           ↓                    ↓            ↓
+        Schema      RBAC              Retry/Failover  Audit Log
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Database
+MARKTOFLOW_DB_PATH=.marktoflow/state.db
+
+# Queue (Redis)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+# Queue (RabbitMQ)
+RABBITMQ_URL=amqp://localhost
+
+# Security
+MARKTOFLOW_SECRET_KEY=your-secret-key
+```
+
+### Configuration File
+
+Create `.marktoflow/config.yaml`:
+
+```yaml
+state:
+  dbPath: .marktoflow/state.db
+
+queue:
+  type: redis # redis, rabbitmq, or memory
+  redis:
+    host: localhost
+    port: 6379
+
+security:
+  rbac:
+    enabled: true
+  auditLog:
+    enabled: true
+
+costs:
+  budget:
+    daily: 100
+    monthly: 3000
+  alerts:
+    - threshold: 50
+      emails: [admin@example.com]
+```
+
+## API Reference
+
+### WorkflowParser
+
+```typescript
+class WorkflowParser {
+  parseWorkflow(filePath: string): Promise<Workflow>;
+  parseYAML(content: string): Workflow;
+  validate(workflow: Workflow): ValidationResult;
+}
+```
+
+### WorkflowEngine
+
+```typescript
+class WorkflowEngine {
+  constructor(options?: EngineOptions);
+  execute(workflow: Workflow, context?: ExecutionContext): Promise<WorkflowResult>;
+  stop(): Promise<void>;
+}
+```
+
+### StateManager
+
+```typescript
+class StateManager {
+  constructor(options: StateOptions);
+  getWorkflowHistory(workflowId: string): Promise<WorkflowRun[]>;
+  getWorkflowState(runId: string): Promise<WorkflowState>;
+  saveWorkflowState(state: WorkflowState): Promise<void>;
+}
+```
+
+### Scheduler
+
+```typescript
+class Scheduler {
+  schedule(config: ScheduleConfig): Promise<void>;
+  unschedule(workflowId: string): Promise<void>;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+```
+
+## Testing
+
+```bash
+npm test
+```
+
+## Links
+
+- [Main Repository](https://github.com/marktoflow/marktoflow)
+- [Documentation](https://github.com/marktoflow/marktoflow#readme)
+- [CLI Package](@marktoflow/cli)
+- [Integrations Package](@marktoflow/integrations)
+
+## License
+
+Apache-2.0

package/dist/bundle.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Workflow bundle support for marktoflow.
+ */
+import { Workflow, ToolConfig } from './models.js';
+import { ToolRegistry } from './tool-registry.js';
+import { Tool } from './tool-base.js';
+export interface BundleConfig {
+    agent: string;
+    fallbackAgent?: string | undefined;
+    timeout: number;
+    maxRetries: number;
+    toolsDir: string;
+    inheritGlobalTools: boolean;
+    env: Record<string, string>;
+}
+export declare function loadBundleConfig(path: string): BundleConfig;
+export declare class BundleToolRegistry extends ToolRegistry {
+    private scriptTools;
+    private bundleDir;
+    private toolsDir;
+    constructor(bundleDir: string, toolsDir?: string, inheritGlobal?: boolean, globalRegistryPath?: string);
+    private loadScriptTools;
+    getTool(name: string, agent: string): Tool | null;
+    listTools(): string[];
+    listScriptTools(): string[];
+    getScriptToolPaths(): Record<string, string>;
+}
+export declare class WorkflowBundle {
+    private globalRegistryPath?;
+    readonly path: string;
+    private configCache?;
+    private workflowCache?;
+    private toolRegistryCache?;
+    constructor(path: string, globalRegistryPath?: string | undefined);
+    get name(): string;
+    get config(): BundleConfig;
+    get workflowFile(): string | null;
+    loadWorkflow(): Promise<Workflow>;
+    loadTools(): BundleToolRegistry;
+    buildToolConfigs(): Record<string, ToolConfig>;
+    loadWorkflowWithBundleTools(): Promise<Workflow>;
+}
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAgD,MAAM,gBAAgB,CAAC;AAEpF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAsB3D;AAyCD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAgB,EAAE,aAAa,GAAE,OAAc,EAAE,kBAAkB,CAAC,EAAE,MAAM;IAOrH,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAOjD,SAAS,IAAI,MAAM,EAAE;IAMrB,eAAe,IAAI,MAAM,EAAE;IAI3B,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAO7C;AAED,qBAAa,cAAc;IAMC,OAAO,CAAC,kBAAkB,CAAC;IALrD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,aAAa,CAAC,CAAW;IACjC,OAAO,CAAC,iBAAiB,CAAC,CAAqB;gBAEnC,IAAI,EAAE,MAAM,EAAU,kBAAkB,CAAC,EAAE,MAAM,YAAA;IAM7D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,YAAY,CAKzB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAShC;IAEK,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IASvC,SAAS,IAAI,kBAAkB;IAW/B,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAmBxC,2BAA2B,IAAI,OAAO,CAAC,QAAQ,CAAC;CAYvD"}

package/dist/bundle.js

@@ -0,0 +1,202 @@
+/**
+ * Workflow bundle support for marktoflow.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, resolve, extname, basename } from 'node:path';
+import { parse } from 'yaml';
+import { parseFile } from './parser.js';
+import { ScriptTool } from './script-tool.js';
+import { ToolRegistry } from './tool-registry.js';
+import { Tool, ToolType } from './tool-base.js';
+export function loadBundleConfig(path) {
+    if (!existsSync(path)) {
+        return {
+            agent: 'opencode',
+            timeout: 300,
+            maxRetries: 3,
+            toolsDir: 'tools',
+            inheritGlobalTools: true,
+            env: {},
+        };
+    }
+    const content = readFileSync(path, 'utf8');
+    const data = parse(content) ?? {};
+    return {
+        agent: data.agent ?? 'opencode',
+        fallbackAgent: data.fallback_agent ?? undefined,
+        timeout: data.timeout ?? 300,
+        maxRetries: data.max_retries ?? 3,
+        toolsDir: data.tools_dir ?? 'tools',
+        inheritGlobalTools: data.inherit_global_tools ?? true,
+        env: data.env ?? {},
+    };
+}
+class ScriptToolWrapper extends Tool {
+    scriptTool;
+    operations = [];
+    constructor(definition, implementation, toolsDir) {
+        super(definition, implementation);
+        this.scriptTool = new ScriptTool(implementation.adapterPath ?? '', toolsDir);
+        this.operations = this.loadOperations(implementation.adapterPath ?? '', toolsDir);
+    }
+    async initialize() {
+        this.initialized = true;
+    }
+    loadOperations(scriptPath, toolsDir) {
+        const fullPath = resolve(toolsDir, scriptPath);
+        const yamlPath = fullPath.replace(/\.[^/.]+$/, '') + '.yaml';
+        if (existsSync(yamlPath)) {
+            const content = readFileSync(yamlPath, 'utf8');
+            const data = parse(content);
+            const ops = data?.operations ? Object.keys(data.operations) : [];
+            return ops.length > 0 ? ops : ['run'];
+        }
+        return ['run'];
+    }
+    async execute(operation, params) {
+        return this.scriptTool.execute(operation, params);
+    }
+    listOperations() {
+        return this.operations;
+    }
+    getOperationSchema(_operation) {
+        return { description: '', parameters: { type: 'object', properties: {}, required: [] } };
+    }
+}
+export class BundleToolRegistry extends ToolRegistry {
+    scriptTools = new Map();
+    bundleDir;
+    toolsDir;
+    constructor(bundleDir, toolsDir = 'tools', inheritGlobal = true, globalRegistryPath) {
+        super(inheritGlobal ? globalRegistryPath : undefined);
+        this.bundleDir = resolve(bundleDir);
+        this.toolsDir = resolve(this.bundleDir, toolsDir);
+        this.loadScriptTools();
+    }
+    loadScriptTools() {
+        if (!existsSync(this.toolsDir))
+            return;
+        const entries = readdirSync(this.toolsDir);
+        for (const entry of entries) {
+            const ext = extname(entry);
+            if (ext === '.yaml' || ext === '.yml')
+                continue;
+            const toolName = basename(entry, ext);
+            const implementation = {
+                type: ToolType.CUSTOM,
+                priority: 0,
+                adapterPath: join(this.toolsDir, entry),
+            };
+            const definition = {
+                name: toolName,
+                description: `Script tool ${toolName}`,
+                implementations: [implementation],
+            };
+            const tool = new ScriptToolWrapper(definition, implementation, this.toolsDir);
+            this.scriptTools.set(toolName, tool);
+            this.register(definition);
+        }
+    }
+    getTool(name, agent) {
+        if (this.scriptTools.has(name)) {
+            return this.scriptTools.get(name) ?? null;
+        }
+        return super.getTool(name, agent);
+    }
+    listTools() {
+        const tools = new Set(super.listTools());
+        for (const name of this.scriptTools.keys())
+            tools.add(name);
+        return Array.from(tools).sort();
+    }
+    listScriptTools() {
+        return Array.from(this.scriptTools.keys());
+    }
+    getScriptToolPaths() {
+        const result = {};
+        for (const [name, tool] of this.scriptTools.entries()) {
+            result[name] = tool.implementation.adapterPath ?? '';
+        }
+        return result;
+    }
+}
+export class WorkflowBundle {
+    globalRegistryPath;
+    path;
+    configCache;
+    workflowCache;
+    toolRegistryCache;
+    constructor(path, globalRegistryPath) {
+        this.globalRegistryPath = globalRegistryPath;
+        const resolved = resolve(path);
+        if (!existsSync(resolved))
+            throw new Error(`Bundle directory not found: ${resolved}`);
+        this.path = resolved;
+    }
+    get name() {
+        return basename(this.path);
+    }
+    get config() {
+        if (!this.configCache) {
+            this.configCache = loadBundleConfig(join(this.path, 'config.yaml'));
+        }
+        return this.configCache;
+    }
+    get workflowFile() {
+        const candidates = ['workflow.md', 'main.md'];
+        for (const candidate of candidates) {
+            const full = join(this.path, candidate);
+            if (existsSync(full))
+                return full;
+        }
+        const entries = readdirSync(this.path).filter((name) => name.endsWith('.md') && name !== 'README.md');
+        if (entries.length === 1)
+            return join(this.path, entries[0]);
+        return null;
+    }
+    async loadWorkflow() {
+        if (this.workflowCache)
+            return this.workflowCache;
+        const wfPath = this.workflowFile;
+        if (!wfPath)
+            throw new Error('No workflow markdown found in bundle');
+        const { workflow } = await parseFile(wfPath);
+        this.workflowCache = workflow;
+        return workflow;
+    }
+    loadTools() {
+        if (this.toolRegistryCache)
+            return this.toolRegistryCache;
+        this.toolRegistryCache = new BundleToolRegistry(this.path, this.config.toolsDir, this.config.inheritGlobalTools, this.globalRegistryPath);
+        return this.toolRegistryCache;
+    }
+    buildToolConfigs() {
+        const registry = this.loadTools();
+        const scriptToolPaths = registry.getScriptToolPaths();
+        const configs = {};
+        for (const [toolName, scriptPath] of Object.entries(scriptToolPaths)) {
+            if (!scriptPath)
+                continue;
+            configs[toolName] = {
+                sdk: 'script',
+                options: {
+                    path: scriptPath,
+                    toolsDir: join(this.path, this.config.toolsDir),
+                },
+            };
+        }
+        return configs;
+    }
+    async loadWorkflowWithBundleTools() {
+        const workflow = await this.loadWorkflow();
+        const bundleTools = this.buildToolConfigs();
+        return {
+            ...workflow,
+            tools: {
+                ...(workflow.tools ?? {}),
+                ...bundleTools,
+            },
+        };
+    }
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * marktoflow configuration loader.
+ */
+export interface MarktoflowConfig {
+    agent?: {
+        primary?: string;
+        fallback?: string | null;
+        selectionStrategy?: string;
+    };
+    runtime?: {
+        mode?: string;
+        nodeVersion?: string;
+    };
+    logging?: {
+        level?: string;
+        destination?: string;
+        format?: string;
+        logPath?: string;
+    };
+    tools?: {
+        discovery?: string;
+        timeout?: string;
+        registryPath?: string;
+    };
+    workflows?: {
+        path?: string;
+        maxConcurrent?: number;
+        defaultTimeout?: string;
+    };
+    features?: Record<string, string>;
+}
+export declare function loadConfig(cwd?: string): MarktoflowConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAOD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,gBAAgB,CAcxE"}

package/dist/config.js

@@ -0,0 +1,27 @@
+/**
+ * marktoflow configuration loader.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse } from 'yaml';
+import { findProjectRoot } from './env.js';
+const DEFAULT_CONFIG = {
+    workflows: { path: '.marktoflow/workflows' },
+    tools: { registryPath: '.marktoflow/tools/registry.yaml' },
+};
+export function loadConfig(cwd = process.cwd()) {
+    const root = findProjectRoot(cwd);
+    const configPath = root ? join(root, 'marktoflow.yaml') : join(cwd, 'marktoflow.yaml');
+    if (!existsSync(configPath)) {
+        return DEFAULT_CONFIG;
+    }
+    const contents = readFileSync(configPath, 'utf8');
+    const data = parse(contents);
+    return {
+        ...DEFAULT_CONFIG,
+        ...data,
+        workflows: { ...DEFAULT_CONFIG.workflows, ...data?.workflows },
+        tools: { ...DEFAULT_CONFIG.tools, ...data?.tools },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA+B3C,MAAM,cAAc,GAAqB;IACvC,SAAS,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE;IAC5C,KAAK,EAAE,EAAE,YAAY,EAAE,iCAAiC,EAAE;CAC3D,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACpD,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACvF,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAqB,CAAC;IACjD,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,IAAI;QACP,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE;QAC9D,KAAK,EAAE,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE;KACnD,CAAC;AACJ,CAAC"}

package/dist/core-tools.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Core built-in tools for marktoflow workflows
+ *
+ * These tools are always available without needing to be declared in the workflow.
+ */
+import { SDKInitializer } from './sdk-registry.js';
+/**
+ * Core tools client that provides built-in workflow actions
+ */
+export declare class CoreToolsClient {
+    constructor();
+    /**
+     * Log a message during workflow execution
+     */
+    log(inputs: {
+        level: string;
+        message: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        logged: true;
+    }>;
+    /**
+     * Write content to a file
+     */
+    writeFile(inputs: {
+        path: string;
+        content: string;
+        encoding?: string;
+    }): Promise<{
+        written: true;
+        path: string;
+        size: number;
+    }>;
+}
+/**
+ * Core SDK initializer
+ */
+export declare const CoreInitializer: SDKInitializer;
+//# sourceMappingURL=core-tools.d.ts.map

package/dist/core-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-tools.d.ts","sourceRoot":"","sources":["../src/core-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;GAEG;AACH,qBAAa,eAAe;;IAK1B;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC;IAkB7B;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAiB3D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAI7B,CAAC"}