tycono 0.1.36 → 0.1.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tycono",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "description": "Build an AI company. Watch them work.",
   "type": "module",
   "bin": {

package/src/api/src/engine/agent-loop.ts

@@ -5,6 +5,7 @@ import { validateDispatch } from './authority-validator.js';
 import { getToolsForRole } from './tools/definitions.js';
 import { executeTool, type ToolExecutorOptions } from './tools/executor.js';
 import { type TokenLedger } from '../services/token-ledger.js';
+import { type ImageAttachment } from './runners/types.js';
 
 /* ─── Types ──────────────────────────────────── */
 
@@ -24,6 +25,7 @@ export interface AgentConfig {
   jobId?: string;             // Job ID for token tracking
   model?: string;             // LLM model name for cost tracking
   tokenLedger?: TokenLedger;  // Token usage ledger (optional)
+  attachments?: ImageAttachment[];  // Image attachments for vision
   // Callbacks
   onText?: (text: string) => void;
   onToolExec?: (name: string, input: Record<string, unknown>) => void;
@@ -133,8 +135,28 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
   };
 
   // 4. Run the loop
+  // Build initial user message with optional image attachments
+  const userContent: MessageContent[] = [];
+
+  // Add image attachments first (if any)
+  if (config.attachments && config.attachments.length > 0) {
+    for (const att of config.attachments) {
+      userContent.push({
+        type: 'image',
+        source: {
+          type: 'base64',
+          media_type: att.mediaType,
+          data: att.data,
+        },
+      } as unknown as MessageContent);
+    }
+  }
+
+  // Add text content
+  userContent.push({ type: 'text', text: task });
+
   const messages: LLMMessage[] = [
-    { role: 'user', content: task },
+    { role: 'user', content: userContent.length === 1 ? task : userContent },
   ];
 
   let turns = 0;

package/src/api/src/engine/llm-adapter.ts

@@ -23,7 +23,8 @@ export interface ToolResult {
 
 export type MessageContent =
   | { type: 'text'; text: string }
-  | { type: 'tool_use'; id: string; name: string; input: Record<string, unknown> };
+  | { type: 'tool_use'; id: string; name: string; input: Record<string, unknown> }
+  | { type: 'image'; source: { type: 'base64'; media_type: string; data: string } };
 
 export interface LLMResponse {
   content: MessageContent[];

package/src/api/src/engine/runners/claude-cli.ts

@@ -128,7 +128,13 @@ else:
  */
 export class ClaudeCliRunner implements ExecutionRunner {
   execute(config: RunnerConfig, callbacks: RunnerCallbacks): RunnerHandle {
-    const { companyRoot, roleId, task, sourceRole, orgTree, readOnly = false, teamStatus } = config;
+    const { companyRoot, roleId, task, sourceRole, orgTree, readOnly = false, teamStatus, attachments } = config;
+
+    // Note: Claude CLI doesn't support inline image attachments.
+    // Images will be ignored with a warning if passed.
+    if (attachments && attachments.length > 0) {
+      console.warn(`[ClaudeCliRunner] Warning: Image attachments (${attachments.length}) are not supported in CLI mode. Use EXECUTION_ENGINE=direct-api for vision support.`);
+    }
 
     // 1. Context Assembly
     const context = assembleContext(companyRoot, roleId, task, sourceRole, orgTree, { teamStatus });

package/src/api/src/engine/runners/direct-api.ts

@@ -40,6 +40,7 @@ export class DirectApiRunner implements ExecutionRunner {
       jobId: config.jobId,
       model: config.model,
       tokenLedger,
+      attachments: config.attachments,
       onText: (text) => callbacks.onText?.(text),
       onToolExec: (name, input) => callbacks.onToolUse?.(name, input),
       onDispatch: (roleId, task) => callbacks.onDispatch?.(roleId, task),

package/src/api/src/engine/runners/types.ts

@@ -12,6 +12,15 @@ import type { OrgTree } from '../org-tree.js';
  * EXECUTION_ENGINE 환경변수로 전환 (기본값: claude-cli)
  */
 
+/* ─── Attachment Types ────────────────────────── */
+
+export interface ImageAttachment {
+  type: 'image';
+  data: string;      // base64 encoded
+  name: string;
+  mediaType: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+}
+
 /* ─── Config ──────────────────────────────────── */
 
 export type TeamStatus = Record<string, { status: string; task?: string }>;
@@ -27,6 +36,7 @@ export interface RunnerConfig {
   model?: string;
   jobId?: string;
   teamStatus?: TeamStatus;
+  attachments?: ImageAttachment[];
 }
 
 /* ─── Callbacks ───────────────────────────────── */

package/src/api/src/routes/execute.ts

@@ -8,6 +8,7 @@ import {
   addMessage,
   updateMessage,
   type Message,
+  type ImageAttachment,
 } from '../services/session-store.js';
 import { jobManager, type Job } from '../services/job-manager.js';
 import { ActivityStream, type ActivityEvent, type ActivitySubscriber } from '../services/activity-stream.js';
@@ -597,11 +598,32 @@ function handleSessionMessage(
 
   const content = body.content as string;
   const mode = (body.mode as 'talk' | 'do') ?? session.mode;
-  if (!content) {
-    jsonResponse(res, 400, { error: 'content is required' });
+  const attachments = body.attachments as ImageAttachment[] | undefined;
+
+  // Allow empty content if there are attachments
+  if (!content && (!attachments || attachments.length === 0)) {
+    jsonResponse(res, 400, { error: 'content or attachments required' });
     return;
   }
 
+  // Validate attachments if present
+  const MAX_FILE_SIZE = 5 * 1024 * 1024; // 5MB
+  const SUPPORTED_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'];
+  if (attachments && attachments.length > 0) {
+    for (const att of attachments) {
+      if (!SUPPORTED_TYPES.includes(att.mediaType)) {
+        jsonResponse(res, 400, { error: `Unsupported image type: ${att.mediaType}` });
+        return;
+      }
+      // Approximate size check (base64 is ~33% larger than binary)
+      const approximateSize = (att.data.length * 3) / 4;
+      if (approximateSize > MAX_FILE_SIZE) {
+        jsonResponse(res, 400, { error: `File too large: ${att.name}. Max 5MB.` });
+        return;
+      }
+    }
+  }
+
   const roleId = session.roleId;
   const readOnly = mode === 'talk';
 
@@ -614,17 +636,18 @@ function handleSessionMessage(
   const ceoMsg: Message = {
     id: `msg-${Date.now()}-ceo`,
     from: 'ceo',
-    content,
+    content: content || '',
     type: mode === 'do' ? 'directive' : 'conversation',
     status: 'done',
     timestamp: new Date().toISOString(),
+    attachments,
   };
   addMessage(sessionId, ceoMsg);
 
   const contextWindow = buildConversationContext(session.messages, ceoMsg);
   const fullTask = contextWindow
-    ? `${contextWindow}\n[Current Message]\nCEO: ${content}`
-    : content;
+    ? `${contextWindow}\n[Current Message]\nCEO: ${content || '(image attached)'}`
+    : content || '(image attached)';
 
   const roleMsg: Message = {
     id: `msg-${Date.now() + 1}-role`,
@@ -700,7 +723,7 @@ function handleSessionMessage(
   });
 
   const handle = getRunner().execute(
-    { companyRoot: COMPANY_ROOT, roleId, task: fullTask, sourceRole: 'ceo', orgTree, readOnly, model: orgTree.nodes.get(roleId)?.model },
+    { companyRoot: COMPANY_ROOT, roleId, task: fullTask, sourceRole: 'ceo', orgTree, readOnly, model: orgTree.nodes.get(roleId)?.model, attachments },
     {
       onText: (text) => {
         roleMsg.content += text;

package/src/api/src/routes/speech.ts

@@ -263,6 +263,101 @@ function buildCompanyContext(): string {
     : '';
 }
 
+/**
+ * Build role-specific AKB context by pre-fetching relevant knowledge server-side.
+ * Works with ANY engine (including claude-cli which doesn't support tool_use).
+ */
+function buildRoleContext(roleId: string): string {
+  const parts: string[] = [];
+
+  // 1. Role's own journal (most recent 2 entries)
+  try {
+    const journalDir = path.join(COMPANY_ROOT, 'roles', roleId, 'journal');
+    if (fs.existsSync(journalDir)) {
+      const files = fs.readdirSync(journalDir)
+        .filter(f => f.endsWith('.md'))
+        .sort()
+        .slice(-2);
+      for (const file of files) {
+        const content = fs.readFileSync(path.join(journalDir, file), 'utf-8');
+        // Extract title + first meaningful section (truncated)
+        const title = content.match(/^#\s+(.+)/m)?.[1] ?? file;
+        const body = content.split('\n').slice(1).join('\n').trim().slice(0, 400);
+        parts.push(`[Your Journal: ${file}] ${title}\n${body}`);
+      }
+    }
+  } catch { /* no journal */ }
+
+  // 2. Recent waves mentioning this role (last 3)
+  try {
+    const wavesDir = path.join(COMPANY_ROOT, 'operations', 'waves');
+    if (fs.existsSync(wavesDir)) {
+      const waveFiles = fs.readdirSync(wavesDir)
+        .filter(f => f.endsWith('.md'))
+        .sort()
+        .slice(-10); // scan last 10, pick up to 3 relevant
+      const relevant: string[] = [];
+      for (const file of waveFiles.reverse()) {
+        if (relevant.length >= 3) break;
+        const content = fs.readFileSync(path.join(wavesDir, file), 'utf-8');
+        const lower = content.toLowerCase();
+        if (lower.includes(roleId) || lower.includes('all roles') || lower.includes('전체')) {
+          const title = content.match(/^#\s+(.+)/m)?.[1] ?? file;
+          const tldr = content.match(/TL;DR[\s\S]*?\n\n/)?.[0]?.trim() ?? '';
+          const snippet = tldr || content.split('\n').slice(1, 6).join('\n').trim();
+          relevant.push(`[Wave: ${file}] ${title}\n${snippet.slice(0, 300)}`);
+        }
+      }
+      if (relevant.length > 0) parts.push(...relevant);
+    }
+  } catch { /* no waves */ }
+
+  // 3. Recent standup (latest, only this role's section)
+  try {
+    const standupDir = path.join(COMPANY_ROOT, 'operations', 'standup');
+    if (fs.existsSync(standupDir)) {
+      const standupFiles = fs.readdirSync(standupDir)
+        .filter(f => f.endsWith('.md'))
+        .sort()
+        .slice(-1);
+      for (const file of standupFiles) {
+        const content = fs.readFileSync(path.join(standupDir, file), 'utf-8');
+        // Try to extract this role's section from standup
+        const rolePattern = new RegExp(`(## .*${roleId}.*|### .*${roleId}.*)([\\s\\S]*?)(?=\\n## |\\n### |$)`, 'i');
+        const match = content.match(rolePattern);
+        if (match) {
+          parts.push(`[Standup: ${file}] Your report:\n${match[0].slice(0, 300)}`);
+        }
+      }
+    }
+  } catch { /* no standups */ }
+
+  // 4. Recent decisions (last 2 approved — brief titles only, full list is in company context)
+  try {
+    const decisionsDir = path.join(COMPANY_ROOT, 'operations', 'decisions');
+    if (fs.existsSync(decisionsDir)) {
+      const files = fs.readdirSync(decisionsDir)
+        .filter(f => f.endsWith('.md') && f !== 'decisions.md')
+        .sort()
+        .slice(-3);
+      const decisions: string[] = [];
+      for (const file of files) {
+        const content = fs.readFileSync(path.join(decisionsDir, file), 'utf-8');
+        const title = content.match(/^#\s+(.+)/m)?.[1] ?? file;
+        const summary = content.match(/## (?:Summary|TL;DR|요약)[\s\S]*?\n\n/)?.[0]?.trim() ?? '';
+        decisions.push(`- ${title}${summary ? ': ' + summary.split('\n').slice(1).join(' ').trim().slice(0, 150) : ''}`);
+      }
+      if (decisions.length > 0) {
+        parts.push(`[Recent Decisions]\n${decisions.join('\n')}`);
+      }
+    }
+  } catch { /* no decisions */ }
+
+  return parts.length > 0
+    ? `\n\nYOUR KNOWLEDGE (real AKB context — reference this in conversation):\n${parts.join('\n\n')}`
+    : '';
+}
+
 /**
  * Role-specific chat style guidelines.
  * Makes each role sound distinctly different in conversations.
@@ -463,6 +558,9 @@ speechRouter.post('/chat', async (req: Request, res: Response, next: NextFunctio
     // Build company context (cached per request — lightweight)
     const companyCtx = buildCompanyContext();
 
+    // Build role-specific AKB context (pre-fetched, works with any engine)
+    const roleCtx = buildRoleContext(roleId);
+
     // Role-specific communication style
     const roleStyle = getRoleChatStyle(roleId, node.level);
 
@@ -471,6 +569,7 @@ Persona: ${persona}
 ${workCtx}
 ${levelCtx}
 ${companyCtx}
+${roleCtx}
 
 You are in the #${channelId} chat channel.${topicCtx}
 Members: ${memberList}
@@ -478,22 +577,11 @@ ${relContext}
 
 ${roleStyle}
 
-AKB EXPLORATION (IMPORTANT):
-You have tools to search and read the company knowledge base (AKB). Use them to ground your conversation in REAL company context.
-Before responding, consider: "Is there something in our AKB that relates to this conversation?"
-- search_akb: Search for keywords across the AKB (decisions, projects, journals, waves, standups)
-- read_file: Read a specific file for details
-- list_files: Discover what files exist in a directory
-
-Useful paths to explore:
-- operations/decisions/ — CEO decisions (what was decided and why)
-- operations/waves/ — Work dispatches (what CEO asked teams to do)
-- operations/standups/ — Daily standups (what everyone reported)
-- projects/ — Active projects and their tasks
-- roles/${roleId}/journal/ — Your own work journal
-- knowledge/ — Domain knowledge
-
-You don't need to search every time. But when the conversation touches on company work, decisions, or direction, DO search to find real facts rather than making up generic discussion.
+GROUNDING (CRITICAL):
+You have been given real company knowledge above under "YOUR KNOWLEDGE". This is from your journal, recent CEO waves, standups, and decisions.
+You MUST reference this real context in your conversations — mention specific projects, decisions, tasks, or events by name.
+Do NOT generate generic workplace chatter. Every message should show you're aware of what's actually happening in the company.
+If your knowledge section mentions a specific decision or wave, reference it naturally (e.g. "after the test minimization decision..." or "CEO's wave about side panel...").
 
 CONVERSATION RULES:
 1. Stay deeply in character — your expertise, vocabulary, and concerns should be DISTINCT from other roles.

package/src/api/src/services/job-manager.ts

@@ -46,6 +46,8 @@ export interface StartJobParams {
   readOnly?: boolean;
   parentJobId?: string;
   model?: string;
+  /** If true, this is a continuation from CEO reply — skip question detection */
+  isContinuation?: boolean;
 }
 
 /* ─── Helpers ────────────────────────────── */
@@ -218,7 +220,8 @@ class JobManager {
         };
 
         // Check if output ends with a question → awaiting_input
-        if (hasQuestion(result.output)) {
+        // Skip for continuation jobs (CEO already replied once — avoid infinite loop)
+        if (!params.isContinuation && hasQuestion(result.output)) {
           job.status = 'awaiting_input';
           stream.emit('job:awaiting_input', params.roleId, {
             ...doneData,
@@ -344,13 +347,14 @@ class JobManager {
       : prevOutput;
     const continuationTask = `[Continuation — previous output follows]\n${contextSummary}\n\n[CEO Response]\n${response}`;
 
-    // Create new job for same role
+    // Create new job for same role (mark as continuation to skip question detection)
     const newJob = this.startJob({
       type: job.type,
       roleId: job.roleId,
       task: continuationTask,
       sourceRole: 'ceo',
       parentJobId: job.id,
+      isContinuation: true,
     });
 
     job.childJobIds.push(newJob.id);

package/src/api/src/services/session-store.ts

@@ -4,6 +4,13 @@ import { COMPANY_ROOT } from './file-reader.js';
 
 /* ─── Types ─────────────────────────────── */
 
+export interface ImageAttachment {
+  type: 'image';
+  data: string;      // base64 encoded
+  name: string;
+  mediaType: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+}
+
 export interface Message {
   id: string;
   from: 'ceo' | 'role';
@@ -11,6 +18,7 @@ export interface Message {
   type: 'conversation' | 'directive' | 'system';
   status?: 'streaming' | 'done' | 'error';
   timestamp: string;
+  attachments?: ImageAttachment[];
 }
 
 export interface Session {