@swifty.js/swifty 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,183 @@
+# Swifty
+
+Swifty is a terminal-based AI coding agent. It provides an interactive TUI (terminal user interface) for conversing with large language models, executing code, manipulating files, and orchestrating multi-agent workflows, all from the command line.
+
+## Overview
+
+Swifty runs as a single CLI binary that connects to configurable LLM providers (Anthropic, OpenAI, or any OpenAI-compatible endpoint). It renders a rich terminal interface using React and Ink, giving you streaming responses, tool execution feedback, permission prompts, and slash commands in a single pane.
+
+Beyond interactive use, Swifty supports a non-interactive print mode for scripting, a remote mode that serves a browser-based chat UI over WebSocket, and a teammate mode that lets one lead agent coordinate multiple subagents working in parallel.
+
+## Features
+
+### Core Capabilities
+
+- Multi-provider LLM support with Anthropic, OpenAI, and OpenAI-compatible protocols
+- Interactive terminal UI with streaming text, thinking indicators, and tool execution display
+- Built-in tool set: ReadFile, WriteFile, EditFile, Bash, Glob, Grep, ToolSearch, EnterWorktree, ExitWorktree, ExitPlanMode
+- MCP (Model Context Protocol) server integration for extending the tool set with external services
+- Permission system with four modes: default, acceptEdits, plan (read-only), and bypassPermissions
+- Sandbox support via bwrap (Linux) and seatbelt (macOS) for isolated command execution
+- Dangerous command pattern detection with human-in-the-loop approval dialogs
+
+### Conversation and Memory
+
+- Session persistence with JSONL-based storage for cross-session resume
+- Automatic context compaction when conversations approach the model's context window
+- Long-term memory extraction and recall across sessions
+- Instructions file support for persistent project-level guidance
+
+### Skills and Commands
+
+- Skill catalog with three-tier loading: built-in, user-global (~/.swifty/skills/), and project-level (.swifty/skills/)
+- Hot-reload support for skills edited on disk
+- Inline and fork execution modes for skills
+- Slash command system with built-in commands and user-defined commands from .swifty/commands/
+- Skill installation from URLs
+
+### Agent Orchestration
+
+- Subagent spawning with built-in agent types: general-purpose, plan (read-only architect), explore (read-only code explorer)
+- Team coordination with file-based mailboxes and lead/member communication
+- Coordinator mode for managing multi-agent workflows
+- Git worktree isolation for parallel agent tasks
+
+### Hooks
+
+- Event-driven hook engine supporting: session_start, session_end, turn_start, turn_end, pre_send, post_receive, pre_tool_use, post_tool_use, shutdown
+- Hook actions: shell commands, HTTP requests, prompt injection
+- Conditional execution, reject-on-failure, and async options
+
+### Remote Mode
+
+- Koa HTTP server with WebSocket bridge for browser-based access
+- React frontend served at a configurable address
+- Bidirectional message streaming between browser and agent
+
+## Installation
+
+```bash
+npm install -g @swifty.js/swifty
+```
+
+Or run directly from the monorepo:
+
+```bash
+pnpm dev
+```
+
+## Configuration
+
+Swifty reads YAML configuration files from multiple locations, merged in order:
+
+1. ~/.swifty/config.yml or ~/.swifty/config.yaml
+2. .swifty/config.yml or .swifty/config.yaml (project root)
+3. .swifty/config.local.yml or .swifty/config.local.yaml (project root, gitignored)
+
+At least one provider must be configured. Example config.yml:
+
+```yaml
+providers:
+  - name: anthropic
+    protocol: anthropic
+    base_url: https://api.anthropic.com
+    model: claude-sonnet-4-20250514
+    # api_key defaults to $ANTHROPIC_API_KEY
+
+permission_mode: default
+
+mcp_servers:
+  - name: my-server
+    command: npx
+    args: ["-y", "my-mcp-server"]
+
+hooks:
+  - event: pre_tool_use
+    condition: "Bash"
+    action:
+      type: command
+      command: "echo tool about to run"
+
+sandbox:
+  enabled: false
+  auto_allow: false
+  network_enabled: true
+
+enable_coordinator_mode: false
+```
+
+Provider fields:
+
+| Field             | Required | Description                                                          |
+| ----------------- | -------- | -------------------------------------------------------------------- |
+| name              | yes      | Display name for the provider                                        |
+| protocol          | yes      | One of: anthropic, openai, openai-compat                             |
+| base_url          | yes      | API base URL                                                         |
+| model             | yes      | Model identifier                                                     |
+| api_key           | no       | API key (falls back to environment variable)                         |
+| thinking          | no       | Enable extended thinking mode (increases max_output_tokens to 64000) |
+| context_window    | no       | Override auto-detected context window size                           |
+| max_output_tokens | no       | Override default max output tokens                                   |
+
+API keys are resolved in this order: explicit api_key field, then environment variables (ANTHROPIC_API_KEY for anthropic, OPENAI_API_KEY for openai and openai-compat).
+
+## Usage
+
+### Interactive TUI Mode
+
+```bash
+swifty
+```
+
+Launches the terminal interface. If multiple providers are configured, a provider selection screen appears first.
+
+### Print Mode (Non-Interactive)
+
+```bash
+swifty -p "explain this codebase"
+swifty -p "fix the failing test" --output-format stream-json
+```
+
+The -p flag sends a single prompt, runs the agent loop, and prints the result to stdout. Useful for scripting and CI pipelines.
+
+### Remote Mode (Browser UI)
+
+```bash
+swifty --remote            # listens on :18888
+swifty --remote :9000      # custom address
+```
+
+Starts a Koa HTTP server and WebSocket bridge. The bundled React frontend is served at the configured address for browser-based interaction.
+
+### Slash Commands
+
+Inside the TUI, these commands are available:
+
+| Command                 | Description                                                                        |
+| ----------------------- | ---------------------------------------------------------------------------------- |
+| /status                 | Show current session status (model, tokens, tools, sandbox, memories, skills, MCP) |
+| /permission mode <mode> | Change permission mode (default, acceptEdits, plan, bypassPermissions)             |
+| /memory                 | List stored memories                                                               |
+| /memory clear           | Clear all memories                                                                 |
+| /skills                 | List available skills                                                              |
+| /skills reload          | Hot-reload skills from disk                                                        |
+| /skill <name> [args]    | Run a skill by name                                                                |
+| /plan                   | Enter plan mode (read-only investigation)                                          |
+| /do                     | Exit plan mode and execute the approved plan                                       |
+| /compact                | Force conversation compaction                                                      |
+| /clear                  | Reset the session and clear the terminal                                           |
+| /resume [id]            | List or restore a previous session                                                 |
+| /rewind                 | Open checkpoint rewind dialog                                                      |
+| /sandbox [1/2/3]        | Configure sandbox (1=on+auto, 2=on+manual, 3=off)                                  |
+| /worktree               | List git worktrees                                                                 |
+| /mcp                    | Show MCP server status                                                             |
+| /quit                   | Exit the application                                                               |
+
+### Keyboard Shortcuts
+
+| Key       | Action                                                               |
+| --------- | -------------------------------------------------------------------- |
+| Ctrl+C    | Interrupt streaming (first press), exit app (second press within 2s) |
+| Ctrl+O    | Toggle full vs. truncated tool output                                |
+| Ctrl+T    | Toggle Teams dialog overlay                                          |
+| Shift+Tab | Cycle permission modes                                               |

