@marktoflow/core 2.0.0-alpha.12

package/dist/permissions.js

@@ -0,0 +1,286 @@
+/**
+ * Permissions module for marktoflow v2.0
+ *
+ * Provides permission merging and enforcement utilities for step-level
+ * and workflow-level permission restrictions.
+ */
+import { minimatch } from 'minimatch';
+// ============================================================================
+// Permission Merging
+// ============================================================================
+/**
+ * Merge workflow-level and step-level permissions.
+ * Step permissions override workflow permissions, with most restrictive winning.
+ */
+export function mergePermissions(workflow, step) {
+    // Start with defaults (most permissive)
+    const effective = {
+        read: true,
+        write: true,
+        execute: true,
+        allowedCommands: [],
+        blockedCommands: [],
+        allowedDirectories: [],
+        blockedPaths: [],
+        network: true,
+        allowedHosts: [],
+        maxFileSize: undefined,
+    };
+    // Apply workflow-level permissions first
+    if (workflow) {
+        applyPermissions(effective, workflow);
+    }
+    // Apply step-level permissions (overrides workflow)
+    if (step) {
+        applyPermissions(effective, step);
+    }
+    return effective;
+}
+/**
+ * Apply a permission configuration to effective permissions.
+ */
+function applyPermissions(effective, perms) {
+    if (!perms)
+        return;
+    // File operations
+    if (perms.read !== undefined) {
+        effective.read = perms.read;
+    }
+    if (perms.write !== undefined) {
+        effective.write = perms.write;
+    }
+    // Command execution
+    if (perms.execute !== undefined) {
+        effective.execute = perms.execute;
+    }
+    if (perms.allowedCommands) {
+        // Merge allowed commands (union)
+        effective.allowedCommands = [
+            ...new Set([...effective.allowedCommands, ...perms.allowedCommands]),
+        ];
+    }
+    if (perms.blockedCommands) {
+        // Merge blocked commands (union)
+        effective.blockedCommands = [
+            ...new Set([...effective.blockedCommands, ...perms.blockedCommands]),
+        ];
+    }
+    // Directory restrictions
+    if (perms.allowedDirectories) {
+        effective.allowedDirectories = [
+            ...new Set([...effective.allowedDirectories, ...perms.allowedDirectories]),
+        ];
+    }
+    if (perms.blockedPaths) {
+        effective.blockedPaths = [
+            ...new Set([...effective.blockedPaths, ...perms.blockedPaths]),
+        ];
+    }
+    // Network
+    if (perms.network !== undefined) {
+        effective.network = perms.network;
+    }
+    if (perms.allowedHosts) {
+        effective.allowedHosts = [
+            ...new Set([...effective.allowedHosts, ...perms.allowedHosts]),
+        ];
+    }
+    // Limits (most restrictive wins)
+    if (perms.maxFileSize !== undefined) {
+        if (effective.maxFileSize === undefined) {
+            effective.maxFileSize = perms.maxFileSize;
+        }
+        else {
+            effective.maxFileSize = Math.min(effective.maxFileSize, perms.maxFileSize);
+        }
+    }
+}
+// ============================================================================
+// Permission Checking
+// ============================================================================
+/**
+ * Check if an operation is permitted.
+ */
+export function checkPermission(perms, operation, target) {
+    switch (operation) {
+        case 'read':
+            return checkFilePermission(perms.read, target, 'read', perms);
+        case 'write':
+            return checkFilePermission(perms.write, target, 'write', perms);
+        case 'execute':
+            return checkExecutePermission(perms, target);
+        case 'network':
+            return checkNetworkPermission(perms, target);
+        default:
+            return { allowed: false, reason: `Unknown operation: ${operation}` };
+    }
+}
+/**
+ * Check file operation permission (read/write).
+ */
+function checkFilePermission(permission, target, operation, perms) {
+    // If permission is false, deny all
+    if (!permission) {
+        return { allowed: false, reason: `${operation} operations are disabled` };
+    }
+    // If permission is true and no target, allow
+    if (permission === true && !target) {
+        return { allowed: true };
+    }
+    // Check blocked paths first
+    if (target && perms.blockedPaths.length > 0) {
+        for (const blocked of perms.blockedPaths) {
+            if (matchPath(target, blocked)) {
+                return { allowed: false, reason: `Path is blocked: ${blocked}` };
+            }
+        }
+    }
+    // Check allowed directories if specified
+    if (target && perms.allowedDirectories.length > 0) {
+        const inAllowedDir = perms.allowedDirectories.some((dir) => target.startsWith(dir) || matchPath(target, dir + '/**'));
+        if (!inAllowedDir) {
+            return { allowed: false, reason: `Path not in allowed directories` };
+        }
+    }
+    // If permission is an array, check if target matches any pattern
+    if (Array.isArray(permission)) {
+        if (!target) {
+            return { allowed: true }; // No specific target, allow
+        }
+        const matches = permission.some((pattern) => matchPath(target, pattern));
+        if (!matches) {
+            return { allowed: false, reason: `Path does not match allowed patterns for ${operation}` };
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * Check execute permission for a command.
+ */
+function checkExecutePermission(perms, command) {
+    // If execute is false, deny all
+    if (perms.execute === false) {
+        return { allowed: false, reason: 'Command execution is disabled' };
+    }
+    if (!command) {
+        return { allowed: true };
+    }
+    // Check blocked commands first
+    if (perms.blockedCommands.length > 0) {
+        for (const blocked of perms.blockedCommands) {
+            if (commandMatches(command, blocked)) {
+                return { allowed: false, reason: `Command is blocked: ${blocked}` };
+            }
+        }
+    }
+    // If execute is an array of allowed commands
+    if (Array.isArray(perms.execute)) {
+        const matches = perms.execute.some((allowed) => commandMatches(command, allowed));
+        if (!matches) {
+            return { allowed: false, reason: 'Command not in allowed list' };
+        }
+    }
+    // Check allowed commands if specified
+    if (perms.allowedCommands.length > 0) {
+        const matches = perms.allowedCommands.some((allowed) => commandMatches(command, allowed));
+        if (!matches) {
+            return { allowed: false, reason: 'Command not in allowed list' };
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * Check network permission for a host.
+ */
+function checkNetworkPermission(perms, host) {
+    // If network is false, deny all
+    if (!perms.network) {
+        return { allowed: false, reason: 'Network access is disabled' };
+    }
+    if (!host) {
+        return { allowed: true };
+    }
+    // Check allowed hosts if specified
+    if (perms.allowedHosts.length > 0) {
+        const matches = perms.allowedHosts.some((allowed) => hostMatches(host, allowed));
+        if (!matches) {
+            return { allowed: false, reason: `Host not in allowed list: ${host}` };
+        }
+    }
+    return { allowed: true };
+}
+// ============================================================================
+// Pattern Matching Helpers
+// ============================================================================
+/**
+ * Match a path against a glob pattern.
+ */
+function matchPath(path, pattern) {
+    return minimatch(path, pattern, { dot: true });
+}
+/**
+ * Check if a command matches a pattern.
+ * Patterns can be exact matches or wildcards.
+ */
+function commandMatches(command, pattern) {
+    // Exact match
+    if (command === pattern) {
+        return true;
+    }
+    // Check if command starts with pattern (for matching command prefixes like "rm -rf")
+    if (command.startsWith(pattern + ' ') || command.startsWith(pattern)) {
+        return true;
+    }
+    // Wildcard pattern matching
+    if (pattern.includes('*')) {
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+        return regex.test(command);
+    }
+    return false;
+}
+/**
+ * Check if a host matches a pattern.
+ * Supports wildcard domains like *.example.com
+ */
+function hostMatches(host, pattern) {
+    // Exact match
+    if (host === pattern) {
+        return true;
+    }
+    // Wildcard domain matching (e.g., *.example.com)
+    if (pattern.startsWith('*.')) {
+        const suffix = pattern.slice(1); // .example.com
+        return host.endsWith(suffix);
+    }
+    return false;
+}
+/**
+ * Convert EffectivePermissions to a SecurityPolicy for use with hooks.
+ */
+export function toSecurityPolicy(perms) {
+    return {
+        allowFileRead: (path) => checkPermission(perms, 'read', path),
+        allowFileWrite: (path) => checkPermission(perms, 'write', path),
+        allowCommand: (command) => checkPermission(perms, 'execute', command),
+        allowNetwork: (host) => checkPermission(perms, 'network', host),
+        maxFileSize: perms.maxFileSize,
+    };
+}
+/**
+ * Create default (permissive) permissions.
+ */
+export function createDefaultPermissions() {
+    return {
+        read: true,
+        write: true,
+        execute: true,
+        allowedCommands: [],
+        blockedCommands: [],
+        allowedDirectories: [],
+        blockedPaths: [],
+        network: true,
+        allowedHosts: [],
+        maxFileSize: undefined,
+    };
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Plugin system for marktoflow.
+ *
+ * Provides hook registry and plugin lifecycle management.
+ */
+export declare enum PluginState {
+    DISCOVERED = "discovered",
+    LOADED = "loaded",
+    ENABLED = "enabled",
+    DISABLED = "disabled",
+    ERROR = "error"
+}
+export declare enum HookType {
+    WORKFLOW_BEFORE_START = "workflow_before_start",
+    WORKFLOW_AFTER_START = "workflow_after_start",
+    WORKFLOW_BEFORE_END = "workflow_before_end",
+    WORKFLOW_AFTER_END = "workflow_after_end",
+    WORKFLOW_ON_ERROR = "workflow_on_error",
+    STEP_BEFORE_EXECUTE = "step_before_execute",
+    STEP_AFTER_EXECUTE = "step_after_execute",
+    STEP_ON_RETRY = "step_on_retry",
+    STEP_ON_SKIP = "step_on_skip",
+    STEP_ON_ERROR = "step_on_error",
+    AGENT_BEFORE_SELECT = "agent_before_select",
+    AGENT_AFTER_SELECT = "agent_after_select",
+    AGENT_ON_FAILOVER = "agent_on_failover",
+    TOOL_BEFORE_CALL = "tool_before_call",
+    TOOL_AFTER_CALL = "tool_after_call",
+    TOOL_ON_ERROR = "tool_on_error",
+    CUSTOM = "custom"
+}
+export interface PluginMetadata {
+    name: string;
+    version: string;
+    description?: string | undefined;
+    author?: string | undefined;
+    homepage?: string | undefined;
+    license?: string | undefined;
+    requires?: string[];
+    tags?: string[];
+}
+export interface HookContext {
+    hookType: HookType;
+    workflowId?: string | undefined;
+    stepIndex?: number | undefined;
+    stepName?: string | undefined;
+    agentName?: string | undefined;
+    toolName?: string | undefined;
+    data: Record<string, unknown>;
+    timestamp: Date;
+}
+export interface HookResult {
+    success: boolean;
+    modifiedData?: Record<string, unknown> | undefined;
+    stopPropagation?: boolean | undefined;
+    error?: string | undefined;
+}
+export type HookCallback = (context: HookContext) => HookResult | void | Promise<HookResult | void>;
+export interface Plugin {
+    metadata: PluginMetadata;
+    onLoad?(): void;
+    onEnable?(): void;
+    onDisable?(): void;
+    onUnload?(): void;
+    getHooks?(): Record<string, HookCallback[]>;
+    getTools?(): unknown[];
+    getTemplates?(): unknown[];
+    getConfigSchema?(): Record<string, unknown> | null;
+    configure?(config: Record<string, unknown>): void;
+}
+export interface PluginInfo {
+    plugin: Plugin;
+    source: string;
+    state: PluginState;
+    loadedAt: Date;
+    error?: string | undefined;
+}
+export declare class HookRegistry {
+    private hooks;
+    register(hook: HookType, callback: HookCallback): void;
+    unregister(hook: HookType, callback: HookCallback): void;
+    run(hook: HookType, context: HookContext): Promise<HookResult[]>;
+}
+export declare class PluginManager {
+    private plugins;
+    private hookRegistry;
+    register(plugin: Plugin, source?: string): PluginInfo;
+    enable(name: string): boolean;
+    disable(name: string): boolean;
+    unload(name: string): boolean;
+    list(): PluginInfo[];
+    get(name: string): PluginInfo | undefined;
+    hooks(): HookRegistry;
+}
+export declare class LoggingPlugin implements Plugin {
+    metadata: PluginMetadata;
+    getHooks(): Record<string, HookCallback[]>;
+}
+export declare class MetricsPlugin implements Plugin {
+    metadata: PluginMetadata;
+    private counts;
+    getHooks(): Record<string, HookCallback[]>;
+    getMetrics(): Record<string, number>;
+}
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

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

package/dist/plugins.js

@@ -0,0 +1,182 @@
+/**
+ * Plugin system for marktoflow.
+ *
+ * Provides hook registry and plugin lifecycle management.
+ */
+export var PluginState;
+(function (PluginState) {
+    PluginState["DISCOVERED"] = "discovered";
+    PluginState["LOADED"] = "loaded";
+    PluginState["ENABLED"] = "enabled";
+    PluginState["DISABLED"] = "disabled";
+    PluginState["ERROR"] = "error";
+})(PluginState || (PluginState = {}));
+export var HookType;
+(function (HookType) {
+    HookType["WORKFLOW_BEFORE_START"] = "workflow_before_start";
+    HookType["WORKFLOW_AFTER_START"] = "workflow_after_start";
+    HookType["WORKFLOW_BEFORE_END"] = "workflow_before_end";
+    HookType["WORKFLOW_AFTER_END"] = "workflow_after_end";
+    HookType["WORKFLOW_ON_ERROR"] = "workflow_on_error";
+    HookType["STEP_BEFORE_EXECUTE"] = "step_before_execute";
+    HookType["STEP_AFTER_EXECUTE"] = "step_after_execute";
+    HookType["STEP_ON_RETRY"] = "step_on_retry";
+    HookType["STEP_ON_SKIP"] = "step_on_skip";
+    HookType["STEP_ON_ERROR"] = "step_on_error";
+    HookType["AGENT_BEFORE_SELECT"] = "agent_before_select";
+    HookType["AGENT_AFTER_SELECT"] = "agent_after_select";
+    HookType["AGENT_ON_FAILOVER"] = "agent_on_failover";
+    HookType["TOOL_BEFORE_CALL"] = "tool_before_call";
+    HookType["TOOL_AFTER_CALL"] = "tool_after_call";
+    HookType["TOOL_ON_ERROR"] = "tool_on_error";
+    HookType["CUSTOM"] = "custom";
+})(HookType || (HookType = {}));
+export class HookRegistry {
+    hooks = new Map();
+    register(hook, callback) {
+        if (!this.hooks.has(hook)) {
+            this.hooks.set(hook, []);
+        }
+        this.hooks.get(hook).push(callback);
+    }
+    unregister(hook, callback) {
+        const list = this.hooks.get(hook);
+        if (!list)
+            return;
+        this.hooks.set(hook, list.filter((cb) => cb !== callback));
+    }
+    async run(hook, context) {
+        const callbacks = this.hooks.get(hook) ?? [];
+        const results = [];
+        for (const cb of callbacks) {
+            try {
+                const result = await cb(context);
+                if (result) {
+                    results.push(result);
+                    if (result.stopPropagation)
+                        break;
+                }
+            }
+            catch (error) {
+                results.push({ success: false, error: String(error) });
+            }
+        }
+        return results;
+    }
+}
+export class PluginManager {
+    plugins = new Map();
+    hookRegistry = new HookRegistry();
+    register(plugin, source = 'manual') {
+        const info = {
+            plugin,
+            source,
+            state: PluginState.DISCOVERED,
+            loadedAt: new Date(),
+        };
+        this.plugins.set(plugin.metadata.name, info);
+        return info;
+    }
+    enable(name) {
+        const info = this.plugins.get(name);
+        if (!info)
+            return false;
+        try {
+            if (info.state === PluginState.DISCOVERED) {
+                info.plugin.onLoad?.();
+                info.state = PluginState.LOADED;
+            }
+            info.plugin.onEnable?.();
+            info.state = PluginState.ENABLED;
+            const hooks = info.plugin.getHooks?.() ?? {};
+            for (const [hookName, callbacks] of Object.entries(hooks)) {
+                const hookType = hookName;
+                for (const cb of callbacks) {
+                    this.hookRegistry.register(hookType, cb);
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            info.state = PluginState.ERROR;
+            info.error = String(error);
+            return false;
+        }
+    }
+    disable(name) {
+        const info = this.plugins.get(name);
+        if (!info)
+            return false;
+        try {
+            info.plugin.onDisable?.();
+            info.state = PluginState.DISABLED;
+            return true;
+        }
+        catch (error) {
+            info.state = PluginState.ERROR;
+            info.error = String(error);
+            return false;
+        }
+    }
+    unload(name) {
+        const info = this.plugins.get(name);
+        if (!info)
+            return false;
+        try {
+            info.plugin.onUnload?.();
+            this.plugins.delete(name);
+            return true;
+        }
+        catch (error) {
+            info.state = PluginState.ERROR;
+            info.error = String(error);
+            return false;
+        }
+    }
+    list() {
+        return Array.from(this.plugins.values());
+    }
+    get(name) {
+        return this.plugins.get(name);
+    }
+    hooks() {
+        return this.hookRegistry;
+    }
+}
+export class LoggingPlugin {
+    metadata = {
+        name: 'logging',
+        version: '1.0.0',
+        description: 'Logs hook events',
+    };
+    getHooks() {
+        return {
+            [HookType.WORKFLOW_BEFORE_START]: [
+                (ctx) => {
+                    console.log(`[workflow:start] ${ctx.workflowId ?? ''}`.trim());
+                },
+            ],
+        };
+    }
+}
+export class MetricsPlugin {
+    metadata = {
+        name: 'metrics',
+        version: '1.0.0',
+        description: 'Collects basic metrics for hooks',
+    };
+    counts = {};
+    getHooks() {
+        return {
+            [HookType.STEP_AFTER_EXECUTE]: [
+                () => {
+                    this.counts.stepAfterExecute = (this.counts.stepAfterExecute ?? 0) + 1;
+                },
+            ],
+        };
+    }
+    getMetrics() {
+        return { ...this.counts };
+    }
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

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

package/dist/prompt-loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Prompt Loader for marktoflow v2.0
+ *
+ * Loads external prompt files with optional YAML frontmatter for variable definitions.
+ * Supports template variable resolution using {{ prompt.variable }} syntax.
+ */
+import { ExecutionContext } from './models.js';
+export interface PromptVariable {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    required: boolean | undefined;
+    default: unknown;
+    description: string | undefined;
+}
+export interface LoadedPrompt {
+    name: string | undefined;
+    description: string | undefined;
+    variables: Record<string, PromptVariable>;
+    content: string;
+    rawContent: string;
+    filePath: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface ResolvedPrompt {
+    content: string;
+    variables: Record<string, unknown>;
+}
+/**
+ * Load a prompt file with optional YAML frontmatter.
+ */
+export declare function loadPromptFile(promptPath: string, basePath?: string): Promise<LoadedPrompt>;
+/**
+ * Resolve {{ prompt.variable }} templates in a prompt.
+ */
+export declare function resolvePromptTemplate(prompt: LoadedPrompt, inputs: Record<string, unknown>, context?: ExecutionContext): ResolvedPrompt;
+/**
+ * Validate that all required prompt inputs are provided.
+ */
+export declare function validatePromptInputs(prompt: LoadedPrompt, inputs: Record<string, unknown>): ValidationResult;
+/**
+ * Extract all variable references from a prompt template.
+ */
+export declare function extractPromptVariables(content: string): string[];
+//# sourceMappingURL=prompt-loader.d.ts.map

package/dist/prompt-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-loader.d.ts","sourceRoot":"","sources":["../src/prompt-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAQD;;GAEG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CA2DvB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAuDhB;AAyBD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAmClB;AA0FD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWhE"}