@synergenius/flow-weaver 0.33.2 → 0.44.0

package/dist/chevrotain-parser/trigger-cancel-parser.js

@@ -1,291 +0,0 @@
-/**
- * @module chevrotain-parser/trigger-cancel-parser
- *
- * Shared Chevrotain parser for @trigger, @cancelOn, @retries, @timeout, @throttle annotations.
- */
-import { CstParser } from 'chevrotain';
-import { JSDocLexer, TriggerTag, CancelOnTag, RetriesTag, TimeoutTag, ThrottleTag, EventEq, CronEq, MatchEq, TimeoutEq, LimitEq, PeriodEq, StringLiteral, Integer, allTokens, } from './tokens.js';
-// =============================================================================
-// Helpers
-// =============================================================================
-function stripQuotes(s) {
-    if (s.startsWith('"') && s.endsWith('"')) {
-        return s.slice(1, -1);
-    }
-    return s;
-}
-const CRON_REGEX = /^(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)\s+(\*|[0-9,\-\/]+)$/;
-// =============================================================================
-// Parser Definition
-// =============================================================================
-class TriggerCancelParser extends CstParser {
-    constructor() {
-        super(allTokens);
-        this.performSelfAnalysis();
-    }
-    // @trigger event="agent/request" cron="0 9 * * *"
-    triggerLine = this.RULE('triggerLine', () => {
-        this.CONSUME(TriggerTag);
-        this.MANY(() => {
-            this.OR([
-                { ALT: () => {
-                        this.CONSUME(EventEq);
-                        this.CONSUME(StringLiteral, { LABEL: 'eventValue' });
-                    } },
-                { ALT: () => {
-                        this.CONSUME(CronEq);
-                        this.CONSUME2(StringLiteral, { LABEL: 'cronValue' });
-                    } },
-            ]);
-        });
-    });
-    // @cancelOn event="app/user.deleted" match="data.userId" timeout="1h"
-    cancelOnLine = this.RULE('cancelOnLine', () => {
-        this.CONSUME(CancelOnTag);
-        this.CONSUME(EventEq);
-        this.CONSUME(StringLiteral, { LABEL: 'eventValue' });
-        this.OPTION(() => {
-            this.CONSUME(MatchEq);
-            this.CONSUME2(StringLiteral, { LABEL: 'matchValue' });
-        });
-        this.OPTION2(() => {
-            this.CONSUME(TimeoutEq);
-            this.CONSUME3(StringLiteral, { LABEL: 'timeoutValue' });
-        });
-    });
-    // @retries 5
-    retriesLine = this.RULE('retriesLine', () => {
-        this.CONSUME(RetriesTag);
-        this.CONSUME(Integer, { LABEL: 'retriesValue' });
-    });
-    // @timeout "30m"
-    timeoutLine = this.RULE('timeoutLine', () => {
-        this.CONSUME(TimeoutTag);
-        this.CONSUME(StringLiteral, { LABEL: 'timeoutValue' });
-    });
-    // @throttle limit=3 period="1m"
-    throttleLine = this.RULE('throttleLine', () => {
-        this.CONSUME(ThrottleTag);
-        this.CONSUME(LimitEq);
-        this.CONSUME(Integer, { LABEL: 'limitValue' });
-        this.OPTION(() => {
-            this.CONSUME(PeriodEq);
-            this.CONSUME(StringLiteral, { LABEL: 'periodValue' });
-        });
-    });
-}
-// =============================================================================
-// Parser Instance (singleton)
-// =============================================================================
-const parserInstance = new TriggerCancelParser();
-// =============================================================================
-// CST Visitor
-// =============================================================================
-const BaseVisitor = parserInstance.getBaseCstVisitorConstructor();
-class TriggerCancelVisitor extends BaseVisitor {
-    constructor() {
-        super();
-        this.validateVisitor();
-    }
-    triggerLine(ctx) {
-        const result = {};
-        if (ctx.eventValue?.[0]) {
-            result.event = stripQuotes(ctx.eventValue[0].image);
-        }
-        if (ctx.cronValue?.[0]) {
-            result.cron = stripQuotes(ctx.cronValue[0].image);
-        }
-        return result;
-    }
-    cancelOnLine(ctx) {
-        const result = {
-            event: stripQuotes(ctx.eventValue[0].image),
-        };
-        if (ctx.matchValue?.[0]) {
-            result.match = stripQuotes(ctx.matchValue[0].image);
-        }
-        if (ctx.timeoutValue?.[0]) {
-            result.timeout = stripQuotes(ctx.timeoutValue[0].image);
-        }
-        return result;
-    }
-    retriesLine(ctx) {
-        return { retries: parseInt(ctx.retriesValue[0].image, 10) };
-    }
-    timeoutLine(ctx) {
-        return { timeout: stripQuotes(ctx.timeoutValue[0].image) };
-    }
-    throttleLine(ctx) {
-        const result = {
-            limit: parseInt(ctx.limitValue[0].image, 10),
-        };
-        if (ctx.periodValue?.[0]) {
-            result.period = stripQuotes(ctx.periodValue[0].image);
-        }
-        return result;
-    }
-}
-const visitorInstance = new TriggerCancelVisitor();
-// =============================================================================
-// Public API
-// =============================================================================
-/**
- * Parse a @trigger line and return structured result.
- * Returns null if the line is not a trigger declaration.
- */
-export function parseTriggerLine(input, warnings) {
-    const lexResult = JSDocLexer.tokenize(input);
-    if (lexResult.errors.length > 0) {
-        return null;
-    }
-    if (lexResult.tokens.length === 0) {
-        return null;
-    }
-    const firstToken = lexResult.tokens[0];
-    if (firstToken.tokenType !== TriggerTag) {
-        return null;
-    }
-    parserInstance.input = lexResult.tokens;
-    const cst = parserInstance.triggerLine();
-    if (parserInstance.errors.length > 0) {
-        // Don't warn here — return null so domain-specific handlers (e.g. CI/CD)
-        // get a chance to parse the trigger. The caller can warn if nothing handles it.
-        return null;
-    }
-    const result = visitorInstance.visit(cst);
-    // Empty result means the parser consumed @trigger but found no event=/cron= assignments.
-    // Return null so the caller can delegate to domain-specific handlers (e.g. CI/CD triggers
-    // like @trigger push, @trigger pull_request, etc.)
-    if (!result.event && !result.cron) {
-        return null;
-    }
-    // Validate cron expression
-    if (result.cron && !CRON_REGEX.test(result.cron)) {
-        warnings.push(`Invalid cron expression: "${result.cron}". Expected 5 fields (minute hour day month weekday).`);
-    }
-    return result;
-}
-/**
- * Parse a @cancelOn line and return structured result.
- * Returns null if the line is not a cancelOn declaration.
- */
-export function parseCancelOnLine(input, warnings) {
-    const lexResult = JSDocLexer.tokenize(input);
-    if (lexResult.errors.length > 0) {
-        return null;
-    }
-    if (lexResult.tokens.length === 0) {
-        return null;
-    }
-    const firstToken = lexResult.tokens[0];
-    if (firstToken.tokenType !== CancelOnTag) {
-        return null;
-    }
-    parserInstance.input = lexResult.tokens;
-    const cst = parserInstance.cancelOnLine();
-    if (parserInstance.errors.length > 0) {
-        const firstError = parserInstance.errors[0];
-        const truncatedInput = input.length > 60 ? input.substring(0, 60) + '...' : input;
-        warnings.push(`Failed to parse cancelOn line: "${truncatedInput}"\n` +
-            `  Error: ${firstError.message}\n` +
-            `  Expected format: @cancelOn event="name" match="field" timeout="duration"`);
-        return null;
-    }
-    return visitorInstance.visit(cst);
-}
-/**
- * Parse a @retries line and return structured result.
- * Returns null if the line is not a retries declaration.
- */
-export function parseRetriesLine(input, warnings) {
-    const lexResult = JSDocLexer.tokenize(input);
-    if (lexResult.errors.length > 0) {
-        return null;
-    }
-    if (lexResult.tokens.length === 0) {
-        return null;
-    }
-    const firstToken = lexResult.tokens[0];
-    if (firstToken.tokenType !== RetriesTag) {
-        return null;
-    }
-    parserInstance.input = lexResult.tokens;
-    const cst = parserInstance.retriesLine();
-    if (parserInstance.errors.length > 0) {
-        const firstError = parserInstance.errors[0];
-        const truncatedInput = input.length > 60 ? input.substring(0, 60) + '...' : input;
-        warnings.push(`Failed to parse retries line: "${truncatedInput}"\n` +
-            `  Error: ${firstError.message}\n` +
-            `  Expected format: @retries <integer>`);
-        return null;
-    }
-    const result = visitorInstance.visit(cst);
-    // Validate non-negative
-    if (result.retries < 0) {
-        warnings.push(`Invalid @retries value: ${result.retries}. Expected non-negative integer.`);
-    }
-    return result;
-}
-/**
- * Parse a @timeout line and return structured result.
- * Returns null if the line is not a timeout declaration.
- */
-export function parseTimeoutLine(input, warnings) {
-    const lexResult = JSDocLexer.tokenize(input);
-    if (lexResult.errors.length > 0) {
-        return null;
-    }
-    if (lexResult.tokens.length === 0) {
-        return null;
-    }
-    const firstToken = lexResult.tokens[0];
-    if (firstToken.tokenType !== TimeoutTag) {
-        return null;
-    }
-    parserInstance.input = lexResult.tokens;
-    const cst = parserInstance.timeoutLine();
-    if (parserInstance.errors.length > 0) {
-        const firstError = parserInstance.errors[0];
-        const truncatedInput = input.length > 60 ? input.substring(0, 60) + '...' : input;
-        warnings.push(`Failed to parse timeout line: "${truncatedInput}"\n` +
-            `  Error: ${firstError.message}\n` +
-            `  Expected format: @timeout "duration"`);
-        return null;
-    }
-    return visitorInstance.visit(cst);
-}
-/**
- * Parse a @throttle line and return structured result.
- * Returns null if the line is not a throttle declaration.
- */
-/**
- * Get serialized grammar productions for documentation/diagrams.
- */
-export function getTriggerCancelGrammar() {
-    return parserInstance.getSerializedGastProductions();
-}
-export function parseThrottleLine(input, warnings) {
-    const lexResult = JSDocLexer.tokenize(input);
-    if (lexResult.errors.length > 0) {
-        return null;
-    }
-    if (lexResult.tokens.length === 0) {
-        return null;
-    }
-    const firstToken = lexResult.tokens[0];
-    if (firstToken.tokenType !== ThrottleTag) {
-        return null;
-    }
-    parserInstance.input = lexResult.tokens;
-    const cst = parserInstance.throttleLine();
-    if (parserInstance.errors.length > 0) {
-        const firstError = parserInstance.errors[0];
-        const truncatedInput = input.length > 60 ? input.substring(0, 60) + '...' : input;
-        warnings.push(`Failed to parse throttle line: "${truncatedInput}"\n` +
-            `  Error: ${firstError.message}\n` +
-            `  Expected format: @throttle limit=<number> period="duration"`);
-        return null;
-    }
-    return visitorInstance.visit(cst);
-}
-//# sourceMappingURL=trigger-cancel-parser.js.map

