deepseek-coder-cli 1.0.0

package/dist/utils/packageInfo.d.ts

@@ -0,0 +1,14 @@
+export interface PackageInfo {
+    name?: string;
+    version?: string;
+}
+/**
+ * Locate and read the nearest package.json starting from the caller's module URL.
+ * This mirrors prior per-file helpers but centralizes the logic so CLI entrypoints
+ * and tests stay consistent even if their relative paths change.
+ */
+export declare function readPackageInfo(importMetaUrl: string | URL, options?: {
+    maxDepth?: number;
+}): PackageInfo;
+export declare function readPackageVersion(importMetaUrl: string | URL, fallback?: string): string;
+//# sourceMappingURL=packageInfo.d.ts.map

package/dist/utils/packageInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageInfo.d.ts","sourceRoot":"","sources":["../../src/utils/packageInfo.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,GAAG,EAC3B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,WAAW,CAiBb;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,EAAE,QAAQ,SAAU,GAAG,MAAM,CAE1F"}

package/dist/utils/packageInfo.js

@@ -0,0 +1,45 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Locate and read the nearest package.json starting from the caller's module URL.
+ * This mirrors prior per-file helpers but centralizes the logic so CLI entrypoints
+ * and tests stay consistent even if their relative paths change.
+ */
+export function readPackageInfo(importMetaUrl, options) {
+    const maxDepth = options?.maxDepth ?? 6;
+    const startDir = dirname(fileURLToPath(importMetaUrl));
+    const packagePath = findNearestPackageJson(startDir, maxDepth);
+    if (!packagePath) {
+        return {};
+    }
+    try {
+        const payload = JSON.parse(readFileSync(packagePath, 'utf8'));
+        return {
+            name: typeof payload.name === 'string' ? payload.name : undefined,
+            version: typeof payload.version === 'string' ? payload.version : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+export function readPackageVersion(importMetaUrl, fallback = '0.0.0') {
+    return readPackageInfo(importMetaUrl).version ?? fallback;
+}
+function findNearestPackageJson(startDir, maxDepth) {
+    let current = startDir;
+    for (let depth = 0; depth <= maxDepth; depth += 1) {
+        const candidate = resolve(current, 'package.json');
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=packageInfo.js.map

package/dist/utils/packageInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageInfo.js","sourceRoot":"","sources":["../../src/utils/packageInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,aAA2B,EAC3B,OAA+B;IAE/B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAgB,CAAC;QAC7E,OAAO;YACL,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACjE,OAAO,EAAE,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAC3E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAA2B,EAAE,QAAQ,GAAG,OAAO;IAChF,OAAO,eAAe,CAAC,aAAa,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC;AAC5D,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB,EAAE,QAAgB;IAChE,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACnD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/planFormatter.d.ts

@@ -0,0 +1,34 @@
+export type PlanStatus = 'pending' | 'in_progress' | 'completed';
+export interface PlanItem {
+    step: string;
+    status?: PlanStatus;
+}
+export type NormalizedPlanItem = PlanItem & {
+    status: PlanStatus;
+};
+export type PlanInput = Array<PlanItem | string | number | boolean | null | undefined>;
+export interface PlanFormatOptions {
+    heading?: string;
+    bullet?: string;
+    width?: number;
+    statusSymbols?: Partial<Record<PlanStatus, string>>;
+}
+/**
+ * Format a structured plan for display with compact tree-like layout.
+ */
+export declare function formatPlan(plan: PlanInput, options?: PlanFormatOptions): string;
+export declare function formatPlan(plan: unknown, options?: PlanFormatOptions): string;
+/**
+ * Normalize plan input into a typed list of steps with default statuses.
+ */
+export declare function normalizePlanItems(plan: PlanInput): NormalizedPlanItem[];
+export declare function normalizePlanItems(plan: unknown): NormalizedPlanItem[];
+/**
+ * Wrap plan text with a prefix, preserving indentation for continuations.
+ */
+export declare function wrapPlanText(text: string, prefix: string, width?: number): string[];
+/**
+ * Determine the available plan width using the terminal size if available.
+ */
+export declare function resolvePlanWidth(padding?: number): number | undefined;
+//# sourceMappingURL=planFormatter.d.ts.map

package/dist/utils/planFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/planFormatter.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEvF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;AAuB/E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,kBAAkB,EAAE,CAAC;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAAC;AAyCxE;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAanF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAU,GAAG,MAAM,GAAG,SAAS,CASxE"}

package/dist/utils/planFormatter.js

@@ -0,0 +1,141 @@
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /\u001B\[[0-9;]*m/g;
+const DEFAULT_WIDTH = 78;
+const MIN_WIDTH = 42;
+const MAX_WIDTH = 100;
+export function formatPlan(plan, options = {}) {
+    const width = clampWidth(options.width);
+    const heading = (options.heading ?? 'Updated Plan').trim() || 'Updated Plan';
+    const bullet = (options.bullet ?? '•').trim() || '•';
+    const items = normalizePlanItems(plan);
+    const lines = [`${bullet} ${heading}`];
+    if (!items.length) {
+        lines.push('  (no steps provided)');
+        return lines.join('\n');
+    }
+    const statusSymbols = buildStatusSymbols(options.statusSymbols);
+    items.forEach((item, index) => {
+        const prefix = `${index === 0 ? '  └ ' : '    '}${statusSymbols[item.status]} `;
+        lines.push(...wrapPlanText(item.step, prefix, width));
+    });
+    return lines.join('\n');
+}
+export function normalizePlanItems(plan) {
+    if (!Array.isArray(plan)) {
+        return [];
+    }
+    const items = [];
+    for (const entry of plan) {
+        if (entry === null || entry === undefined) {
+            continue;
+        }
+        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean') {
+            const step = String(entry).trim();
+            if (!step) {
+                continue;
+            }
+            items.push({ step, status: 'pending' });
+            continue;
+        }
+        if (typeof entry === 'object') {
+            const rawStep = entry.step;
+            const step = typeof rawStep === 'string'
+                ? rawStep.trim()
+                : typeof rawStep === 'number' || typeof rawStep === 'boolean'
+                    ? String(rawStep).trim()
+                    : '';
+            if (!step) {
+                continue;
+            }
+            const status = normalizeStatus(entry.status);
+            items.push({ step, status });
+        }
+    }
+    return items;
+}
+/**
+ * Wrap plan text with a prefix, preserving indentation for continuations.
+ */
+export function wrapPlanText(text, prefix, width) {
+    const normalizedWidth = clampWidth(width);
+    const cleanPrefix = prefix ?? '';
+    const prefixLength = visibleLength(cleanPrefix);
+    const available = Math.max(12, normalizedWidth - prefixLength);
+    const wrapped = wrapText(text, available);
+    if (!wrapped.length) {
+        return [cleanPrefix.trimEnd()];
+    }
+    const indent = ' '.repeat(prefixLength);
+    return wrapped.map((line, index) => (index === 0 ? `${cleanPrefix}${line}` : `${indent}${line}`));
+}
+/**
+ * Determine the available plan width using the terminal size if available.
+ */
+export function resolvePlanWidth(padding = 4) {
+    if (typeof process !== 'undefined' &&
+        typeof process.stdout?.columns === 'number' &&
+        Number.isFinite(process.stdout.columns)) {
+        return Math.max(0, process.stdout.columns - padding);
+    }
+    return undefined;
+}
+function buildStatusSymbols(overrides) {
+    return {
+        pending: overrides?.pending?.trim() || '□',
+        in_progress: overrides?.in_progress?.trim() || '◐',
+        completed: overrides?.completed?.trim() || '✔',
+    };
+}
+function normalizeStatus(status) {
+    if (typeof status !== 'string') {
+        return 'pending';
+    }
+    const normalized = status.trim().toLowerCase().replace(/[\s-]+/g, '_');
+    if (normalized === 'completed' || normalized === 'complete' || normalized === 'done') {
+        return 'completed';
+    }
+    if (normalized === 'in_progress' || normalized === 'inprogress') {
+        return 'in_progress';
+    }
+    return 'pending';
+}
+function wrapText(text, width) {
+    const normalized = (text || '').trim();
+    if (!normalized) {
+        return [];
+    }
+    const words = normalized.split(/\s+/);
+    const lines = [];
+    let current = words.shift() ?? '';
+    for (const word of words) {
+        const candidate = `${current} ${word}`;
+        if (visibleLength(candidate) > width && current) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current) {
+        lines.push(current);
+    }
+    return lines;
+}
+function clampWidth(width) {
+    if (typeof width !== 'number' || !Number.isFinite(width)) {
+        return DEFAULT_WIDTH;
+    }
+    const normalized = Math.floor(width);
+    if (normalized < MIN_WIDTH) {
+        return MIN_WIDTH;
+    }
+    if (normalized > MAX_WIDTH) {
+        return MAX_WIDTH;
+    }
+    return normalized;
+}
+function visibleLength(value) {
+    return value.replace(ANSI_REGEX, '').length;
+}
+//# sourceMappingURL=planFormatter.js.map

package/dist/utils/planFormatter.js.map

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

package/dist/utils/securityUtils.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Security Utilities for AGI Core
+ * Comprehensive security validation, sanitization, and safe execution utilities
+ */
+import { SpawnSyncOptions } from 'node:child_process';
+/**
+ * Validate target hostname, IP address, or domain
+ * Prevents command injection and path traversal
+ */
+export declare function validateTarget(target: string): {
+    valid: boolean;
+    reason?: string;
+};
+/**
+ * Validate port numbers and ranges
+ */
+export declare function validatePorts(ports: string): {
+    valid: boolean;
+    reason?: string;
+};
+/**
+ * Validate and sanitize URL
+ */
+export declare function validateUrl(url: string): {
+    valid: boolean;
+    reason?: string;
+    sanitized?: string;
+};
+/**
+ * Safe command execution wrapper
+ * Uses spawnSync with array arguments, never shell mode
+ */
+export declare function safeExecSync(command: string, args?: string[], options?: SpawnSyncOptions): {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    error?: string;
+};
+/**
+ * Sanitize user input for shell commands
+ * Escapes shell metacharacters
+ */
+export declare function sanitizeShellInput(input: string): string;
+/**
+ * Validate and sanitize file path
+ * Prevents directory traversal attacks
+ */
+export declare function sanitizeFilePath(path: string): {
+    valid: boolean;
+    sanitized?: string;
+    reason?: string;
+};
+/**
+ * Rate limiting and request throttling
+ */
+export declare class RateLimiter {
+    private maxRequests;
+    private timeWindowMs;
+    private requests;
+    constructor(maxRequests?: number, timeWindowMs?: number);
+    /**
+     * Check if request is allowed
+     */
+    isAllowed(key: string): boolean;
+    /**
+     * Clean up old request records
+     */
+    private cleanup;
+    /**
+     * Get wait time if rate limited
+     */
+    getWaitTime(key: string): number;
+}
+/**
+ * Secure HTTP request utilities
+ */
+export declare class SecureHttpClient {
+    private rateLimiter;
+    get(url: string, options?: {
+        timeout?: number;
+        headers?: Record<string, string>;
+    }): Promise<{
+        success: boolean;
+        statusCode?: number;
+        data?: string;
+        error?: string;
+    }>;
+}
+/**
+ * Security context for tool execution
+ */
+export interface SecurityContext {
+    userId?: string;
+    permissions: string[];
+    maxExecutionTime: number;
+    allowedCommands: string[];
+    allowedHosts: string[];
+}
+/**
+ * Security policy validator
+ */
+export declare class SecurityPolicyValidator {
+    private defaultContext;
+    validateCommand(command: string, args: string[], context?: Partial<SecurityContext>): {
+        allowed: boolean;
+        reason?: string;
+    };
+    private validateNmapArgs;
+    private validateCurlArgs;
+}
+/**
+ * Security logger for audit trail
+ */
+export declare class SecurityLogger {
+    private logFile?;
+    constructor(logFile?: string);
+    logSecurityEvent(event: {
+        type: string;
+        userId?: string;
+        command?: string;
+        args?: string[];
+        target?: string;
+        success: boolean;
+        timestamp: Date;
+        details?: Record<string, any>;
+    }): void;
+    private getClientIp;
+}
+export declare const securityValidator: SecurityPolicyValidator;
+export declare const securityLogger: SecurityLogger;
+export declare const globalRateLimiter: RateLimiter;
+//# sourceMappingURL=securityUtils.d.ts.map

package/dist/utils/securityUtils.d.ts.map

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