gigabuddy 0.7.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gigabuddy",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Command-line sign-in for Gigabuddy. Authenticates your machine and configures npm for @gigabuddy packages.",
   "type": "module",
   "license": "MIT",

package/src/lib/commands.d.ts

@@ -41,6 +41,19 @@ export declare function loginCommand(env: Env, options?: {
  * proves who you are.
  */
 export declare function npmLoginCommand(env: Env, account?: string): Promise<void>;
+/**
+ * `gigabuddy login --npm --renew` — keep an EXISTING npm credential alive.
+ *
+ * npm can only send a fixed token, so the ~30-day registry credential can't
+ * refresh itself; this re-mints it from the live sign-in once it is within
+ * a week of expiring (or already expired). The agent runs it in the background
+ * at startup, so nobody has to notice the 30 days.
+ *
+ * Never signs in, never prompts, and never ADDS npm access: no sign-in or no
+ * credential in `.npmrc` (the user never opted in) means nothing to do.
+ * Silent unless it renewed something or failed.
+ */
+export declare function npmRenewCommand(env: Env, account?: string, now?: number): Promise<void>;
 export declare function npmLogoutCommand(env: Env, account?: string): void;
 export declare function logoutCommand(env: Env, account?: string): Promise<void>;
 /**
@@ -49,23 +62,45 @@ export declare function logoutCommand(env: Env, account?: string): Promise<void>
  * Exits non-zero when it found something wrong, so CI can gate on it.
  */
 export declare function doctorCommand(env: Env, packageName?: string): Promise<void>;
+export type Harness = 'claude' | 'codex';
+export declare const HARNESSES: readonly Harness[];
 export interface SetupRunner {
+    /** Whether this harness's CLI is on this machine. */
+    has(harness: Harness): boolean;
     /** Run `claude <args>` with output flowing straight to the user. Returns the
      * exit code, or 'missing' when there is no `claude` binary to run. */
     runClaude(args: string[]): number | 'missing';
+    /** Same for `codex`. */
+    runCodex(args: string[]): number | 'missing';
+    /** The Codex version (`0.160.0`), or null when there is no Codex or it doesn't say. */
+    codexVersion(): string | null;
+    /** `npm install -g @gigabuddy/agent@latest`, output to the user. Returns the exit code. */
+    installAgent(): number;
+    /** `gigabuddy-agent warm` (caches the door's tool menu). Exit code, or 'missing' when not on PATH. */
+    warmAgent(): number | 'missing';
 }
 /**
- * `gigabuddy setup` — put Gigabuddy into Claude Code without the user knowing
- * the /plugin incantations. Shells out to Claude Code's own headless plugin
- * commands (`claude plugin marketplace add` / `claude plugin install`) rather
- * than editing ~/.claude by hand: those commands are the supported surface, and
- * `marketplace add` is idempotent, so re-running setup just refreshes.
+ * The oldest Codex the plugin works in. Its prompt hook is an `mcp_tool` hook
+ * (it must reach the thread's own agent, which a `command` hook can't), and
+ * Codex parses those from 0.148.0. Older Codex rejects the plugin's whole
+ * hooks file: "unknown variant `mcp_tool`, expected one of `command`,
+ * `prompt`, `agent`" (checked against the released binaries, 2026-10-03).
+ */
+export declare const MIN_CODEX_VERSION = "0.148.0";
+/** True when `version` is at least `min` (dotted numbers; pre-release tags ignored). */
+export declare function versionAtLeast(version: string, min: string): boolean;
+/**
+ * `gigabuddy setup [claude|codex]` — put Gigabuddy into a coding agent without
+ * the user knowing the plugin incantations. With no harness named, sets up
+ * every one it finds on this machine. Shells out to each harness's own headless
+ * plugin commands rather than editing its config by hand: those commands are
+ * the supported surface, and re-running setup just refreshes.
  *
  * This stays within the client's "no tool implementations" rule — it installs
  * the AGENT client's delivery vehicle, it does not become it. The agent
  * custodies its own credential; our sign-in is neither needed nor offered here.
  */
-export declare function setupCommand(runner?: SetupRunner): void;
+export declare function setupCommand(harness?: Harness, runner?: SetupRunner): void;
 export interface UpdateRunner {
     /** The latest published version on npm, or null when it can't be read. */
     latestVersion(): string | null;
@@ -73,13 +108,17 @@ export interface UpdateRunner {
     installLatest(): number;
     /** Re-run the idempotent plugin refresh. Returns exit code, or 'missing' with no claude binary. */
     refreshPlugin(): number | 'missing';
+    /** Refresh the Codex marketplace and reinstall the plugin. Exit code, or 'missing' when Codex or its Gigabuddy marketplace isn't set up. */
+    refreshCodexPlugin(): number | 'missing';
+    /** Reinstall `@gigabuddy/agent@latest` if it is installed globally. Exit code, or 'not-installed'. */
+    updateAgent(): number | 'not-installed';
 }
 /**
  * `gigabuddy update` — bring everything gigabuddy on this machine current.
- * Doctor DIAGNOSES and never mutates; this is the verb that acts. There are
- * only two things to act on: this CLI (npm global) and the Claude Code plugin
- * shell (idempotent marketplace refresh). The agent server needs nothing —
- * the plugin launches `@gigabuddy/agent@latest` via npx, so it updates itself.
+ * Doctor DIAGNOSES and never mutates; this is the verb that acts: this CLI
+ * (npm global), the Claude Code and Codex plugin shells (marketplace refresh),
+ * and the installed agent the Codex plugin launches. The Claude plugin runs
+ * the agent through `npx @latest`, so that copy needs nothing.
  */
 export declare function updateCommand(current: string, runner?: UpdateRunner): Promise<void>;
 export declare function statusCommand(account?: string): Promise<void>;