actoviq-agent-sdk 0.4.0 → 0.4.2

package/dist/src/workflow/workflowPersistence.d.ts

@@ -0,0 +1,34 @@
+import type { WorkflowMeta } from '../types.js';
+export interface SavedWorkflow {
+    name: string;
+    description: string;
+    script: string;
+    source: 'project' | 'personal';
+    filePath: string;
+    meta?: WorkflowMeta;
+}
+/**
+ * Load a workflow script by name. Project workflows override personal ones.
+ */
+export declare function loadWorkflow(name: string, projectDir?: string, homeDir?: string): SavedWorkflow | null;
+/**
+ * Save a workflow script to disk.
+ */
+export declare function saveWorkflow(name: string, script: string, options?: {
+    projectDir?: string;
+    homeDir?: string;
+    overwrite?: boolean;
+}): Promise<string>;
+/**
+ * List all saved workflows from all search paths.
+ */
+export declare function listWorkflows(projectDir?: string, homeDir?: string): SavedWorkflow[];
+/**
+ * Delete a saved workflow.
+ */
+export declare function deleteWorkflow(name: string, projectDir?: string, homeDir?: string): Promise<boolean>;
+/**
+ * Check if dynamic workflows are disabled.
+ */
+export declare function isWorkflowsDisabled(): boolean;
+//# sourceMappingURL=workflowPersistence.d.ts.map

package/dist/src/workflow/workflowPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowPersistence.d.ts","sourceRoot":"","sources":["../../../src/workflow/workflowPersistence.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAgBD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,GAAG,IAAI,CAqBtB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3E,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,EAAE,CAmCjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAI7C"}

package/dist/src/workflow/workflowPersistence.js

