typeclaw 0.11.1 → 0.12.0

package/README.md

@@ -1,7 +1,7 @@
 # TypeClaw
 
 <p align="center">
-  <img src="./docs/public/typeey.png" alt="Typeey, the TypeClaw mascot — a plush bird with navy wings sitting in grass" width="240" />
+  <img src="./docs/public/typeclaw.png" alt="TypeClaw logo" width="240" />
 </p>
 
 > A TypeScript-native, Bun-powered, Docker-friendly general-purpose agent runtime.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typeclaw",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "homepage": "https://github.com/typeclaw/typeclaw#readme",
   "bugs": {
     "url": "https://github.com/typeclaw/typeclaw/issues"

package/src/cli/builtins.ts

@@ -23,6 +23,7 @@ export const BUILTIN_COMMAND_NAMES = [
   'model',
   'doctor',
   'usage',
+  'update',
   '_hostd',
 ] as const
 

package/src/cli/index.ts

@@ -33,6 +33,7 @@ const main = defineCommand({
     model: () => import('./model').then((m) => m.modelCommand),
     doctor: () => import('./doctor').then((m) => m.doctorCommand),
     usage: () => import('./usage').then((m) => m.usageCommand),
+    update: () => import('./update').then((m) => m.updateCommand),
     _hostd: () => import('./hostd').then((m) => m.hostdCommand),
   },
 })

package/src/cli/update.ts

@@ -0,0 +1,82 @@
+import { defineCommand } from 'citty'
+
+import { formatCommand, planSelfUpdate, type UpdateManagerSelection } from '@/update'
+
+import { c, errorLine, successLine } from './ui'
+
+const MANAGERS = ['auto', 'bun', 'npm', 'pnpm', 'yarn'] as const
+
+export const updateCommand = defineCommand({
+  meta: {
+    name: 'update',
+    description: 'update the globally installed typeclaw CLI',
+  },
+  args: {
+    manager: {
+      type: 'string',
+      description: 'package manager to use: auto, bun, npm, pnpm, or yarn',
+      default: 'auto',
+    },
+    'dry-run': {
+      type: 'boolean',
+      description: 'print the update command without running it',
+      default: false,
+    },
+  },
+  async run({ args }) {
+    const manager = parseManager(args.manager)
+    if (manager === null) {
+      console.error(errorLine(`Invalid --manager=${args.manager}. Expected auto, bun, npm, pnpm, or yarn.`))
+      process.exit(2)
+    }
+
+    const plan = planSelfUpdate({ manager })
+    if (!plan.ok) {
+      console.error(errorLine(plan.reason))
+      process.exit(1)
+    }
+
+    const rendered = formatCommand(plan.command)
+    if (args['dry-run']) {
+      process.stdout.write(`${rendered}\n`)
+      return
+    }
+
+    process.stdout.write(`${c.cyan('Updating TypeClaw with:')} ${rendered}\n`)
+    const exitCode = await runUpdateCommand(plan.command)
+    if (exitCode !== 0) {
+      console.error(errorLine(`Update command exited with code ${exitCode}.`))
+      process.exit(exitCode)
+    }
+    process.stdout.write(`${successLine('TypeClaw update command completed.')}\n`)
+    process.stdout.write(`${c.dim('Restart running agent containers to pick up the new CLI runtime.')}\n`)
+  },
+})
+
+function parseManager(value: string | undefined): UpdateManagerSelection | null {
+  if (value === undefined) return 'auto'
+  return (MANAGERS as readonly string[]).includes(value) ? (value as UpdateManagerSelection) : null
+}
+
+async function runUpdateCommand(command: string[]): Promise<number> {
+  const bun = (globalThis as { Bun?: { spawn: typeof Bun.spawn } }).Bun
+  if (!bun) {
+    console.error(errorLine('bun runtime not available'))
+    return 1
+  }
+  try {
+    const proc = bun.spawn({
+      cmd: command,
+      stdin: 'inherit',
+      stdout: 'inherit',
+      stderr: 'inherit',
+    })
+    return await proc.exited
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException)?.code === 'ENOENT') {
+      console.error(errorLine(`${command[0]} not found in $PATH.`))
+      return 127
+    }
+    throw error
+  }
+}

