cli-claw-kit 0.0.1

package/shared/dist/runtime-command-registry.js

@@ -0,0 +1,185 @@
+const CLAUDE_MODEL_PRESETS = [
+    'opus[1m]',
+    'opus',
+    'sonnet[1m]',
+    'sonnet',
+    'haiku',
+];
+const CODEX_MODEL_PRESETS = ['gpt-5.4', 'gpt-5.4-mini'];
+const REASONING_EFFORT_PRESETS = [
+    'low',
+    'medium',
+    'high',
+    'xhigh',
+];
+export const RUNTIME_COMMANDS = [
+    {
+        name: 'help',
+        usage: '/help',
+        description: '查看当前入口可用命令',
+        availableEntrypoints: ['im', 'web'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'clear',
+        usage: '/clear',
+        description: '清除当前工作区或会话上下文',
+        availableEntrypoints: ['im', 'web'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'list',
+        aliases: ['ls'],
+        usage: '/list',
+        description: '查看当前用户可访问的工作区与对话',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'status',
+        usage: '/status',
+        description: '查看当前工作区和运行状态摘要',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'recall',
+        aliases: ['rc'],
+        usage: '/recall',
+        description: '回顾当前工作区最近消息',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'where',
+        usage: '/where',
+        description: '查看当前聊天绑定位置',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'bind',
+        usage: '/bind <workspace>',
+        description: '绑定到指定工作区或会话',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'unbind',
+        usage: '/unbind',
+        description: '解除当前绑定',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'new',
+        usage: '/new <名称>',
+        description: '创建新工作区并绑定过去',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'require_mention',
+        usage: '/require_mention true|false',
+        description: '控制群聊中是否必须 @机器人',
+        availableEntrypoints: ['im'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'sw',
+        aliases: ['spawn'],
+        usage: '/sw <任务描述>',
+        description: '创建并行任务',
+        availableEntrypoints: ['im', 'web'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'model',
+        usage: '/model <preset>',
+        description: '切换当前工作区模型预设',
+        availableEntrypoints: ['im', 'web'],
+        availabilityByRuntime: 'all',
+    },
+    {
+        name: 'effort',
+        usage: '/effort <low|medium|high|xhigh>',
+        description: '切换当前工作区思考强度',
+        availableEntrypoints: ['im', 'web'],
+        availabilityByRuntime: ['codex'],
+    },
+];
+function normalizeText(value) {
+    return value.trim().toLowerCase();
+}
+export function supportsReasoningEffort(agentType) {
+    return agentType === 'codex';
+}
+export function getModelPresets(agentType) {
+    return agentType === 'codex'
+        ? [...CODEX_MODEL_PRESETS]
+        : [...CLAUDE_MODEL_PRESETS];
+}
+export function getReasoningEffortPresets() {
+    return [...REASONING_EFFORT_PRESETS];
+}
+export function normalizeModelPreset(agentType, rawValue) {
+    const normalized = normalizeText(rawValue);
+    const matched = getModelPresets(agentType).find((preset) => preset.toLowerCase() === normalized);
+    return matched ?? null;
+}
+export function normalizeReasoningEffortPreset(rawValue) {
+    const normalized = normalizeText(rawValue);
+    return REASONING_EFFORT_PRESETS.find((preset) => preset === normalized) ?? null;
+}
+function isCommandAvailableForAgent(command, agentType) {
+    if (command.availabilityByRuntime === 'all' ||
+        !command.availabilityByRuntime) {
+        return true;
+    }
+    return command.availabilityByRuntime.includes(agentType);
+}
+export function findRuntimeCommand(rawName) {
+    const normalized = normalizeText(rawName);
+    if (!normalized)
+        return null;
+    return (RUNTIME_COMMANDS.find((command) => {
+        if (command.name === normalized)
+            return true;
+        return command.aliases?.some((alias) => alias === normalized);
+    }) ?? null);
+}
+export function parseRuntimeCommand(text) {
+    const trimmed = text.trim();
+    const body = trimmed.startsWith('/') ? trimmed.slice(1).trim() : trimmed;
+    if (!body)
+        return null;
+    const [rawName = '', ...args] = body.split(/\s+/);
+    const command = findRuntimeCommand(rawName);
+    if (!command)
+        return null;
+    return {
+        rawName,
+        name: command.name,
+        argsText: body.slice(rawName.length).trim(),
+        args,
+    };
+}
+export function isCommandAvailable(options) {
+    const command = findRuntimeCommand(options.commandName);
+    if (!command)
+        return false;
+    return (command.availableEntrypoints.includes(options.entrypoint) &&
+        isCommandAvailableForAgent(command, options.agentType));
+}
+export function getAvailableCommands(options) {
+    return RUNTIME_COMMANDS.filter((command) => command.availableEntrypoints.includes(options.entrypoint) &&
+        isCommandAvailableForAgent(command, options.agentType));
+}
+export function formatCommandHelp(options) {
+    const commands = getAvailableCommands(options);
+    const lines = ['可用命令：'];
+    for (const command of commands) {
+        lines.push(`- ${command.usage}：${command.description}`);
+    }
+    return lines.join('\n');
+}

package/shared/dist/stream-event.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Canonical StreamEvent type definitions.
+ *
+ * This is the single source of truth.
+ * Build step compiles this file to shared/dist/stream-event.{js,d.ts},
+ * and each runtime consumes those types through thin local wrappers.
+ */
+export type StreamEventType = 'text_delta' | 'thinking_delta' | 'tool_use_start' | 'tool_use_end' | 'tool_progress' | 'hook_started' | 'hook_progress' | 'hook_response' | 'task_start' | 'task_notification' | 'todo_update' | 'usage' | 'status' | 'init';
+export interface StreamRuntimeIdentity {
+    agentType: 'claude' | 'codex';
+    model?: string | null;
+    reasoningEffort?: string | null;
+    supportsReasoningEffort?: boolean | null;
+}
+export interface StreamEvent {
+    eventType: StreamEventType;
+    /** Correlates all stream events for a single user turn. */
+    turnId?: string;
+    /** SDK session identifier if known. */
+    sessionId?: string;
+    /** SDK message uuid if known. */
+    messageUuid?: string;
+    /** Reserved — whether this event was synthesized locally rather than emitted directly by SDK semantics. */
+    isSynthetic?: boolean;
+    text?: string;
+    toolName?: string;
+    toolUseId?: string;
+    parentToolUseId?: string | null;
+    isNested?: boolean;
+    skillName?: string;
+    toolInputSummary?: string;
+    elapsedSeconds?: number;
+    hookName?: string;
+    hookEvent?: string;
+    hookOutcome?: string;
+    statusText?: string;
+    taskDescription?: string;
+    taskId?: string;
+    taskStatus?: string;
+    taskSummary?: string;
+    isBackground?: boolean;
+    isTeammate?: boolean;
+    runtimeIdentity?: StreamRuntimeIdentity | null;
+    toolInput?: Record<string, unknown>;
+    todos?: Array<{
+        id: string;
+        content: string;
+        status: 'pending' | 'in_progress' | 'completed';
+    }>;
+    /** Token usage data emitted at query completion */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadInputTokens: number;
+        cacheCreationInputTokens: number;
+        costUSD: number;
+        durationMs: number;
+        numTurns: number;
+        modelUsage?: Record<string, {
+            inputTokens: number;
+            outputTokens: number;
+            costUSD: number;
+        }>;
+    };
+}

package/shared/dist/stream-event.js

@@ -0,0 +1,8 @@
+/**
+ * Canonical StreamEvent type definitions.
+ *
+ * This is the single source of truth.
+ * Build step compiles this file to shared/dist/stream-event.{js,d.ts},
+ * and each runtime consumes those types through thin local wrappers.
+ */
+export {};

package/shared/dist/tool-step-display.d.ts

@@ -0,0 +1,4 @@
+export interface ToolStepDisplayOptions {
+    maxSummaryChars?: number;
+}
+export declare function formatToolStepLine(toolName: string, summary?: string | null, options?: ToolStepDisplayOptions): string;

package/shared/dist/tool-step-display.js

@@ -0,0 +1,11 @@
+export function formatToolStepLine(toolName, summary, options) {
+    const normalizedName = toolName.trim() || 'unknown';
+    const normalizedSummary = (summary || '').trim();
+    if (!normalizedSummary)
+        return normalizedName;
+    const maxSummaryChars = options?.maxSummaryChars ?? 60;
+    const compactSummary = normalizedSummary.length > maxSummaryChars
+        ? `${normalizedSummary.slice(0, maxSummaryChars)}...`
+        : normalizedSummary;
+    return `${normalizedName} · ${compactSummary}`;
+}

package/shared/image-detector.ts

@@ -0,0 +1,116 @@
+/**
+ * Detect image MIME type from buffer magic bytes.
+ * Canonical source — synced to src/ and container/agent-runner/src/ via make sync-types.
+ *
+ * Returns the detected MIME type or null if unknown.
+ */
+export function detectImageMimeTypeStrict(buffer: Buffer): string | null {
+  if (buffer.length < 12) {
+    return null;
+  }
+
+  // PNG: 89 50 4E 47 0D 0A 1A 0A
+  if (
+    buffer[0] === 0x89 &&
+    buffer[1] === 0x50 &&
+    buffer[2] === 0x4e &&
+    buffer[3] === 0x47 &&
+    buffer[4] === 0x0d &&
+    buffer[5] === 0x0a &&
+    buffer[6] === 0x1a &&
+    buffer[7] === 0x0a
+  ) {
+    return 'image/png';
+  }
+
+  // JPEG: FF D8 FF
+  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
+    return 'image/jpeg';
+  }
+
+  // GIF: 47 49 46 38
+  if (
+    buffer[0] === 0x47 &&
+    buffer[1] === 0x49 &&
+    buffer[2] === 0x46 &&
+    buffer[3] === 0x38
+  ) {
+    return 'image/gif';
+  }
+
+  // WebP: RIFF....WEBP
+  if (
+    buffer[0] === 0x52 &&
+    buffer[1] === 0x49 &&
+    buffer[2] === 0x46 &&
+    buffer[3] === 0x46 &&
+    buffer.length >= 12 &&
+    buffer[8] === 0x57 &&
+    buffer[9] === 0x45 &&
+    buffer[10] === 0x42 &&
+    buffer[11] === 0x50
+  ) {
+    return 'image/webp';
+  }
+
+  // TIFF: 49 49 2A 00 (little-endian) or 4D 4D 00 2A (big-endian)
+  if (
+    (buffer[0] === 0x49 &&
+      buffer[1] === 0x49 &&
+      buffer[2] === 0x2a &&
+      buffer[3] === 0x00) ||
+    (buffer[0] === 0x4d &&
+      buffer[1] === 0x4d &&
+      buffer[2] === 0x00 &&
+      buffer[3] === 0x2a)
+  ) {
+    return 'image/tiff';
+  }
+
+  // AVIF: ....ftypavif or ....ftypavis
+  if (buffer.length >= 12) {
+    const ftyp = buffer.toString('ascii', 4, 8);
+    if (ftyp === 'ftyp') {
+      const brand = buffer.toString('ascii', 8, 12);
+      if (brand === 'avif' || brand === 'avis') {
+        return 'image/avif';
+      }
+    }
+  }
+
+  // BMP: 42 4D
+  if (buffer[0] === 0x42 && buffer[1] === 0x4d) {
+    return 'image/bmp';
+  }
+
+  return null;
+}
+
+/**
+ * Detect image MIME type from buffer magic bytes with fallback.
+ */
+export function detectImageMimeType(buffer: Buffer): string {
+  return detectImageMimeTypeStrict(buffer) || 'image/jpeg';
+}
+
+/**
+ * Detect image MIME type from base64 payload (using header bytes only).
+ * Returns detected MIME or null if unknown/invalid.
+ */
+export function detectImageMimeTypeFromBase64Strict(
+  base64Data: string,
+): string | null {
+  try {
+    const header = Buffer.from(base64Data.slice(0, 400), 'base64');
+    return detectImageMimeTypeStrict(header);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Detect image MIME type from base64 payload with fallback.
+ */
+export function detectImageMimeTypeFromBase64(base64Data: string): string {
+  return detectImageMimeTypeFromBase64Strict(base64Data) || 'image/jpeg';
+}

package/shared/runtime-command-registry.ts

@@ -0,0 +1,252 @@
+export type RuntimeAgentType = 'claude' | 'codex';
+export type RuntimeCommandEntrypoint = 'im' | 'web';
+export type ReasoningEffortPreset = 'low' | 'medium' | 'high' | 'xhigh';
+
+const CLAUDE_MODEL_PRESETS = [
+  'opus[1m]',
+  'opus',
+  'sonnet[1m]',
+  'sonnet',
+  'haiku',
+] as const;
+
+const CODEX_MODEL_PRESETS = ['gpt-5.4', 'gpt-5.4-mini'] as const;
+
+const REASONING_EFFORT_PRESETS = [
+  'low',
+  'medium',
+  'high',
+  'xhigh',
+] as const;
+
+export interface RuntimeCommandDefinition {
+  name: string;
+  aliases?: string[];
+  usage: string;
+  description: string;
+  availableEntrypoints: RuntimeCommandEntrypoint[];
+  availabilityByRuntime?: RuntimeAgentType[] | 'all';
+}
+
+export interface ParsedRuntimeCommand {
+  rawName: string;
+  name: string;
+  argsText: string;
+  args: string[];
+}
+
+export const RUNTIME_COMMANDS: RuntimeCommandDefinition[] = [
+  {
+    name: 'help',
+    usage: '/help',
+    description: '查看当前入口可用命令',
+    availableEntrypoints: ['im', 'web'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'clear',
+    usage: '/clear',
+    description: '清除当前工作区或会话上下文',
+    availableEntrypoints: ['im', 'web'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'list',
+    aliases: ['ls'],
+    usage: '/list',
+    description: '查看当前用户可访问的工作区与对话',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'status',
+    usage: '/status',
+    description: '查看当前工作区和运行状态摘要',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'recall',
+    aliases: ['rc'],
+    usage: '/recall',
+    description: '回顾当前工作区最近消息',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'where',
+    usage: '/where',
+    description: '查看当前聊天绑定位置',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'bind',
+    usage: '/bind <workspace>',
+    description: '绑定到指定工作区或会话',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'unbind',
+    usage: '/unbind',
+    description: '解除当前绑定',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'new',
+    usage: '/new <名称>',
+    description: '创建新工作区并绑定过去',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'require_mention',
+    usage: '/require_mention true|false',
+    description: '控制群聊中是否必须 @机器人',
+    availableEntrypoints: ['im'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'sw',
+    aliases: ['spawn'],
+    usage: '/sw <任务描述>',
+    description: '创建并行任务',
+    availableEntrypoints: ['im', 'web'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'model',
+    usage: '/model <preset>',
+    description: '切换当前工作区模型预设',
+    availableEntrypoints: ['im', 'web'],
+    availabilityByRuntime: 'all',
+  },
+  {
+    name: 'effort',
+    usage: '/effort <low|medium|high|xhigh>',
+    description: '切换当前工作区思考强度',
+    availableEntrypoints: ['im', 'web'],
+    availabilityByRuntime: ['codex'],
+  },
+];
+
+function normalizeText(value: string): string {
+  return value.trim().toLowerCase();
+}
+
+export function supportsReasoningEffort(
+  agentType: RuntimeAgentType,
+): boolean {
+  return agentType === 'codex';
+}
+
+export function getModelPresets(agentType: RuntimeAgentType): string[] {
+  return agentType === 'codex'
+    ? [...CODEX_MODEL_PRESETS]
+    : [...CLAUDE_MODEL_PRESETS];
+}
+
+export function getReasoningEffortPresets(): ReasoningEffortPreset[] {
+  return [...REASONING_EFFORT_PRESETS];
+}
+
+export function normalizeModelPreset(
+  agentType: RuntimeAgentType,
+  rawValue: string,
+): string | null {
+  const normalized = normalizeText(rawValue);
+  const matched = getModelPresets(agentType).find(
+    (preset) => preset.toLowerCase() === normalized,
+  );
+  return matched ?? null;
+}
+
+export function normalizeReasoningEffortPreset(
+  rawValue: string,
+): ReasoningEffortPreset | null {
+  const normalized = normalizeText(rawValue);
+  return REASONING_EFFORT_PRESETS.find((preset) => preset === normalized) ?? null;
+}
+
+function isCommandAvailableForAgent(
+  command: RuntimeCommandDefinition,
+  agentType: RuntimeAgentType,
+): boolean {
+  if (
+    command.availabilityByRuntime === 'all' ||
+    !command.availabilityByRuntime
+  ) {
+    return true;
+  }
+  return command.availabilityByRuntime.includes(agentType);
+}
+
+export function findRuntimeCommand(
+  rawName: string,
+): RuntimeCommandDefinition | null {
+  const normalized = normalizeText(rawName);
+  if (!normalized) return null;
+  return (
+    RUNTIME_COMMANDS.find((command) => {
+      if (command.name === normalized) return true;
+      return command.aliases?.some((alias) => alias === normalized);
+    }) ?? null
+  );
+}
+
+export function parseRuntimeCommand(
+  text: string,
+): ParsedRuntimeCommand | null {
+  const trimmed = text.trim();
+  const body = trimmed.startsWith('/') ? trimmed.slice(1).trim() : trimmed;
+  if (!body) return null;
+
+  const [rawName = '', ...args] = body.split(/\s+/);
+  const command = findRuntimeCommand(rawName);
+  if (!command) return null;
+
+  return {
+    rawName,
+    name: command.name,
+    argsText: body.slice(rawName.length).trim(),
+    args,
+  };
+}
+
+export function isCommandAvailable(options: {
+  commandName: string;
+  entrypoint: RuntimeCommandEntrypoint;
+  agentType: RuntimeAgentType;
+}): boolean {
+  const command = findRuntimeCommand(options.commandName);
+  if (!command) return false;
+  return (
+    command.availableEntrypoints.includes(options.entrypoint) &&
+    isCommandAvailableForAgent(command, options.agentType)
+  );
+}
+
+export function getAvailableCommands(options: {
+  entrypoint: RuntimeCommandEntrypoint;
+  agentType: RuntimeAgentType;
+}): RuntimeCommandDefinition[] {
+  return RUNTIME_COMMANDS.filter(
+    (command) =>
+      command.availableEntrypoints.includes(options.entrypoint) &&
+      isCommandAvailableForAgent(command, options.agentType),
+  );
+}
+
+export function formatCommandHelp(options: {
+  entrypoint: RuntimeCommandEntrypoint;
+  agentType: RuntimeAgentType;
+}): string {
+  const commands = getAvailableCommands(options);
+  const lines = ['可用命令：'];
+  for (const command of commands) {
+    lines.push(`- ${command.usage}：${command.description}`);
+  }
+  return lines.join('\n');
+}