@orxataguy/tyr 1.0.30 → 1.0.32

package/README.md

@@ -173,6 +173,35 @@ tyr doc
 # → Open http://localhost:3000
 ```
 
+### `tyr chat [directory] [--port <n>] [--split <0-1>]`
+
+Opens a local web app with a chat pane and a file browser for `directory` (defaults to the current directory). You can attach images to a message, drag the divider between the two panes to resize them, and click any file in the browser to preview it. Messages are answered by the configured AI vendor (see `AIVendorManager`, below) by default.
+
+```bash
+tyr chat ./my-project --split 0.35
+# → Chat ready at: http://localhost:4646
+```
+
+Under the hood this is powered by `ChatManager`, injected into every command as `chat`. Write your own command to customise it:
+
+```typescript
+export default ({ chat, aiVendor, logger }: TyrContext) => {
+    return async (args: string[]) => {
+        chat.onMessage(async ({ message, history, dir }) => {
+            // Decide how to answer — call AIVendorManager, a local model, a script, etc.
+            const result = await aiVendor.complete([{ role: 'user', content: message.text }]);
+            return result.content;
+        });
+
+        chat.on('message:send', ({ message }) => logger.info(`User: ${message.text}`));
+        chat.on('message:response', ({ message }) => logger.info(`Assistant: ${message.text}`));
+
+        const session = await chat.open(args[0] ?? process.cwd(), { splitRatio: 0.4 });
+        logger.success(`Chat ready at: ${session.url}`);
+    };
+};
+```
+
 ---
 
 ## Context API Reference
@@ -252,6 +281,8 @@ tyr deploy --debug
 │   │   ├── Kernel.ts          # Command router and execution engine
 │   │   ├── Container.ts       # Dependency injection container
 │   │   ├── TyrError.ts        # Structured error type
+│   │   ├── util
+│   │   │   └── getenv.ts      # Helper: get environment variables
 │   │   └── sys/
 │   │       ├── gen.ts         # Built-in: scaffold a command
 │   │       ├── rem.ts         # Built-in: remove a command
@@ -259,16 +290,24 @@ tyr deploy --debug
 │   ├── commands/
 │   │   └── *.tyr.ts           # Your custom commands go here
 │   └── lib/
-│       ├── ShellManager.ts
-│       ├── FileSystemManager.ts
-│       ├── PackageManager.ts
-│       ├── DockerManager.ts
-│       ├── GitManager.ts
-│       ├── SystemManager.ts
-│       ├── SQLManager.ts
-│       └── WebManager.ts
-├── config/
-│   └── map.yml                # Command registry
+│   │   ├── AIContextManager.ts
+│   │   ├── AIVendorManager.ts
+│   │   ├── ChatManager.ts
+│   │   ├── DockerManager.ts
+│   │   ├── FileSystemManager.ts
+│   │   ├── GitManager.ts
+│   │   ├── JiraManager.ts
+│   │   ├── MongoManager.ts
+│   │   ├── PackageManager.ts
+│   │   ├── PromptTemplateManager.ts
+│   │   ├── SetupManager.ts
+│   │   ├── ShellManager.ts
+│   │   ├── SQLManager.ts
+│   │   ├── SystemManager.ts
+│   │   ├── TokenManager.ts
+│   │   ├── WebManager.ts
+│   │   └── WorkspaceManager.ts
+|   └── index.ts               # Exports context
 └── tests/
     ├── setup.ts               # Mock context factory
     └── test-runner.ts         # Smoke test runner

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orxataguy/tyr",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "type": "module",
   "bin": {
     "tyr": "./bin/tyr.js"

package/src/core/Container.ts

@@ -14,6 +14,7 @@ import { AIVendorManager } from '../lib/AIVendorManager.js';
 import { AIContextManager } from '../lib/AIContextManager.js';
 import { PromptTemplateManager } from '../lib/PromptTemplateManager.js';
 import { TokenManager } from '../lib/TokenManager.js';
+import { ChatManager } from '../lib/ChatManager.js';
 import { Logger, createLogger } from './Logger.js';
 
 import path from 'path';
@@ -39,6 +40,7 @@ export interface ServiceContainer {
     aiContext: AIContextManager;
     prompts: PromptTemplateManager;
     tokens: TokenManager;
+    chat: ChatManager;
 }
 
 export class Container {
@@ -56,7 +58,7 @@ export class Container {
         const web = new WebManager(logger);
         const fs = new FileSystemManager(logger);
         const aiVendor = new AIVendorManager(logger);
-        const aiContext = new AIContextManager(fs, aiVendor, logger);
+        const aiContext = new AIContextManager(fs, shell, aiVendor, logger);
 
         this.services = {
             logger,
@@ -77,6 +79,7 @@ export class Container {
             aiContext,
             prompts: new PromptTemplateManager(aiContext, logger),
             tokens: new TokenManager(logger),
+            chat: new ChatManager(fs, logger),
         };
     }
 

package/src/core/Kernel.ts

@@ -9,6 +9,7 @@ import { Container } from './Container';
 import gen from './sys/gen';
 import rem from './sys/rem';
 import doc from './sys/doc';
+import chat from './sys/chat';
 import config from './sys/config';
 import help from './sys/help';
 
@@ -166,6 +167,7 @@ export class Kernel {
             gen,
             rem,
             doc,
+            chat,
         };
 
         if (systemCommands[commandName]) {

package/src/core/sys/chat.ts

@@ -0,0 +1,73 @@
+import path from 'path';
+import { readFile } from 'fs/promises';
+import { TyrContext } from '../Kernel';
+import type { AIContentBlock, AIMessage } from '../../lib/AIVendorManager';
+import type { ChatMessageContext } from '../../lib/ChatManager';
+
+function parseFlag(args: string[], name: string): string | undefined {
+    const index = args.indexOf(name);
+    return index !== -1 ? args[index + 1] : undefined;
+}
+
+export default function chat({ logger, chat: chatManager, aiVendor, fail }: TyrContext) {
+    return async (args: string[]) => {
+        const positional = args.filter((a) => !a.startsWith('--'));
+        const dir = path.resolve(positional[0] ?? process.cwd());
+
+        const portArg = parseFlag(args, '--port');
+        const splitArg = parseFlag(args, '--split');
+        const port = portArg ? parseInt(portArg, 10) : undefined;
+        const splitRatio = splitArg ? parseFloat(splitArg) : undefined;
+
+        // Default responder: forwards the conversation (plus any attached images) to the
+        // configured AI vendor. Replace with your own chatManager.onMessage(...) in a custom
+        // command if you want different behaviour.
+        chatManager.onMessage(async ({ message, history, dir: chatDir }: ChatMessageContext) => {
+            const priorTurns: AIMessage[] = history.slice(0, -1).map((m) => ({
+                role: m.role === 'user' ? 'user' : 'assistant',
+                content: m.text,
+            }));
+
+            const contentBlocks: AIContentBlock[] = [];
+            if (message.text) contentBlocks.push({ type: 'text', text: message.text });
+
+            for (const attachment of message.attachments) {
+                try {
+                    const fileBuffer = await readFile(attachment.path);
+                    contentBlocks.push({ type: 'image', mediaType: attachment.mimeType, data: fileBuffer.toString('base64') });
+                } catch (e) {
+                    logger.warn(`Could not read attachment '${attachment.filename}': ${(e as Error).message}`);
+                }
+            }
+
+            const messages: AIMessage[] = [
+                {
+                    role: 'system',
+                    content: `You are an assistant embedded in a chat UI browsing the directory: ${chatDir}. Answer helpfully and concisely, referencing its files when relevant.`,
+                },
+                ...priorTurns,
+                { role: 'user', content: contentBlocks.length > 0 ? contentBlocks : message.text },
+            ];
+
+            const result = await aiVendor.complete(messages);
+            return result.content;
+        });
+
+        // Example hooks — side effects around the conversation, independent from onMessage.
+        chatManager.on('message:send', ({ message }: { message: { text: string } }) => {
+            logger.info(`[chat] user: ${message.text}`);
+        });
+        chatManager.on('message:error', ({ error }: { error: Error }) => {
+            logger.warn(`[chat] handler failed: ${error.message}`);
+        });
+
+        try {
+            const session = await chatManager.open(dir, { port, splitRatio });
+            logger.success(`Chat ready at: ${session.url}`);
+            logger.info(`Browsing: ${session.dir}`);
+            logger.info('Press Ctrl+C to stop.');
+        } catch (e: any) {
+            fail(`Could not start chat: ${e.message}`, 'Check that the directory exists and the port is free.');
+        }
+    };
+}

package/src/core/sys/help.ts

@@ -76,6 +76,7 @@ export default function help({ userRoot }: TyrContext) {
             { name: '--upgrade', description: 'Upgrades the tyr npm package.',                usage: 'tyr --upgrade' },
             { name: 'gen',       description: 'Generates a new command from a description using AI.', usage: 'tyr gen <name> "<description>"' },
             { name: 'doc',       description: 'Opens the framework documentation in the browser.', usage: 'tyr doc' },
+            { name: 'chat',      description: 'Opens an AI chat + file browser for a directory.',  usage: 'tyr chat [directory] [--port <n>] [--split <0-1>]' },
         ];
 
         console.log(`  ${bold}${yellow}Framework${reset}`);

package/src/index.ts

@@ -3,3 +3,4 @@
 //   import type { TyrContext } from '@orxataguy/tyr';
 
 export type { TyrContext } from './core/Kernel.js';
+export type { TaskPriority } from './lib/AIVendorManager.js';