tower-studio 0.1.3 → 0.1.6

package/src/lib/ai/types.ts

@@ -1,151 +0,0 @@
-// src/lib/ai/types.ts
-
-// ---------------------------------------------------------------------------
-// CLI Adapter — PTY execution layer
-// ---------------------------------------------------------------------------
-
-export interface CliSpawnOptions {
-  taskId: string;
-  prompt: string;
-  cwd: string;
-  envOverrides?: Record<string, string>;
-  resumeSessionId?: string;
-  continueLatest?: boolean;
-  worktreePath?: string;
-  profileArgs?: string[];
-  profileEnvVars?: Record<string, string>;
-}
-
-export interface CliSpawnResult {
-  command: string;
-  args: string[];
-  env: Record<string, string>;
-  /** Gemini: spawn 后通过 PTY write 发送初始 prompt */
-  initialInput?: string;
-}
-
-export interface CliAdapter {
-  buildSpawnArgs(opts: CliSpawnOptions): CliSpawnResult;
-
-  buildEnvOverrides(opts: {
-    taskId: string;
-    taskTitle: string;
-    apiUrl: string;
-    callbackUrl?: string;
-  }): Record<string, string>;
-
-  installHooks(apiUrl: string): Promise<void>;
-  uninstallHooks(): Promise<void>;
-  isHooksInstalled(): Promise<boolean>;
-
-  isAvailable(): Promise<boolean>;
-  getVersion(): Promise<string | null>;
-  getModels(): Promise<string[]>;
-
-  getConfigDir(): string;
-  getSettingsPath(): string;
-  getSessionsDir(): string;
-}
-
-// ---------------------------------------------------------------------------
-// AI Query Adapter — single-turn and streaming queries
-// ---------------------------------------------------------------------------
-
-export interface AiQueryOptions {
-  prompt: string;
-  cwd?: string;
-  systemPrompt?: string;
-  model?: string;
-  maxTurns?: number;
-  tools?: string[];
-  allowedTools?: string[];
-}
-
-export interface AiQueryResult {
-  content: string | null;
-  usage?: { inputTokens: number; outputTokens: number };
-}
-
-export interface AiQueryChunk {
-  type: "text" | "tool_use" | "tool_result" | "error";
-  content: string;
-}
-
-export interface AiQueryAdapter {
-  query(opts: AiQueryOptions): Promise<AiQueryResult>;
-  queryStream?(opts: AiQueryOptions): AsyncIterable<AiQueryChunk>;
-
-  isAvailable(): Promise<boolean>;
-  getModels(): Promise<string[]>;
-}
-
-// ---------------------------------------------------------------------------
-// Provider definition & registry types
-// ---------------------------------------------------------------------------
-
-export interface ProviderDefinition {
-  name: string;
-  displayName: string;
-  agentFieldValue: string;
-
-  cli?: {
-    command: string;
-    adapter: CliAdapter;
-  };
-  api?: {
-    keyEnvVar: string;
-    adapter: AiQueryAdapter;
-  };
-  cliQuery?: {
-    adapter: AiQueryAdapter;
-  };
-
-  models: {
-    cli: string[];
-    api: string[];
-  };
-}
-
-export interface ProviderAvailability {
-  name: string;
-  displayName: string;
-  cli: { available: boolean; version: string | null };
-  api: { available: boolean; keyConfigured: boolean };
-}
-
-// ---------------------------------------------------------------------------
-// Capability slot config (mirrors Prisma model)
-// ---------------------------------------------------------------------------
-
-export type AiSlot = "terminal" | "summary" | "dreaming" | "analysis" | "assistant";
-
-export interface AiSlotConfig {
-  slot: AiSlot;
-  provider: string;
-  mode: "cli" | "api";
-  model?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Errors
-// ---------------------------------------------------------------------------
-
-export type AiProviderErrorCode =
-  | "CLI_NOT_FOUND"
-  | "API_KEY_MISSING"
-  | "MODEL_NOT_AVAILABLE"
-  | "RATE_LIMITED"
-  | "NETWORK_ERROR"
-  | "UNSUPPORTED_MODE"
-  | "SPAWN_FAILED";
-
-export class AiProviderError extends Error {
-  constructor(
-    public code: AiProviderErrorCode,
-    public provider: string,
-    message: string,
-  ) {
-    super(message);
-    this.name = "AiProviderError";
-  }
-}

package/src/lib/assistant-constants.ts

@@ -1,2 +0,0 @@
-/** Fixed session key for the global assistant PTY session */
-export const ASSISTANT_SESSION_KEY = "__assistant__";

package/src/lib/assistant-message-converter.ts

@@ -1,131 +0,0 @@
-/**
- * Convert Claude Agent SDK SessionMessage[] → ChatMessage[] for the assistant UI.
- */
-
-import type { ChatMessage } from "@/hooks/use-assistant-chat";
-
-/** Minimal shape of what the SDK returns from getSessionMessages */
-export interface SDKSessionMessage {
-  type: "user" | "assistant" | "system";
-  uuid: string;
-  session_id: string;
-  message: unknown;
-  parent_tool_use_id: null;
-}
-
-interface ContentBlock {
-  type: string;
-  text?: string;
-  name?: string;
-  input?: unknown;
-  thinking?: string;
-}
-
-interface UserContentBlock {
-  type: string;
-  source?: { type?: string; media_type?: string; data?: string };
-  text?: string;
-}
-
-/**
- * Extract imageFilenames from a user message's content field.
- * Currently returns undefined for Phase 42 (images tracked client-side).
- * Phase 43 will populate this from SDK image blocks when multimodal is wired.
- */
-function extractImageFilenames(content: unknown): string[] | undefined {
-  // If content is an array of multimodal blocks, look for image blocks (Phase 43+)
-  if (Array.isArray(content)) {
-    const imageBlocks = (content as UserContentBlock[]).filter(
-      (b) => b.type === "image" && b.source?.data
-    );
-    if (imageBlocks.length > 0) {
-      // Phase 43 will map these to server filenames; for now return undefined
-      return undefined;
-    }
-  }
-  return undefined;
-}
-
-interface SystemPayload {
-  subtype?: string;
-  tool_name?: string;
-  content?: string;
-}
-
-function nextId(): string {
-  return typeof crypto !== "undefined" && crypto.randomUUID
-    ? crypto.randomUUID()
-    : `msg-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
-}
-
-export function convertSessionMessages(sdkMessages: SDKSessionMessage[]): ChatMessage[] {
-  const result: ChatMessage[] = [];
-
-  for (const msg of sdkMessages) {
-    switch (msg.type) {
-      case "user": {
-        const payload = msg.message as { content?: unknown };
-        let text = typeof payload?.content === "string" ? payload.content : "";
-        // Strip "/tower " prefix injected by chat route
-        if (text.startsWith("/tower ")) text = text.slice(7);
-        // Strip skill XML wrapping: <command-message>tower</command-message><command-name>/tower</command-name><command-args>actual text</command-args>
-        const argsMatch = text.match(/<command-args>([\s\S]*?)<\/command-args>/);
-        if (argsMatch) text = argsMatch[1].trim();
-        // Strip multimodal image prompt appended by buildMultimodalPrompt
-        text = text.replace(/\n---\nThe user has attached the following image\(s\)[\s\S]*$/, "").trim();
-        const imageFilenames = extractImageFilenames(payload?.content);
-        if (text) {
-          result.push({ id: nextId(), role: "user", content: text, imageFilenames });
-        }
-        break;
-      }
-
-      case "assistant": {
-        const payload = msg.message as { content?: ContentBlock[] };
-        const blocks = Array.isArray(payload?.content) ? payload.content : [];
-
-        // Collect text blocks
-        const textParts = blocks
-          .filter((b) => b.type === "text" && b.text)
-          .map((b) => b.text!);
-
-        if (textParts.length > 0) {
-          result.push({
-            id: nextId(),
-            role: "assistant",
-            content: textParts.join(""),
-          });
-        }
-
-        // Collect tool_use blocks as separate messages
-        for (const block of blocks) {
-          if (block.type === "tool_use" && block.name) {
-            result.push({
-              id: nextId(),
-              role: "tool",
-              content: JSON.stringify(block.input ?? {}, null, 2),
-              toolName: block.name,
-            });
-          }
-        }
-        break;
-      }
-
-      case "system": {
-        const payload = msg.message as SystemPayload | undefined;
-        if (payload?.subtype === "tool_result" && payload.content) {
-          result.push({
-            id: nextId(),
-            role: "tool",
-            content: payload.content,
-            toolName: `${payload.tool_name ?? "tool"} (result)`,
-          });
-        }
-        // Skip other system messages
-        break;
-      }
-    }
-  }
-
-  return result;
-}

package/src/lib/assistant-sessions.ts

@@ -1,75 +0,0 @@
-export interface AssistantSession {
-  id: string;       // UUID / SDK session ID
-  title: string;    // First user message truncated to 30 chars, or "New Session"
-  createdAt: string; // ISO string
-  updatedAt: string; // ISO string
-}
-
-const STORAGE_KEY = "tower-assistant-sessions";
-const ACTIVE_KEY = "tower-assistant-active-session";
-const MAX_SESSIONS = 10;
-
-export function getSessions(): AssistantSession[] {
-  if (typeof window === "undefined") return [];
-  try {
-    const raw = localStorage.getItem(STORAGE_KEY);
-    if (!raw) return [];
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) return [];
-    return parsed as AssistantSession[];
-  } catch {
-    return [];
-  }
-}
-
-export function addSession(session: AssistantSession): void {
-  if (typeof window === "undefined") return;
-  const existing = getSessions();
-  // Prepend and cap at MAX_SESSIONS
-  const updated = [session, ...existing.filter((s) => s.id !== session.id)].slice(0, MAX_SESSIONS);
-  localStorage.setItem(STORAGE_KEY, JSON.stringify(updated));
-}
-
-export function updateSession(id: string, updates: Partial<AssistantSession>): void {
-  if (typeof window === "undefined") return;
-  const existing = getSessions();
-  const updated = existing.map((s) =>
-    s.id === id ? { ...s, ...updates, updatedAt: new Date().toISOString() } : s
-  );
-  localStorage.setItem(STORAGE_KEY, JSON.stringify(updated));
-}
-
-export function deleteSession(id: string): void {
-  if (typeof window === "undefined") return;
-  const existing = getSessions();
-  const updated = existing.filter((s) => s.id !== id);
-  localStorage.setItem(STORAGE_KEY, JSON.stringify(updated));
-  // If we deleted the active session, clear active
-  if (getActiveSessionId() === id) {
-    setActiveSessionId(null);
-  }
-}
-
-export function getActiveSessionId(): string | null {
-  if (typeof window === "undefined") return null;
-  return localStorage.getItem(ACTIVE_KEY);
-}
-
-export function setActiveSessionId(id: string | null): void {
-  if (typeof window === "undefined") return;
-  if (id === null) {
-    localStorage.removeItem(ACTIVE_KEY);
-  } else {
-    localStorage.setItem(ACTIVE_KEY, id);
-  }
-}
-
-/**
- * Build a session title from the first user message.
- * Truncates to 30 characters.
- */
-export function buildSessionTitle(firstMessage: string): string {
-  const trimmed = firstMessage.trim();
-  if (!trimmed) return "New Session";
-  return trimmed.length > 30 ? trimmed.slice(0, 30) : trimmed;
-}

package/src/lib/build-multimodal-prompt.ts

@@ -1,53 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-const MAX_IMAGES = 10;
-
-/** Sub-path format: YYYY-MM/(images|files)/filename.ext — prevents traversal and arbitrary filenames */
-const SAFE_SUBPATH_RE =
-  /^\d{4}-\d{2}\/(images|files)\/[^/]+\.(jpg|jpeg|png|gif|webp)$/i;
-
-/**
- * Builds a multimodal prompt by appending image file paths to the prompt text.
- *
- * If no images are provided (or all resolve to missing files), returns the
- * original prompt unchanged — preserving backward compatibility for text-only
- * messages (AI-03).
- *
- * The appended section instructs Claude to use the Read tool to view the images,
- * so they become part of the conversation context (AI-01, AI-02).
- *
- * @param prompt - The original prompt text
- * @param imageFilenames - Array of sub-paths (e.g. '2026-04/images/name.png') relative to cacheDir
- * @param cacheDir - Absolute path to the directory where images are stored
- * @returns The original prompt (if no valid images) or prompt with appended image section
- */
-export function buildMultimodalPrompt(
-  prompt: string,
-  imageFilenames: string[],
-  cacheDir: string
-): string {
-  if (imageFilenames.length === 0) {
-    return prompt;
-  }
-
-  const filenames = imageFilenames.slice(0, MAX_IMAGES);
-  const cacheDirNorm = path.resolve(cacheDir);
-
-  // Validate sub-path format, resolve path, and enforce containment
-  const validPaths = filenames
-    .filter((subPath) => SAFE_SUBPATH_RE.test(subPath))
-    .map((subPath) => path.resolve(cacheDir, subPath))
-    .filter((absPath) => {
-      if (!absPath.startsWith(cacheDirNorm + path.sep)) return false;
-      return fs.existsSync(absPath);
-    });
-
-  if (validPaths.length === 0) {
-    return prompt;
-  }
-
-  const pathList = validPaths.map((p) => `- ${p}`).join("\n");
-
-  return `${prompt}\n\n---\nThe user has attached the following image(s). Use the Read tool to view them:\n${pathList}`;
-}

package/src/lib/claude-session.ts

@@ -1,156 +0,0 @@
-import { ClaudeCliAdapter } from "@/lib/ai/adapters/cli/claude-cli-adapter";
-
-const claudeAdapter = new ClaudeCliAdapter();
-
-export interface DreamingResult {
-  summary: string;
-  insights: Array<{ type: "pattern" | "pitfall" | "decision" | "tool" | "reference"; content: string }>;
-  shouldCreateNote: boolean;
-  noteTitle?: string;
-}
-
-/**
- * Run a single-turn AI query via Claude Agent SDK.
- * Unified entry point — all AI capabilities route through here.
- */
-export interface AiQueryOptions {
-  maxTurns?: number;
-  /** Built-in tools to enable (e.g. ["Read", "Glob", "Grep"]) */
-  tools?: string[];
-  /** Tool patterns to allow (e.g. ["Read", "Glob"]) */
-  allowedTools?: string[];
-}
-
-export async function aiQuery(
-  prompt: string,
-  cwd: string,
-  opts: AiQueryOptions = {},
-): Promise<string | null> {
-  let result = "";
-  try {
-    const { query } = await import("@anthropic-ai/claude-agent-sdk");
-    const claudePath = claudeAdapter.resolveCommand();
-    const q = query({
-      prompt,
-      options: {
-        tools: opts.tools ?? [],
-        allowedTools: opts.allowedTools ?? [],
-        maxTurns: opts.maxTurns ?? 1,
-        cwd,
-        pathToClaudeCodeExecutable: claudePath,
-        sessionPersistence: false,
-      } as Parameters<typeof query>[0]["options"],
-    });
-
-    for await (const msg of q) {
-      if (msg.type === "assistant") {
-        const textBlocks = msg.message.content.filter(
-          (b: { type: string }) => b.type === "text"
-        );
-        result += textBlocks
-          .map((b: { type: string; text?: string }) => b.text ?? "")
-          .join("");
-      } else if (msg.type === "result") {
-        // SDK result message — may contain final text
-        const resultMsg = msg as Record<string, unknown>;
-        const resultText = typeof resultMsg.result === "string" ? resultMsg.result : "";
-        if (resultText && !result) result = resultText;
-      }
-    }
-
-    return result.trim() || null;
-  } catch (err) {
-    const error = err as Error;
-    // max_turns reached — SDK throws but we may have partial result
-    if (error.message?.includes("maximum number of turns") && result.trim()) {
-      return result.trim();
-    }
-    console.error("[aiQuery] Failed:", error.message, error.stack?.slice(0, 300));
-    return null;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Small summary — stop 时生成
-// ---------------------------------------------------------------------------
-
-/**
- * Generate an AI summary from terminal log content.
- * Uses Agent SDK for unified AI access.
- */
-export async function generateSummaryFromLog(
-  terminalLog: string,
-  cwd: string
-): Promise<string | null> {
-  const prompt = `以下是一次AI编程助手的终端会话记录。请用一句简短的中文总结这次会话做了什么（不超过50字，只回答总结内容，不要加引号或前缀）：
-
-\`\`\`
-${terminalLog.slice(-5000)}
-\`\`\``;
-
-  const result = await aiQuery(prompt, cwd);
-  if (!result) return null;
-  return result.replace(/^[#*\->"'\s]+/, "").trim() || null;
-}
-
-// ---------------------------------------------------------------------------
-// Dreaming — 任务 DONE 时生成
-// ---------------------------------------------------------------------------
-
-/**
- * Generate dreaming insights from a completed session.
- * Uses Agent SDK for unified AI access.
- */
-export async function generateDreamingInsight(
-  terminalLog: string,
-  cwd: string,
-  aiSummary: string | null
-): Promise<DreamingResult | null> {
-  const logSnippet = terminalLog.slice(-8000);
-  const summaryContext = aiSummary ? `\nSession summary: ${aiSummary}` : "";
-
-  const prompt = `You are analyzing a completed AI coding session. Extract reusable insights.
-${summaryContext}
-
-Terminal log (last 8000 chars):
-\`\`\`
-${logSnippet}
-\`\`\`
-
-Respond ONLY with valid JSON matching this schema (no markdown, no explanation):
-{
-  "summary": "one-sentence summary of what was accomplished",
-  "insights": [
-    { "type": "pattern|pitfall|decision|tool|reference", "content": "description" }
-  ],
-  "shouldCreateNote": true/false,
-  "noteTitle": "short title for the note (only if shouldCreateNote is true)"
-}
-
-Rules:
-- Set shouldCreateNote=true ONLY if there are genuinely reusable insights (architectural decisions, non-obvious pitfalls, useful patterns, important tool discoveries)
-- Trivial sessions (simple formatting, single-line edits, routine commits) should have shouldCreateNote=false
-- insights array can be empty if nothing notable
-- Keep each insight concise (1-2 sentences)`;
-
-  const result = await aiQuery(prompt, cwd);
-  if (!result) return null;
-
-  try {
-    let jsonStr = result;
-    const jsonMatch = jsonStr.match(/\{[\s\S]*\}/);
-    if (jsonMatch) jsonStr = jsonMatch[0];
-
-    const parsed = JSON.parse(jsonStr) as DreamingResult;
-
-    if (typeof parsed.summary !== "string" || typeof parsed.shouldCreateNote !== "boolean") {
-      console.error("[generateDreamingInsight] Invalid response structure");
-      return null;
-    }
-
-    return parsed;
-  } catch (parseErr) {
-    console.error("[generateDreamingInsight] JSON parse failed:", (parseErr as Error).message);
-    return null;
-  }
-}