package/dist/cli/commands/account.d.ts

@@ -1,4 +0,0 @@
-export declare function formatLimit(used: number, limit: number): string;
-export declare function usageBar(used: number, limit: number, width?: number): string;
-export declare function accountCommand(): Promise<void>;
-//# sourceMappingURL=account.d.ts.map

package/dist/cli/commands/account.js

@@ -1,50 +0,0 @@
-import { requireLogin, fmt, exitWithError } from '../utils/cli-helpers.js';
-export function formatLimit(used, limit) {
-    if (limit === -1)
-        return `${used} (unlimited)`;
-    return `${used} / ${limit}`;
-}
-export function usageBar(used, limit, width = 20) {
-    if (limit === -1)
-        return '\x1b[36m∞\x1b[0m';
-    if (limit <= 0)
-        return '\x1b[2m-\x1b[0m';
-    const ratio = Math.min(used / limit, 1);
-    const filled = Math.round(ratio * width);
-    const empty = width - filled;
-    const color = ratio >= 0.9 ? '\x1b[31m' : ratio >= 0.7 ? '\x1b[33m' : '\x1b[32m';
-    return `${color}${'█'.repeat(filled)}\x1b[2m${'░'.repeat(empty)}\x1b[0m`;
-}
-export async function accountCommand() {
-    const { creds, client } = requireLogin();
-    try {
-        const [user, usage] = await Promise.all([
-            client.getUser(),
-            client.getDetailedUsage().catch(() => null),
-        ]);
-        console.log('');
-        console.log(`  ${fmt.bold(user.name)}`);
-        console.log(`  ${user.email}`);
-        console.log(`  Plan: ${user.plan}`);
-        console.log(`  Platform: ${fmt.dim(creds.platformUrl)}`);
-        if (usage) {
-            console.log('');
-            const rows = [
-                { label: 'Workflows', ...usage.usage.workflows },
-                { label: 'Deployments', ...usage.usage.deployments },
-                { label: 'Executions', ...usage.usage.executions },
-            ];
-            for (const row of rows) {
-                const bar = usageBar(row.used, row.limit);
-                const nums = formatLimit(row.used, row.limit);
-                console.log(`  ${row.label.padEnd(14)} ${bar}  ${nums}`);
-            }
-            console.log(`  ${'Timeout'.padEnd(14)} ${usage.limits.timeoutMs / 1000}s per run`);
-        }
-        console.log('');
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to fetch account');
-    }
-}
-//# sourceMappingURL=account.js.map

