zerg-ztc 0.1.11 → 0.1.12

package/src/agent/tools/search.ts

@@ -1,138 +0,0 @@
-import { spawn } from 'child_process';
-import { resolve } from 'path';
-import { Tool, ToolContext } from './types.js';
-import { ToolCapability } from '../runtime/capabilities.js';
-
-interface RunResult {
-  stdout: string;
-  stderr: string;
-  code: number;
-}
-
-function runCommand(command: string, args: string[], cwd: string): Promise<RunResult> {
-  return new Promise((resolveResult, reject) => {
-    const child = spawn(command, args, { cwd });
-    let stdout = '';
-    let stderr = '';
-    child.stdout.on('data', chunk => { stdout += chunk.toString(); });
-    child.stderr.on('data', chunk => { stderr += chunk.toString(); });
-    child.on('error', reject);
-    child.on('close', (code) => {
-      resolveResult({ stdout, stderr, code: code ?? 1 });
-    });
-  });
-}
-
-// --- Search Tool ---
-
-export const searchTool: Tool = {
-  capabilities: [ToolCapability.FILE_READ],
-  definition: {
-    name: 'search',
-    description: 'Search for a pattern in files (ripgrep preferred)',
-    parameters: {
-      type: 'object',
-      properties: {
-        pattern: {
-          type: 'string',
-          description: 'Regex pattern to search for'
-        },
-        path: {
-          type: 'string',
-          description: 'Path to search within (default: .)'
-        },
-        glob: {
-          type: 'string',
-          description: 'Optional glob filter (e.g., "*.ts")'
-        },
-        output_mode: {
-          type: 'string',
-          description: 'Output mode: content or files',
-          enum: ['content', 'files']
-        },
-        max_results: {
-          type: 'string',
-          description: 'Maximum number of results (default: 20)'
-        }
-      },
-      required: ['pattern']
-    }
-  },
-  execute: async (args, context) => {
-    const baseCwd = context?.cwd || process.cwd();
-    const pattern = String(args.pattern || '');
-    const path = resolve(baseCwd, String(args.path || '.'));
-    const glob = args.glob ? String(args.glob) : undefined;
-    const outputMode = args.output_mode === 'files' ? 'files' : 'content';
-    const maxResults = Math.max(1, Math.min(200, parseInt(String(args.max_results || '20'), 10)));
-
-    if (!pattern) {
-      throw new Error('Search pattern is required');
-    }
-
-    const rgArgs: string[] = [];
-    if (outputMode === 'files') {
-      rgArgs.push('-l', '--max-count', String(maxResults));
-    } else {
-      rgArgs.push('--line-number', '--column', '--with-filename', '--no-heading', '--max-count', String(maxResults));
-    }
-    if (glob) {
-      rgArgs.push('-g', glob);
-    }
-    rgArgs.push(pattern, path);
-
-    let result: RunResult | null = null;
-    try {
-      result = await runCommand('rg', rgArgs, baseCwd);
-    } catch {
-      result = null;
-    }
-
-    if (!result || (result.code !== 0 && result.code !== 1)) {
-      const grepArgs = ['-R', '-n', pattern, path];
-      const fallback = await runCommand('grep', grepArgs, baseCwd);
-      if (fallback.code !== 0 && fallback.code !== 1) {
-        throw new Error(fallback.stderr || 'Search failed');
-      }
-      result = fallback;
-    }
-
-    const stdout = result.stdout.trim();
-    if (!stdout) {
-      return JSON.stringify({ pattern, path, matches: [], count: 0, truncated: false });
-    }
-
-    if (outputMode === 'files') {
-      const files = stdout.split('\n').slice(0, maxResults);
-      return JSON.stringify({
-        pattern,
-        path,
-        files,
-        count: files.length,
-        truncated: files.length >= maxResults
-      });
-    }
-
-    const lines = stdout.split('\n');
-    const matches = [];
-    for (const line of lines) {
-      const match = line.match(/^(.+?):(\d+):(\d+):(.*)$/);
-      if (!match) continue;
-      matches.push({
-        path: match[1],
-        line: Number(match[2]),
-        column: Number(match[3]),
-        text: match[4]
-      });
-      if (matches.length >= maxResults) break;
-    }
-
-    return JSON.stringify({
-      pattern,
-      path,
-      matches,
-      count: matches.length,
-      truncated: matches.length >= maxResults
-    });
-  }
-};

package/src/agent/tools/shell.ts

