mastracode 0.0.1 → 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# mastracode
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- Migrated MastraCode from the prototype harness to the generic CoreHarness from @mastra/core. The createMastraCode function is now fully configurable with optional parameters for modes, subagents, storage, tools, and more. Removed the deprecated prototype harness implementation. ([#13245](https://github.com/mastra-ai/mastra/pull/13245))
+
+### Patch Changes
+
+- Added generic Harness class to @mastra/core for orchestrating agents with modes, state management, built-in tools (ask_user, submit_plan), subagent support, Observational Memory integration, model discovery, and permission-aware tool approval. The Harness provides a reusable foundation for building agent-powered applications with features like thread management, heartbeat monitoring, and event-driven architecture. ([#13245](https://github.com/mastra-ai/mastra/pull/13245))
+
+- Updated dependencies [[`252580a`](https://github.com/mastra-ai/mastra/commit/252580a71feb0e46d0ccab04a70a79ff6a2ee0ab), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`5c75261`](https://github.com/mastra-ai/mastra/commit/5c7526120d936757d4ffb7b82232e1641ebd45cb), [`e27d832`](https://github.com/mastra-ai/mastra/commit/e27d83281b5e166fd63a13969689e928d8605944), [`e37ef84`](https://github.com/mastra-ai/mastra/commit/e37ef8404043c94ca0c8e35ecdedb093b8087878), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`10cf521`](https://github.com/mastra-ai/mastra/commit/10cf52183344743a0d7babe24cd24fd78870c354), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`efdb682`](https://github.com/mastra-ai/mastra/commit/efdb682887f6522149769383908f9790c188ab88), [`0dee7a0`](https://github.com/mastra-ai/mastra/commit/0dee7a0ff4c2507e6eb6e6ee5f9738877ebd4ad1), [`04c2c8e`](https://github.com/mastra-ai/mastra/commit/04c2c8e888984364194131aecb490a3d6e920e61), [`02dc07a`](https://github.com/mastra-ai/mastra/commit/02dc07acc4ad42d93335825e3308f5b42266eba2), [`8650e4d`](https://github.com/mastra-ai/mastra/commit/8650e4d3579a2c3a13e2dba7ec6ee7c82c7f61a8), [`bd222d3`](https://github.com/mastra-ai/mastra/commit/bd222d39e292bfcc4a2d9a9e6ec3976cc5a4f22f), [`bb7262b`](https://github.com/mastra-ai/mastra/commit/bb7262b7c0ca76320d985b40510b6ffbbb936582), [`cf1c6e7`](https://github.com/mastra-ai/mastra/commit/cf1c6e789b131f55638fed52183a89d5078b4876), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`1e1339c`](https://github.com/mastra-ai/mastra/commit/1e1339cc276e571a48cfff5014487877086bfe68), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`d03df73`](https://github.com/mastra-ai/mastra/commit/d03df73f8fe9496064a33e1c3b74ba0479bf9ee6), [`79b8f45`](https://github.com/mastra-ai/mastra/commit/79b8f45a6767e1a5c3d56cd3c5b1214326b81661), [`9bbf08e`](https://github.com/mastra-ai/mastra/commit/9bbf08e3c20731c79dea13a765895b9fcf29cbf1), [`0a25952`](https://github.com/mastra-ai/mastra/commit/0a259526b5e1ac11e6efa53db1f140272962af2d), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`3264a04`](https://github.com/mastra-ai/mastra/commit/3264a04e30340c3c5447433300a035ea0878df85), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`088d9ba`](https://github.com/mastra-ai/mastra/commit/088d9ba2577518703c52b0dccd617178d9ee6b0d), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`aea6217`](https://github.com/mastra-ai/mastra/commit/aea621790bfb2291431b08da0cc5e6e150303ae7), [`b6a855e`](https://github.com/mastra-ai/mastra/commit/b6a855edc056e088279075506442ba1d6fa6def9), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`17e942e`](https://github.com/mastra-ai/mastra/commit/17e942eee2ba44985b1f807e6208cdde672f82f9), [`2015cf9`](https://github.com/mastra-ai/mastra/commit/2015cf921649f44c3f5bcd32a2c052335f8e49b4), [`7ef454e`](https://github.com/mastra-ai/mastra/commit/7ef454eaf9dcec6de60021c8f42192052dd490d6), [`2be1d99`](https://github.com/mastra-ai/mastra/commit/2be1d99564ce79acc4846071082bff353035a87a), [`2708fa1`](https://github.com/mastra-ai/mastra/commit/2708fa1055ac91c03e08b598869f6b8fb51fa37f), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ec53e89`](https://github.com/mastra-ai/mastra/commit/ec53e8939c76c638991e21af762e51378eff7543), [`9b5a8cb`](https://github.com/mastra-ai/mastra/commit/9b5a8cb13e120811b0bf14140ada314f1c067894), [`607e66b`](https://github.com/mastra-ai/mastra/commit/607e66b02dc7f531ee37799f3456aa2dc0ca7ac5), [`a215d06`](https://github.com/mastra-ai/mastra/commit/a215d06758dcf590eabfe0b7afd4ae39bdbf082c), [`6909c74`](https://github.com/mastra-ai/mastra/commit/6909c74a7781e0447d475e9dbc1dc871b700f426), [`192438f`](https://github.com/mastra-ai/mastra/commit/192438f8a90c4f375e955f8ff179bf8dc6821a83)]:
+  - @mastra/core@1.5.0-alpha.0
+  - @mastra/memory@1.4.0-alpha.0
+  - @mastra/libsql@1.5.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -1,15 +1,149 @@
-# js
+# Mastra Code
 
-To install dependencies:
+A terminal-based coding agent TUI built with [Mastra](https://mastra.ai) and [pi-tui](https://github.com/badlogic/pi-mono).
+
+## Features
+
+- 🤖 **Multi-model support** - Use Claude, GPT, Gemini, and 70+ other models via Mastra's unified model router
+- 🔐 **OAuth login** - Authenticate with Anthropic (Claude Max) and OpenAI (ChatGPT Plus/Codex)
+- 💾 **Persistent conversations** - Threads are saved per-project and resume automatically
+- 🛠️ **Coding tools** - View files, edit code, run shell commands
+- 📊 **Token tracking** - Monitor usage with persistent token counts per thread
+- 🎨 **Beautiful TUI** - Polished terminal interface with streaming responses
+
+## Installation
+
+Clone the repository and install its dependencies.
+
+```bash
+# Clone the repository
+git clone https://github.com/mastra-ai/mastra.git
+cd mastracode
+
+# Install dependencies
+pnpm install
+```
+
+To use Mastra Code, we recommend creating an alias in your shell configuration to launch it from any directory. You have to specify the absolute path to `main.ts` and then run it with `tsx`.
 
 ```bash
-bun install
+# Add this to your .bashrc, .zshrc, etc.
+alias mastracode="pnpm dlx tsx /absolute/path/mastracode/src/main.ts"
+```
+
+Lastly, start the TUI and execute the `/login` command to authenticate with your AI providers.
+
+## Usage
+
+### Starting a conversation
+
+Simply type your message and press Enter. The agent will respond with streaming text.
+
+### Slash commands
+
+| Command    | Description                               |
+| ---------- | ----------------------------------------- |
+| `/new`     | Start a new conversation thread           |
+| `/threads` | List all threads for this project         |
+| `/models`  | Select a different AI model               |
+| `/cost`    | Show token usage for current conversation |
+| `/login`   | Authenticate with OAuth providers         |
+| `/logout`  | Log out from a provider                   |
+| `/help`    | Show available commands                   |
+| `/exit`    | Exit the TUI                              |
+
+### Keyboard shortcuts
+
+| Shortcut | Action                            |
+| -------- | --------------------------------- |
+| `Ctrl+C` | Interrupt current operation       |
+| `Ctrl+D` | Exit (when editor is empty)       |
+| `Ctrl+T` | Toggle thinking blocks visibility |
+| `Ctrl+E` | Expand/collapse all tool outputs  |
+
+## Configuration
+
+### Project-based threads
+
+Threads are automatically scoped to your project based on:
+
+1. Git remote URL (if available)
+2. Absolute path (fallback)
+
+This means conversations are shared across clones, worktrees, and SSH/HTTPS URLs of the same repository.
+
+### Database location
+
+The SQLite database is stored in your system's application data directory:
+
+- **macOS**: `~/Library/Application Support/mastracode/`
+- **Linux**: `~/.local/share/mastracode/`
+- **Windows**: `%APPDATA%/mastracode/`
+
+### Authentication
+
+OAuth credentials are stored alongside the database in `auth.json`.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                          TUI                                │
+│  (pi-tui components: Editor, Markdown, Loader, etc.)        │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                        Harness                              │
+│  - Mode management (plan, build, review)                    │
+│  - Thread/message persistence                               │
+│  - Event system for TUI updates                             │
+│  - State management with Zod schemas                        │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                      Mastra Agent                           │
+│  - Dynamic model selection                                  │
+│  - Tool execution (view, edit, bash)                        │
+│  - Memory integration                                       │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                      LibSQL Storage                         │
+│  - Thread persistence                                       │
+│  - Message history                                          │
+│  - Token usage tracking                                     │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-To run:
+## Development
 
 ```bash
-bun run index.ts
+# Run in development mode (with watch)
+pnpm dev
+
+# Type check
+pnpm typecheck
+
+# Build
+pnpm build
 ```
 
-This project was created using `bun init` in bun v1.2.12. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+## Roadmap
+
+- [ ] Tool approval UI for dangerous operations
+- [ ] Streaming tool output
+- [ ] More tools (search, grep, etc.)
+- [ ] Multi-agent collaboration (network mode)
+
+## Credits
+
+- [Mastra](https://mastra.ai) - AI agent framework
+- [pi-mono](https://github.com/badlogic/pi-mono) - TUI primitives and inspiration
+- [OpenCode](https://github.com/sst/opencode) - OAuth provider patterns
+
+## License
+
+Apache-2.0

package/dist/agents/coding.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=coding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coding.d.ts","sourceRoot":"","sources":["../../src/agents/coding.ts"],"names":[],"mappings":""}

package/dist/agents/instructions.d.ts

@@ -0,0 +1,6 @@
+export declare function getDynamicInstructions({ requestContext }: {
+    requestContext: {
+        get(key: string): unknown;
+    };
+}): string;
+//# sourceMappingURL=instructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agents/instructions.ts"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,CAAC,EAAE,cAAc,EAAE,EAAE;IAAE,cAAc,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAAE,UAoB3G"}

package/dist/agents/memory.d.ts

@@ -0,0 +1,12 @@
+import type { RequestContext } from '@mastra/core/request-context';
+import type { MastraCompositeStore } from '@mastra/core/storage';
+import { Memory } from '@mastra/memory';
+/**
+ * Dynamic memory factory function.
+ * Reads OM thresholds from harness state via requestContext.
+ * Model functions also read from requestContext (no mutable bridge needed).
+ */
+export declare function getDynamicMemory(storage: MastraCompositeStore): ({ requestContext }: {
+    requestContext: RequestContext;
+}) => Memory;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agents/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAmCxC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,IACpD,oBAAoB;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,YA4C/D"}

package/dist/agents/model.d.ts

@@ -0,0 +1,21 @@
+import type { LanguageModelV1 } from '@ai-sdk/provider';
+import type { MastraLanguageModel } from '@mastra/core/agent';
+import type { RequestContext } from '@mastra/core/request-context';
+/**
+ * Resolve a model ID to the correct provider instance.
+ * Shared by the main agent, observer, and reflector.
+ *
+ * - For anthropic/* models: Uses Claude Max OAuth provider (opencode auth)
+ * - For openai/* models with OAuth: Uses OpenAI Codex OAuth provider
+ * - For moonshotai/* models: Uses Moonshot AI Anthropic-compatible endpoint
+ * - For all other providers: Uses Mastra's model router (models.dev gateway)
+ */
+export declare function resolveModel(modelId: string): LanguageModelV1 | MastraLanguageModel;
+/**
+ * Dynamic model function that reads the current model from harness state.
+ * This allows runtime model switching via the /models picker.
+ */
+export declare function getDynamicModel({ requestContext, }: {
+    requestContext: RequestContext;
+}): LanguageModelV1 | MastraLanguageModel;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/agents/model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQnE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,mBAAmB,CAqBnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAC9B,cAAc,GACf,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;CAChC,GAAG,eAAe,GAAG,mBAAmB,CASxC"}

package/dist/agents/prompts/agent-instructions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Load project and global agent instruction files (AGENT.md, CLAUDE.md).
+ * Prefers AGENT.md over CLAUDE.md when both exist at the same location.
+ */
+interface InstructionSource {
+    path: string;
+    content: string;
+    scope: 'global' | 'project';
+}
+/**
+ * Load all agent instruction files from global and project locations.
+ * Returns an array of instruction sources, with global ones first.
+ */
+export declare function loadAgentInstructions(projectPath: string): InstructionSource[];
+/**
+ * Format loaded instructions into a string for the system prompt.
+ */
+export declare function formatAgentInstructions(sources: InstructionSource[]): string;
+export {};
+//# sourceMappingURL=agent-instructions.d.ts.map

package/dist/agents/prompts/agent-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/agent-instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC7B;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuC9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAS5E"}

package/dist/agents/prompts/base.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Base system prompt — shared behavioral instructions for all modes.
+ * This is the "brain" that makes the agent a good coding assistant.
+ */
+export interface PromptContext {
+    projectPath: string;
+    projectName: string;
+    gitBranch?: string;
+    platform: string;
+    date: string;
+    mode: string;
+    activePlan?: {
+        title: string;
+        plan: string;
+        approvedAt: string;
+    } | null;
+}
+export declare function buildBasePrompt(ctx: PromptContext): string;
+//# sourceMappingURL=base.d.ts.map

package/dist/agents/prompts/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA8I1D"}

package/dist/agents/prompts/build.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build mode prompt — full tool access, make changes and verify.
+ */
+import type { PromptContext } from './base.js';
+/**
+ * Dynamic build mode prompt function.
+ * When an approved plan exists in state, prepends it so the agent
+ * knows exactly what to implement.
+ */
+export declare function buildModePromptFn(ctx: PromptContext): string;
+export declare const buildModePrompt = "\n# Build Mode\n\nYou are in BUILD mode. You have full access to all tools and can read, write, edit, and execute commands.\n\n## Working Style\n\n**For simple tasks** (typo fixes, small edits, single-file changes):\n- Just do it. No need to explain your plan first.\n\n**For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):\n- Use todo_write to track your steps\n- Work on ONE step at a time \u2014 complete it and verify it works before moving on\n- If the approach is risky or ambiguous, ask the user before proceeding\n\n## The Implementation Loop\n\nFor each change you make:\n\n1. **Understand** \u2014 Read the relevant code. Check how similar things are done elsewhere.\n2. **Implement** \u2014 Make the change. Follow existing patterns and conventions.\n3. **Verify** \u2014 Test that it works. Don't assume \u2014 actually run it.\n4. **Clean up** \u2014 Ensure no broken code, no debug statements, no half-done features.\n\nOnly move to the next change after the current one is verified working.\n\n## Verification is Required\n\nBefore considering any task complete:\n- Run relevant tests (check package.json for test scripts)\n- For TypeScript, run `tsc --noEmit` to catch type errors\n- If there are no automated tests, manually verify the behavior works as expected\n- Use todo_check to ensure all tracked tasks are done\n\n**Don't mark something as done until you've verified it actually works.**\n\n## Error Recovery\n\nWhen something breaks:\n1. Read the full error output carefully \u2014 don't guess\n2. Find the root cause, not just the symptom\n3. Fix it properly \u2014 no casts or suppressions to hide errors\n4. Re-run to confirm the fix\n5. If stuck after 2 attempts, tell the user what you've tried\n\n## Git in Build Mode\n\n- Don't commit unless asked \u2014 just report what you changed\n- Before committing, verify the code compiles and passes lint\n- Use descriptive branch names: `feat/...`, `fix/...`, `refactor/...`\n";
+//# sourceMappingURL=build.d.ts.map

package/dist/agents/prompts/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiB5D;AAED,eAAO,MAAM,eAAe,m8DAkD3B,CAAC"}

package/dist/agents/prompts/fast.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Fast mode prompt — quick answers and small edits, minimal overhead.
+ */
+export declare const fastModePrompt = "\n# Fast Mode\n\nYou are in FAST mode. Optimize for speed and brevity.\n\n## Rules\n- Keep responses short. Under 200 words unless the task genuinely requires more.\n- Skip planning. Just do the task directly.\n- For questions: give the direct answer, not a tutorial.\n- For edits: make the change, show what you did, move on.\n- Don't explore the codebase more than necessary for the immediate task.\n\n## When to Use Tools vs. Just Answer\n- If the user asks a general programming question, answer directly from knowledge. Don't search the codebase.\n- If the user asks about THIS project's code, use tools to look it up \u2014 don't guess.\n- If the user asks for a quick edit and you know the file, read it and edit it. Don't ask for confirmation.\n- One tool call to read + one to edit is ideal. Minimize round trips.\n";
+//# sourceMappingURL=fast.d.ts.map

package/dist/agents/prompts/fast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/fast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,6zBAiB1B,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Prompt system — exports the prompt builder and mode-specific prompts.
+ */
+export { buildBasePrompt } from './base.js';
+export { buildModePrompt, buildModePromptFn } from './build.js';
+export { planModePrompt } from './plan.js';
+export { fastModePrompt } from './fast.js';
+import type { PromptContext as BasePromptContext } from './base.js';
+export interface PromptContext extends BasePromptContext {
+    modeId: string;
+    state?: any;
+    currentDate: string;
+    workingDir: string;
+    availableTools?: string;
+}
+/**
+ * Build the full system prompt for a given mode and context.
+ * Combines the base prompt with mode-specific instructions.
+ */
+export declare function buildFullPrompt(ctx: PromptContext): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI3C,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAMpE,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAsC1D"}

package/dist/agents/prompts/plan.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Plan mode prompt — read-only exploration and planning.
+ */
+export declare const planModePrompt = "\n# Plan Mode \u2014 READ-ONLY\n\nYou are in PLAN mode. Your job is to explore the codebase and design an implementation plan \u2014 NOT to make changes.\n\n## CRITICAL: Read-Only Mode\n\nThis mode is **strictly read-only**. You must NOT modify anything.\n\n**Allowed tools:**\n- `view` \u2014 read files and directories\n- `grep` \u2014 search file contents\n- `glob` \u2014 find files by pattern\n- `execute_command` \u2014 ONLY for read-only commands (git status, git log, git diff, etc.)\n- `submit_plan` \u2014 submit your completed plan\n\n**Prohibited actions:**\n- Do NOT use `string_replace_lsp` or `write_file` \u2014 no file modifications\n- Do NOT use `execute_command` for anything that changes state (no git commit, no npm install, no file creation)\n- Do NOT create, delete, or modify any files\n- Do NOT run build commands, tests, or scripts that have side effects\n\nIf the user asks you to make changes while in Plan mode, explain that you're in read-only mode and they should switch to Build mode (`/mode build`) first.\n\n## Exploration Strategy\n\nBefore writing any plan, build a mental model of the codebase:\n1. Start with the directory structure (`view` on the project root or relevant subdirectory).\n2. Find the relevant entry points and core files using `grep` and `glob`.\n3. Read the actual code \u2014 don't assume based on file names alone.\n4. Trace data flow: where does input come from, how is it transformed, where does it go?\n5. Identify existing patterns the codebase uses (naming, structure, error handling, testing).\n\n## Your Plan Output\n\nProduce a clear, step-by-step plan with this structure:\n\n### Overview\nOne paragraph: what the change does and why.\n\n### Complexity Estimate\n- **Size**: Small (1-2 files) / Medium (3-5 files) / Large (6+ files)\n- **Risk**: Low (additive, no breaking changes) / Medium (modifies existing behavior) / High (architectural, affects many consumers)\n- **Dependencies**: List any new packages, external services, or migration steps needed.\n\n### Steps\nFor each step:\n1. **File**: path to create or modify\n2. **Change**: what to add/modify/remove, with enough specificity to implement directly\n3. **Why**: brief rationale connecting this step to the overall goal\n\n### Verification\n- What tests to run\n- What to check manually\n- What could go wrong\n\n## When Done\n\nWhen your plan is complete, call the `submit_plan` tool with:\n- **title**: A short descriptive title (e.g., \"Add dark mode toggle\")\n- **plan**: The full plan in markdown, using the structure above (Overview, Complexity, Steps, Verification)\n\nThe user will see the plan rendered inline and can:\n- **Approve** \u2014 automatically switches to Build mode for implementation\n- **Reject** \u2014 stays in Plan mode\n- **Request changes** \u2014 provides feedback for you to revise and resubmit\n\nDo NOT start implementing until the plan is approved. If rejected with feedback, revise the plan and call `submit_plan` again.\n";
+//# sourceMappingURL=plan.d.ts.map

package/dist/agents/prompts/plan.d.ts.map

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

package/dist/agents/subagents/execute.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Execute subagent — focused task execution with write capabilities.
+ *
+ * This subagent is given a specific implementation task and uses both
+ * read and write tools to complete it. It can modify files, run commands,
+ * and perform actual development work within a constrained scope.
+ */
+import type { SubagentDefinition } from './types.js';
+export declare const executeSubagent: SubagentDefinition;
+//# sourceMappingURL=execute.d.ts.map

package/dist/agents/subagents/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,eAAe,EAAE,kBAkD7B,CAAC"}

package/dist/agents/subagents/explore.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Explore subagent — read-only codebase exploration.
+ *
+ * This subagent is given a focused task (e.g., "find all usages of X",
+ * "understand how module Y works") and uses read-only tools to explore
+ * the codebase, then returns a concise summary of its findings.
+ */
+import type { SubagentDefinition } from './types.js';
+export declare const exploreSubagent: SubagentDefinition;
+//# sourceMappingURL=explore.d.ts.map

package/dist/agents/subagents/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/explore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,eAAe,EAAE,kBA8B7B,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { SubagentDefinition } from './types.js';
+/**
+ * Look up a subagent definition by ID.
+ * Returns undefined if not found.
+ */
+export declare function getSubagentDefinition(id: string): SubagentDefinition | undefined;
+/**
+ * Get all registered subagent IDs (for tool description / validation).
+ */
+export declare function getSubagentIds(): string[];
+export declare function getSubagentTools(projectPath: string): {
+    tool: import("@mastra/core/tools").Tool<{
+        agentType: string;
+        task: string;
+        modelId?: string | undefined;
+    }, {
+        content: string;
+        isError: boolean;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "subagent", unknown>;
+    toolReadOnly: import("@mastra/core/tools").Tool<{
+        agentType: string;
+        task: string;
+        modelId?: string | undefined;
+    }, {
+        content: string;
+        isError: boolean;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "subagent", unknown>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASrD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;EA0CnD"}

package/dist/agents/subagents/plan.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Plan subagent — read-only analysis and planning.
+ *
+ * This subagent is given a task to analyze and produces a structured
+ * implementation plan. It can read the codebase to understand existing
+ * patterns and architecture, but cannot modify anything.
+ */
+import type { SubagentDefinition } from './types.js';
+export declare const planSubagent: SubagentDefinition;
+//# sourceMappingURL=plan.d.ts.map

package/dist/agents/subagents/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/plan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,kBAgC1B,CAAC"}

package/dist/agents/subagents/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Subagent type definitions.
+ *
+ * A subagent is a lightweight Agent instance with a constrained tool set,
+ * spawned by the parent agent via the `task` meta-tool. Each subagent runs
+ * in its own conversation thread and returns a single text result.
+ */
+export interface SubagentDefinition {
+    /** Unique identifier for this subagent type (e.g., "explore", "plan") */
+    id: string;
+    /** Human-readable name shown in tool output */
+    name: string;
+    /** System prompt for this subagent */
+    instructions: string;
+    /**
+     * Which tool IDs this subagent may use.
+     * These are keys from the parent agent's tool registry
+     * (e.g., "view", "search_content", "find_files").
+     */
+    allowedTools: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/subagents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IAEX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/agents/tools.d.ts

@@ -0,0 +1,6 @@
+import type { RequestContext } from '@mastra/core/request-context';
+import type { MCPManager } from '../mcp/index.js';
+export declare function createDynamicTools(mcpManager?: MCPManager): ({ requestContext }: {
+    requestContext: RequestContext;
+}) => Record<string, any>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAkBzC,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,UAAU,IACxB,oBAAoB;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,yBAkDvF"}

package/dist/agents/workspace.d.ts

@@ -0,0 +1,6 @@
+import type { RequestContext } from '@mastra/core/request-context';
+import { Workspace, LocalFilesystem, LocalSandbox } from '@mastra/core/workspace';
+export declare function getDynamicWorkspace({ requestContext }: {
+    requestContext: RequestContext;
+}): Workspace<LocalFilesystem, LocalSandbox, undefined>;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/agents/workspace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAyElF,wBAAgB,mBAAmB,CAAC,EAAE,cAAc,EAAE,EAAE;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,uDA6BzF"}

package/dist/auth/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OAuth credential management for AI providers.
+ */
+export * from './types.js';
+export * from './storage.js';
+export { anthropicOAuthProvider } from './providers/anthropic.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/auth/pkce.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PKCE utilities using Web Crypto API.
+ * Works in both Node.js 20+ and browsers.
+ */
+/**
+ * Generate PKCE code verifier and challenge.
+ * Uses Web Crypto API for cross-platform compatibility.
+ */
+export declare function generatePKCE(): Promise<{
+    verifier: string;
+    challenge: string;
+}>;
+//# sourceMappingURL=pkce.d.ts.map

package/dist/auth/pkce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.d.ts","sourceRoot":"","sources":["../../src/auth/pkce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAaD"}

package/dist/auth/providers/anthropic.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Anthropic OAuth flow (Claude Pro/Max)
+ *
+ * Inspired by pi-mono's OAuth implementation:
+ * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/anthropic.ts
+ */
+import type { OAuthCredentials, OAuthProviderInterface } from '../types.js';
+/**
+ * Login with Anthropic OAuth (device code flow)
+ */
+export declare function loginAnthropic(onAuthUrl: (url: string) => void, onPromptCode: () => Promise<string>): Promise<OAuthCredentials>;
+/**
+ * Refresh Anthropic OAuth token
+ */
+export declare function refreshAnthropicToken(refreshToken: string): Promise<OAuthCredentials>;
+export declare const anthropicOAuthProvider: OAuthProviderInterface;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/auth/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/auth/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,sBAAsB,EAAE,MAAM,aAAa,CAAC;AASjG;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAChC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,gBAAgB,CAAC,CA6D3B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2B3F;AAED,eAAO,MAAM,sBAAsB,EAAE,sBAkBpC,CAAC"}

package/dist/auth/providers/openai-codex.d.ts

@@ -0,0 +1,37 @@
+/**
+ * OpenAI Codex (ChatGPT OAuth) flow
+ *
+ * Inspired by pi-mono's OAuth implementation:
+ * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/openai-codex.ts
+ *
+ * NOTE: This module uses Node.js crypto and http for the OAuth callback.
+ * It is only intended for CLI use, not browser environments.
+ */
+import type { OAuthCredentials, OAuthPrompt, OAuthProviderInterface } from '../types.js';
+/**
+ * Login with OpenAI Codex OAuth
+ *
+ * @param options.onAuth - Called with URL and instructions when auth starts
+ * @param options.onPrompt - Called to prompt user for manual code paste (fallback if no onManualCodeInput)
+ * @param options.onProgress - Optional progress messages
+ * @param options.onManualCodeInput - Optional promise that resolves with user-pasted code.
+ *                                    Races with browser callback - whichever completes first wins.
+ *                                    Useful for showing paste input immediately alongside browser flow.
+ * @param options.originator - OAuth originator parameter (defaults to "pi")
+ */
+export declare function loginOpenAICodex(options: {
+    onAuth: (info: {
+        url: string;
+        instructions?: string;
+    }) => void;
+    onPrompt: (prompt: OAuthPrompt) => Promise<string>;
+    onProgress?: (message: string) => void;
+    onManualCodeInput?: () => Promise<string>;
+    originator?: string;
+}): Promise<OAuthCredentials>;
+/**
+ * Refresh OpenAI Codex OAuth token
+ */
+export declare function refreshOpenAICodexToken(refreshToken: string): Promise<OAuthCredentials>;
+export declare const openaiCodexOAuthProvider: OAuthProviderInterface;
+//# sourceMappingURL=openai-codex.d.ts.map

package/dist/auth/providers/openai-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex.d.ts","sourceRoot":"","sources":["../../../src/auth/providers/openai-codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAyR9G;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsG5B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB7F;AAED,eAAO,MAAM,wBAAwB,EAAE,sBAqBtC,CAAC"}