package/dist/agent-MICFDGUF.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createRequire as __swiftyCreateRequire } from "node:module";
+const require = __swiftyCreateRequire(import.meta.url);
+import{q as a}from"./chunk-F6HLYUZ4.js";import"./chunk-FZPTNGTU.js";import"./chunk-4KVSJNS6.js";import"./chunk-MQ5XOYLD.js";import"./chunk-X3UA5OZL.js";export{a as Agent};

package/dist/anthropic-JDAGNAPR.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createRequire as __swiftyCreateRequire } from "node:module";
+const require = __swiftyCreateRequire(import.meta.url);
+import{g as P}from"./chunk-H7VXSMJR.js";import{f as B,h as W,i as R}from"./chunk-RD3MICOU.js";import{b as O,c as j,d as M,e as U,f as $,g as K}from"./chunk-FZPTNGTU.js";import"./chunk-7MHXMDYC.js";import{H as w,J as v,K as S,L as I,M as k,N,e as L,l as E}from"./chunk-4KVSJNS6.js";import"./chunk-MQ5XOYLD.js";import"./chunk-X3UA5OZL.js";var x=L({module:"llm"});var H=3e3,Y=w.object({max_input_tokens:w.coerce.number()});async function ot(n){if(n.protocol!=="anthropic")return 0;let t=R(n),o=`${n.base_url.replace(/\/+$/,"")}/v1/models/${encodeURIComponent(n.model)}`,r=new AbortController,a=setTimeout(()=>{r.abort()},H);try{let l=await fetch(o,{method:"GET",headers:{"anthropic-version":"2023-06-01",...t?{"x-api-key":t}:{}},signal:r.signal});if(!l.ok)return 0;let g=await l.json(),{success:h,error:f,data:d}=await E(Y,g);if(!h)return console.error(f.message),0;let y=d.max_input_tokens;return Math.max(y,0)}catch(l){return console.error(l),0}finally{clearTimeout(a)}}function q(){return!0}function D(n){let t=[];for(let e of n)if(e.role==="assistant"){let o=[];if(e.thinkingBlocks)for(let r of e.thinkingBlocks)o.push({type:"thinking",thinking:r.thinking,signature:r.signature});if(e.content&&o.push({type:"text",text:e.content}),e.toolUses)for(let r of e.toolUses)o.push({type:"tool_use",id:r.toolUseId,name:r.toolName,input:r.arguments});o.length===0&&o.push({type:"text",text:""}),t.push({role:"assistant",content:o})}else if(e.toolResults&&e.toolResults.length>0){let o=[];for(let r of e.toolResults)o.push({type:"tool_result",tool_use_id:r.toolUseId,is_error:r.isError,content:r.content});t.push({role:"user",content:o})}else{if(t.length===0){t.push({role:"user",content:[{type:"text",text:e.content}]});continue}let o=!1,r=t[t.length-1],a=r.content;r.role==="user"&&(typeof a=="string"||Array.isArray(a)&&a.length>0&&a[0].type==="text")&&(o=!0),o?(typeof a=="string"&&(a=r.content=a.trim().length>0?[{type:"text",text:a}]:[]),a.push({type:"text",text:e.content})):t.push({role:"user",content:[{type:"text",text:e.content}]})}return t}var G=class{client;model;thinking;systemPrompt;maxOutputTokens;contextWindow;constructor(t,e){let o=R(t);if(!o)throw new M("Anthropic API key not found, set ANTHROPIC_API_KEY in .swifty/config.y(a)ml, or via ANTHROPIC_API_KEY env variable.");this.client=new P({apiKey:o,baseURL:t.base_url}),this.model=t.model,this.thinking=t.thinking??!0,this.systemPrompt=e,this.maxOutputTokens=W(t),this.contextWindow=B(t)}setSystemPrompt(t){this.systemPrompt=t}setMaxOutputTokens(t){this.maxOutputTokens=t}async*stream(t,e,o){let r=D(O(t.getMessages())),a=e.map(c=>{let p=c.input_schema;return{name:c.name,description:c.description,input_schema:{type:"object",properties:p.properties,required:p.required??[]}}});a.length>0&&(a[a.length-1].cache_control={type:"ephemeral"}),F(r);let l={model:this.model,max_tokens:this.maxOutputTokens,stream:!0,system:[{type:"text",text:this.systemPrompt,cache_control:{type:"ephemeral"}}],messages:r,...a.length>0?{tools:a}:{}};this.thinking?q()&&(l.thinking={type:"enabled",budget_tokens:this.maxOutputTokens-1}):l.thinking={type:"enabled",budget_tokens:this.maxOutputTokens-1};let g=0,h=0,f=0,d=0,y="end_turn",b="",T="",A=!1,C=0;try{let c=this.client.messages.stream(l,{...o?{signal:o}:{}}),p="",_="",u="";for await(let i of c)switch(i.type){case"content_block_start":{let s=i.content_block;s.type==="thinking"?(A=!0,b="",T=""):s.type==="tool_use"&&(_=s.id,p=s.name,u="",yield{type:"tool_call_start",toolName:p,toolId:_});break}case"content_block_delta":{let s=i.delta;s.type==="thinking_delta"?(b+=s.thinking,yield{type:"thinking_delta",text:s.thinking}):s.type==="signature_delta"?(x.debug({signature:s.signature},"thinking signature received"),T=s.signature):s.type==="text_delta"?yield{type:"text_delta",text:s.text}:s.type==="input_json_delta"&&(u+=s.partial_json,yield{type:"tool_call_delta",text:s.partial_json});break}case"content_block_stop":{if(A&&(yield{type:"thinking_complete",thinking:b,signature:T},A=!1),p){let s={};if(u)try{let m=JSON.parse(u);s=S(m)?I(m):{[v]:u}}catch(m){x.error({err:m},"llm operation failed"),s={[v]:u}}yield{type:"tool_call_complete",toolId:_,toolName:p,arguments:s},p="",_="",u=""}break}case"message_delta":{i.delta.stop_reason&&(y=i.delta.stop_reason),i.usage.output_tokens&&(h=i.usage.output_tokens,i.usage.input_tokens&&(g=i.usage.input_tokens),i.usage.cache_read_input_tokens&&(f=i.usage.cache_read_input_tokens),i.usage.cache_creation_input_tokens&&(d=i.usage.cache_creation_input_tokens));break}case"message_start":{C=performance.now(),g=i.message.usage.input_tokens,h=i.message.usage.output_tokens,f=i.message.usage.cache_read_input_tokens??0,d=i.message.usage.cache_creation_input_tokens??0;break}case"message_stop":{let m=performance.now()-C;x.debug({elapsedMs:m},"message stream complete");break}}yield{type:"stream_end",stopReason:y,usage:{inputTokens:g,outputTokens:h,cacheReadInputTokens:f,cacheCreationInputTokens:d}}}catch(c){throw x.error({err:c},"llm operation failed"),J(c)}}};function F(n){for(let t=n.length-1;t>=0;t--){if(n[t].role!=="user")continue;let e=n[t].content;if(typeof e=="string"&&e.length===0||Array.isArray(e)&&e.length===0)return;typeof e=="string"&&(e=n[t].content=[{type:"text",text:e}]);let o=e[e.length-1];Reflect.set(o,"cache_control",{type:"ephemeral"})}}function J(n){if(n instanceof P.APIError){if(n.status===413||/prompts?\s+too\s+long/i.test(n.message))return new K(`Prompt too long: ${n.message}`);if(n.status===401)return new M(`Invalid API key: ${n.message}`);if(n.status===429){let t=I(n.headers)["retry-after"],e="Rate Limited";if(t){let o=Number.parseInt(k(t));Number.isNaN(o)&&(e+=", please wait."),e+=`, retry after ${k(o)}s.`}else e+=", please wait.";return new U(e,t?k(t):void 0)}return new j(`Anthropic API error (${k(n.status)}): ${n.message}`)}return new $(`Network error: ${N(n)}`)}export{G as AnthropicClient,D as buildAnthropicMessages,ot as fetchModelContextWindow};

package/dist/checker-PF3FEOF2.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createRequire as __swiftyCreateRequire } from "node:module";
+const require = __swiftyCreateRequire(import.meta.url);
+import{a,b,c,d}from"./chunk-6ARDOHBL.js";import"./chunk-7MHXMDYC.js";import"./chunk-4KVSJNS6.js";import"./chunk-MQ5XOYLD.js";import"./chunk-X3UA5OZL.js";export{b as PathSandbox,d as PermissionChecker,c as RuleEngine,a as extractContent};