@@ -0,0 +1,144 @@
+/**
+ * Workflow persistence — save/load workflow scripts to/from disk.
+ *
+ * Search path (project overrides personal):
+ *   1. .actoviq/workflows/<name>.js   (project)
+ *   2. ~/.actoviq/workflows/<name>.js (personal)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { mkdir } from 'node:fs/promises';
+/**
+ * Resolve the search paths for workflow scripts.
+ */
+function resolveWorkflowDirs(projectDir, homeDir) {
+    const dirs = [];
+    const home = homeDir ?? process.env.ACTOVIQ_HOME ?? path.join(process.env.HOME ?? process.env.USERPROFILE ?? '.', '.actoviq');
+    if (projectDir) {
+        dirs.push(path.join(projectDir, '.actoviq', 'workflows'));
+    }
+    dirs.push(path.join(home, 'workflows'));
+    return dirs;
+}
+/**
+ * Load a workflow script by name. Project workflows override personal ones.
+ */
+export function loadWorkflow(name, projectDir, homeDir) {
+    const dirs = resolveWorkflowDirs(projectDir, homeDir);
+    for (let i = 0; i < dirs.length; i++) {
+        const dir = dirs[i];
+        const filePath = path.join(dir, `${name}.js`);
+        if (fs.existsSync(filePath)) {
+            const script = fs.readFileSync(filePath, 'utf-8');
+            const meta = extractWorkflowMeta(script);
+            return {
+                name,
+                description: meta?.description ?? script.slice(0, 100),
+                script,
+                source: i === 0 && projectDir ? 'project' : 'personal',
+                filePath,
+                meta,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Save a workflow script to disk.
+ */
+export async function saveWorkflow(name, script, options = {}) {
+    const dirs = resolveWorkflowDirs(options.projectDir, options.homeDir);
+    // Save to project dir if available, otherwise personal
+    const targetDir = dirs[0];
+    await mkdir(targetDir, { recursive: true });
+    const filePath = path.join(targetDir, `${name}.js`);
+    if (fs.existsSync(filePath) && !options.overwrite) {
+        throw new Error(`Workflow "${name}" already exists at ${filePath}. Use overwrite: true to replace.`);
+    }
+    fs.writeFileSync(filePath, script, 'utf-8');
+    return filePath;
+}
+/**
+ * List all saved workflows from all search paths.
+ */
+export function listWorkflows(projectDir, homeDir) {
+    const dirs = resolveWorkflowDirs(projectDir, homeDir);
+    const seen = new Set();
+    const workflows = [];
+    for (let i = 0; i < dirs.length; i++) {
+        const dir = dirs[i];
+        if (!fs.existsSync(dir))
+            continue;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile() || !entry.name.endsWith('.js'))
+                    continue;
+                const name = entry.name.slice(0, -3);
+                if (seen.has(name))
+                    continue; // project overrides personal
+                seen.add(name);
+                const filePath = path.join(dir, entry.name);
+                const script = fs.readFileSync(filePath, 'utf-8');
+                const meta = extractWorkflowMeta(script);
+                workflows.push({
+                    name,
+                    description: meta?.description ?? `Workflow: ${name}`,
+                    script,
+                    source: i === 0 && projectDir ? 'project' : 'personal',
+                    filePath,
+                    meta,
+                });
+            }
+        }
+        catch {
+            // Skip inaccessible directories
+        }
+    }
+    return workflows;
+}
+/**
+ * Delete a saved workflow.
+ */
+export async function deleteWorkflow(name, projectDir, homeDir) {
+    const dirs = resolveWorkflowDirs(projectDir, homeDir);
+    for (const dir of dirs) {
+        const filePath = path.join(dir, `${name}.js`);
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if dynamic workflows are disabled.
+ */
+export function isWorkflowsDisabled() {
+    if (process.env.ACTOVIQ_DISABLE_WORKFLOWS === '1')
+        return true;
+    if (process.env.ACTOVIQ_DISABLE_WORKFLOWS === 'true')
+        return true;
+    return false;
+}
+/**
+ * Extract meta from a saved script without executing it.
+ */
+function extractWorkflowMeta(script) {
+    const match = script.match(/export\s+const\s+meta\s*=\s*(\{[\s\S]*?\});/);
+    if (!match)
+        return undefined;
+    try {
+        const metaBlock = match[1];
+        // Safe eval — just a JSON-like object literal
+        const fn = new Function(`return ${metaBlock}`);
+        const meta = fn();
+        if (meta.name && meta.description)
+            return meta;
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return undefined;
+}
+//# sourceMappingURL=workflowPersistence.js.map

package/dist/src/workflow/workflowPersistence.js.map

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

package/dist/src/workflow/workflowScriptRuntime.d.ts

@@ -0,0 +1,22 @@
+import type { WorkflowRunState, WorkflowResumeState } from '../types.js';
+import type { ActoviqAgentClient } from '../runtime/agentClient.js';
+export interface WorkflowRuntimeOptions {
+    sdk: ActoviqAgentClient;
+    maxConcurrent?: number;
+    budgetTotal?: number | null;
+    signal?: AbortSignal;
+    onEvent?: (event: any) => void;
+    resumeState?: WorkflowResumeState;
+    args?: any;
+}
+export declare class WorkflowScriptRuntime {
+    private options;
+    constructor(options: WorkflowRuntimeOptions);
+    execute(script: string): Promise<{
+        result: any;
+        state: WorkflowRunState;
+        resumeState: WorkflowResumeState;
+        logs: string[];
+    }>;
+}
+//# sourceMappingURL=workflowScriptRuntime.d.ts.map

package/dist/src/workflow/workflowScriptRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowScriptRuntime.d.ts","sourceRoot":"","sources":["../../../src/workflow/workflowScriptRuntime.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAIV,gBAAgB,EAChB,mBAAmB,EAMpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAiFpE,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,kBAAkB,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAshBD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,sBAAsB;IAIrC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QACrC,MAAM,EAAE,GAAG,CAAC;QACZ,KAAK,EAAE,gBAAgB,CAAC;QACxB,WAAW,EAAE,mBAAmB,CAAC;QACjC,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CA2HH"}