package/dist/cli/commands/ai-credentials.d.ts

@@ -1,12 +0,0 @@
-export declare function aiAddCommand(provider: string, options: {
-    key?: string;
-    label?: string;
-    model?: string;
-    default?: boolean;
-}): Promise<void>;
-export declare function aiListCommand(): Promise<void>;
-export declare function aiRevokeCommand(id: string, options: {
-    force?: boolean;
-}): Promise<void>;
-export declare function aiTestCommand(id: string): Promise<void>;
-//# sourceMappingURL=ai-credentials.d.ts.map

package/dist/cli/commands/ai-credentials.js

@@ -1,95 +0,0 @@
-import { requireLogin, readLine, confirm, fmt, exitWithError } from '../utils/cli-helpers.js';
-const VALID_PROVIDERS = ['anthropic', 'openai'];
-export async function aiAddCommand(provider, options) {
-    const { client } = requireLogin();
-    try {
-        if (!VALID_PROVIDERS.includes(provider)) {
-            throw new Error(`Invalid provider "${provider}". Use: ${VALID_PROVIDERS.join(', ')}`);
-        }
-        // Read key from --key flag or prompt via stdin (non-TTY requires --key)
-        let apiKey = options.key;
-        if (!apiKey) {
-            apiKey = await readLine('  Enter API key: ') ?? undefined;
-            if (!apiKey) {
-                throw new Error('No API key provided. Use --key <key> or run in a terminal.');
-            }
-        }
-        const label = options.label ?? `${provider} key`;
-        const cred = await client.createAiCredential({
-            provider,
-            label,
-            apiKey,
-            defaultModel: options.model,
-            isDefault: options.default,
-        });
-        console.log('');
-        console.log(fmt.ok('Credential added'));
-        console.log('');
-        console.log(`  Provider: ${cred.provider}`);
-        console.log(`  Label:    ${cred.label}`);
-        console.log(`  ID:       ${fmt.dim(cred.id)}`);
-        console.log('');
-        console.log(`  Test it:  fw ai test ${cred.id}`);
-        console.log('');
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to add credential');
-    }
-}
-export async function aiListCommand() {
-    const { client } = requireLogin();
-    try {
-        const creds = await client.listAiCredentials();
-        console.log('');
-        if (creds.length === 0) {
-            console.log('  No AI credentials. Add one with: fw ai add <provider>');
-        }
-        else {
-            console.log(`  ${creds.length} credential${creds.length === 1 ? '' : 's'}:`);
-            console.log('');
-            for (const c of creds) {
-                const def = c.isDefault ? ` ${fmt.yellow('★ default')}` : '';
-                const model = c.defaultModel ? ` ${fmt.dim(`(${c.defaultModel})`)}` : '';
-                console.log(`    ${fmt.cyan(c.provider.padEnd(10))} ${c.label}${model}${def}  ${fmt.dim(c.id)}`);
-            }
-        }
-        console.log('');
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to list credentials');
-    }
-}
-export async function aiRevokeCommand(id, options) {
-    const { client } = requireLogin();
-    if (!options.force) {
-        const confirmed = await confirm('  Are you sure? This cannot be undone. [y/N] ');
-        if (!confirmed) {
-            console.log('  Cancelled.');
-            return;
-        }
-    }
-    try {
-        await client.revokeAiCredential(id);
-        console.log(fmt.ok('Credential revoked'));
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to revoke credential');
-    }
-}
-export async function aiTestCommand(id) {
-    const { client } = requireLogin();
-    try {
-        console.log(`  ${fmt.dim('Testing credential...')}`);
-        const result = await client.testAiCredential(id);
-        if (result.success) {
-            console.log(fmt.ok('Credential is valid'));
-        }
-        else {
-            console.log(fmt.err(`Credential test failed${result.message ? `: ${result.message}` : ''}`));
-        }
-    }
-    catch (err) {
-        exitWithError(err, 'Test failed');
-    }
-}
-//# sourceMappingURL=ai-credentials.js.map