package/src/update/index.ts

@@ -0,0 +1,86 @@
+import { join } from 'node:path'
+
+export type UpdateManager = 'bun' | 'npm' | 'pnpm' | 'yarn'
+export type UpdateManagerSelection = 'auto' | UpdateManager
+
+export type SelfUpdatePlan =
+  | { ok: true; manager: UpdateManager; command: string[]; detectedFrom: string }
+  | { ok: false; reason: string }
+
+export function resolveSelfPackageJsonPath(): string {
+  return join(import.meta.dir, '..', '..', 'package.json')
+}
+
+export function planSelfUpdate(options: { manager: UpdateManagerSelection; packageJsonPath?: string }): SelfUpdatePlan {
+  const packageJsonPath = options.packageJsonPath ?? resolveSelfPackageJsonPath()
+  const manager = options.manager === 'auto' ? detectInstallManager(packageJsonPath) : options.manager
+  if (manager === null) {
+    return {
+      ok: false,
+      reason:
+        'Cannot auto-detect how TypeClaw was installed from this checkout. Re-run with --manager=bun, --manager=npm, --manager=pnpm, or --manager=yarn if you want to update a global install.',
+    }
+  }
+  return {
+    ok: true,
+    manager,
+    command: commandForManager(manager),
+    detectedFrom: packageJsonPath,
+  }
+}
+
+export function commandForManager(manager: UpdateManager): string[] {
+  switch (manager) {
+    case 'bun':
+      return ['bun', 'update', '-g', 'typeclaw', '--latest']
+    case 'npm':
+      return ['npm', 'install', '-g', 'typeclaw@latest']
+    case 'pnpm':
+      return ['pnpm', 'add', '-g', 'typeclaw@latest']
+    case 'yarn':
+      return ['yarn', 'global', 'upgrade', 'typeclaw', '--latest']
+  }
+}
+
+export function formatCommand(command: readonly string[]): string {
+  return command.map(shellQuote).join(' ')
+}
+
+function detectInstallManager(packageJsonPath: string): UpdateManager | null {
+  const parts = packageJsonPath.split(/[\\/]+/).filter(Boolean)
+  const packageJson = parts[parts.length - 1]
+  const packageName = parts[parts.length - 2]
+  const nodeModulesIdx = parts.lastIndexOf('node_modules')
+  if (packageJson !== 'package.json' || packageName !== 'typeclaw' || nodeModulesIdx === -1) return null
+
+  // Bun global: .bun/install/global/node_modules/typeclaw
+  const bunGlobalIdx = parts.lastIndexOf('.bun')
+  if (
+    bunGlobalIdx !== -1 &&
+    parts[bunGlobalIdx + 1] === 'install' &&
+    parts[bunGlobalIdx + 2] === 'global' &&
+    parts[bunGlobalIdx + 3] === 'node_modules'
+  ) {
+    return 'bun'
+  }
+
+  // pnpm shards globals under a numeric major-version segment, e.g.
+  // ~/Library/pnpm/global/5/node_modules or legacy ~/.pnpm-global/5/node_modules.
+  if (nodeModulesIdx >= 2 && /^\d+$/.test(parts[nodeModulesIdx - 1] ?? '')) {
+    const anchor = parts[nodeModulesIdx - 2]
+    if (anchor === 'pnpm-global' || anchor === '.pnpm-global') return 'pnpm'
+    if (anchor === 'global' && parts[nodeModulesIdx - 3] === 'pnpm') return 'pnpm'
+  }
+
+  if (nodeModulesIdx >= 2 && parts[nodeModulesIdx - 1] === 'global' && parts[nodeModulesIdx - 2] === 'yarn') {
+    return 'yarn'
+  }
+
+  if (parts[nodeModulesIdx - 1] === 'lib') return 'npm'
+  return null
+}
+
+function shellQuote(arg: string): string {
+  if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(arg)) return arg
+  return `'${arg.replaceAll("'", "'\\''")}'`
+}