@@ -1,69 +0,0 @@
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import { resolve } from 'path';
-import { Tool, ToolContext } from './types.js';
-import { ToolCapability } from '../runtime/capabilities.js';
-
-const execAsync = promisify(exec);
-
-// --- Shell Tool ---
-
-export const runCommandTool: Tool = {
-  capabilities: [ToolCapability.SHELL_EXEC],
-  definition: {
-    name: 'run_command',
-    description: 'Execute a shell command and return output',
-    parameters: {
-      type: 'object',
-      properties: {
-        command: { 
-          type: 'string', 
-          description: 'Shell command to execute' 
-        },
-        cwd: {
-          type: 'string',
-          description: 'Working directory for the command'
-        },
-        timeout: {
-          type: 'string',
-          description: 'Timeout in milliseconds (default: 30000)'
-        }
-      },
-      required: ['command']
-    }
-  },
-  execute: async (args, context) => {
-    const command = String(args.command);
-    const baseCwd = context?.cwd || process.cwd();
-    const cwd = args.cwd ? resolve(baseCwd, String(args.cwd)) : baseCwd;
-    const timeout = parseInt(String(args.timeout || '30000'), 10);
-
-    // Basic safety checks
-    const dangerous = ['rm -rf /', 'mkfs', ':(){:|:&};:'];
-    if (dangerous.some(d => command.includes(d))) {
-      throw new Error('Command rejected for safety reasons');
-    }
-
-    try {
-      const { stdout, stderr } = await execAsync(command, {
-        cwd,
-        timeout,
-        maxBuffer: 1024 * 1024 // 1MB
-      });
-
-      return JSON.stringify({
-        command,
-        cwd,
-        stdout: stdout.slice(0, 10000),
-        stderr: stderr.slice(0, 10000),
-        truncated: stdout.length > 10000 || stderr.length > 10000
-      });
-    } catch (err) {
-      const e = err as Error & { stdout?: string; stderr?: string; code?: number };
-      // Include both stdout and stderr in error - many tools output errors to stdout
-      const output = [e.stdout, e.stderr].filter(Boolean).join('\n').trim();
-      const outputSnippet = output.slice(0, 2000) || '(no output)';
-      throw new Error(`Command failed (exit ${e.code || '?'}):\n${outputSnippet}`);
-    }
-  }
-};

package/src/agent/tools/skills.ts

@@ -1,28 +0,0 @@
-import { Tool } from './types.js';
-import { ToolCapability } from '../runtime/capabilities.js';
-import { loadSkills } from '../../skills/loader.js';
-
-export const listSkillsTool: Tool = {
-  capabilities: [ToolCapability.FILE_READ],
-  definition: {
-    name: 'list_skills',
-    description: 'List available skills',
-    parameters: {
-      type: 'object',
-      properties: {},
-      required: []
-    }
-  },
-  execute: async () => {
-    const skills = await loadSkills();
-    return JSON.stringify({
-      count: skills.length,
-      skills: skills.map(skill => ({
-        id: skill.id,
-        name: skill.name,
-        description: skill.description,
-        sourceRoot: skill.sourceRoot
-      }))
-    });
-  }
-};

package/src/agent/tools/types.ts

@@ -1,14 +0,0 @@
-import { ToolDefinition } from '../../types.js';
-import { ToolCapability } from '../runtime/capabilities.js';
-
-// --- Tool Interface ---
-
-export interface ToolContext {
-  cwd: string;  // Working directory for path resolution
-}
-
-export interface Tool {
-  definition: ToolDefinition;
-  capabilities?: ToolCapability[];
-  execute: (args: Record<string, unknown>, context?: ToolContext) => Promise<string>;
-}

package/src/agent/tools/zerg.ts

@@ -1,50 +0,0 @@
-import { Tool } from './types.js';
-import { ToolCapability } from '../runtime/capabilities.js';
-
-// --- Zerg Integration Tool ---
-
-export const zergQueryTool: Tool = {
-  capabilities: [ToolCapability.NETWORK],
-  definition: {
-    name: 'zerg_query',
-    description: 'Send a query to the Zerg continual AI system',
-    parameters: {
-      type: 'object',
-      properties: {
-        query: { 
-          type: 'string', 
-          description: 'Query or instruction for Zerg' 
-        },
-        context: {
-          type: 'string',
-          description: 'Additional context for the query'
-        },
-        project: {
-          type: 'string',
-          description: 'Project identifier within Zerg'
-        },
-        wait: {
-          type: 'string',
-          description: 'If "true", wait for completion; otherwise return task ID'
-        }
-      },
-      required: ['query']
-    }
-  },
-  execute: async (args) => {
-    // Placeholder - implement actual Zerg API integration
-    const query = String(args.query);
-    const context = args.context ? String(args.context) : undefined;
-    const project = args.project ? String(args.project) : 'default';
-    
-    // TODO: Replace with actual Zerg API call
-    return JSON.stringify({
-      status: 'placeholder',
-      message: 'Zerg integration not yet implemented',
-      query,
-      context,
-      project,
-      taskId: `zerg_${Date.now()}`
-    });
-  }
-};

