@polka-codes/cli 0.10.22 → 0.10.24

package/dist/api.js

@@ -1,279 +0,0 @@
-/**
- * Polka Codes Scripting API
- *
- * This module provides a high-level TypeScript API for programmatic access to
- * polka-codes workflows. All functions support both interactive and non-interactive modes.
- *
- * @example
- * ```typescript
- * import { commit, code, review } from '@polka-codes/cli'
- *
- * // Non-interactive scripting
- * await commit({ all: true, context: 'Fix login bug', interactive: false })
- *
- * // Interactive use (default)
- * await code({ task: 'Add user authentication' })
- * ```
- */
-import { createLogger } from './logger';
-import { runWorkflow } from './runWorkflow';
-import { codeWorkflow, commitWorkflow, fixWorkflow, planWorkflow, prWorkflow, reviewWorkflow, taskWorkflow, } from './workflows';
-/**
- * Creates a commit with an AI-generated message
- *
- * @param options - Commit options
- * @returns The generated commit message, or undefined if cancelled
- *
- * @example
- * ```typescript
- * // Commit all changes with context
- * const message = await commit({
- *   all: true,
- *   context: 'Fix authentication bug'
- * })
- *
- * // Non-interactive commit
- * await commit({ all: true, interactive: false })
- * ```
- */
-export async function commit(options = {}) {
-    const { all, files, context: messageContext, interactive, onUsage, ...context } = options;
-    // Create logger from options
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    // Build workflow input
-    const workflowInput = {
-        ...(all && { all: true }),
-        ...(files && { files }),
-        ...(messageContext && { context: messageContext }),
-        interactive: interactive !== false,
-    };
-    // Execute workflow
-    const result = await runWorkflow(commitWorkflow, workflowInput, {
-        commandName: 'commit',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-    // Handle both string and void returns
-    return result ?? undefined;
-}
-/**
- * Creates a GitHub pull request with AI-generated title and description
- *
- * @param options - PR creation options
- * @returns The PR URL and details, or undefined if cancelled
- *
- * @example
- * ```typescript
- * // Create PR with context
- * const pr = await createPr({
- *   context: 'Implements user authentication flow'
- * })
- *
- * // Non-interactive PR creation
- * await createPr({ interactive: false })
- * ```
- */
-export async function createPr(options = {}) {
-    const { context: prContext, interactive, onUsage, ...context } = options;
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    const workflowInput = {
-        ...(prContext && { context: prContext }),
-    };
-    return runWorkflow(prWorkflow, workflowInput, {
-        commandName: 'pr',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-}
-/**
- * Plans and implements a feature or task using AI agents
- *
- * @param options - Code generation options
- * @returns Implementation result with summaries
- *
- * @example
- * ```typescript
- * // Implement a feature
- * const result = await code({
- *   task: 'Add OAuth2 login with Google'
- * })
- *
- * // With custom files
- * await code({
- *   task: 'Implement this design',
- *   files: [{ type: 'image', mediaType: 'image/png', image: 'base64...' }]
- * })
- * ```
- */
-export async function code(options) {
-    const { task, files, mode, additionalInstructions, interactive, onUsage, ...context } = options;
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    const workflowInput = {
-        task,
-        files,
-        mode,
-        additionalInstructions,
-    };
-    return runWorkflow(codeWorkflow, workflowInput, {
-        commandName: 'code',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-}
-/**
- * Reviews code changes (PR or local)
- *
- * @param options - Review options
- * @returns Review result with overview and specific feedback
- *
- * @example
- * ```typescript
- * // Review local changes
- * const review = await reviewCode({})
- *
- * // Review specific PR
- * const review = await reviewCode({ pr: 123 })
- * ```
- */
-export async function reviewCode(options = {}) {
-    const { pr, range, files, context: reviewContext, interactive, onUsage, ...context } = options;
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    const workflowInput = {
-        pr,
-        range,
-        files,
-        context: reviewContext,
-    };
-    return runWorkflow(reviewWorkflow, workflowInput, {
-        commandName: 'review',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-}
-/**
- * Fixes issues by running a command and letting AI fix errors
- *
- * @param options - Fix options
- * @returns Fix result with summaries
- *
- * @example
- * ```typescript
- * // Fix test failures
- * const result = await fix({
- *   command: 'npm test',
- *   task: 'Fix failing unit tests'
- * })
- *
- * // Use default check/test scripts from config
- * await fix({})
- * ```
- */
-export async function fix(options = {}) {
-    const { command, task, prompt, interactive, onUsage, ...context } = options;
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    const workflowInput = {
-        command,
-        task,
-        prompt,
-    };
-    return runWorkflow(fixWorkflow, workflowInput, {
-        commandName: 'fix',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-}
-/**
- * Performs a generic task using an AI agent
- *
- * @param options - Task options
- * @returns Task completion result (ExitReason with agent output)
- *
- * @example
- * ```typescript
- * // Run a simple task
- * const result = await task({
- *   task: 'Refactor the auth module'
- * })
- *
- * // Non-interactive mode with JSON output
- * const result = await task({
- *   task: 'Update dependencies',
- *   jsonMode: true,
- *   interactive: false
- * })
- * ```
- */
-export async function task(options) {
-    const { task: taskInput, jsonMode, readonly, systemPrompt, interactive, onUsage, ...context } = options;
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    const workflowInput = {
-        task: taskInput,
-        jsonMode,
-        readonly,
-        systemPrompt,
-    };
-    return runWorkflow(taskWorkflow, workflowInput, {
-        commandName: 'task',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-}
-/**
- * Creates or updates an implementation plan
- *
- * @param options - Planning options
- * @returns The generated plan and related files
- *
- * @example
- * ```typescript
- * // Create a new plan
- * const plan = await plan({
- *   task: 'Design and implement user dashboard'
- * })
- *
- * // Update existing plan
- * await plan({
- *   task: 'Add dark mode',
- *   fileContent: existingPlan,
- *   planFile: '.plans/dashboard.md'
- * })
- * ```
- */
-export async function plan(options = {}) {
-    const { task, fileContent, planFile, files, mode, interactive, onUsage, ...context } = options;
-    const verbose = context.silent ? -1 : (context.verbose ?? 0);
-    const logger = createLogger({ verbose });
-    const workflowInput = {
-        task,
-        fileContent,
-        filePath: planFile,
-        files,
-        mode,
-    };
-    return runWorkflow(planWorkflow, workflowInput, {
-        commandName: 'plan',
-        context,
-        logger,
-        interactive: interactive !== false,
-        onUsageMeterCreated: onUsage,
-    });
-}
-//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/builtin-commands.js

@@ -1,20 +0,0 @@
-// generated by polka.codes
-/**
- * List of built-in command names that cannot be used for custom scripts or skills.
- * This list is centralized to prevent drift across the codebase.
- */
-export const BUILT_IN_COMMANDS = [
-    'code',
-    'commit',
-    'pr',
-    'review',
-    'fix',
-    'plan',
-    'task',
-    'workflow',
-    'run',
-    'init',
-    'meta',
-    'skills',
-];
-//# sourceMappingURL=builtin-commands.js.map

package/dist/builtin-commands.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtin-commands.js","sourceRoot":"","sources":["../src/builtin-commands.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,UAAU;IACV,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;CACA,CAAA"}