takt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masanobu Naruse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,307 @@
+# TAKT
+
+**T**ask **A**gent **K**oordination **T**ool - Multi-agent orchestration system for Claude Code (Codex support planned).
+
+> **Note**: This project is developed at my own pace. See [Disclaimer](#disclaimer) for details.
+
+## Requirements
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) must be installed and configured
+
+## Installation
+
+```bash
+npm install -g takt
+```
+
+## Quick Start
+
+```bash
+# Run a task (will prompt for workflow selection)
+takt "Add a login feature"
+
+# Switch workflow
+takt /switch
+
+# Run all pending tasks
+takt /run-tasks
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `takt "task"` | Execute task with workflow selection |
+| `takt -r "task"` | Execute task, resuming previous session |
+| `takt /run-tasks` | Run all pending tasks |
+| `takt /switch` | Switch workflow interactively |
+| `takt /clear` | Clear agent conversation sessions |
+| `takt /help` | Show help |
+
+## Workflows
+
+TAKT uses YAML-based workflow definitions. Place them in:
+- `~/.takt/workflows/*.yaml`
+
+### Example Workflow
+
+```yaml
+name: default
+max_iterations: 10
+
+steps:
+  - name: implement
+    agent: coder
+    instruction_template: |
+      {task}
+    transitions:
+      - condition: done
+        next_step: review
+      - condition: blocked
+        next_step: ABORT
+
+  - name: review
+    agent: architect
+    transitions:
+      - condition: approved
+        next_step: COMPLETE
+      - condition: rejected
+        next_step: implement
+```
+
+## Built-in Agents
+
+- **coder** - Implements features and fixes bugs
+- **architect** - Reviews code and provides feedback
+- **supervisor** - Final verification and approval
+
+## Custom Agents
+
+Define custom agents in `.takt/agents.yaml`:
+
+```yaml
+agents:
+  - name: my-reviewer
+    prompt_file: .takt/prompts/reviewer.md
+    allowed_tools: [Read, Glob, Grep]
+    status_patterns:
+      approved: "\\[APPROVE\\]"
+      rejected: "\\[REJECT\\]"
+```
+
+## Project Structure
+
+```
+~/.takt/
+├── config.yaml          # Global config
+├── workflows/           # Workflow definitions
+└── agents/              # Agent prompt files
+```
+
+## Practical Usage Guide
+
+### Resuming Sessions with `-r`
+
+When TAKT prompts for additional input during execution (e.g., "Please provide more details"), use the `-r` flag to continue the conversation:
+
+```bash
+# First run - agent might ask for clarification
+takt "Fix the login bug"
+
+# Resume the same session to provide the requested information
+takt -r "The bug occurs when the password contains special characters"
+```
+
+The `-r` flag preserves the agent's conversation history, allowing for natural back-and-forth interaction.
+
+### Playing with MAGI System
+
+MAGI is a deliberation system inspired by Evangelion. Three AI personas analyze your question from different perspectives and vote:
+
+```bash
+# Select 'magi' workflow when prompted
+takt "Should we migrate from REST to GraphQL?"
+```
+
+The three MAGI personas:
+- **MELCHIOR-1** (Scientist): Logical, data-driven analysis
+- **BALTHASAR-2** (Nurturer): Team and human-centered perspective
+- **CASPER-3** (Pragmatist): Practical, real-world considerations
+
+Each persona votes: APPROVE, REJECT, or CONDITIONAL. The final decision is made by majority vote.
+
+### Adding Custom Workflows
+
+Create your own workflow by adding YAML files to `~/.takt/workflows/`:
+
+```yaml
+# ~/.takt/workflows/my-workflow.yaml
+name: my-workflow
+description: My custom workflow
+
+max_iterations: 5
+
+steps:
+  - name: analyze
+    agent: ~/.takt/agents/my-agents/analyzer.md
+    instruction_template: |
+      Analyze this request: {task}
+    transitions:
+      - condition: done
+        next_step: implement
+
+  - name: implement
+    agent: ~/.takt/agents/default/coder.md
+    instruction_template: |
+      Implement based on the analysis: {previous_response}
+    pass_previous_response: true
+    transitions:
+      - condition: done
+        next_step: COMPLETE
+```
+
+### Specifying Agents by Path
+
+Agents are specified using file paths in workflow definitions:
+
+```yaml
+# Use built-in agents
+agent: ~/.takt/agents/default/coder.md
+agent: ~/.takt/agents/magi/melchior.md
+
+# Use project-local agents
+agent: ./.takt/agents/my-reviewer.md
+
+# Use absolute paths
+agent: /path/to/custom/agent.md
+```
+
+Create custom agent prompts as Markdown files:
+
+```markdown
+# ~/.takt/agents/my-agents/reviewer.md
+
+You are a code reviewer focused on security.
+
+## Your Role
+- Check for security vulnerabilities
+- Verify input validation
+- Review authentication logic
+
+## Output Format
+- [REVIEWER:APPROVE] if code is secure
+- [REVIEWER:REJECT] if issues found (list them)
+```
+
+### Using `/run-tasks` for Batch Processing
+
+The `/run-tasks` command executes all task files in `.takt/tasks/` directory:
+
+```bash
+# Create task files as you think of them
+echo "Add unit tests for the auth module" > .takt/tasks/001-add-tests.md
+echo "Refactor the database layer" > .takt/tasks/002-refactor-db.md
+echo "Update API documentation" > .takt/tasks/003-update-docs.md
+
+# Run all pending tasks
+takt /run-tasks
+```
+
+**How it works:**
+- Tasks are executed in alphabetical order (use prefixes like `001-`, `002-` for ordering)
+- Each task file should contain a description of what needs to be done
+- Completed tasks are moved to `.takt/completed/` with execution reports
+- New tasks added during execution will be picked up dynamically
+
+**Task file format:**
+
+```markdown
+# .takt/tasks/add-login-feature.md
+
+Add a login feature to the application.
+
+Requirements:
+- Username and password fields
+- Form validation
+- Error handling for failed attempts
+```
+
+This is perfect for:
+- Brainstorming sessions where you capture ideas as files
+- Breaking down large features into smaller tasks
+- Automated pipelines that generate task files
+
+### Workflow Variables
+
+Available variables in `instruction_template`:
+
+| Variable | Description |
+|----------|-------------|
+| `{task}` | Original user request |
+| `{iteration}` | Current iteration number |
+| `{max_iterations}` | Maximum iterations |
+| `{previous_response}` | Previous step's output (requires `pass_previous_response: true`) |
+| `{user_inputs}` | Additional user inputs during workflow |
+| `{git_diff}` | Current git diff (uncommitted changes) |
+
+## API Usage
+
+```typescript
+import { WorkflowEngine, loadWorkflow } from 'takt';  // npm install takt
+
+const config = loadWorkflow('default');
+if (!config) {
+  throw new Error('Workflow not found');
+}
+const engine = new WorkflowEngine(config, process.cwd(), 'My task');
+
+engine.on('step:complete', (step, response) => {
+  console.log(`${step.name}: ${response.status}`);
+});
+
+await engine.run();
+```
+
+## Disclaimer
+
+This project is a personal project developed at my own pace.
+
+- **Response times**: I may not be able to respond to issues immediately
+- **Development style**: This project is primarily developed using "vibe coding" (AI-assisted development) - **use at your own risk**
+- **Pull requests**:
+  - Small, focused PRs (bug fixes, typos, docs) are welcome
+  - Large PRs, especially AI-generated bulk changes, are difficult to review
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for more details.
+
+## Docker Support
+
+Docker environment is provided for testing in other environments:
+
+```bash
+# Build Docker images
+docker compose build
+
+# Run tests in container
+docker compose run --rm test
+
+# Run lint in container
+docker compose run --rm lint
+
+# Build only (skip tests)
+docker compose run --rm build
+```
+
+This ensures the project works correctly in a clean Node.js 20 environment.
+
+## Documentation
+
+- 🇯🇵 [日本語ドキュメント](./docs/README.ja.md) - Japanese documentation
+- [Workflow Guide](./docs/workflows.md) - Create and customize workflows
+- [Agent Guide](./docs/agents.md) - Configure custom agents
+- [Changelog](./CHANGELOG.md) - Version history
+- [Security Policy](./SECURITY.md) - Vulnerability reporting
+
+## License
+
+MIT - See [LICENSE](./LICENSE) for details.

package/bin/takt

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+/**
+ * TAKT CLI wrapper for npm global/local installation
+ *
+ * This wrapper script ensures takt can be run via:
+ * - npm install -g takt && takt
+ * - npx takt
+ * - npm exec takt
+ */
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Import the actual CLI from dist
+const cliPath = join(__dirname, '..', 'dist', 'cli.js');
+
+try {
+  await import(cliPath);
+} catch (err) {
+  console.error('Failed to load TAKT CLI. Have you run "npm run build"?');
+  console.error(err.message);
+  process.exit(1);
+}

