cray-code 1.0.0

package/README.md

@@ -0,0 +1,316 @@
+# 🦀 Cray Code
+
+> **A powerful, extensible AI agent framework for the terminal** — MCP, Skills, Sub-agents, and multi-provider LLM support.
+
+Cray Code is an AI coding assistant framework inspired by [Claude Code](https://claude.ai/code)'s architecture. It provides a unified tool interface, full [Model Context Protocol (MCP)](https://modelcontextprotocol.io) integration, a flexible skills system, sub-agent orchestration, and plugin extensibility — all running in a beautiful React/Ink terminal UI.
+
+---
+
+## Features
+
+| Feature | Description |
+|---|---|
+| **🧠 Multi-Provider** | Anthropic, OpenAI, Ollama, OpenRouter, DeepSeek, or any OpenAI-compatible API |
+| **🔧 Unified Tool System** | All operations (file I/O, shell, MCP, agent, skill) share a single, uniform interface |
+| **🔌 MCP Integration** | Full [Model Context Protocol](https://modelcontextprotocol.io) support — stdio, SSE, WebSocket transports |
+| **📜 Skills System** | Bundled + disk-based skills with tool restrictions, model overrides, and `/skill` invocation |
+| **👾 Sub-Agent Support** | Spawn specialized child agents with constrained tool access, receive structured results |
+| **🧩 Plugin Architecture** | Extensible plugin system for commands, skills, MCP servers, and lifecycle hooks |
+| **💻 Rich Terminal UI** | Real-time thinking display, tool call visualization, React/Ink-based REPL |
+| **💾 Session Management** | Session persistence, resumption, and automatic context compaction |
+| **🔐 Permission System** | Four modes: `default`, `acceptEdits`, `bypass`, `plan` — fine-grained tool-level control |
+| **⚡ Stream & Async** | Async generator event loop, streaming LLM responses, concurrent background agents |
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- **Node.js** >= 18.0.0
+- **npm** (comes with Node.js)
+
+### Install
+
+```bash
+# Install globally via npm
+npm install -g cray-code
+
+# Or install from the repo
+git clone https://github.com/WYH/cray-code.git
+cd cray-code
+npm install
+npm run build
+```
+
+### First Run
+
+```bash
+# Run the setup wizard (required first time)
+cray --setup
+
+# Start interactive session
+cray
+
+# Start with an initial prompt
+cray "Review the current codebase"
+
+# Run in a specific directory
+cray --dir /path/to/project
+```
+
+---
+
+## Usage
+
+### CLI Options
+
+| Option | Description |
+|---|---|
+| `[prompt]` | First message to send, then stay interactive |
+| `-m, --model <model>` | Override the configured model |
+| `-d, --dir <directory>` | Working directory |
+| `-p, --permission <mode>` | Permission mode: `default`, `acceptEdits`, `bypass`, `plan` |
+| `-v, --verbose` | Enable verbose logging |
+| `--max-turns <number>` | Max agent loop turns (default: 25) |
+| `--resume <sessionId>` | Resume a previous conversation |
+| `--setup` | Re-run the setup wizard |
+| `--show-welcome` | Display the welcome banner and exit |
+| `--list-sessions` | List saved sessions and exit |
+
+### Commands (Slash Commands)
+
+Inside the interactive REPL, use `/` commands:
+
+```
+/help          Show available commands
+/model         Change the active model
+/config        View or change configuration
+/setup         Re-run the setup wizard
+/sessions      List and manage sessions
+/clear         Clear the conversation
+/exit          Exit Cray Code
+```
+
+### Programmatic API
+
+Use Cray Code as a library in your own projects:
+
+```typescript
+import CrayCode from 'cray-code';
+
+const cray = new CrayCode({
+  cwd: process.cwd(),
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-6',
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  permissionMode: 'default',
+});
+
+await cray.initialize();
+
+const result = await cray.processMessage('Review this code');
+console.log(result.finalResponse);
+
+await cray.shutdown();
+```
+
+---
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────┐
+│                    CrayCode Class                      │
+│  (Orchestrator — EventEmitter-based)                   │
+├──────────────────────────────────────────────────────┤
+│                        │                               │
+│     ┌──────────────────┼──────────────────┐            │
+│     ▼                  ▼                  ▼            │
+│  ┌──────┐     ┌──────────────┐    ┌──────────┐        │
+│  │ Tool │     │  Query Loop  │    │  Skills  │        │
+│  │ Pool │     │  (agent      │    │  System  │        │
+│  │      │     │   loop)      │    │          │        │
+│  └──┬───┘     └──────┬───────┘    └────┬─────┘        │
+│     │                │                 │              │
+│     ▼                ▼                 ▼              │
+│  ┌──────────────────────────────────────────┐         │
+│  │              Provider Layer               │         │
+│  │  Anthropic │ OpenAI │ Ollama │ OpenRouter │         │
+│  │                  DeepSeek │ Custom        │         │
+│  └──────────────────────────────────────────┘         │
+│                        │                               │
+│     ┌──────────────────┼──────────────────┐            │
+│     ▼                  ▼                  ▼            │
+│  ┌────────┐    ┌──────────────┐    ┌────────────┐     │
+│  │  MCP   │    │   Plugins   │    │  React/Ink │     │
+│  │Servers │    │             │    │  Terminal  │     │
+│  └────────┘    └──────────────┘    │    UI      │     │
+│                                    └────────────┘     │
+└──────────────────────────────────────────────────────┘
+```
+
+### Core Components
+
+#### Tool System (`Tool.ts`)
+Every tool follows the same interface — file operations, shell commands, MCP calls, skills, and sub-agents all conform to `ToolDef<Input, Output>`. This uniform design means the LLM interacts with all capabilities through a single, predictable pattern.
+
+#### Query Loop (`query.ts`)
+The core agent loop uses an async generator pattern that yields typed `QueryEvent`s. The React/Ink UI consumes these events via `for-await` and renders real-time updates — thinking, tool calls, results, and errors.
+
+#### MCP Integration
+Full [Model Context Protocol](https://modelcontextprotocol.io) support via `@modelcontextprotocol/sdk`. Connect external tools dynamically — databases, APIs, file systems, and more — through stdio, SSE, or WebSocket transports.
+
+#### Skills System
+Skills are markdown files with frontmatter that define how the model should behave. They can restrict tools, override models, inject context, or spawn sub-agents. Skills are loaded from:
+- **Bundled** — built-in skills shipped with Cray Code
+- **Disk** — user-created skills in the project directory
+- **Plugin** — skills contributed by plugins
+
+#### Sub-Agent Support
+The `AgentTool` spawns child agents with constrained tool access, preventing infinite recursion while enabling complex parallel workflows. Sub-agents run in isolation with their own context and return structured results.
+
+#### Plugin Architecture
+Plugins extend Cray Code with custom commands, skills, MCP servers, and lifecycle hooks (`sessionStart`, `sessionEnd`). The plugin registry discovers and loads plugins at startup.
+
+---
+
+## Configuration
+
+Configuration is stored in `~/.cray/settings.json`:
+
+```json
+{
+  "provider": "anthropic",
+  "model": "claude-sonnet-4-6",
+  "apiKey": "sk-...",
+  "baseUrl": "",
+  "setupComplete": true,
+  "permissionMode": "default",
+  "maxTurns": 25,
+  "verbose": false
+}
+```
+
+Environment variables:
+- `CRAY_API_KEY` — API key (overrides config)
+- `CRAY_MODEL` — Default model (overrides config)
+
+---
+
+## Provider Support
+
+| Provider | Type | API Key Required |
+|---|---|---|
+| [Anthropic](https://anthropic.com) | Native | Yes |
+| [OpenAI](https://openai.com) | OpenAI-compatible | Yes |
+| [Ollama](https://ollama.ai) | OpenAI-compatible | No |
+| [OpenRouter](https://openrouter.ai) | OpenAI-compatible | Yes |
+| [DeepSeek](https://deepseek.com) | OpenAI-compatible | Yes |
+| Custom | OpenAI-compatible | Configurable |
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Development mode (with hot-reload via tsx)
+npm run dev
+
+# Run tests
+node run_test.mjs
+```
+
+### Project Structure
+
+```
+cray-code/
+├── src/
+│   ├── index.ts          # CLI entry point & REPL
+│   ├── cray.ts           # Main orchestrator class
+│   ├── Tool.ts           # Core tool abstraction
+│   ├── tools.ts          # Tool registry & assembly
+│   ├── query.ts          # Agent loop (LLM calls + tool execution)
+│   ├── queryStream.ts    # Streaming variant
+│   ├── context.ts        # Tool context builder
+│   ├── setup.ts          # First-run setup wizard
+│   ├── tools/            # Built-in tool implementations
+│   ├── services/         # MCP, session, config, compaction services
+│   ├── commands/         # Slash command system
+│   ├── skills/           # Skills system (bundled + disk)
+│   ├── plugins/          # Plugin discovery & registry
+│   ├── screens/          # React/Ink terminal screens
+│   ├── types/            # TypeScript type definitions
+│   └── branding/         # Logo & theme
+├── dist/                 # Compiled output
+├── install.sh            # Unix installer
+├── install.ps1           # Windows installer
+├── package.json
+└── tsconfig.json
+```
+
+### Building & Publishing
+
+```bash
+# Build for production
+npm run build
+
+# Create npm tarball
+npm run pack:tarball
+
+# Create tarball and install locally
+npm run pack:install-local
+
+# Publish to npm
+npm publish
+```
+
+---
+
+## Skills
+
+Skills are markdown-based instructions that guide the AI's behavior. They support:
+
+- **Tool restrictions** — limit the AI to specific tools
+- **Model overrides** — use a different model for specific tasks
+- **Context injection** — inject content inline or fork a sub-agent
+- **User invocation** — invoke via `/skill-name` in the REPL
+- **Argument substitution** — `{{arg}}` templates in skill content
+
+### Creating a Skill
+
+Create a `SKILL.md` file with frontmatter:
+
+```markdown
+---
+name: my-skill
+description: Does something useful
+allowedTools: [read, write, bash]
+model: claude-sonnet-4-6
+---
+
+Follow these instructions when this skill is active:
+1. Read the relevant files
+2. Analyze the problem
+3. Apply the fix
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+---
+
+## Acknowledgements
+
+- Inspired by [Claude Code](https://claude.ai/code) by Anthropic
+- Built on [Model Context Protocol](https://modelcontextprotocol.io)
+- Terminal UI powered by [React](https://react.dev) & [Ink](https://github.com/vadimdemedes/ink)

package/dist/Tool.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Tool.ts — Core Tool Abstraction for Cray Code
+ *
+ * Every tool in Cray Code follows the same interface, making them uniformly
+ * usable by LLMs. This is the central design pattern inherited from Claude Code.
+ *
+ * Key design principles:
+ * 1. Unified interface — all tools (files, shell, MCP, agent, skill) conform
+ * 2. Schema-driven — Zod schemas for input validation + JSON Schema for LLM
+ * 3. Permission-aware — every tool declares its permission requirements
+ * 4. Progress-reporting — long-running tools can stream progress
+ * 5. Composable — tools can be wrapped (MCPTool wraps external tools)
+ */
+import type { z } from 'zod';
+import type { Message, ToolResultContent } from './types/message.js';
+import type { PermissionResult, ToolPermissionContext } from './types/permission.js';
+import type { ToolProgressData } from './types/tool.js';
+/**
+ * Context provided to every tool invocation.
+ * Contains everything a tool needs to execute: state, permissions, I/O.
+ */
+export interface ToolUseContext {
+    /** Working directory for filesystem operations */
+    cwd: string;
+    /** Current permission mode and rules */
+    permissionContext: ToolPermissionContext;
+    /** Abort signal for cancellation */
+    abortSignal: AbortSignal;
+    /** Available MCP server connections */
+    mcpClients: Map<string, MCPClientInfo>;
+    /** Available skills */
+    availableSkills: SkillInfo[];
+    /** Available agent definitions */
+    agentDefinitions: AgentDefinitionInfo[];
+    /** System prompt for context awareness */
+    systemPromptParts: string[];
+    /** Current message history */
+    messages: Message[];
+    /** Current model configuration */
+    modelConfig: ModelConfig;
+    /** Write a progress message to the output */
+    writeProgress(data: ToolProgressData): void;
+    /** Log a message for debugging */
+    logDebug(message: string): void;
+}
+export interface MCPClientInfo {
+    serverName: string;
+    tools: MCPToolInfo[];
+    resources: MCPResourceInfo[];
+    connected: boolean;
+}
+export interface MCPToolInfo {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface MCPResourceInfo {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface SkillInfo {
+    /** Skill name (e.g., 'code-review', 'brainstorming') */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** When the model should consider using this skill (injected into system prompt) */
+    whenToUse?: string;
+    /** The full SKILL.md body content (after frontmatter parsing) */
+    content?: string;
+    /** Optional base directory for skill reference files */
+    baseDir?: string;
+    /** Tools this skill is restricted to (empty = all tools) */
+    allowedTools?: string[];
+    /** Model override for this skill */
+    model?: string;
+    /** Execution context: 'inline' injects content into conversation, 'fork' spawns a sub-agent */
+    context?: 'inline' | 'fork';
+    /** Whether the user can invoke this skill via /name */
+    userInvocable?: boolean;
+    /** Whether the model is blocked from invoking this skill */
+    disableModelInvocation?: boolean;
+    /** Hint shown next to the command in help listings */
+    argumentHint?: string;
+    /** Argument names for ${arg} substitution in skill content */
+    argNames?: string[];
+    /** Source of the skill (bundled, disk, plugin) */
+    source?: 'bundled' | 'disk' | 'plugin';
+}
+export interface AgentDefinitionInfo {
+    name: string;
+    description: string;
+    allowedTools: string[];
+    model?: string;
+}
+export interface ModelConfig {
+    provider: string;
+    model: string;
+    maxTokens: number;
+    thinkingEnabled: boolean;
+    apiKey: string;
+    baseUrl: string;
+}
+export interface ToolResult<T = unknown> {
+    /** Core result data */
+    data: T;
+    /** Optional string representation for the LLM */
+    content?: string;
+    /** Whether an error occurred */
+    isError?: boolean;
+    /** If the result was truncated */
+    truncated?: boolean;
+    /** Title for display */
+    title?: string;
+    /** Rendered UI content */
+    render?: ToolResultRender;
+    /**
+     * New messages to inject into the conversation.
+     * SkillTool uses this to inject skill content; AgentTool uses this for
+     * sub-agent results that should persist in the conversation.
+     */
+    newMessages?: Message[];
+    /**
+     * Modify the tool-use context for subsequent turns.
+     * SkillTool uses this to restrict allowed tools and apply model overrides.
+     */
+    contextModifier?(ctx: ToolUseContext): ToolUseContext;
+}
+export interface ToolResultRender {
+    type: 'text' | 'diff' | 'list' | 'card' | 'custom';
+    content: string;
+    language?: string;
+}
+/**
+ * Abstract tool definition. Concrete tools extend this.
+ *
+ * Type parameters:
+ * - Input: Zod schema type for the tool's input
+ * - Output: The type of data the tool returns
+ */
+export interface ToolDef<Input extends z.ZodTypeAny, Output = unknown> {
+    /** Unique tool name (e.g., 'read', 'bash', 'agent') */
+    name: string;
+    /** Alternative names */
+    aliases?: string[];
+    /** Search hint for tool search */
+    searchHint?: string;
+    /** Zod schema for input validation */
+    inputSchema: Input;
+    /** JSON Schema version for LLM consumption */
+    inputJSONSchema?: Record<string, unknown>;
+    /** Zod schema for output validation */
+    outputSchema?: z.ZodTypeAny;
+    /** Human-readable description */
+    description(input: z.infer<Input>): string | Promise<string>;
+    /** System prompt addition describing this tool */
+    prompt?(): string | Promise<string>;
+    /** User-facing name for display */
+    userFacingName(input: z.infer<Input>): string;
+    /** Is this tool currently enabled? */
+    isEnabled?(): boolean;
+    /** Is this tool read-only? (no side effects) */
+    isReadOnly?(input: z.infer<Input>): boolean;
+    /** Is this tool safe for concurrent use? */
+    isConcurrencySafe?(): boolean;
+    /** Is this tool destructive? (triggers extra warning) */
+    isDestructive?(input: z.infer<Input>): boolean;
+    /** Maximum result size in characters before truncation */
+    maxResultSizeChars?: number;
+    /** Core execution function */
+    call(input: z.infer<Input>, context: ToolUseContext): Promise<ToolResult<Output>>;
+    /** Permission check - called before execution */
+    checkPermissions?(input: z.infer<Input>, context: ToolUseContext): Promise<PermissionResult>;
+    /** Validate input before execution (return true or error message) */
+    validateInput?(input: z.infer<Input>, context: ToolUseContext): Promise<{
+        result: true;
+    } | {
+        result: false;
+        message: string;
+    }>;
+    /** Render tool use message in UI */
+    renderToolUseMessage?(input: z.infer<Input>, context: ToolUseContext): string;
+    /** Render tool result in UI */
+    renderToolResultMessage?(input: z.infer<Input>, result: ToolResult<Output>, context: ToolUseContext): string;
+    /** Format result for the LLM as content blocks */
+    mapToolResultToContentBlocks?(result: ToolResult<Output>, toolUseId: string): ToolResultContent[];
+    /** MCP info for tools proxied through MCP */
+    mcpInfo?: {
+        serverName: string;
+        toolName: string;
+    };
+}
+/**
+ * Build a tool from a definition. This is the standard factory function.
+ * Wraps common logic: permission checks, input validation, result formatting.
+ */
+export declare function buildTool<Input extends z.ZodTypeAny, Output = unknown>(overrides: Partial<ToolDef<Input, Output>> & {
+    name: string;
+    inputSchema: Input;
+}): ToolDef<Input, Output>;
+/** Check if a tool name matches the given name or aliases */
+export declare function toolMatchesName(tool: ToolDef<any, any>, name: string): boolean;
+/** Find a tool by name in a tool collection */
+export declare function findTool(tools: ToolDef<any, any>[], name: string): ToolDef<any, any> | undefined;
+export interface AssembleToolPoolInput {
+    builtinTools: ToolDef<any, any>[];
+    mcpTools: ToolDef<any, any>[];
+    permissionContext: ToolPermissionContext;
+}
+/**
+ * Assemble the final tool pool from built-in tools + MCP tools.
+ * Built-in tools take precedence; MCP tools fill gaps.
+ * Permission rules filter the final result.
+ */
+export declare function assembleToolPool(input: AssembleToolPoolInput): ToolDef<any, any>[];
+//# sourceMappingURL=Tool.d.ts.map

package/dist/Tool.d.ts.map

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

package/dist/Tool.js

@@ -0,0 +1,89 @@
+/**
+ * Tool.ts — Core Tool Abstraction for Cray Code
+ *
+ * Every tool in Cray Code follows the same interface, making them uniformly
+ * usable by LLMs. This is the central design pattern inherited from Claude Code.
+ *
+ * Key design principles:
+ * 1. Unified interface — all tools (files, shell, MCP, agent, skill) conform
+ * 2. Schema-driven — Zod schemas for input validation + JSON Schema for LLM
+ * 3. Permission-aware — every tool declares its permission requirements
+ * 4. Progress-reporting — long-running tools can stream progress
+ * 5. Composable — tools can be wrapped (MCPTool wraps external tools)
+ */
+// ─── Tool Builder ────────────────────────────────────────────────────────
+/**
+ * Build a tool from a definition. This is the standard factory function.
+ * Wraps common logic: permission checks, input validation, result formatting.
+ */
+export function buildTool(overrides) {
+    const defaults = {
+        maxResultSizeChars: 100_000,
+        isEnabled: () => true,
+        isConcurrencySafe: () => true,
+        isReadOnly: () => false,
+        isDestructive: () => false,
+        aliases: [],
+        async description(_input) {
+            return overrides.name;
+        },
+        userFacingName(_input) {
+            return overrides.name;
+        },
+        async checkPermissions() {
+            return { behavior: 'allow' };
+        },
+        mapToolResultToContentBlocks(result, toolUseId) {
+            const content = result.content ?? JSON.stringify(result.data, null, 2);
+            return [
+                {
+                    type: 'tool_result',
+                    tool_use_id: toolUseId,
+                    content,
+                    is_error: result.isError,
+                },
+            ];
+        },
+        renderToolUseMessage(input) {
+            return `${overrides.name}(${JSON.stringify(input)})`;
+        },
+        renderToolResultMessage(_input, result) {
+            if (result.isError)
+                return `Error: ${result.content}`;
+            if (result.truncated)
+                return `${result.content}\n... [truncated]`;
+            return result.content ?? 'Done.';
+        },
+    };
+    return { ...defaults, ...overrides };
+}
+// ─── Tool Matching ───────────────────────────────────────────────────────
+/** Check if a tool name matches the given name or aliases */
+export function toolMatchesName(tool, name) {
+    if (tool.name === name)
+        return true;
+    return tool.aliases?.includes(name) ?? false;
+}
+/** Find a tool by name in a tool collection */
+export function findTool(tools, name) {
+    return tools.find((t) => toolMatchesName(t, name));
+}
+/**
+ * Assemble the final tool pool from built-in tools + MCP tools.
+ * Built-in tools take precedence; MCP tools fill gaps.
+ * Permission rules filter the final result.
+ */
+export function assembleToolPool(input) {
+    const { builtinTools, mcpTools, permissionContext } = input;
+    const builtinNames = new Set(builtinTools.map((t) => t.name));
+    const filteredMCP = mcpTools.filter((t) => !builtinNames.has(t.name));
+    let pool = [...builtinTools, ...filteredMCP];
+    // Apply deny rules
+    const denyNames = new Set(permissionContext.alwaysDenyRules
+        .filter((r) => r.behavior === 'deny')
+        .map((r) => r.toolName));
+    pool = pool.filter((t) => !denyNames.has(t.name));
+    pool = pool.filter((t) => t.isEnabled?.() ?? true);
+    return pool;
+}
+//# sourceMappingURL=Tool.js.map

package/dist/Tool.js.map

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

package/dist/branding/logo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cray Code ASCII logo for terminal display.
+ */
+export declare const CRAY_LOGO = "\n  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\n \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\n \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u255A\u2588\u2588\u2588\u2588\u2554\u255D\n \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557  \u255A\u2588\u2588\u2554\u255D\n \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551\n  \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D\n";
+export declare const CRAY_LOGO_SMALL = "\n  \u2597\u2584\u2584\u2596\u2597\u2584\u2584\u2584\u2596\u2597\u2596  \u2597\u2596\n \u2597\u2596   \u2597\u2584\u2584\u2584\u2596 \u259D\u259A\u259E\u2598\n \u2597\u2596        \u2597\u2596\u2597\u2596\n \u259D\u259A\u2584\u2584\u2596   \u2597\u2596\u2597\u2596\u2597\u2596\n";
+export declare const CRAY_TAGLINE = "Cray Code - Your AI Agent Framework";
+export declare const WELCOME_MESSAGE = "\n\n  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\n \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\n \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u255A\u2588\u2588\u2588\u2588\u2554\u255D\n \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557  \u255A\u2588\u2588\u2554\u255D\n \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551\n  \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D\n\n  Cray Code - Your AI Agent Framework\n\n  Powerful AI agent with MCP, Skills, and Sub-agent support.\n  Type /help to see available commands.\n";
+//# sourceMappingURL=logo.d.ts.map

package/dist/branding/logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/branding/logo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,SAAS,m9BAOrB,CAAC;AAEF,eAAO,MAAM,eAAe,2RAK3B,CAAC;AAEF,eAAO,MAAM,YAAY,wCAAwC,CAAC;AAElE,eAAO,MAAM,eAAe,umCAM3B,CAAC"}