package/src/cli.tsx

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-import React from 'react';
-import { render } from 'ink';
-import { resolve } from 'path';
-import { statSync } from 'fs';
-import { App } from './App.js';
-import { configStore } from './config.js';
-import { getVersion } from './utils/version.js';
-
-// --- CLI Entry Point ---
-
-// Parse command line args
-const args = process.argv.slice(2);
-
-if (args.includes('--help') || args.includes('-h')) {
-  const version = getVersion();
-  console.log(`
-ZTC - Zerg Terminal Client v${version}
-
-Usage: ztc [options]
-
-Options:
-  -h, --help      Show this help message
-  -v, --version   Show version number
-  --cwd <path>    Start in a specific working directory
-
-Environment Variables:
-  ANTHROPIC_API_KEY   API key for Claude (optional, can be set in-app)
-
-In-App Commands:
-  /help              Show available commands
-  /config key <key>  Set API key
-  /config show       Show current configuration
-  /clear             Clear message history
-  /status            Show current status
-  /exit              Exit ZTC
-
-Keyboard Shortcuts:
-  Ctrl+C    Exit
-  Ctrl+L    Clear screen
-  Up/Down   Navigate command history
-  Ctrl+U    Clear input line
-  Ctrl+W    Delete word
-  Ctrl+A    Move to start of line
-  Ctrl+E    Move to end of line
-`);
-  process.exit(0);
-}
-
-if (args.includes('--version') || args.includes('-v')) {
-  console.log(`ztc v${getVersion()}`);
-  process.exit(0);
-}
-
-const cwdIndex = args.indexOf('--cwd');
-if (cwdIndex >= 0) {
-  const target = args[cwdIndex + 1];
-  if (!target) {
-    console.error('Error: --cwd requires a path');
-    process.exit(1);
-  }
-  const resolved = resolve(target);
-  try {
-    const info = statSync(resolved);
-    if (!info.isDirectory()) {
-      throw new Error('Not a directory');
-    }
-    process.chdir(resolved);
-  } catch {
-    console.error(`Error: invalid --cwd path (${resolved})`);
-    process.exit(1);
-  }
-}
-
-async function main(): Promise<void> {
-  await configStore.load(true);
-
-  const isTty = Boolean(process.stdout.isTTY);
-  const useAltScreen = isTty
-    && process.env.ZTC_ALT_SCREEN === '1'
-    && process.env.ZTC_NO_ALT_SCREEN !== '1'
-    && process.env.ZTC_SCROLLBACK !== '1';
-
-  if (useAltScreen) {
-    process.stdout.write('\x1b[?1049h');
-    process.stdout.write('\x1b[?25l');
-  }
-
-  if (isTty) {
-    // Clear screen and move cursor home for a clean start
-    process.stdout.write('\x1b[2J');
-    process.stdout.write('\x1b[H');
-  }
-
-  // In scrollback mode, print a static header once at startup
-  const scrollback = !useAltScreen;
-  if (scrollback && isTty) {
-    const version = getVersion();
-    const dateLabel = new Date().toLocaleDateString('en-US', {
-      month: 'short',
-      day: '2-digit',
-      year: 'numeric'
-    });
-    const cols = process.stdout.columns || 80;
-    const title = 'Zerg Terminal Client';
-    const right = `${dateLabel} • v${version} • Ctrl+C exit • /help`;
-    const padding = Math.max(0, cols - title.length - right.length - 4);
-    const borderLine = '─'.repeat(cols - 2);
-
-    console.log(`┌${borderLine}┐`);
-    console.log(`│ ${title}${' '.repeat(padding)}${right} │`);
-    console.log(`└${borderLine}┘`);
-    console.log(''); // Extra line after header
-  }
-
-  // Enable bracketed paste mode so we can detect paste boundaries
-  process.stdout.write('\x1b[?2004h');
-
-  // Enable Kitty keyboard protocol (progressive enhancement)
-  // This allows detection of Cmd+V and other modifier combinations
-  // Flags: 1 = disambiguate escape codes, 2 = report event types, 4 = report alternate keys, 8 = report all keys
-  // Using flags=1 for basic disambiguation which reports Cmd+V as CSI sequence
-  process.stdout.write('\x1b[>1u');
-
-  if (useAltScreen) {
-    // Wrap stdout.write to use synchronized output (reduces flicker)
-    // DECSM/DECRM 2026 tells terminal to batch updates
-    const originalWrite = process.stdout.write.bind(process.stdout);
-    let syncPending = false;
-    process.stdout.write = function(chunk: any, encoding?: any, callback?: any): boolean {
-      if (!syncPending) {
-        syncPending = true;
-        originalWrite('\x1b[?2026h'); // Begin synchronized update
-        setImmediate(() => {
-          originalWrite('\x1b[?2026l'); // End synchronized update
-          syncPending = false;
-        });
-      }
-      return originalWrite(chunk, encoding, callback);
-    } as typeof process.stdout.write;
-  }
-
-  // Render the app
-  const { waitUntilExit } = render(<App />);
-
-  // Handle clean exit
-  waitUntilExit().then(() => {
-    // Disable Kitty keyboard protocol
-    process.stdout.write('\x1b[<u');
-    // Disable bracketed paste mode
-    process.stdout.write('\x1b[?2004l');
-    if (useAltScreen) {
-      process.stdout.write('\x1b[?25h');
-      process.stdout.write('\x1b[?1049l');
-    }
-    console.log('Goodbye from ZTC! 👋');
-    process.exit(0);
-  });
-}
-
-void main();
-
-// getVersion moved to utils/version.ts

