@jungjaehoon/mama-os 0.10.0 → 0.10.2

package/README.md

@@ -156,6 +156,9 @@ gateways:
 # In Slack
 @mama what's the status?
 @mama /report
+
+# File upload support
+@mama [attach image] translate this
 ```
 
 ### Telegram Bot
@@ -222,6 +225,20 @@ Built-in web interface for managing MAMA and chatting with your configured backe
 - Topic filtering and search
 - Export decisions (JSON, Markdown, CSV)
 
+**🧩 Skills Tab**
+
+- Browse installed skills with status badges (published/draft/coworking)
+- Click to open in Skill Lab Playground for editing
+- Skill verification with 12-point checklist
+
+**🧪 Playground Tab**
+
+- **Skill Lab** — Step-by-step skill creation, modification, and verification
+- **Cron Workflow Lab** — Node-based DAG editor for cron workflows (trigger → prompt → condition → action)
+- **Wave Visualizer** — Multi-Agent task execution flow visualizer (Simulation + Live modes)
+- Bidirectional sync with Skills Tab (select skill → opens in Skill Lab)
+- "Open in new tab" for full-screen editing
+
 **⚙️ Settings Tab**
 
 - Configure gateway tokens
@@ -400,7 +417,6 @@ multi_agent:
       bot_token: 'DISCORD_BOT_TOKEN_2'
       tier: 1 # Full access for code changes
       auto_continue: true
-      pool_size: 3 # Enable 3 parallel processes for this agent
       auto_respond_keywords: ['bug', 'code', 'implement', '구현']
 
     reviewer:
@@ -439,38 +455,6 @@ multi_agent:
     global_cooldown_ms: 2000
 ```
 
-### Process Pool (Parallel Execution)
-
-Each agent runs as a separate backend CLI subprocess. By default, each agent has **1 process** (sequential execution). Configure `pool_size` to enable parallel task execution per agent.
-
-```yaml
-multi_agent:
-  agents:
-    developer:
-      pool_size: 5 # 5 parallel backend CLI processes for this agent
-```
-
-**How it works:**
-
-- When a task arrives and all processes are busy, a new process is spawned (up to `pool_size`)
-- Idle processes are reused automatically (no cold start penalty)
-- Processes auto-terminate after 5 minutes of inactivity (`idleTimeoutMs`)
-- Hung processes (busy > 15 minutes) are auto-killed (`hungTimeoutMs`)
-
-**Pool status per agent:**
-
-| State   | Description                         |
-| ------- | ----------------------------------- |
-| `total` | Total processes currently in pool   |
-| `busy`  | Processes handling active requests  |
-| `idle`  | Processes ready for immediate reuse |
-
-**Default:** `pool_size: 1` (sequential execution, safe default)
-
-**Recommendation:** Start with `pool_size: 3` for implementation agents (Developer) and keep `pool_size: 1` for advisory agents (Reviewer, Explorer).
-
-> **Note:** Each process spawns a separate backend CLI subprocess. Higher pool sizes increase memory and API usage proportionally.
-
 ### Delegation
 
 Tier 1 agents can delegate tasks to other agents:
@@ -505,7 +489,7 @@ When an agent's response appears incomplete, MAMA auto-retries:
 - **Max retries:** Configurable (default: 3)
 - Supports Korean and English patterns
 
-### UltraWork Mode
+### UltraWork Mode (Ralph Loop 3-Phase)
 
 Trigger autonomous multi-step sessions:
 