package/dist/cli/commands/apikey.d.ts

@@ -1,4 +0,0 @@
-export declare function apiKeyCreateCommand(name: string): Promise<void>;
-export declare function apiKeyListCommand(): Promise<void>;
-export declare function apiKeyRevokeCommand(idOrPrefix: string): Promise<void>;
-//# sourceMappingURL=apikey.d.ts.map

package/dist/cli/commands/apikey.js

@@ -1,64 +0,0 @@
-import { requireLogin, isUuid, fmt, exitWithError } from '../utils/cli-helpers.js';
-export async function apiKeyCreateCommand(name) {
-    const { client } = requireLogin();
-    try {
-        const apiKey = await client.createApiKey(name);
-        console.log('');
-        console.log(fmt.ok('API key created'));
-        console.log('');
-        console.log(`  Name:   ${apiKey.name}`);
-        console.log(`  Key:    ${fmt.bold(apiKey.key)}`);
-        console.log(`  Prefix: ${apiKey.keyPrefix}`);
-        console.log('');
-        console.log(`  ${fmt.yellow('⚠')} Copy this key now — it cannot be shown again.`);
-        console.log('');
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to create API key');
-    }
-}
-export async function apiKeyListCommand() {
-    const { client } = requireLogin();
-    try {
-        const keys = await client.listApiKeys();
-        console.log('');
-        if (keys.length === 0) {
-            console.log('  No API keys. Create one with: fw apikey create <name>');
-        }
-        else {
-            console.log(`  ${keys.length} API key${keys.length === 1 ? '' : 's'}:`);
-            console.log('');
-            for (const key of keys) {
-                const date = new Date(key.createdAt).toLocaleDateString();
-                console.log(`    ${fmt.cyan(key.keyPrefix + '...')}  ${key.name.padEnd(20)}  ${date}  ${fmt.dim(key.id)}`);
-            }
-        }
-        console.log('');
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to list API keys');
-    }
-}
-export async function apiKeyRevokeCommand(idOrPrefix) {
-    const { client } = requireLogin();
-    try {
-        let id = idOrPrefix;
-        if (!isUuid(idOrPrefix)) {
-            const keys = await client.listApiKeys();
-            const match = keys.filter((k) => k.keyPrefix.startsWith(idOrPrefix) || k.id.startsWith(idOrPrefix));
-            if (match.length === 0) {
-                throw new Error(`No API key matching "${idOrPrefix}"`);
-            }
-            if (match.length > 1) {
-                throw new Error(`Ambiguous: "${idOrPrefix}" matches ${match.length} keys. Use the full ID.`);
-            }
-            id = match[0].id;
-        }
-        await client.revokeApiKey(id);
-        console.log(fmt.ok('API key revoked'));
-    }
-    catch (err) {
-        exitWithError(err, 'Failed to revoke API key');
-    }
-}
-//# sourceMappingURL=apikey.js.map

package/dist/cli/commands/auth.d.ts

@@ -1,9 +0,0 @@
-export declare function loginCommand(options: {
-    email?: string;
-    password?: string;
-    apiKey?: string;
-    platformUrl?: string;
-}): Promise<void>;
-export declare function logoutCommand(): Promise<void>;
-export declare function authStatusCommand(): Promise<void>;
-//# sourceMappingURL=auth.d.ts.map