package/src/components/ActivityLine.tsx

@@ -1,23 +0,0 @@
-import React from 'react';
-import { AgentState } from '../types.js';
-import { InkNode } from '../ui/ink/index.js';
-import { buildActivityLineView } from '../ui/views/activity_line.js';
-
-interface ActivityLineProps {
-  state: AgentState;
-  spinnerLabel?: string | null;
-  spinnerFrame?: string | null;
-  inputMode?: 'queue' | 'interrupt';
-}
-
-export const ActivityLine: React.FC<ActivityLineProps> = ({
-  state,
-  spinnerLabel,
-  spinnerFrame,
-  inputMode
-}) => {
-  const node = buildActivityLineView({ state, spinnerLabel, spinnerFrame, inputMode });
-  return <InkNode node={node} />;
-};
-
-export default ActivityLine;

package/src/components/FullScreen.tsx

@@ -1,79 +0,0 @@
-import React, { PropsWithChildren, useState, useEffect } from 'react';
-import { Box } from 'ink';
-
-/**
- * FullScreen component that uses the alternate screen buffer.
- *
- * This prevents flickering by:
- * 1. Switching to the alternate screen buffer (like vim, htop, less do)
- * 2. Tracking terminal resize events
- * 3. Restoring the original terminal state on exit
- *
- * ANSI escape codes:
- * - \x1b[?1049h - Enter alternate screen buffer
- * - \x1b[?1049l - Exit alternate screen buffer
- * - \x1b[?25l  - Hide cursor
- * - \x1b[?25h  - Show cursor
- */
-
-interface FullScreenProps extends PropsWithChildren {
-  debug?: boolean;
-  scrollback?: boolean;
-}
-
-function getTerminalSize() {
-  return {
-    columns: process.stdout.columns || 80,
-    rows: process.stdout.rows || 24,
-  };
-}
-
-export const FullScreen: React.FC<FullScreenProps> = ({ children, debug = false, scrollback = false }) => {
-  const { rows, columns } = useScreenSize();
-
-  return (
-    <Box
-      flexDirection="column"
-      width={columns}
-      height={scrollback ? undefined : rows}
-      overflow={scrollback ? undefined : 'hidden'}
-      borderStyle={debug ? 'single' : undefined}
-      borderColor={debug ? 'red' : undefined}
-    >
-      {children}
-    </Box>
-  );
-};
-
-/**
- * Hook to get current screen size with resize tracking
- */
-export function useScreenSize() {
-  const [size, setSize] = useState(getTerminalSize);
-
-  useEffect(() => {
-    const updateSize = () => {
-      const current = getTerminalSize();
-      setSize(prev => {
-        if (prev.rows !== current.rows || prev.columns !== current.columns) {
-          return current;
-        }
-        return prev;
-      });
-    };
-
-    process.stdout.on('resize', updateSize);
-
-    // Also check on an interval as a fallback for some terminals
-    const interval = setInterval(updateSize, 1000);
-
-    return () => {
-      process.stdout.off('resize', updateSize);
-      clearInterval(interval);
-    };
-  }, []);
-
-  return size;
-}
-
-export default FullScreen;

package/src/components/Header.tsx

@@ -1,27 +0,0 @@
-import React from 'react';
-import { InkNode } from '../ui/ink/index.js';
-import { buildHeaderView } from '../ui/views/header.js';
-
-interface HeaderProps {
-  title?: string;
-  version?: string;
-  showHelp?: boolean;
-  debug?: boolean;
-}
-
-export const Header: React.FC<HeaderProps> = ({ 
-  title = 'Zerg Terminal Client',
-  version = '0.1.0',
-  showHelp = true,
-  debug = false
-}) => {
-  const dateLabel = new Date().toLocaleDateString('en-US', {
-    month: 'short',
-    day: '2-digit',
-    year: 'numeric'
-  });
-  const node = buildHeaderView({ title, version, dateLabel, showHelp, debug });
-  return <InkNode node={node} />;
-};
-
-export default Header;