@uluops/cli 0.2.0

package/dist/commands/versions.js

@@ -0,0 +1,61 @@
+import { createRegistryContext, handleRegistryError } from '../context.js';
+import { withSpinner } from '../utils.js';
+import { formatVersions, formatVersionDiff } from '../formatters/registry.js';
+/**
+ * Register version commands
+ */
+export function registerVersionCommands(program) {
+    const versions = program
+        .command('versions')
+        .description('Manage definition versions');
+    // ulu versions list <type> <name>
+    versions
+        .command('list <type> <name>')
+        .description('List version history for a definition')
+        .action(async (type, name, _, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const ctx = createRegistryContext(globalOpts);
+        try {
+            const data = await withSpinner(ctx, { start: 'Fetching versions...', failure: 'Failed to fetch versions' }, () => ctx.client.versions.list(type, name));
+            if (ctx.json) {
+                console.log(JSON.stringify(data, null, 2));
+            }
+            else if (!data.versions || data.versions.length === 0) {
+                console.log('No versions found');
+            }
+            else {
+                console.log(formatVersions(data.versions));
+                console.log(`\n${data.versions.length} versions`);
+            }
+        }
+        catch (error) {
+            handleRegistryError(error, ctx);
+        }
+    });
+    // ulu versions diff <type> <name> <from> <to>
+    versions
+        .command('diff <type> <name> <from> <to>')
+        .description('Compare two versions of a definition')
+        .action(async (type, name, from, to, _, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const ctx = createRegistryContext(globalOpts);
+        try {
+            const result = await withSpinner(ctx, { start: 'Comparing versions...', failure: 'Failed to compare versions' }, () => ctx.client.versions.diff(type, name, from, to));
+            if (ctx.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                if ('fromYaml' in result || 'sectionsModified' in result) {
+                    console.log(formatVersionDiff(result));
+                }
+                else {
+                    console.log(JSON.stringify(result, null, 2));
+                }
+            }
+        }
+        catch (error) {
+            handleRegistryError(error, ctx);
+        }
+    });
+}
+//# sourceMappingURL=versions.js.map

package/dist/commands/versions.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,85 @@
+import { OpsClient } from '@uluops/ops-sdk';
+import { RegistryClient } from '@uluops/registry-sdk';
+import { UluOpsClient } from '@uluops/core';
+/**
+ * Global CLI options passed from commander
+ */
+export interface GlobalOptions {
+    apiKey?: string;
+    profile?: string;
+    baseUrl?: string;
+    json?: boolean;
+    debug?: boolean;
+    quiet?: boolean;
+    timeout?: string;
+}
+/**
+ * CLI execution context for ops commands
+ */
+export interface OpsCliContext {
+    client: OpsClient;
+    json: boolean;
+    debug: boolean;
+    quiet: boolean;
+}
+/**
+ * CLI execution context for registry commands
+ */
+export interface RegistryCliContext {
+    client: RegistryClient;
+    json: boolean;
+    debug: boolean;
+    quiet: boolean;
+}
+/**
+ * Options specific to exec commands
+ */
+export interface CoreExecOptions {
+    localDefinitions?: string;
+    registryUrl?: string;
+    project?: string;
+    tracking?: boolean;
+}
+/**
+ * CLI execution context for core SDK commands (exec)
+ */
+export interface CoreCliContext {
+    client: UluOpsClient;
+    json: boolean;
+    debug: boolean;
+    quiet: boolean;
+}
+/**
+ * Create CLI context for ops commands
+ */
+export declare function createOpsContext(options: GlobalOptions): OpsCliContext;
+/**
+ * Create CLI context for registry commands
+ */
+export declare function createRegistryContext(options: GlobalOptions): RegistryCliContext;
+/**
+ * Create context without requiring credentials (for commands like login)
+ */
+export declare function createUnauthenticatedContext(options: GlobalOptions): {
+    baseUrl: string;
+    json: boolean;
+    debug: boolean;
+    quiet: boolean;
+};
+/**
+ * Create CLI context for core SDK commands (exec)
+ */
+export declare function createCoreContext(options: GlobalOptions & CoreExecOptions, modelOverride?: string): CoreCliContext;
+/**
+ * Handle ops errors consistently
+ */
+export declare function handleOpsError(error: unknown, ctx: Pick<OpsCliContext, 'json' | 'debug'>): never;
+/**
+ * Handle registry errors consistently
+ */
+export declare function handleRegistryError(error: unknown, ctx: Pick<RegistryCliContext, 'json' | 'debug'>): never;
+/**
+ * Handle core SDK errors consistently
+ */
+export declare function handleCoreError(error: unknown, ctx: Pick<CoreCliContext, 'json' | 'debug'>): never;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA4C,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACL,YAAY,EAYb,MAAM,cAAc,CAAC;AAOtB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAyCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAsCtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,CA+ChF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAavI;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,cAAc,CAuDlH;AA6ED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,CAOhG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,CAW1G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,CAqGlG"}

