@toothfairyai/tfcode 2.0.0-beta.4 → 2.0.0

package/README.md

@@ -0,0 +1,201 @@
+# TF Code
+
+**ToothFairyAI's AI coding agent** — a command-line interface that brings AI-powered coding assistance to your terminal with deep ToothFairyAI workspace integration.
+
+## Agents
+
+TF Code ships with three built-in agents:
+
+| Agent           | Purpose                       | Key Ability                                                 |
+| --------------- | ----------------------------- | ----------------------------------------------------------- |
+| **Build**       | Execute and implement         | Full read/write access, the default agent                   |
+| **Plan**        | Explore and plan              | Read-only analysis, writes plans to `.tfcode/plans/`        |
+| **TF Engineer** | Manage ToothFairyAI workspace | Exclusive access to live MCP tools for workspace operations |
+
+Switch between them at any time with **Tab** or the `--agent` flag.
+
+## Prerequisites
+
+- **Node.js** 18+
+- A modern terminal emulator (WezTerm, Alacritty, Kitty, Ghostty recommended)
+- ToothFairyAI API credentials (from **Admin → TFCode & API Integration**)
+
+## Install
+
+```
+npm install -g @toothfairyai/tfcode
+```
+
+Verify:
+
+```
+tfcode --version
+```
+
+## Configure
+
+Run the interactive setup to create a profile:
+
+```
+tfcode setup
+```
+
+This prompts for profile name, workspace ID, API key, and region. Alternatively, set environment variables:
+
+```
+export TF_WORKSPACE_ID="your-workspace-id"
+export TF_API_KEY="your-api-key"
+export TF_REGION="au"
+```
+
+Validate:
+
+```
+tfcode validate
+```
+
+## Usage
+
+### Interactive session
+
+```
+tfcode
+```
+
+### Single command
+
+```
+tfcode run "Explain this codebase"
+```
+
+### Plan first, then build
+
+Use **Tab** to switch to Plan mode, describe what you want, then switch back to Build to implement.
+
+1. **Plan** — describe the feature, review the plan
+2. **Build** — switch back and ask it to implement
+
+### Workspace management
+
+```
+tfcode run --agent "TF Engineer" "Create a retriever agent called SupportBot"
+tfcode run --agent "TF Engineer" "Search documents about refund policy"
+```
+
+### Undo changes
+
+```
+/undo
+```
+
+## Profiles
+
+Profiles store multiple sets of ToothFairyAI credentials so you can switch between workspaces instantly.
+
+### Create
+
+```
+tfcode setup
+```
+
+Non-interactive:
+
+```
+tfcode setup --profile dev --workspace-id dev-ws-456 --api-key dev-key-xxx --region dev --name dev
+```
+
+### Switch
+
+```
+tfcode profile prod
+```
+
+### Use in commands
+
+```
+tfcode -p prod run "Deploy to production"
+TF_PROFILE=prod tfcode run "Force prod workspace"
+```
+
+## Regions
+
+| Region | Base URL                 | Streaming URL             |
+| ------ | ------------------------ | ------------------------- |
+| `dev`  | `ai.toothfairylab.link`  | `ais.toothfairylab.link`  |
+| `au`   | `ai.toothfairyai.com`    | `ais.toothfairyai.com`    |
+| `eu`   | `ai.eu.toothfairyai.com` | `ais.eu.toothfairyai.com` |
+| `us`   | `ai.us.toothfairyai.com` | `ais.us.toothfairyai.com` |
+
+## Environment Variables
+
+| Variable                  | Description                                     |
+| ------------------------- | ----------------------------------------------- |
+| `TF_WORKSPACE_ID`         | ToothFairyAI workspace ID                       |
+| `TF_API_KEY`              | ToothFairyAI API key                            |
+| `TF_REGION`               | ToothFairyAI region: dev, au, eu, us            |
+| `TF_PROFILE`              | Profile name to use (overrides default profile) |
+| `TFCODE_SERVER_PASSWORD`  | HTTP basic auth password for server mode        |
+| `TFCODE_SERVER_USERNAME`  | HTTP basic auth username (default: tfcode)      |
+| `OPENCODE_CONFIG`         | Path to custom config file                      |
+| `OPENCODE_CONFIG_CONTENT` | Inline config content (highest priority)        |
+
+## CLI Commands
+
+### Top-level
+
+| Command               | Description                         |
+| --------------------- | ----------------------------------- |
+| `tfcode`              | Start interactive session           |
+| `tfcode run <prompt>` | Execute a single task and exit      |
+| `tfcode serve`        | Start headless HTTP server          |
+| `tfcode web`          | Start server and open web interface |
+| `tfcode attach <url>` | Attach TUI to a running server      |
+
+### Setup & credentials
+
+| Command                    | Description                                            |
+| -------------------------- | ------------------------------------------------------ |
+| `tfcode setup`             | Interactive credential setup (creates a profile)       |
+| `tfcode validate`          | Validate credentials (`--profile <name>` for specific) |
+| `tfcode profile`           | Show current profile and list all                      |
+| `tfcode profile <name>`    | Switch to a different profile                          |
+| `tfcode sync`              | Sync workspace tools metadata                          |
+| `tfcode providers list`    | List available providers                               |
+| `tfcode models [provider]` | List available models (optional provider filter)       |
+| `tfcode models --verbose`  | List models with metadata                              |
+| `tfcode models --refresh`  | Refresh the models cache                               |
+
+### MCP
+
+| Command             | Description                        |
+| ------------------- | ---------------------------------- |
+| `tfcode mcp list`   | List MCP servers and tools         |
+| `tfcode mcp add`    | Add a local MCP server             |
+| `tfcode mcp auth`   | Authenticate with OAuth MCP server |
+| `tfcode mcp logout` | Logout from MCP server             |
+
+### Agents
+
+| Command                                                          | Description                                                                        |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `tfcode agent list`                                              | List available agents                                                              |
+| `tfcode agent create [--description ...]`                        | Generate a new local agent (`.tfcode/agents/<name>.md`)                            |
+| `tfcode agent share <agent> [--force] [--profile p] [--dry-run]` | Upload a local agent (and its referenced skills) to the workspace as a coder agent |
+
+See [docs/agent-share-flow.md](../../docs/agent-share-flow.md) for the full local→cloud agent flow.
+
+### Chat commands (interactive)
+
+| Command                   | Description                             |
+| ------------------------- | --------------------------------------- |
+| `/compact [instructions]` | Compact context with preservation hints |
+| `/help`                   | Show available commands                 |
+| `/undo`                   | Undo last changes                       |
+
+## Documentation
+
+Full documentation at [https://docs.toothfairyai.com/tfcode/intro](https://docs.toothfairyai.com/tfcode/intro)
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toothfairyai/tfcode",
-  "version": "2.0.0-beta.4",
+  "version": "2.0.0",
   "bin": {
     "tfcode": "./bin/tfcode.js"
   },
@@ -9,7 +9,18 @@
   },
   "license": "MIT",
   "optionalDependencies": {
-    "@toothfairyai/tfcode-darwin-arm64": "2.0.0-beta.4"
+    "@toothfairyai/tfcode-linux-arm64": "2.0.0",
+    "@toothfairyai/tfcode-windows-x64": "2.0.0",
+    "@toothfairyai/tfcode-linux-x64-baseline-musl": "2.0.0",
+    "@toothfairyai/tfcode-darwin-x64-baseline": "2.0.0",
+    "@toothfairyai/tfcode-linux-x64-musl": "2.0.0",
+    "@toothfairyai/tfcode-windows-x64-baseline": "2.0.0",
+    "@toothfairyai/tfcode-linux-arm64-musl": "2.0.0",
+    "@toothfairyai/tfcode-windows-arm64": "2.0.0",
+    "@toothfairyai/tfcode-linux-x64": "2.0.0",
+    "@toothfairyai/tfcode-darwin-x64": "2.0.0",
+    "@toothfairyai/tfcode-linux-x64-baseline": "2.0.0",
+    "@toothfairyai/tfcode-darwin-arm64": "2.0.0"
   },
   "engines": {
     "node": ">=18"

package/postinstall.mjs

@@ -82,6 +82,37 @@ async function getVersion() {
   }
 }
 
