cast-code 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Castanheira Costa
+
+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,217 @@
+# Cast Code
+
+Cast Code is a multi-agent coding CLI for day-to-day engineering work.
+It is designed to feel like an in-terminal AI teammate that can read your codebase, plan work, use tools, and delegate to specialist sub-agents.
+
+## Why this project
+
+Main goal: accelerate product delivery, especially frontend bootstrap work from design prototypes.
+
+Typical target workflow:
+- connect Figma MCP,
+- map project context,
+- ask Cast to scaffold screens/components/styles,
+- let frontend engineers focus on integration and complex business flows.
+
+## Requirements
+
+- Node.js `>= 20`
+- npm
+- At least one LLM provider configured (`/config init`)
+
+## Install (global, from npm)
+
+```bash
+npm install -g cast-code
+cast
+```
+
+> Requires Node.js >= 20. Works on any Linux/macOS terminal: bash, zsh, fish, dash, ksh, and others.
+
+### If `cast` is not found after install
+
+The npm global bin directory may not be in your PATH. Run `npm prefix -g` to find it, then add `<prefix>/bin` to your shell:
+
+**bash** (`~/.bashrc` or `~/.bash_profile`):
+```bash
+export PATH="$(npm prefix -g)/bin:$PATH"
+```
+
+**zsh** (`~/.zshrc`):
+```zsh
+export PATH="$(npm prefix -g)/bin:$PATH"
+```
+
+**fish** (`~/.config/fish/config.fish`):
+```fish
+fish_add_path (npm prefix -g)/bin
+```
+
+**dash / ksh / others** (`~/.profile`):
+```sh
+export PATH="$(npm prefix -g)/bin:$PATH"
+```
+
+After editing, reload your shell (`source ~/.zshrc`, `source ~/.bashrc`, or open a new terminal), then run `cast`.
+
+## Install (local development)
+
+```bash
+npm install
+npm run build
+npm run start
+```
+
+For development mode:
+
+```bash
+npm run start:dev
+```
+
+## First Run
+
+On first run, configure providers/models:
+
+```bash
+/config init
+```
+
+Configuration file:
+- `~/.cast/config.yaml`
+
+## Frontend Daily Flow (Recommended)
+
+1. Connect Figma MCP
+
+```bash
+/mcp add
+```
+
+2. Map project context
+
+```bash
+/init
+```
+
+`/init` is the project bootstrap command. It analyzes the repo and refreshes `.cast/context.md`.
+
+3. Validate specialists
+
+```bash
+/agents
+/skills
+/context
+```
+
+4. Prompt for scaffold generation
+
+Example prompt:
+
+```text
+Use Figma to extract main screens and create a full frontend scaffold:
+- routes
+- page skeletons
+- reusable UI components (button, table, modal, form)
+- design tokens and global styling
+- responsive behavior
+```
+
+## Useful Commands
+
+### Core
+- `/help` show command guide
+- `/init` analyze project and generate context
+- `/project-deep` generate deep context + specialist brief
+- `/context` show session, tools, agents, skills, MCP status
+- `/clear` clear conversation history
+- `/compact` compact context window
+- `/exit` exit CLI
+
+### Config
+- `/config` config menu
+- `/config show` show current config
+- `/config path` print config path
+- `/config add-provider` add provider
+- `/config set-model` set model by purpose
+
+### MCP
+- `/mcp` MCP hub menu
+- `/mcp list` list servers
+- `/mcp tools` list tools
+- `/mcp add` add server from templates or custom
+- `/mcp remove` remove server
+- `/mcp what` explain MCP
+
+### Git
+- `/status`, `/diff`, `/log`
+- `/commit`, `/up`, `/split-up`, `/pr`
+- `/review`, `/fix`, `/ident`, `/release`
+
+### Agents & Skills
+- `/agents`, `/agents create`
+- `/skills`, `/skills create`
+
+## Mentions
+
+Use mentions to inject context directly:
+
+- `@src/file.ts`
+- `@path/to/dir/`
+- `@git:status`
+- `@git:diff`
+
+## Plan Mode
+
+For complex requests, Cast can enter plan mode:
+- asks clarifying questions,
+- generates a structured plan,
+- allows refine/approve/cancel,
+- executes with the approved plan as context.
+
+## Providers and Model Purposes
+
+Cast supports multiple providers and model purposes:
+- `default`
+- `subAgent`
+- `coder`
+- `architect`
+- `reviewer`
+- `planner`
+- `cheap`
+
+This enables cost/performance tuning by task type.
+
+## Project Structure (high level)
+
+- `src/modules/repl` interactive CLI and commands
+- `src/modules/core` deep agent orchestration and system prompt
+- `src/modules/agents` specialist sub-agents
+- `src/modules/skills` skill definitions and knowledge
+- `src/modules/mcp` MCP integration
+- `src/modules/project` project analysis/context generation
+- `src/modules/tasks` task and plan tools
+
+## Notes
+
+- Keep `.cast/context.md` updated for better answers.
+- For MCP servers requiring OAuth (like Figma), authenticate after adding and restarting Cast.
+- If no agents/skills appear, run `/context` and verify project-level `.cast/agents` and `.cast/skills`.
+
+## Environment Variables
+
+Before running, configure at least one LLM provider via `/config init` or set the relevant environment variables:
+
+| Variable | Provider |
+|---|---|
+| `ANTHROPIC_API_KEY` | Anthropic / Claude |
+| `OPENAI_API_KEY` | OpenAI |
+| `GOOGLE_API_KEY` | Google Gemini |
+
+Example:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+cast
+```
+
+Or create a `.env` file in your working directory with the keys above.

package/dist/app.module.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "AppModule", {
+    enumerable: true,
+    get: function() {
+        return AppModule;
+    }
+});
+const _common = require("@nestjs/common");
+const _commonmodule = require("./common/common.module");
+const _coremodule = require("./modules/core/core.module");
+const _replmodule = require("./modules/repl/repl.module");
+const _permissionsmodule = require("./modules/permissions/permissions.module");
+const _tasksmodule = require("./modules/tasks/tasks.module");
+const _memorymodule = require("./modules/memory/memory.module");
+const _mentionsmodule = require("./modules/mentions/mentions.module");
+const _gitmodule = require("./modules/git/git.module");
+const _config = require("./modules/config");
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+let AppModule = class AppModule {
+};
+AppModule = _ts_decorate([
+    (0, _common.Module)({
+        imports: [
+            _config.ConfigModule,
+            _commonmodule.CommonModule,
+            _coremodule.CoreModule,
+            _replmodule.ReplModule,
+            _permissionsmodule.PermissionsModule,
+            _tasksmodule.TasksModule,
+            _memorymodule.MemoryModule,
+            _mentionsmodule.MentionsModule,
+            _gitmodule.GitModule
+        ]
+    })
+], AppModule);
+
+//# sourceMappingURL=app.module.js.map

package/dist/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/app.module.ts"],"sourcesContent":["import { Module } from '@nestjs/common';\nimport { CommonModule } from './common/common.module';\nimport { CoreModule } from './modules/core/core.module';\nimport { ReplModule } from './modules/repl/repl.module';\nimport { PermissionsModule } from './modules/permissions/permissions.module';\nimport { TasksModule } from './modules/tasks/tasks.module';\nimport { MemoryModule } from './modules/memory/memory.module';\nimport { MentionsModule } from './modules/mentions/mentions.module';\nimport { GitModule } from './modules/git/git.module';\nimport { ConfigModule } from './modules/config';\n\n@Module({\n  imports: [ConfigModule, CommonModule, CoreModule, ReplModule, PermissionsModule, TasksModule, MemoryModule, MentionsModule, GitModule],\n})\nexport class AppModule {}\n"],"names":["AppModule","imports","ConfigModule","CommonModule","CoreModule","ReplModule","PermissionsModule","TasksModule","MemoryModule","MentionsModule","GitModule"],"mappings":";;;;+BAcaA;;;eAAAA;;;wBAdU;8BACM;4BACF;4BACA;mCACO;6BACN;8BACC;gCACE;2BACL;wBACG;;;;;;;AAKtB,IAAA,AAAMA,YAAN,MAAMA;AAAW;;;QAFtBC,SAAS;YAACC,oBAAY;YAAEC,0BAAY;YAAEC,sBAAU;YAAEC,sBAAU;YAAEC,oCAAiB;YAAEC,wBAAW;YAAEC,0BAAY;YAAEC,8BAAc;YAAEC,oBAAS;SAAC"}

package/dist/common/common.module.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "CommonModule", {
+    enumerable: true,
+    get: function() {
+        return CommonModule;
+    }
+});
+const _common = require("@nestjs/common");
+const _markdownparserservice = require("./services/markdown-parser.service");
+const _llmservice = require("./services/llm.service");
+const _multillmservice = require("./services/multi-llm.service");
+const _configservice = require("./services/config.service");
+const _markdownrendererservice = require("./services/markdown-renderer.service");
+const _config = require("../modules/config");
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+let CommonModule = class CommonModule {
+};
+CommonModule = _ts_decorate([
+    (0, _common.Global)(),
+    (0, _common.Module)({
+        imports: [
+            _config.ConfigModule
+        ],
+        providers: [
+            _markdownparserservice.MarkdownParserService,
+            _llmservice.LlmService,
+            _multillmservice.MultiLlmService,
+            _configservice.ConfigService,
+            _markdownrendererservice.MarkdownRendererService
+        ],
+        exports: [
+            _markdownparserservice.MarkdownParserService,
+            _llmservice.LlmService,
+            _multillmservice.MultiLlmService,
+            _configservice.ConfigService,
+            _markdownrendererservice.MarkdownRendererService
+        ]
+    })
+], CommonModule);
+
+//# sourceMappingURL=common.module.js.map

package/dist/common/common.module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/common.module.ts"],"sourcesContent":["import { Module, Global } from '@nestjs/common';\nimport { MarkdownParserService } from './services/markdown-parser.service';\nimport { LlmService } from './services/llm.service';\nimport { MultiLlmService } from './services/multi-llm.service';\nimport { ConfigService } from './services/config.service';\nimport { MarkdownRendererService } from './services/markdown-renderer.service';\nimport { ConfigModule } from '../modules/config';\n\n@Global()\n@Module({\n  imports: [ConfigModule],\n  providers: [MarkdownParserService, LlmService, MultiLlmService, ConfigService, MarkdownRendererService],\n  exports: [MarkdownParserService, LlmService, MultiLlmService, ConfigService, MarkdownRendererService],\n})\nexport class CommonModule {}\n"],"names":["CommonModule","imports","ConfigModule","providers","MarkdownParserService","LlmService","MultiLlmService","ConfigService","MarkdownRendererService","exports"],"mappings":";;;;+BAcaA;;;eAAAA;;;wBAdkB;uCACO;4BACX;iCACK;+BACF;yCACU;wBACX;;;;;;;AAQtB,IAAA,AAAMA,eAAN,MAAMA;AAAc;;;;QAJzBC,SAAS;YAACC,oBAAY;SAAC;QACvBC,WAAW;YAACC,4CAAqB;YAAEC,sBAAU;YAAEC,gCAAe;YAAEC,4BAAa;YAAEC,gDAAuB;SAAC;QACvGC,SAAS;YAACL,4CAAqB;YAAEC,sBAAU;YAAEC,gCAAe;YAAEC,4BAAa;YAAEC,gDAAuB;SAAC"}

package/dist/common/constants/index.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get BUILT_IN_TOOLS () {
+        return BUILT_IN_TOOLS;
+    },
+    get CAST_DIR () {
+        return CAST_DIR;
+    },
+    get DEFAULT_MODEL () {
+        return DEFAULT_MODEL;
+    },
+    get DEFAULT_TEMPERATURE () {
+        return DEFAULT_TEMPERATURE;
+    },
+    get DEFINITIONS_DIR () {
+        return DEFINITIONS_DIR;
+    },
+    get GLOBAL_CONFIG_DIR () {
+        return GLOBAL_CONFIG_DIR;
+    }
+});
+const _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
+const _os = /*#__PURE__*/ _interop_require_wildcard(require("os"));
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+const CAST_DIR = '.cast';
+const GLOBAL_CONFIG_DIR = _path.join(_os.homedir(), '.cast');
+const DEFAULT_MODEL = 'gpt-4.1-nano';
+const DEFAULT_TEMPERATURE = 0.1;
+const DEFINITIONS_DIR = {
+    AGENTS: 'definitions',
+    SKILLS: 'definitions'
+};
+const BUILT_IN_TOOLS = [
+    'read_file',
+    'write_file',
+    'edit_file',
+    'glob',
+    'grep',
+    'ls',
+    'shell',
+    'shell_background',
+    'web_search',
+    'web_fetch',
+    'task_create',
+    'task_update',
+    'task_list',
+    'task_get',
+    'ask_user_question',
+    'enter_plan_mode',
+    'exit_plan_mode',
+    'memory_write',
+    'memory_read',
+    'memory_search'
+];
+
+//# sourceMappingURL=index.js.map

package/dist/common/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/common/constants/index.ts"],"sourcesContent":["import * as path from 'path';\nimport * as os from 'os';\n\nexport const CAST_DIR = '.cast';\nexport const GLOBAL_CONFIG_DIR = path.join(os.homedir(), '.cast');\n\nexport const DEFAULT_MODEL = 'gpt-4.1-nano';\nexport const DEFAULT_TEMPERATURE = 0.1;\n\nexport const DEFINITIONS_DIR = {\n  AGENTS: 'definitions',\n  SKILLS: 'definitions',\n} as const;\n\nexport const BUILT_IN_TOOLS = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'glob',\n  'grep',\n  'ls',\n  'shell',\n  'shell_background',\n  'web_search',\n  'web_fetch',\n  'task_create',\n  'task_update',\n  'task_list',\n  'task_get',\n  'ask_user_question',\n  'enter_plan_mode',\n  'exit_plan_mode',\n  'memory_write',\n  'memory_read',\n  'memory_search',\n] as const;\n\nexport type BuiltInToolName = (typeof BUILT_IN_TOOLS)[number];\n"],"names":["BUILT_IN_TOOLS","CAST_DIR","DEFAULT_MODEL","DEFAULT_TEMPERATURE","DEFINITIONS_DIR","GLOBAL_CONFIG_DIR","path","join","os","homedir","AGENTS","SKILLS"],"mappings":";;;;;;;;;;;QAcaA;eAAAA;;QAXAC;eAAAA;;QAGAC;eAAAA;;QACAC;eAAAA;;QAEAC;eAAAA;;QALAC;eAAAA;;;8DAJS;4DACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEb,MAAMJ,WAAW;AACjB,MAAMI,oBAAoBC,MAAKC,IAAI,CAACC,IAAGC,OAAO,IAAI;AAElD,MAAMP,gBAAgB;AACtB,MAAMC,sBAAsB;AAE5B,MAAMC,kBAAkB;IAC7BM,QAAQ;IACRC,QAAQ;AACV;AAEO,MAAMX,iBAAiB;IAC5B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD"}

package/dist/common/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./types"), exports);
+_export_star(require("./constants"), exports);
+_export_star(require("./services/markdown-parser.service"), exports);
+_export_star(require("./services/llm.service"), exports);
+_export_star(require("./common.module"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/index.ts"],"sourcesContent":["export * from './types';\nexport * from './constants';\nexport * from './services/markdown-parser.service';\nexport * from './services/llm.service';\nexport * from './common.module';\n"],"names":[],"mappings":";;;;qBAAc;qBACA;qBACA;qBACA;qBACA"}

package/dist/common/services/config.service.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ConfigService", {
+    enumerable: true,
+    get: function() {
+        return ConfigService;
+    }
+});
+const _common = require("@nestjs/common");
+const _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
+const _markdownparserservice = require("./markdown-parser.service");
+const _constants = require("../constants");
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+let ConfigService = class ConfigService {
+    async loadGlobalConfig() {
+        const configPath = _path.join(_constants.GLOBAL_CONFIG_DIR, 'config.md');
+        if (await this.markdownParser.exists(configPath)) {
+            const { frontmatter } = await this.markdownParser.parse(configPath);
+            this.config = {
+                model: frontmatter.model || process.env.OLLAMA_MODEL || this.config.model,
+                temperature: frontmatter.temperature ?? this.config.temperature,
+                apiKey: frontmatter.apiKey || process.env.OPENAI_API_KEY || '',
+                provider: frontmatter.provider || process.env.LLM_PROVIDER || this.config.provider,
+                ollamaBaseUrl: frontmatter.ollamaBaseUrl || process.env.OLLAMA_BASE_URL || this.config.ollamaBaseUrl
+            };
+        }
+        if (this.config.provider === 'openai' && !this.config.apiKey) {
+            throw new Error('OPENAI_API_KEY not configured. Set it in environment or ~/.cast/config.md');
+        }
+    }
+    getConfig() {
+        return this.config;
+    }
+    getModel() {
+        return this.config.model;
+    }
+    getTemperature() {
+        return this.config.temperature;
+    }
+    getApiKey() {
+        return this.config.apiKey;
+    }
+    getProvider() {
+        return this.config.provider;
+    }
+    getOllamaBaseUrl() {
+        return this.config.ollamaBaseUrl;
+    }
+    constructor(markdownParser){
+        this.markdownParser = markdownParser;
+        this.config = {
+            model: process.env.OLLAMA_MODEL || _constants.DEFAULT_MODEL,
+            temperature: _constants.DEFAULT_TEMPERATURE,
+            apiKey: process.env.OPENAI_API_KEY || '',
+            provider: process.env.LLM_PROVIDER || 'openai',
+            ollamaBaseUrl: process.env.OLLAMA_BASE_URL || 'http://localhost:11434'
+        };
+    }
+};
+ConfigService = _ts_decorate([
+    (0, _common.Injectable)(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof _markdownparserservice.MarkdownParserService === "undefined" ? Object : _markdownparserservice.MarkdownParserService
+    ])
+], ConfigService);
+
+//# sourceMappingURL=config.service.js.map

package/dist/common/services/config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/common/services/config.service.ts"],"sourcesContent":["import { Injectable } from '@nestjs/common';\nimport * as path from 'path';\nimport { MarkdownParserService } from './markdown-parser.service';\nimport { GLOBAL_CONFIG_DIR, DEFAULT_MODEL, DEFAULT_TEMPERATURE } from '../constants';\n\ninterface GlobalConfigFrontmatter {\n  model?: string;\n  temperature?: number;\n  apiKey?: string;\n  provider?: string;\n  ollamaBaseUrl?: string;\n}\n\nexport interface GlobalConfig {\n  model: string;\n  temperature: number;\n  apiKey: string;\n  provider: string;\n  ollamaBaseUrl: string;\n}\n\n@Injectable()\nexport class ConfigService {\n  private config: GlobalConfig = {\n    model: process.env.OLLAMA_MODEL || DEFAULT_MODEL,\n    temperature: DEFAULT_TEMPERATURE,\n    apiKey: process.env.OPENAI_API_KEY || '',\n    provider: process.env.LLM_PROVIDER || 'openai',\n    ollamaBaseUrl: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',\n  };\n\n  constructor(private readonly markdownParser: MarkdownParserService) {}\n\n  async loadGlobalConfig() {\n    const configPath = path.join(GLOBAL_CONFIG_DIR, 'config.md');\n\n    if (await this.markdownParser.exists(configPath)) {\n      const { frontmatter } =\n        await this.markdownParser.parse<GlobalConfigFrontmatter>(configPath);\n\n      this.config = {\n        model: frontmatter.model || process.env.OLLAMA_MODEL || this.config.model,\n        temperature: frontmatter.temperature ?? this.config.temperature,\n        apiKey: frontmatter.apiKey || process.env.OPENAI_API_KEY || '',\n        provider: frontmatter.provider || process.env.LLM_PROVIDER || this.config.provider,\n        ollamaBaseUrl: frontmatter.ollamaBaseUrl || process.env.OLLAMA_BASE_URL || this.config.ollamaBaseUrl,\n      };\n    }\n\n    if (this.config.provider === 'openai' && !this.config.apiKey) {\n      throw new Error(\n        'OPENAI_API_KEY not configured. Set it in environment or ~/.cast/config.md',\n      );\n    }\n  }\n\n  getConfig(): GlobalConfig {\n    return this.config;\n  }\n\n  getModel(): string {\n    return this.config.model;\n  }\n\n  getTemperature(): number {\n    return this.config.temperature;\n  }\n\n  getApiKey(): string {\n    return this.config.apiKey;\n  }\n\n  getProvider(): string {\n    return this.config.provider;\n  }\n\n  getOllamaBaseUrl(): string {\n    return this.config.ollamaBaseUrl;\n  }\n}\n"],"names":["ConfigService","loadGlobalConfig","configPath","path","join","GLOBAL_CONFIG_DIR","markdownParser","exists","frontmatter","parse","config","model","process","env","OLLAMA_MODEL","temperature","apiKey","OPENAI_API_KEY","provider","LLM_PROVIDER","ollamaBaseUrl","OLLAMA_BASE_URL","Error","getConfig","getModel","getTemperature","getApiKey","getProvider","getOllamaBaseUrl","DEFAULT_MODEL","DEFAULT_TEMPERATURE"],"mappings":";;;;+BAsBaA;;;eAAAA;;;wBAtBc;8DACL;uCACgB;2BACgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmB/D,IAAA,AAAMA,gBAAN,MAAMA;IAWX,MAAMC,mBAAmB;QACvB,MAAMC,aAAaC,MAAKC,IAAI,CAACC,4BAAiB,EAAE;QAEhD,IAAI,MAAM,IAAI,CAACC,cAAc,CAACC,MAAM,CAACL,aAAa;YAChD,MAAM,EAAEM,WAAW,EAAE,GACnB,MAAM,IAAI,CAACF,cAAc,CAACG,KAAK,CAA0BP;YAE3D,IAAI,CAACQ,MAAM,GAAG;gBACZC,OAAOH,YAAYG,KAAK,IAAIC,QAAQC,GAAG,CAACC,YAAY,IAAI,IAAI,CAACJ,MAAM,CAACC,KAAK;gBACzEI,aAAaP,YAAYO,WAAW,IAAI,IAAI,CAACL,MAAM,CAACK,WAAW;gBAC/DC,QAAQR,YAAYQ,MAAM,IAAIJ,QAAQC,GAAG,CAACI,cAAc,IAAI;gBAC5DC,UAAUV,YAAYU,QAAQ,IAAIN,QAAQC,GAAG,CAACM,YAAY,IAAI,IAAI,CAACT,MAAM,CAACQ,QAAQ;gBAClFE,eAAeZ,YAAYY,aAAa,IAAIR,QAAQC,GAAG,CAACQ,eAAe,IAAI,IAAI,CAACX,MAAM,CAACU,aAAa;YACtG;QACF;QAEA,IAAI,IAAI,CAACV,MAAM,CAACQ,QAAQ,KAAK,YAAY,CAAC,IAAI,CAACR,MAAM,CAACM,MAAM,EAAE;YAC5D,MAAM,IAAIM,MACR;QAEJ;IACF;IAEAC,YAA0B;QACxB,OAAO,IAAI,CAACb,MAAM;IACpB;IAEAc,WAAmB;QACjB,OAAO,IAAI,CAACd,MAAM,CAACC,KAAK;IAC1B;IAEAc,iBAAyB;QACvB,OAAO,IAAI,CAACf,MAAM,CAACK,WAAW;IAChC;IAEAW,YAAoB;QAClB,OAAO,IAAI,CAAChB,MAAM,CAACM,MAAM;IAC3B;IAEAW,cAAsB;QACpB,OAAO,IAAI,CAACjB,MAAM,CAACQ,QAAQ;IAC7B;IAEAU,mBAA2B;QACzB,OAAO,IAAI,CAAClB,MAAM,CAACU,aAAa;IAClC;IA/CA,YAAY,AAAiBd,cAAqC,CAAE;aAAvCA,iBAAAA;aARrBI,SAAuB;YAC7BC,OAAOC,QAAQC,GAAG,CAACC,YAAY,IAAIe,wBAAa;YAChDd,aAAae,8BAAmB;YAChCd,QAAQJ,QAAQC,GAAG,CAACI,cAAc,IAAI;YACtCC,UAAUN,QAAQC,GAAG,CAACM,YAAY,IAAI;YACtCC,eAAeR,QAAQC,GAAG,CAACQ,eAAe,IAAI;QAChD;IAEqE;AAgDvE"}

package/dist/common/services/llm.service.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "LlmService", {
+    enumerable: true,
+    get: function() {
+        return LlmService;
+    }
+});
+const _common = require("@nestjs/common");
+const _openai = require("@langchain/openai");
+const _ollama = require("@langchain/ollama");
+const _configservice = require("./config.service");
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+let LlmService = class LlmService {
+    createModel(streaming = false) {
+        const provider = this.configService.getProvider();
+        if (provider === 'ollama') {
+            return new _ollama.ChatOllama({
+                model: this.configService.getModel(),
+                temperature: this.configService.getTemperature(),
+                baseUrl: this.configService.getOllamaBaseUrl()
+            });
+        }
+        return new _openai.ChatOpenAI({
+            modelName: this.configService.getModel(),
+            temperature: this.configService.getTemperature(),
+            openAIApiKey: this.configService.getApiKey(),
+            streaming
+        });
+    }
+    createStreamingModel() {
+        return this.createModel(true);
+    }
+    constructor(configService){
+        this.configService = configService;
+    }
+};
+LlmService = _ts_decorate([
+    (0, _common.Injectable)(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof _configservice.ConfigService === "undefined" ? Object : _configservice.ConfigService
+    ])
+], LlmService);
+
+//# sourceMappingURL=llm.service.js.map

package/dist/common/services/llm.service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/common/services/llm.service.ts"],"sourcesContent":["import { Injectable } from '@nestjs/common';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { ChatOllama } from '@langchain/ollama';\nimport { BaseChatModel } from '@langchain/core/language_models/chat_models';\nimport { ConfigService } from './config.service';\n\n@Injectable()\nexport class LlmService {\n  constructor(private readonly configService: ConfigService) {}\n\n  createModel(streaming = false): BaseChatModel {\n    const provider = this.configService.getProvider();\n\n    if (provider === 'ollama') {\n      return new ChatOllama({\n        model: this.configService.getModel(),\n        temperature: this.configService.getTemperature(),\n        baseUrl: this.configService.getOllamaBaseUrl(),\n      });\n    }\n\n    return new ChatOpenAI({\n      modelName: this.configService.getModel(),\n      temperature: this.configService.getTemperature(),\n      openAIApiKey: this.configService.getApiKey(),\n      streaming,\n    });\n  }\n\n  createStreamingModel(): BaseChatModel {\n    return this.createModel(true);\n  }\n}\n"],"names":["LlmService","createModel","streaming","provider","configService","getProvider","ChatOllama","model","getModel","temperature","getTemperature","baseUrl","getOllamaBaseUrl","ChatOpenAI","modelName","openAIApiKey","getApiKey","createStreamingModel"],"mappings":";;;;+BAOaA;;;eAAAA;;;wBAPc;wBACA;wBACA;+BAEG;;;;;;;;;;AAGvB,IAAA,AAAMA,aAAN,MAAMA;IAGXC,YAAYC,YAAY,KAAK,EAAiB;QAC5C,MAAMC,WAAW,IAAI,CAACC,aAAa,CAACC,WAAW;QAE/C,IAAIF,aAAa,UAAU;YACzB,OAAO,IAAIG,kBAAU,CAAC;gBACpBC,OAAO,IAAI,CAACH,aAAa,CAACI,QAAQ;gBAClCC,aAAa,IAAI,CAACL,aAAa,CAACM,cAAc;gBAC9CC,SAAS,IAAI,CAACP,aAAa,CAACQ,gBAAgB;YAC9C;QACF;QAEA,OAAO,IAAIC,kBAAU,CAAC;YACpBC,WAAW,IAAI,CAACV,aAAa,CAACI,QAAQ;YACtCC,aAAa,IAAI,CAACL,aAAa,CAACM,cAAc;YAC9CK,cAAc,IAAI,CAACX,aAAa,CAACY,SAAS;YAC1Cd;QACF;IACF;IAEAe,uBAAsC;QACpC,OAAO,IAAI,CAAChB,WAAW,CAAC;IAC1B;IAvBA,YAAY,AAAiBG,aAA4B,CAAE;aAA9BA,gBAAAA;IAA+B;AAwB9D"}