package/dist/context.js

@@ -0,0 +1,386 @@
+import { OpsClient, loadConfig as loadOpsConfig, OpsApiError } from '@uluops/ops-sdk';
+import { RegistryClient } from '@uluops/registry-sdk';
+import { RegistryApiError } from '@uluops/registry-sdk/errors';
+import { loadConfig as loadRegistryConfig } from '@uluops/registry-sdk/config';
+import { UluOpsClient, UluOpsError, ConfigurationError, ExecutionError, ModelNotFoundError, PreflightError, ParseError, SubmissionError, WorkflowError, PipelineError, SdkApiError, SubscriptionRequiredError, } from '@uluops/core';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { exitWithError, parseIntOption } from './utils.js';
+/**
+ * Check if the stored session for a profile is expired.
+ * Used to give a specific error message instead of generic "No credentials found".
+ */
+function isSessionExpired(profile) {
+    const credPath = join(homedir(), '.uluops', 'credentials.json');
+    if (!existsSync(credPath))
+        return false;
+    try {
+        const stored = JSON.parse(readFileSync(credPath, 'utf-8'));
+        const creds = stored[profile];
+        if (creds?.type === 'session' && creds.expiresAt) {
+            return new Date(creds.expiresAt) <= new Date();
+        }
+    }
+    catch {
+        // Ignore parse errors — handled elsewhere
+    }
+    return false;
+}
+/**
+ * Validate that credentials exist, exiting with a helpful message if not.
+ * Checks for expired sessions and provides appropriate guidance.
+ */
+function requireCredentials(hasCredentials, profile) {
+    if (hasCredentials)
+        return;
+    if (isSessionExpired(profile)) {
+        exitWithError(`Session expired for profile "${profile}".\n` +
+            'Run "ulu auth login" to re-authenticate.');
+    }
+    exitWithError('No credentials found.\n' +
+        'Set ULUOPS_API_KEY environment variable, use --api-key flag,\n' +
+        'or run "ulu auth login" to authenticate.');
+}
+/**
+ * Create CLI context for ops commands
+ */
+export function createOpsContext(options) {
+    const config = loadOpsConfig({
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        profile: options.profile,
+        debug: options.debug,
+    });
+    const hasCredentials = config.credentials.apiKey ||
+        config.credentials.sessionToken ||
+        (config.credentials.email && config.credentials.password);
+    requireCredentials(hasCredentials, options.profile ?? 'default');
+    const timeout = options.timeout ? parseIntOption(options.timeout, '--timeout') : undefined;
+    let client;
+    try {
+        client = new OpsClient({
+            apiKey: config.credentials.apiKey,
+            sessionToken: config.credentials.sessionToken,
+            email: config.credentials.email,
+            password: config.credentials.password,
+            baseUrl: config.baseUrl,
+            debug: config.debug,
+            timeout,
+        });
+    }
+    catch (error) {
+        exitWithError(error instanceof Error ? error.message : String(error));
+    }
+    return {
+        client,
+        json: options.json ?? false,
+        debug: options.debug ?? false,
+        quiet: options.quiet ?? false,
+    };
+}
+/**
+ * Create CLI context for registry commands
+ */
+export function createRegistryContext(options) {
+    // Load ops config to get authBaseUrl (ops API URL for login/refresh)
+    const opsConfig = loadOpsConfig({
+        baseUrl: options.baseUrl,
+        profile: options.profile,
+        debug: options.debug,
+    });
+    const config = loadRegistryConfig({
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        authBaseUrl: opsConfig.baseUrl,
+        profile: options.profile,
+        debug: options.debug,
+    });
+    const hasCredentials = config.credentials.apiKey ||
+        config.credentials.sessionToken ||
+        (config.credentials.email && config.credentials.password);
+    requireCredentials(hasCredentials, options.profile ?? 'default');
+    const timeout = options.timeout ? parseIntOption(options.timeout, '--timeout') : undefined;
+    let client;
+    try {
+        client = new RegistryClient({
+            apiKey: config.credentials.apiKey,
+            email: config.credentials.email,
+            password: config.credentials.password,
+            sessionToken: config.credentials.sessionToken,
+            baseUrl: config.baseUrl,
+            authBaseUrl: config.authBaseUrl,
+            debug: config.debug,
+            timeout,
+        });
+    }
+    catch (error) {
+        exitWithError(error instanceof Error ? error.message : String(error));
+    }
+    return {
+        client,
+        json: options.json ?? false,
+        debug: options.debug ?? false,
+        quiet: options.quiet ?? false,
+    };
+}
+/**
+ * Create context without requiring credentials (for commands like login)
+ */
+export function createUnauthenticatedContext(options) {
+    const config = loadOpsConfig({
+        baseUrl: options.baseUrl,
+        profile: options.profile,
+        debug: options.debug,
+    });
+    return {
+        baseUrl: config.baseUrl,
+        json: options.json ?? false,
+        debug: options.debug ?? false,
+        quiet: options.quiet ?? false,
+    };
+}
+/**
+ * Create CLI context for core SDK commands (exec)
+ */
+export function createCoreContext(options, modelOverride) {
+    // Resolve API key from global options or env
+    const opsConfig = loadOpsConfig({
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        profile: options.profile,
+        debug: options.debug,
+    });
+    const apiKey = opsConfig.credentials.apiKey ?? options.apiKey;
+    // API key is optional when using local definitions with tracking disabled —
+    // the core SDK handles this gracefully (local-only execution, no remote calls).
+    const localOnly = !!options.localDefinitions && options.tracking === false;
+    if (!apiKey && !localOnly) {
+        requireCredentials(false, options.profile ?? 'default');
+    }
+    const thinkingBudgetEnv = process.env['ULUOPS_THINKING_BUDGET'];
+    const thinkingBudget = thinkingBudgetEnv ? parseInt(thinkingBudgetEnv, 10) : undefined;
+    const config = {
+        apiKey,
+        localDefinitions: options.localDefinitions,
+        trackingEnabled: options.tracking,
+        defaultProject: options.project,
+        submissionUrl: process.env['ULUOPS_SUBMISSION_URL'] ?? opsConfig.baseUrl,
+        debug: options.debug,
+        ...(thinkingBudget !== undefined && !Number.isNaN(thinkingBudget) ? { defaultThinkingBudget: thinkingBudget } : {}),
+    };
+    if (modelOverride) {
+        config.ai = { ...config.ai, modelOverride };
+    }
+    if (options.registryUrl) {
+        config.registryUrl = options.registryUrl;
+    }
+    const timeout = options.timeout ? parseIntOption(options.timeout, '--timeout') : undefined;
+    if (timeout !== undefined) {
+        config.timeout = timeout;
+    }
+    let client;
+    try {
+        client = new UluOpsClient(config);
+    }
+    catch (error) {
+        exitWithError(error instanceof Error ? error.message : String(error));
+    }
+    return {
+        client,
+        json: options.json ?? false,
+        debug: options.debug ?? false,
+        quiet: options.quiet ?? false,
+    };
+}
+/**
+ * Print error details with contextual hints based on status code/error code.
+ * Shared logic for both ops and registry error handlers.
+ */
+function printApiErrorDetails(error, ctx, hints = {}) {
+    if (ctx.json) {
+        console.error(JSON.stringify(error.toJSON(), null, 2));
+    }
+    else {
+        console.error(`Error: ${error.message}`);
+        if (error.code === 'UNAUTHORIZED' || error.statusCode === 401) {
+            console.error('\nHint: Your credentials may be invalid or expired.');
+            console.error(hints.unauthorized ?? 'Run "ulu auth login" or check your ULUOPS_API_KEY.');
+        }
+        else if (error.code === 'NOT_FOUND' || error.statusCode === 404) {
+            console.error(`\nHint: ${hints.notFound ?? 'The resource was not found. Check the name or ID.'}`);
+        }
+        else if (error.code === 'VALIDATION_ERROR' || error.statusCode === 400) {
+            console.error(`\nHint: ${hints.validation ?? 'Invalid input. Check the command arguments.'}`);
+        }
+        else if (error.code === 'SUBSCRIPTION_REQUIRED' || error.statusCode === 402) {
+            const details = error.details;
+            const requiredTier = details?.requiredTier;
+            const upgradeUrl = details?.upgradeUrl;
+            const sep = upgradeUrl?.includes('?') ? '&' : '?';
+            const trackedUrl = upgradeUrl ? `${upgradeUrl}${sep}source=cli` : undefined;
+            console.error('');
+            console.error('┌─────────────────────────────────────────────────┐');
+            console.error(`│  Subscription required${requiredTier ? `: ${requiredTier} tier or higher` : ''}`.padEnd(50) + '│');
+            console.error('│                                                 │');
+            if (trackedUrl) {
+                console.error(`│  Upgrade: ${trackedUrl}`.padEnd(50) + '│');
+            }
+            console.error('└─────────────────────────────────────────────────┘');
+        }
+        else if (error.code === 'RATE_LIMITED' || error.statusCode === 429) {
+            console.error('\nHint: Rate limited. Wait a moment and try again.');
+        }
+        else if (error.code === 'SERVICE_UNAVAILABLE' || error.statusCode === 503) {
+            const retryAfter = error.details?.retryAfter;
+            if (retryAfter) {
+                console.error(`\nHint: Service unavailable. Try again in ${retryAfter} seconds.`);
+            }
+            else {
+                console.error('\nHint: Service unavailable. Try again in a few moments.');
+            }
+        }
+        if (ctx.debug && error.details) {
+            console.error('\nDetails:', JSON.stringify(error.details, null, 2));
+        }
+        if (error.requestId) {
+            console.error(`\nRequest ID: ${error.requestId}`);
+        }
+    }
+}
+/**
+ * Handle ops errors consistently
+ */
+export function handleOpsError(error, ctx) {
+    if (error instanceof OpsApiError) {
+        printApiErrorDetails(error, ctx);
+        process.exit(1);
+    }
+    handleGenericError(error, ctx);
+}
+/**
+ * Handle registry errors consistently
+ */
+export function handleRegistryError(error, ctx) {
+    if (error instanceof RegistryApiError) {
+        printApiErrorDetails(error, ctx, {
+            unauthorized: 'Check your ULUOPS_API_KEY or session token.',
+            notFound: 'The resource was not found. Check the type, name, and version.',
+            validation: 'Invalid input. Check the command arguments or YAML file.',
+        });
+        process.exit(1);
+    }
+    handleGenericError(error, ctx);
+}
+/**
+ * Handle core SDK errors consistently
+ */
+export function handleCoreError(error, ctx) {
+    if (error instanceof SubscriptionRequiredError) {
+        if (ctx.json) {
+            console.error(JSON.stringify(error.toJSON(), null, 2));
+        }
+        else {
+            const defLabel = error.definition?.name
+                ? `"${error.definition.displayName ?? error.definition.name}"`
+                : 'this definition';
+            const trackedUrl = error.trackedUpgradeUrl('cli');
+            console.error(`Error: ${defLabel} requires ${error.requiredTier} tier or higher (current: ${error.currentTier})`);
+            console.error('');
+            console.error('┌─────────────────────────────────────────────────┐');
+            console.error(`│  Upgrade to ${error.requiredTier} to access this content`.padEnd(50) + '│');
+            console.error('│                                                 │');
+            if (trackedUrl) {
+                console.error(`│  ${trackedUrl}`.padEnd(50) + '│');
+            }
+            console.error('└─────────────────────────────────────────────────┘');
+        }
+        process.exit(1);
+    }
+    if (error instanceof SdkApiError) {
+        printApiErrorDetails(error, ctx, {
+            unauthorized: 'Check your ULUOPS_API_KEY environment variable.',
+            notFound: 'The definition was not found. Check the name and version.',
+            validation: 'Invalid request. Check the command arguments.',
+        });
+        process.exit(1);
+    }
+    if (error instanceof ConfigurationError) {
+        console.error(`Error: ${error.message}`);
+        console.error('\nHint: Check ULUOPS_API_KEY and ANTHROPIC_API_KEY environment variables.');
+        process.exit(1);
+    }
+    if (error instanceof ModelNotFoundError) {
+        console.error(`Error: ${error.message}`);
+        console.error('\nHint: Use --model with a known alias (haiku, sonnet, opus) or provider:modelId format.');
+        process.exit(1);
+    }
+    if (error instanceof PreflightError) {
+        console.error(`Error: Pre-flight check "${error.check}" failed: ${error.message}`);
+        if (ctx.debug && error.details) {
+            console.error('\nDetails:', JSON.stringify(error.details, null, 2));
+        }
+        process.exit(1);
+    }
+    if (error instanceof ParseError) {
+        console.error(`Error: ${error.message}`);
+        if (ctx.debug) {
+            console.error('\nContent preview:', error.contentPreview);
+        }
+        else {
+            console.error('\nHint: Run with --debug to see the raw output that failed to parse.');
+        }
+        process.exit(1);
+    }
+    if (error instanceof SubmissionError) {
+        console.error(`Error: ${error.message}`);
+        if (error.code) {
+            console.error(`\nSubmission error code: ${error.code}`);
+        }
+        process.exit(1);
+    }
+    if (error instanceof ExecutionError) {
+        console.error(`Error: ${error.message}`);
+        console.error('\nHint: Check that the target path exists and the agent definition is valid.');
+        if (ctx.debug && error.partialResult) {
+            console.error('\nPartial result:', JSON.stringify(error.partialResult, null, 2));
+        }
+        process.exit(1);
+    }
+    if (error instanceof WorkflowError) {
+        console.error(`Error: ${error.message}`);
+        if (ctx.debug && error.context?.partialResult) {
+            console.error('\nPartial result:', JSON.stringify(error.context.partialResult, null, 2));
+        }
+        process.exit(1);
+    }
+    if (error instanceof PipelineError) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+    if (error instanceof UluOpsError) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+    handleGenericError(error, ctx);
+}
+/**
+ * Handle generic/network errors
+ */
+function handleGenericError(error, ctx) {
+    if (ctx.json) {
+        console.error(JSON.stringify({ error: String(error) }));
+    }
+    else {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error: ${message}`);
+        if (message.includes('ECONNREFUSED') || message.includes('network')) {
+            console.error('\nHint: Cannot connect to the API. Check if the server is running.');
+        }
+        if (ctx.debug && error instanceof Error && error.stack) {
+            console.error('\nStack trace:', error.stack);
+        }
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/formatters/core.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Formatters for @uluops/core SDK types (agent results, execution results, definitions)
+ */
+import type { AgentResult, ExecutionResult, Recommendation, DefinitionSummary, DefinitionType } from '@uluops/core';
+/**
+ * Format an agent execution result
+ */
+export declare function formatAgentResult(result: AgentResult): string;
+/**
+ * Format a generic execution result (commands, workflows)
+ */
+export declare function formatExecutionResult(result: ExecutionResult): string;
+/**
+ * Format recommendations grouped by priority
+ */
+export declare function formatRecommendations(recs: Recommendation[]): string;
+/**
+ * Format a list of definitions as a table
+ */
+export declare function formatDefinitionList(items: DefinitionSummary[]): string;
+/**
+ * Format definition details from describe()
+ */
+export declare function formatDefinitionDetails(details: {
+    type: DefinitionType;
+    name: string;
+    version: string;
+    hash: string;
+    interface: unknown;
+}): string;
+//# sourceMappingURL=core.d.ts.map

package/dist/formatters/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/formatters/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACf,MAAM,cAAc,CAAC;AAItB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA8D7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmCrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,CAyBpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAiBT"}