dot-agents 0.1.0

package/dist/lib/persona.js

@@ -0,0 +1,177 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, dirname, relative } from "node:path";
+import { loadMarkdownFile } from "./frontmatter.js";
+const PERSONA_FILENAME = "PERSONA.md";
+/**
+ * Load a single persona file
+ */
+export async function loadPersona(personaPath) {
+    const filePath = personaPath.endsWith(PERSONA_FILENAME)
+        ? personaPath
+        : join(personaPath, PERSONA_FILENAME);
+    const { frontmatter, body } = await loadMarkdownFile(filePath);
+    if (!frontmatter.name) {
+        throw new Error(`Persona missing required 'name' field: ${filePath}`);
+    }
+    // cmd is optional for child personas (inherited from parent)
+    return {
+        ...frontmatter,
+        path: dirname(filePath),
+        prompt: body || undefined,
+    };
+}
+/**
+ * Build the inheritance chain for a persona path
+ * Returns paths from root to leaf (e.g., ["claude", "claude/autonomous"])
+ */
+export function buildInheritanceChain(personaPath, personasRoot) {
+    const relativePath = relative(personasRoot, personaPath);
+    const parts = relativePath.split("/").filter(Boolean);
+    const chain = [];
+    let currentPath = personasRoot;
+    for (const part of parts) {
+        currentPath = join(currentPath, part);
+        chain.push(currentPath);
+    }
+    return chain;
+}
+/**
+ * Check if a directory contains a PERSONA.md file
+ */
+async function hasPersonaFile(dirPath) {
+    try {
+        const filePath = join(dirPath, PERSONA_FILENAME);
+        const stats = await stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Merge arrays with gitignore-style negation support
+ * Items prefixed with ! remove matching items from the array
+ */
+export function mergeArraysWithNegation(parent, child) {
+    const result = [...parent];
+    for (const item of child) {
+        if (item.startsWith("!")) {
+            // Remove items matching the negation pattern
+            const pattern = item.slice(1);
+            const index = result.indexOf(pattern);
+            if (index !== -1) {
+                result.splice(index, 1);
+            }
+        }
+        else if (!result.includes(item)) {
+            // Add new items
+            result.push(item);
+        }
+    }
+    return result;
+}
+/**
+ * Deep merge two objects (child overrides parent)
+ */
+export function deepMerge(parent, child) {
+    const result = { ...parent };
+    for (const key of Object.keys(child)) {
+        const childValue = child[key];
+        const parentValue = parent[key];
+        if (childValue !== undefined &&
+            typeof childValue === "object" &&
+            childValue !== null &&
+            !Array.isArray(childValue) &&
+            typeof parentValue === "object" &&
+            parentValue !== null &&
+            !Array.isArray(parentValue)) {
+            // Recursively merge objects
+            result[key] = deepMerge(parentValue, childValue);
+        }
+        else if (childValue !== undefined) {
+            // Child overrides parent
+            result[key] = childValue;
+        }
+    }
+    return result;
+}
+/**
+ * Merge two personas (child inherits from parent)
+ */
+export function mergePersonas(parent, child) {
+    return {
+        // Scalars: child overrides
+        name: child.name,
+        description: child.description ?? parent.description,
+        cmd: child.cmd ?? parent.cmd, // inherit cmd if not specified
+        path: child.path,
+        parent: parent.path,
+        // Objects: deep merge
+        env: deepMerge(parent.env ?? {}, child.env ?? {}),
+        // Arrays: merge with negation
+        skills: mergeArraysWithNegation(parent.skills ?? [], child.skills ?? []),
+        // Prompt: child replaces entirely if present
+        prompt: child.prompt ?? parent.prompt,
+    };
+}
+/**
+ * Resolve a persona with full inheritance chain
+ */
+export async function resolvePersona(personaPath, personasRoot) {
+    const chain = buildInheritanceChain(personaPath, personasRoot);
+    const inheritanceChain = [];
+    let resolved = null;
+    for (const path of chain) {
+        if (await hasPersonaFile(path)) {
+            const persona = await loadPersona(path);
+            inheritanceChain.push(path);
+            if (resolved === null) {
+                resolved = persona;
+            }
+            else {
+                resolved = mergePersonas(resolved, persona);
+            }
+        }
+    }
+    if (resolved === null) {
+        throw new Error(`No persona found at path: ${personaPath}`);
+    }
+    // Normalize cmd to array
+    const cmd = Array.isArray(resolved.cmd) ? resolved.cmd : [resolved.cmd];
+    return {
+        name: resolved.name,
+        description: resolved.description,
+        cmd,
+        env: resolved.env ?? {},
+        skills: resolved.skills ?? [],
+        prompt: resolved.prompt,
+        path: resolved.path,
+        inheritanceChain,
+    };
+}
+/**
+ * List all personas in a directory (recursive)
+ */
+export async function listPersonas(personasRoot) {
+    const personas = [];
+    async function scanDir(dir) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const subDir = join(dir, entry.name);
+                    if (await hasPersonaFile(subDir)) {
+                        personas.push(subDir);
+                    }
+                    await scanDir(subDir);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+    }
+    await scanDir(personasRoot);
+    return personas;
+}
+//# sourceMappingURL=persona.js.map

package/dist/lib/persona.js.map

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

package/dist/lib/types/index.d.ts

@@ -0,0 +1,69 @@
+export * from "./persona.js";
+export * from "./workflow.js";
+export * from "./triggers.js";
+/**
+ * Execution context for variable expansion
+ */
+export interface ExecutionContext {
+    /** Current date (YYYY-MM-DD) */
+    DATE: string;
+    /** Current datetime (ISO 8601) */
+    DATETIME: string;
+    /** Current time (HH:MM:SS) */
+    TIME: string;
+    /** Unique run identifier */
+    RUN_ID: string;
+    /** Workflow name (if running a workflow) */
+    WORKFLOW_NAME?: string;
+    /** Path to workflow directory */
+    WORKFLOW_DIR?: string;
+    /** Resolved persona name */
+    PERSONA_NAME?: string;
+    /** Path to persona directory */
+    PERSONA_DIR?: string;
+    /** Path to .agents root */
+    AGENTS_DIR?: string;
+    /** Additional context variables */
+    [key: string]: string | undefined;
+}
+/**
+ * Result of a workflow execution
+ */
+export interface ExecutionResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Exit code from agent process */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Execution duration in milliseconds */
+    duration: number;
+    /** Unique run identifier */
+    runId: string;
+    /** Start timestamp */
+    startedAt: Date;
+    /** End timestamp */
+    endedAt: Date;
+    /** Output files that were created */
+    outputs?: string[];
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Configuration for the dot-agents framework
+ */
+export interface DotAgentsConfig {
+    /** Root directory for .agents */
+    agentsDir: string;
+    /** Directory for personas */
+    personasDir: string;
+    /** Directory for workflows */
+    workflowsDir: string;
+    /** Directory for skills */
+    skillsDir: string;
+    /** Directory for session logs and runtime state */
+    sessionsDir: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,IAAI,CAAC;IACd,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/lib/types/index.js

@@ -0,0 +1,4 @@
+export * from "./persona.js";
+export * from "./workflow.js";
+export * from "./triggers.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/lib/types/persona.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Persona configuration - defines how to invoke an agent
+ */
+export interface PersonaFrontmatter {
+    /** Unique identifier for this persona */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Agent invocation command(s) - tried in order as fallbacks */
+    cmd: string | string[];
+    /** Environment variables (supports ${VAR} expansion) */
+    env?: Record<string, string>;
+    /** Enabled skills - glob patterns, use ! for negation */
+    skills?: string[];
+}
+/**
+ * Parsed persona including frontmatter and body content
+ */
+export interface Persona extends PersonaFrontmatter {
+    /** Path to the persona directory */
+    path: string;
+    /** System prompt from markdown body (supports ${VAR} expansion) */
+    prompt?: string;
+    /** Parent persona path if this is a child (for tracking) */
+    parent?: string;
+}
+/**
+ * Resolved persona with all inheritance applied and arrays merged
+ */
+export interface ResolvedPersona {
+    name: string;
+    description?: string;
+    /** Resolved command list */
+    cmd: string[];
+    /** Merged environment variables */
+    env: Record<string, string>;
+    /** Merged and filtered skills (negations applied) */
+    skills: string[];
+    /** Combined system prompt */
+    prompt?: string;
+    /** Full path to persona */
+    path: string;
+    /** Inheritance chain (root to leaf) */
+    inheritanceChain: string[];
+}
+//# sourceMappingURL=persona.d.ts.map

package/dist/lib/types/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../../src/lib/types/persona.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,kBAAkB;IACjD,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/lib/types/persona.js

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

package/dist/lib/types/persona.js.map

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

package/dist/lib/types/triggers.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Trigger-specific input overrides
+ */
+export interface TriggerInputOverride {
+    [inputName: string]: string | number | boolean;
+}
+/**
+ * Schedule trigger - cron-based execution
+ */
+export interface ScheduleTrigger {
+    /** Cron expression (e.g., "0 9 * * 1-5") */
+    cron: string;
+    /** Optional input overrides for this schedule */
+    inputs?: TriggerInputOverride;
+}
+/**
+ * Manual trigger configuration (equivalent to workflow_dispatch)
+ */
+export interface ManualTrigger {
+    /** Additional inputs specific to manual invocation */
+    inputs?: Record<string, {
+        description?: string;
+        default?: string | number | boolean;
+        required?: boolean;
+    }>;
+}
+/**
+ * File change trigger - watch for filesystem changes
+ */
+export interface FileChangeTrigger {
+    /** Glob patterns to watch (supports ! negation) */
+    paths: string[];
+    /** Event types to trigger on */
+    events?: ("modify" | "create" | "delete")[];
+}
+/**
+ * Webhook trigger - HTTP endpoint
+ */
+export interface WebhookTrigger {
+    /** URL path for the webhook endpoint */
+    path: string;
+    /** Secret for validation (supports ${VAR} expansion) */
+    secret?: string;
+}
+/**
+ * Workflow completion trigger - run after another workflow
+ */
+export interface WorkflowCompleteTrigger {
+    /** Name of workflow to watch */
+    workflow: string;
+    /** Status conditions to trigger on */
+    status?: ("success" | "failure" | "any")[];
+}
+/**
+ * Git event trigger
+ */
+export interface GitTrigger {
+    /** Git events to trigger on */
+    events: ("post-commit" | "post-merge" | "pre-push")[];
+    /** Branch filter */
+    branches?: string[];
+}
+/**
+ * GitHub event trigger
+ */
+export interface GitHubTrigger {
+    /** GitHub event types */
+    events: ("pull_request" | "issues" | "push" | "release")[];
+    /** Activity types within the event */
+    types?: string[];
+    /** Additional filters */
+    filters?: {
+        branches?: string[];
+        labels?: string[];
+    };
+}
+/**
+ * All workflow triggers
+ */
+export interface WorkflowTriggers {
+    /** Cron-based schedules */
+    schedule?: ScheduleTrigger[];
+    /** Manual/on-demand trigger */
+    manual?: boolean | ManualTrigger;
+    /** File system change trigger */
+    file_change?: FileChangeTrigger;
+    /** Webhook trigger */
+    webhook?: WebhookTrigger;
+    /** Workflow completion trigger */
+    workflow_complete?: WorkflowCompleteTrigger;
+    /** Git event trigger */
+    git?: GitTrigger;
+    /** GitHub event trigger */
+    github?: GitHubTrigger;
+}
+//# sourceMappingURL=triggers.d.ts.map

package/dist/lib/types/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/lib/types/triggers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CACb,MAAM,EACN;QACE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CACF,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gCAAgC;IAChC,MAAM,CAAC,EAAE,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,MAAM,EAAE,CAAC,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC,EAAE,CAAC;IACtD,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,MAAM,EAAE,CAAC,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC3D,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yBAAyB;IACzB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IACjC,iCAAiC;IACjC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,sBAAsB;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,wBAAwB;IACxB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB"}

package/dist/lib/types/triggers.js

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

package/dist/lib/types/triggers.js.map

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

package/dist/lib/types/workflow.d.ts

@@ -0,0 +1,75 @@
+import type { WorkflowTriggers } from "./triggers.js";
+/**
+ * Workflow input parameter definition
+ */
+export interface WorkflowInput {
+    /** Parameter name (used as ${name} in templates) */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Default value if not provided */
+    default?: string | number | boolean;
+    /** Whether this input is required */
+    required?: boolean;
+    /** Type hint for validation */
+    type?: "string" | "number" | "boolean" | "path";
+    /** Allowed values (for enum-like inputs) */
+    enum?: (string | number)[];
+}
+/**
+ * Workflow output artifact definition
+ */
+export interface WorkflowOutput {
+    /** Output file path (supports ${VAR} expansion) */
+    path: string;
+    /** Description of this output */
+    description?: string;
+    /** Whether to fail if this output is not created */
+    required?: boolean;
+}
+/**
+ * Retry policy for failed workflow executions
+ */
+export interface RetryPolicy {
+    /** Total number of attempts (including first) */
+    attempts: number;
+    /** Delay between attempts (e.g., "30s", "1m") */
+    delay: string;
+    /** Multiplier for exponential backoff */
+    backoff?: number;
+}
+/**
+ * Workflow frontmatter configuration
+ */
+export interface WorkflowFrontmatter {
+    /** Unique workflow identifier */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Persona path to use for execution (e.g., "claude/autonomous") */
+    persona: string;
+    /** Trigger configuration */
+    on?: WorkflowTriggers;
+    /** Input parameters */
+    inputs?: WorkflowInput[];
+    /** Expected output artifacts */
+    outputs?: WorkflowOutput[];
+    /** Workflow-specific environment variables */
+    env?: Record<string, string>;
+    /** Maximum execution time (e.g., "5m", "1h") */
+    timeout?: string;
+    /** Retry policy on failure */
+    retry?: RetryPolicy;
+    /** Working directory for execution */
+    working_dir?: string;
+}
+/**
+ * Parsed workflow including frontmatter and body content
+ */
+export interface Workflow extends WorkflowFrontmatter {
+    /** Path to the workflow directory */
+    path: string;
+    /** Task/prompt content from markdown body */
+    task: string;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/lib/types/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/lib/types/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,4CAA4C;IAC5C,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,uBAAuB;IACvB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,gCAAgC;IAChC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,mBAAmB;IACnD,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/lib/types/workflow.js

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

package/dist/lib/types/workflow.js.map

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

package/dist/lib/variables.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionContext } from "./types/index.js";
+/**
+ * Generate a unique run ID
+ */
+export declare function generateRunId(): string;
+/**
+ * Create execution context with built-in variables
+ */
+export declare function createExecutionContext(overrides?: Partial<ExecutionContext>): ExecutionContext;
+/**
+ * Expand environment variables in a string
+ * Supports ${VAR} syntax
+ */
+export declare function expandVariables(template: string, context: Record<string, string | undefined>, env?: Record<string, string | undefined>): string;
+/**
+ * Expand variables in an object's string values (recursive)
+ */
+export declare function expandObjectVariables<T extends Record<string, unknown>>(obj: T, context: Record<string, string | undefined>, env?: Record<string, string | undefined>): T;
+/**
+ * Process simple conditionals in a template
+ * Supports: {{#if var}}...{{/if}} and {{#unless var}}...{{/unless}}
+ */
+export declare function processConditionals(template: string, context: Record<string, unknown>): string;
+/**
+ * Full template processing: conditionals then variable expansion
+ */
+export declare function processTemplate(template: string, context: Record<string, unknown>, env?: Record<string, string | undefined>): string;
+//# sourceMappingURL=variables.d.ts.map

package/dist/lib/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/lib/variables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACxC,gBAAgB,CAUlB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAGrC,GACA,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACvC,CAAC,CA8BH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CA0CR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACvC,MAAM,CAeR"}