package/dist/agents/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Agents module - exports agent execution utilities
+ */
+export * from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,5 @@
+/**
+ * Agents module - exports agent execution utilities
+ */
+export * from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/agents/runner.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Agent execution runners
+ */
+import { type StreamCallback, type PermissionHandler, type AskUserQuestionHandler } from '../claude/process.js';
+import type { AgentResponse, CustomAgentConfig } from '../models/types.js';
+export type { StreamCallback };
+/** Common options for running agents */
+export interface RunAgentOptions {
+    cwd: string;
+    sessionId?: string;
+    model?: string;
+    /** Resolved path to agent prompt file */
+    agentPath?: string;
+    onStream?: StreamCallback;
+    onPermissionRequest?: PermissionHandler;
+    onAskUserQuestion?: AskUserQuestionHandler;
+    /** Bypass all permission checks (sacrifice-my-pc mode) */
+    bypassPermissions?: boolean;
+}
+/** Get git diff for review context */
+export declare function getGitDiff(cwd: string): string;
+/** Run a custom agent */
+export declare function runCustomAgent(agentConfig: CustomAgentConfig, task: string, options: RunAgentOptions): Promise<AgentResponse>;
+/** Run an agent by name or path */
+export declare function runAgent(agentSpec: string, task: string, options: RunAgentOptions): Promise<AgentResponse>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/agents/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEhH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AASD,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoB9C;AAED,yBAAyB;AACzB,wBAAsB,cAAc,CAClC,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CA8CxB;AAqCD,mCAAmC;AACnC,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CAmCxB"}