+// Detect the machine architecture of an existing binary. Returns "arm64",
+// "x64", or null when it can't be determined (null => keep existing binary).
+function detectBinaryMachineArch(binaryPath, platform) {
+  try {
+    if (platform === "win32") {
+      const buf = fs.readFileSync(binaryPath)
+      if (buf.length < 0x40) return null
+      const pe = buf.readUInt32LE(0x3c)
+      if (pe + 6 > buf.length) return null
+      const machine = buf.readUInt16LE(pe + 4)
+      if (machine === 0x8664) return "x64"
+      if (machine === 0xaa64) return "arm64"
+      return null
+    }
+    const out = spawnSync("file", [binaryPath], { encoding: "utf8" }).stdout || ""
+    if (/arm64|aarch64/i.test(out)) return "arm64"
+    if (/x86-64|x86_64/i.test(out)) return "x64"
+    return null
+  } catch {
+    return null
+  }
+}
+
+// A missing/unparseable binary is treated as a match so installs never break
+// when detection isn't possible; a real mismatch forces a re-download.
+function binaryArchMatches(binaryPath, expectedArch, platform) {
+  const actual = detectBinaryMachineArch(binaryPath, platform)
+  if (!actual) return true
+  return actual === expectedArch
+}
+
 async function downloadBinary() {
   const { platform, arch, needsBaseline, abi } = detectPlatform()
   const version = await getVersion()
@@ -91,8 +122,27 @@ async function downloadBinary() {
   const binDir = path.join(__dirname, "bin")
   const existingBinary = path.join(binDir, binaryName)
 
-  if (fs.existsSync(existingBinary)) {
+  if (fs.existsSync(existingBinary) && binaryArchMatches(existingBinary, arch, platform)) {
     console.log(`✓ Binary already exists at ${existingBinary}`)
+    // Still need to copy app dir from platform package if missing
+    const targetAppDir = path.join(binDir, "app")
+    if (!fs.existsSync(path.join(targetAppDir, "dist", "index.html"))) {
+      let target = `tfcode-${platform}-${arch}`
+      if (needsBaseline) target += "-baseline"
+      if (abi) target += `-${abi}`
+      const pkgName = `@toothfairyai/${target}`
+      try {
+        const pkgUrl = import.meta.resolve(`${pkgName}/package.json`)
+        const pkgDir = path.dirname(fileURLToPath(pkgUrl))
+        const srcAppDir = path.join(pkgDir, "bin", "app")
+        if (fs.existsSync(path.join(srcAppDir, "dist", "index.html"))) {
+          fs.cpSync(srcAppDir, targetAppDir, { recursive: true })
+          console.log("✓ Web app copied from platform package")
+        }
+      } catch (e) {
+        console.log(`! Could not copy web app: ${e.message}`)
+      }
+    }
     return
   }
 
@@ -181,6 +231,15 @@ async function downloadBinary() {
     console.log(`Installed tfcode to ${targetBinary}`)
   }
 
+  // Move app directory
+  const extractedAppDir = path.join(tmpDir, "app")
+  const targetAppDir = path.join(binDir, "app")
+  if (fs.existsSync(path.join(extractedAppDir, "dist", "index.html"))) {
+    if (fs.existsSync(targetAppDir)) fs.rmSync(targetAppDir, { recursive: true, force: true })
+    fs.cpSync(extractedAppDir, targetAppDir, { recursive: true })
+    console.log("Installed web app")
+  }
+
   // Cleanup
   fs.rmSync(tmpDir, { recursive: true, force: true })
 }
@@ -202,6 +261,16 @@ function setupBinary(sourcePath, platform) {
 
   fs.chmodSync(targetBinary, 0o755)
   console.log(`tfcode installed to ${targetBinary}`)
+
+  // Also copy app dir from platform package
+  const sourceDir = path.dirname(sourcePath)
+  const srcAppDir = path.join(sourceDir, "app")
+  const targetAppDir = path.join(binDir, "app")
+  if (fs.existsSync(path.join(srcAppDir, "dist", "index.html"))) {
+    if (fs.existsSync(targetAppDir)) fs.rmSync(targetAppDir, { recursive: true, force: true })
+    fs.cpSync(srcAppDir, targetAppDir, { recursive: true })
+    console.log("Web app copied from platform package")
+  }
 }
 
 async function main() {

package/python/tf_sync/config.py

@@ -105,6 +105,7 @@ class TFConfig(BaseModel):
                 base_url=urls["base_url"],
                 ai_url=urls["ai_url"],
                 ai_stream_url=urls["ai_stream_url"],
+                user_agent="tfcode",
             )
         return self._client