@@ -513,16 +497,50 @@ Trigger autonomous multi-step sessions:
 User: "Build the auth system ultrawork"
 ```
 
-**How it works:**
+**3-Phase Loop:**
+
+```text
+Phase 1: Planning
+  → Lead agent creates implementation plan
+  → Optional Council discussion for plan review
+  → Plan persisted to disk (plan.md)
+
+Phase 2: Building
+  → Executes plan via DELEGATE:: delegation
+  → Each step recorded to progress.json
+  → Council escalation on failures
+
+Phase 3: Retrospective
+  → Reviews completed work against plan
+  → Council discussion for quality check
+  → RETRO_COMPLETE → session ends
+  → RETRO_INCOMPLETE → re-enters Phase 2 (max 1 retry)
+```
+
+**State persistence** (`~/.mama/workspace/ultrawork/{session_id}/`):
 
-1. Lead agent (Tier 1) analyzes the task and creates a plan
-2. Delegates specialized subtasks to Tier 2/3 agents
-3. Collects results, continues until done or limits reached
-4. Safety: max steps (20) and max duration (30 min)
+| File               | Purpose                    |
+| ------------------ | -------------------------- |
+| `session.json`     | Session metadata and phase |
+| `plan.md`          | Phase 1 output             |
+| `progress.json`    | Completed step records     |
+| `retrospective.md` | Phase 3 output             |
+
+**Config:**
+
+```yaml
+multi_agent:
+  ultrawork:
+    enabled: true
+    phased_loop: true # false = legacy freeform loop
+    persist_state: true # file-based state persistence
+    max_steps: 20
+    max_duration: 1800000 # 30 min
+```
 
 **Trigger keywords:** `ultrawork`, `울트라워크`, `deep work`, `autonomous`, `자율 작업`
 
-Session progress is reported in Discord in real-time.
+Session progress is reported in Discord/Slack in real-time.
 
 ### Persona Files
 
@@ -876,4 +894,4 @@ The multi-agent swarm architecture was inspired by [oh-my-opencode](https://gith
 ---
 
 **Author:** SpineLift Team
-**Last Updated:** 2026-02-06
+**Last Updated:** 2026-02-20

package/dist/agent/agent-loop.d.ts

@@ -11,14 +11,24 @@
  */
 import type { OAuthManager } from '../auth/index.js';
 import type { ContentBlock, ToolDefinition, AgentLoopOptions, AgentLoopResult, ClaudeClientOptions, GatewayToolExecutorOptions, AgentContext } from './types.js';
+/**
+ * Load full skill content on-demand for per-message injection.
+ * @param skillId - Skill identifier like "mama/playground"
+ */
+export declare function loadSkillContent(skillId: string): string | null;
 /**
  * Load installed & enabled skills from ~/.mama/skills/
- * Returns skill content blocks for system prompt injection.
- * Reads all .md files recursively (commands/, skills/, etc.)
+ * Returns skill catalog lines for system prompt injection (on-demand mode).
+ * Full skill content is injected per-message via detectSkillMatch() in PromptEnhancer.
  */
-export declare function loadInstalledSkills(verbose?: boolean, options?: {
+export declare function loadInstalledSkills(verbose?: boolean, _options?: {
     onlyCommands?: boolean;
 }): string[];
+/**
+ * Load backend-specific AGENTS.md from ~/.mama/
+ * Maps backend to file: 'claude' → AGENTS.claude.md, 'codex-mcp' → AGENTS.codex.md
+ */
+export declare function loadBackendAgentsMd(backend?: string, verbose?: boolean): string;
 export declare function loadComposedSystemPrompt(verbose?: boolean, context?: AgentContext): string;
 /**
  * Load Gateway Tools prompt from MD file
@@ -41,11 +51,14 @@ export declare class AgentLoop {
     private readonly sessionPool;
     private readonly toolsConfig;
     private readonly isGatewayMode;
+    private readonly useCodeAct;
     private readonly backend;
     private readonly postToolHandler;
     private readonly stopContinuationHandler;
     private readonly preCompactHandler;
     private preCompactInjected;
+    private currentStreamCallbacks?;
+    private currentTier;
     constructor(_oauthManager: OAuthManager, options?: AgentLoopOptions, _clientOptions?: ClaudeClientOptions, executorOptions?: GatewayToolExecutorOptions);
     /**
      * Set session key for lane-based concurrency
@@ -116,7 +129,15 @@ export declare class AgentLoop {
      */
     private parseToolCallsFromText;
     /**
-     * Remove tool_call blocks from text (to avoid duplication in response)
+     * Parse ```js code blocks as code_act tool calls (Code-Act mode)
+     */
+    private parseCodeActBlocks;
+    /**
+     * Execute Code-Act JS code in a sandboxed QuickJS environment
+     */
+    private executeCodeAct;
+    /**
+     * Remove tool_call and code_act blocks from text (to avoid duplication in response)
      */
     private removeToolCallBlocks;
     private extractTextFromContent;

package/dist/agent/agent-loop.d.ts.map

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