package/dist/agents/runner.js

@@ -0,0 +1,144 @@
+/**
+ * Agent execution runners
+ */
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, dirname } from 'node:path';
+import { callClaude, callClaudeCustom, callClaudeAgent, callClaudeSkill, } from '../claude/client.js';
+import { loadCustomAgents, loadAgentPrompt } from '../config/loader.js';
+/** Default tools for each built-in agent type */
+const DEFAULT_AGENT_TOOLS = {
+    coder: ['Read', 'Glob', 'Grep', 'Edit', 'Write', 'Bash', 'WebSearch', 'WebFetch'],
+    architect: ['Read', 'Glob', 'Grep', 'WebSearch', 'WebFetch'],
+    supervisor: ['Read', 'Glob', 'Grep', 'Bash', 'WebSearch', 'WebFetch'],
+};
+/** Get git diff for review context */
+export function getGitDiff(cwd) {
+    try {
+        // First check if HEAD exists (new repos may not have any commits)
+        try {
+            execSync('git rev-parse HEAD', { cwd, encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch {
+            // No commits yet, return empty diff
+            return '';
+        }
+        const diff = execSync('git diff HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            maxBuffer: 1024 * 1024 * 10, // 10MB
+            stdio: 'pipe',
+        });
+        return diff.trim();
+    }
+    catch {
+        return '';
+    }
+}
+/** Run a custom agent */
+export async function runCustomAgent(agentConfig, task, options) {
+    // If agent references a Claude Code agent
+    if (agentConfig.claudeAgent) {
+        const callOptions = {
+            cwd: options.cwd,
+            sessionId: options.sessionId,
+            allowedTools: agentConfig.allowedTools,
+            model: options.model || agentConfig.model,
+            onStream: options.onStream,
+            onPermissionRequest: options.onPermissionRequest,
+            onAskUserQuestion: options.onAskUserQuestion,
+            bypassPermissions: options.bypassPermissions,
+        };
+        return callClaudeAgent(agentConfig.claudeAgent, task, callOptions);
+    }
+    // If agent references a Claude Code skill
+    if (agentConfig.claudeSkill) {
+        const callOptions = {
+            cwd: options.cwd,
+            sessionId: options.sessionId,
+            allowedTools: agentConfig.allowedTools,
+            model: options.model || agentConfig.model,
+            onStream: options.onStream,
+            onPermissionRequest: options.onPermissionRequest,
+            onAskUserQuestion: options.onAskUserQuestion,
+            bypassPermissions: options.bypassPermissions,
+        };
+        return callClaudeSkill(agentConfig.claudeSkill, task, callOptions);
+    }
+    // Custom agent with prompt
+    const systemPrompt = loadAgentPrompt(agentConfig);
+    const callOptions = {
+        cwd: options.cwd,
+        sessionId: options.sessionId,
+        allowedTools: agentConfig.allowedTools || ['Read', 'Glob', 'Grep', 'WebSearch', 'WebFetch'],
+        model: options.model || agentConfig.model,
+        statusPatterns: agentConfig.statusPatterns,
+        onStream: options.onStream,
+        onPermissionRequest: options.onPermissionRequest,
+        onAskUserQuestion: options.onAskUserQuestion,
+        bypassPermissions: options.bypassPermissions,
+    };
+    return callClaudeCustom(agentConfig.name, task, systemPrompt, callOptions);
+}
+/**
+ * Load agent prompt from file path.
+ */
+function loadAgentPromptFromPath(agentPath) {
+    if (!existsSync(agentPath)) {
+        throw new Error(`Agent file not found: ${agentPath}`);
+    }
+    return readFileSync(agentPath, 'utf-8');
+}
+/**
+ * Get agent name from path or spec.
+ * For agents in subdirectories, includes parent dir for pattern matching.
+ * - "~/.takt/agents/default/coder.md" -> "coder"
+ * - "~/.takt/agents/research/supervisor.md" -> "research/supervisor"
+ * - "./coder.md" -> "coder"
+ * - "coder" -> "coder"
+ */
+function extractAgentName(agentSpec) {
+    if (!agentSpec.endsWith('.md')) {
+        return agentSpec;
+    }
+    const name = basename(agentSpec, '.md');
+    const dir = basename(dirname(agentSpec));
+    // If in 'default' directory, just use the agent name
+    // Otherwise, include the directory for disambiguation (e.g., 'research/supervisor')
+    if (dir === 'default' || dir === 'agents' || dir === '.') {
+        return name;
+    }
+    return `${dir}/${name}`;
+}
+/** Run an agent by name or path */
+export async function runAgent(agentSpec, task, options) {
+    const agentName = extractAgentName(agentSpec);
+    // If agentPath is provided (from workflow), use it to load prompt
+    if (options.agentPath) {
+        if (!existsSync(options.agentPath)) {
+            throw new Error(`Agent file not found: ${options.agentPath}`);
+        }
+        const systemPrompt = loadAgentPromptFromPath(options.agentPath);
+        const tools = DEFAULT_AGENT_TOOLS[agentName] || ['Read', 'Glob', 'Grep', 'WebSearch', 'WebFetch'];
+        const callOptions = {
+            cwd: options.cwd,
+            sessionId: options.sessionId,
+            allowedTools: tools,
+            model: options.model,
+            systemPrompt,
+            onStream: options.onStream,
+            onPermissionRequest: options.onPermissionRequest,
+            onAskUserQuestion: options.onAskUserQuestion,
+            bypassPermissions: options.bypassPermissions,
+        };
+        return callClaude(agentName, task, callOptions);
+    }
+    // Fallback: Look for custom agent by name
+    const customAgents = loadCustomAgents();
+    const agentConfig = customAgents.get(agentName);
+    if (agentConfig) {
+        return runCustomAgent(agentConfig, task, options);
+    }
+    throw new Error(`Unknown agent: ${agentSpec}`);
+}
+//# sourceMappingURL=runner.js.map

package/dist/agents/runner.js.map

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

package/dist/claude/client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * High-level Claude client for agent interactions
+ *
+ * Uses the Claude Agent SDK for native TypeScript integration.
+ */
+import { type StreamCallback, type PermissionHandler, type AskUserQuestionHandler } from './process.js';
+import type { AgentDefinition } from '@anthropic-ai/claude-agent-sdk';
+import type { AgentResponse, Status } from '../models/types.js';
+/** Options for calling Claude */
+export interface ClaudeCallOptions {
+    cwd: string;
+    sessionId?: string;
+    allowedTools?: string[];
+    model?: string;
+    maxTurns?: number;
+    systemPrompt?: string;
+    statusPatterns?: Record<string, string>;
+    /** SDK agents to register for sub-agent execution */
+    agents?: Record<string, AgentDefinition>;
+    /** Enable streaming mode with callback for real-time output */
+    onStream?: StreamCallback;
+    /** Custom permission handler for interactive permission prompts */
+    onPermissionRequest?: PermissionHandler;
+    /** Custom handler for AskUserQuestion tool */
+    onAskUserQuestion?: AskUserQuestionHandler;
+    /** Bypass all permission checks (sacrifice-my-pc mode) */
+    bypassPermissions?: boolean;
+}
+/** Detect status from agent output content */
+export declare function detectStatus(content: string, patterns: Record<string, string>): Status;
+/** Validate regex pattern for ReDoS safety */
+export declare function isRegexSafe(pattern: string): boolean;
+/** Get status patterns for a built-in agent type */
+export declare function getBuiltinStatusPatterns(agentType: string): Record<string, string>;
+/** Call Claude with an agent prompt */
+export declare function callClaude(agentType: string, prompt: string, options: ClaudeCallOptions): Promise<AgentResponse>;
+/** Call Claude with a custom agent configuration */
+export declare function callClaudeCustom(agentName: string, prompt: string, systemPrompt: string, options: ClaudeCallOptions): Promise<AgentResponse>;
+/** Call a Claude Code built-in agent (using claude --agent flag if available) */
+export declare function callClaudeAgent(claudeAgentName: string, prompt: string, options: ClaudeCallOptions): Promise<AgentResponse>;
+/** Call a Claude Code skill (using /skill command) */
+export declare function callClaudeSkill(skillName: string, prompt: string, options: ClaudeCallOptions): Promise<AgentResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/claude/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/claude/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA6C,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACnJ,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGhE,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAYR;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBpD;AAED,oDAAoD;AACpD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAElF;AAiBD,uCAAuC;AACvC,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAED,oDAAoD;AACpD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAED,iFAAiF;AACjF,wBAAsB,eAAe,CACnC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAMxB;AAED,sDAAsD;AACtD,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAyBxB"}