@aifight/aifight 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/types/cli/commands/init.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runInit(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/join.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runJoin(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/leave.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runLeave(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/mcp.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runMcp(args: HandlerArgs, _env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/runtime-management.d.ts

@@ -1,18 +0,0 @@
-import type { HandlerEnv } from "../shared";
-export interface ExecResult {
-    readonly code: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-type RuntimeName = "openclaw" | "hermes";
-export declare function findExecutable(name: string): string | undefined;
-export declare function execCommand(command: string, args: readonly string[]): Promise<ExecResult>;
-export declare function writeExecResult(env: HandlerEnv, label: string, result: ExecResult): void;
-export declare function promptYesNo(env: HandlerEnv, question: string): Promise<boolean>;
-export declare function promptYesNoDefaultNo(env: HandlerEnv, question: string): Promise<boolean>;
-export declare function offerGatewayRestart(env: HandlerEnv, runtime: RuntimeName, reason: string, opts?: {
-    readonly approvedLocalSetup?: boolean;
-}): Promise<boolean>;
-export declare function systemdUnitIsActive(result: ExecResult): boolean;
-export declare function hermesRestartUnavailable(result: ExecResult): boolean;
-export {};

package/dist/types/cli/commands/runtime-setup-state.d.ts

@@ -1,21 +0,0 @@
-export interface EnvKeyPrevious {
-    readonly wasActive: boolean;
-    readonly value?: string;
-}
-export interface RuntimeSetupState {
-    readonly version: 1;
-    readonly updatedAt: string;
-    readonly openclaw?: {
-        readonly responsesEnabledByAIFight: boolean;
-        readonly updatedAt: string;
-    };
-    readonly hermes?: {
-        readonly envPath: string;
-        readonly previous: Record<string, EnvKeyPrevious>;
-        readonly updatedAt: string;
-    };
-}
-export declare function getRuntimeSetupStatePath(): string;
-export declare function readRuntimeSetupState(): RuntimeSetupState | undefined;
-export declare function mergeRuntimeSetupState(patch: Omit<Partial<RuntimeSetupState>, "version" | "updatedAt">): void;
-export declare function removeRuntimeSetupState(): void;

package/dist/types/cli/commands/runtime-setup.d.ts

@@ -1,25 +0,0 @@
-import type { BridgeRuntimeType } from "../../bridge/config";
-import type { HandlerEnv } from "../shared";
-export interface RuntimeSetupResult {
-    readonly runtimeLocalToken?: string;
-    readonly blockedReason?: string;
-}
-interface RuntimeSetupOptions {
-    readonly env: HandlerEnv;
-    readonly runtimeType: BridgeRuntimeType;
-    readonly runtimeLocalUrl: string;
-    readonly runtimeLocalToken?: string;
-    readonly runtimeModel?: string;
-    readonly jsonMode: boolean;
-    readonly approvedLocalSetup?: boolean;
-}
-export type ProbeStatus = "ready" | "endpoint_reachable" | "disabled" | "auth_failed" | "unreachable";
-export interface ProbeResult {
-    readonly status: ProbeStatus;
-    readonly detail: string;
-}
-export declare function offerRuntimeSetup(opts: RuntimeSetupOptions): Promise<RuntimeSetupResult>;
-export declare function probeOpenClaw(env: HandlerEnv, baseUrl: string, token?: string, model?: string): Promise<ProbeResult>;
-export declare function probeHermes(env: HandlerEnv, baseUrl: string, token?: string, model?: string): Promise<ProbeResult>;
-export declare function upsertEnvText(existing: string, values: Record<string, string>): string;
-export {};

package/dist/types/cli/commands/serve.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runServe(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/service/launchd.d.ts

@@ -1,71 +0,0 @@
-import type { ServiceTarget } from "./types";
-import { type ServiceExecFile } from "./platform";
-export declare class LaunchdAlreadyInstalledDiffError extends Error {
-    readonly code: "client_already_installed_diff";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class LaunchdNotInstalledError extends Error {
-    readonly code: "client_not_installed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class LaunchdInstallFailedError extends Error {
-    readonly code: "client_install_failed";
-    readonly hint?: string;
-    /** Stage taxonomy distinct from systemd's (which is daemon-reload /
-     *  enable / start). Launchd combines register+start into bootstrap, so
-     *  the natural stages are the prerequisites (log dir + plist write),
-     *  the bootstrap call itself, and the post-bootstrap verify. */
-    readonly stage: "log-dir" | "write-plist" | "bootstrap" | "verify";
-    constructor(stage: LaunchdInstallFailedError["stage"], message: string, hint?: string);
-}
-export declare class LaunchdUninstallFailedError extends Error {
-    readonly code: "client_uninstall_failed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class LaunchdStartFailedError extends Error {
-    readonly code: "client_start_failed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class LaunchdStopFailedError extends Error {
-    readonly code: "client_stop_failed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare function escapeXmlText(s: string): string;
-export declare const LAUNCHD_LABEL = "ai.aifight.runtime";
-export interface LaunchdTargetOptions {
-    /** Absolute path of the resolved `aifight` binary. Step 4
-     *  `resolveAifightExec()` produces this; tests inject any string. */
-    readonly aifightExec: string;
-    /** Absolute path of the plist — typically
-     *  `~/Library/LaunchAgents/ai.aifight.runtime.plist`. Tests inject a
-     *  tmp dir. */
-    readonly plistPath: string;
-    /** Absolute log directory — typically `~/Library/Logs/aifight`.
-     *  Install creates this if missing; uninstall preserves it unless
-     *  `--purge`. */
-    readonly logDir: string;
-    /** AIFIGHT_RUNTIME_HOME baked into the plist EnvironmentVariables. */
-    readonly runtimeHome: string;
-    /** Effective user id for `gui/$UID` selector. Production uses
-     *  `process.getuid?.() ?? 0`; tests inject any integer. */
-    readonly uid: number;
-    /** Factory-time `RunAtLoad` setting (rev3 B4 — see module header for
-     *  the systemd vs launchd asymmetry rationale).
-     *    - true:  plist writes `RunAtLoad=true`; install bootstraps and
-     *      then verifies via `launchctl print` (daemon should be running).
-     *    - false: plist writes `RunAtLoad=false`; install still bootstraps
-     *      (registers LaunchAgent) but does NOT verify (the daemon is
-     *      intentionally idle until `aifight service start` kickstarts
-     *      it). */
-    readonly autoStart: boolean;
-    /** Defaults to `defaultExecFile` (production). Tests pass a mock that
-     *  records calls + returns canned stdout/stderr without spawning a
-     *  real subprocess. */
-    readonly execFile?: ServiceExecFile;
-}
-export declare function createLaunchdTarget(opts: LaunchdTargetOptions): ServiceTarget;

package/dist/types/cli/commands/service/platform.d.ts

@@ -1,69 +0,0 @@
-import type { ServicePlatform } from "./types";
-/** OS-level platform — intermediate value before service-manager probe.
- *  - "linux" / "darwin": candidate for service install; needs probe.
- *  - "unsupported": Windows / FreeBSD / other; short-circuits without probe. */
-export type OsPlatform = "linux" | "darwin" | "unsupported";
-/** Sync, pure, `process.platform`-only OS detection (rev4 B2 + F4 fold).
- *  No I/O, no subprocess. Tests stub `process.platform` via Object.defineProperty. */
-export declare function detectOsPlatform(): OsPlatform;
-/** Result of an injected execFile call. Promise resolves on exit 0;
- *  rejects with `ServiceExecFileError` on ENOENT, non-zero exit, or
- *  any other subprocess error. Mirrors `util.promisify(child_process.execFile)`
- *  semantics so the production default below is a thin adapter. */
-export interface ServiceExecFileResult {
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export interface ServiceExecFileError extends Error {
-    /** Node ErrnoException code, e.g. "ENOENT" when the binary is not in PATH. */
-    readonly code?: string;
-    /** Captured before failure (when the subprocess emitted output then exited
-     *  non-zero). Empty string when no output was captured. */
-    readonly stdout?: string;
-    readonly stderr?: string;
-}
-export type ServiceExecFile = (file: string, args: readonly string[]) => Promise<ServiceExecFileResult>;
-/** Production default — wraps Node `child_process.execFile` with a 2 s
- *  timeout suitable for cheap version probes. Tests pass an explicit mock
- *  so this is never invoked in CI. Exposed so callers (service-install.ts
- *  in Step 4) can reuse it instead of recreating the adapter. */
-export declare const defaultExecFile: ServiceExecFile;
-export interface ProbeServicePlatformOptions {
-    readonly execFile: ServiceExecFile;
-    /** Defaults to `detectOsPlatform()`; tests pass explicit value to avoid
-     *  Object.defineProperty(process, "platform") gymnastics. */
-    readonly osPlatform?: OsPlatform;
-}
-/** Async, injectable, only-read probe.
- *  - osPlatform == "unsupported" → short-circuit `unsupported` (NEVER
- *    invokes execFile). Tests assert this with a spy that throws if called.
- *  - osPlatform == "linux" → `execFile("systemctl", ["--user", "--version"])`.
- *  - osPlatform == "darwin" → `execFile("launchctl", ["version"])`.
- *  - any rejection (ENOENT / non-zero exit / timeout / unexpected throw),
- *    or stdout/stderr containing a known failure marker (e.g.
- *    "Failed to connect to bus" — systemd `--user` not running) → `unsupported`.
- *  - resolution + clean stdout/stderr → corresponding `linux-systemd-user`
- *    or `darwin-launchd-user`. */
-export declare function probeServicePlatform(opts: ProbeServicePlatformOptions): Promise<ServicePlatform>;
-/** rev4 contract — service-specific error class. NOT a `UsageError`,
- *  because plain `UsageError` funnels through `main.ts emitUsageError` and
- *  produces only `client_usage_error`. Service handlers catch
- *  `ServicePlatformError` and call `emitServiceError(env, jsonMode, 2,
- *  e.code, e.message, e.hint)`. */
-export declare class ServicePlatformError extends Error {
-    readonly code: "client_platform_unsupported" | "client_service_manager_missing";
-    readonly hint?: string;
-    constructor(code: ServicePlatformError["code"], message: string, hint?: string);
-}
-export interface EnsureSupportedPlatformOptions extends Partial<ProbeServicePlatformOptions> {
-}
-/** Composes `detectOsPlatform()` + `probeServicePlatform()`.
- *  - Returns the resolved supported platform on success.
- *  - Throws `ServicePlatformError` on unsupported with:
- *      Windows / non-linux + non-darwin → `client_platform_unsupported`
- *        + hint mentioning Windows or "platform <p>".
- *      linux / darwin but service manager unreachable →
- *        `client_service_manager_missing` + hint mentioning systemd `--user`
- *        or launchctl.
- *  Caller handler maps the error via `emitServiceError(... e.code, e.message, e.hint)`. */
-export declare function ensureSupportedPlatform(opts?: EnsureSupportedPlatformOptions): Promise<"linux-systemd-user" | "darwin-launchd-user">;

package/dist/types/cli/commands/service/systemd.d.ts

@@ -1,55 +0,0 @@
-import type { ServiceTarget } from "./types";
-import { type ServiceExecFile } from "./platform";
-export declare class AlreadyInstalledDiffError extends Error {
-    readonly code: "client_already_installed_diff";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class NotInstalledError extends Error {
-    readonly code: "client_not_installed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class InstallFailedError extends Error {
-    readonly code: "client_install_failed";
-    readonly hint?: string;
-    /** Stage the failure happened at — useful for human-mode messages. */
-    readonly stage: "daemon-reload" | "enable" | "start";
-    constructor(stage: InstallFailedError["stage"], message: string, hint?: string);
-}
-export declare class UninstallFailedError extends Error {
-    readonly code: "client_uninstall_failed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class StartFailedError extends Error {
-    readonly code: "client_start_failed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare class StopFailedError extends Error {
-    readonly code: "client_stop_failed";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-export declare function quoteSystemdExecPath(p: string): string;
-export declare const SYSTEMD_UNIT_NAME = "aifight.service";
-export interface SystemdTargetOptions {
-    /** Absolute path of the resolved `aifight` binary. Step 4
-     *  `resolveAifightExec()` produces this; tests inject any string. */
-    readonly aifightExec: string;
-    /** Absolute path of the unit file — typically
-     *  `~/.config/systemd/user/aifight.service`. Tests inject a tmp dir. */
-    readonly unitPath: string;
-    /** AIFIGHT_RUNTIME_HOME baked into the unit. Tests inject any string. */
-    readonly runtimeHome: string;
-    /** Optional `--env-file` absolute path (rev3 B3 — systemd-only).
-     *  Handler validates existence + chmod before passing here; target
-     *  trusts the value. */
-    readonly envFile?: string;
-    /** Defaults to `defaultExecFile` (production). Tests pass a mock that
-     *  records calls + returns canned stdout/stderr without spawning a
-     *  real subprocess. */
-    readonly execFile?: ServiceExecFile;
-}
-export declare function createSystemdTarget(opts: SystemdTargetOptions): ServiceTarget;

package/dist/types/cli/commands/service/types.d.ts

@@ -1,64 +0,0 @@
-/** Service platform identifier — combines OS + service manager.
- *  - "linux-systemd-user": Linux with `systemctl --user` reachable.
- *  - "darwin-launchd-user": macOS with `launchctl` reachable.
- *  - "unsupported": Windows native, Linux without systemd `--user`,
- *    macOS without launchctl, or any other POSIX. */
-export type ServicePlatform = "linux-systemd-user" | "darwin-launchd-user" | "unsupported";
-/** install() options. Passed from `runServiceInstall` handler to the
- *  selected `ServiceTarget` (systemd or launchd).
- *
- *  rev4 contract:
- *    - `autoStart=false` (--no-start) on linux: skip `systemctl start` after enable.
- *    - `autoStart=false` (--no-start) on launchd: plist writes RunAtLoad=false,
- *      still runs `launchctl bootstrap` (registers LaunchAgent) but skips kickstart.
- *    - `printOnly=true` (--print): generator emits unit/plist text to stdout,
- *      writes nothing, runs no systemctl/launchctl. exit 0.
- *    - `envFile` is systemd-only; darwin handlers exit 2 with
- *      `client_env_file_unsupported_on_darwin` BEFORE createLaunchdTarget. */
-export interface ServiceInstallOptions {
-    readonly autoStart: boolean;
-    readonly printOnly: boolean;
-    readonly envFile?: string;
-}
-/** uninstall() options. */
-export interface ServiceUninstallOptions {
-    /** When true, also `rm -rf $AIFIGHT_RUNTIME_HOME` after stop+disable+removing
-     *  unit/plist (拍板点 #8). Plain `--purge` flag is the user's destructive
-     *  opt-in; handler prints a warning line in human mode but does NOT prompt. */
-    readonly purge: boolean;
-}
-/** status() result — three-state contract (拍板点 #6). */
-export type ServiceStatus = {
-    kind: "not_installed";
-} | {
-    kind: "stopped";
-    /** Optional sub-status from the underlying service manager:
-     *  - systemd: `is-active` raw output (`inactive` / `failed` / `activating` / ...)
-     *  - launchd: parsed state (`waiting` / `unknown` / ...) */
-    substatus?: string;
-} | {
-    kind: "running";
-    /** systemd: parsed `MainPID`; launchd: parsed `pid`.
-     *  Best-effort; absent when parser fails (Open Question #6). */
-    pid?: number;
-    /** systemd: parsed `ActiveEnterTimestamp`; launchd: not always available.
-     *  ISO 8601 string when present. */
-    since?: string;
-};
-/** Common shape for systemd + launchd targets. The handlers in
- *  `service-install.ts` consume this interface; both target factories
- *  (`createSystemdTarget` + `createLaunchdTarget`) return implementations. */
-export interface ServiceTarget {
-    /** Absolute path of the generated unit/plist:
-     *  - systemd: `~/.config/systemd/user/aifight.service`
-     *  - launchd: `~/Library/LaunchAgents/ai.aifight.runtime.plist` */
-    readonly unitPath: string;
-    /** Pure — produces the unit/plist text. Used for `--print` dry-run +
-     *  snapshot tests + diff detection on existing files. */
-    generate(): string;
-    install(opts: ServiceInstallOptions): Promise<void>;
-    uninstall(opts: ServiceUninstallOptions): Promise<void>;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    status(): Promise<ServiceStatus>;
-}

package/dist/types/cli/commands/service-install.d.ts

@@ -1,29 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-import { type OsPlatform, type ServiceExecFile } from "./service/platform";
-export type ServiceErrorCode = "client_unsupported_flag" | "client_platform_unsupported" | "client_service_manager_missing" | "client_env_file_missing" | "client_env_file_unsupported_on_darwin" | "client_already_installed_diff" | "client_not_installed" | "client_aifight_exec_unresolved" | "client_install_failed" | "client_uninstall_failed" | "client_start_failed" | "client_stop_failed";
-export declare function emitServiceError(env: HandlerEnv, jsonMode: boolean, exitCode: number, code: ServiceErrorCode, humanMessage: string, hint?: string): number;
-export declare function resolveAifightExec(candidate: string | undefined, execFile: ServiceExecFile): Promise<string>;
-export interface ServiceDeps {
-    /** ExecFile injection for tests. Defaults to `defaultExecFile`. */
-    readonly execFile?: ServiceExecFile;
-    /** Pre-resolved aifight binary path. When provided, the install
-     *  handler skips `resolveAifightExec(process.argv[1], ...)` —
-     *  necessary in tests because `process.argv[1]` typically points at
-     *  the vitest worker, not a real aifight binary. */
-    readonly aifightExec?: string;
-    /** OS platform override for tests. Defaults to `detectOsPlatform()`. */
-    readonly osPlatform?: OsPlatform;
-    /** Effective UID for `gui/$UID` selector on darwin. Defaults to
-     *  `process.getuid?.() ?? 0`. */
-    readonly uid?: number;
-    /** Path overrides — production picks under `~`. Tests inject tmp dirs. */
-    readonly systemdUnitPath?: string;
-    readonly launchdPlistPath?: string;
-    readonly launchdLogDir?: string;
-    readonly runtimeHome?: string;
-}
-export declare function runServiceInstall(args: HandlerArgs, env: HandlerEnv, deps?: ServiceDeps): Promise<number>;
-export declare function runServiceUninstall(args: HandlerArgs, env: HandlerEnv, deps?: ServiceDeps): Promise<number>;
-export declare function runServiceStart(args: HandlerArgs, env: HandlerEnv, deps?: ServiceDeps): Promise<number>;
-export declare function runServiceStop(args: HandlerArgs, env: HandlerEnv, deps?: ServiceDeps): Promise<number>;
-export declare function runServiceStatus(args: HandlerArgs, env: HandlerEnv, deps?: ServiceDeps): Promise<number>;

package/dist/types/cli/commands/setup.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runSetup(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/shutdown.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runShutdown(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/commands/stubs.d.ts

@@ -1,24 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-interface PureStubOptions {
-    /** User-visible canonical name, e.g. "setup" / "service install" / "results". */
-    readonly command: string;
-    readonly arityMin: number;
-    readonly arityMax: number;
-    readonly usage: string;
-    /** Tier B carries milestone (e.g. "M1-18 daemon lifecycle"); Tier C omits. */
-    readonly milestone?: string;
-}
-/** Factory that returns a Tier B / Tier C stub handler. */
-export declare function pureStub(opts: PureStubOptions): (args: HandlerArgs, env: HandlerEnv) => Promise<number>;
-export declare function tierBStub(command: string, milestone: string, arity?: {
-    readonly min: number;
-    readonly max: number;
-}, usage?: string): (args: HandlerArgs, env: HandlerEnv) => Promise<number>;
-export declare function tierCStub(command: string, arity?: {
-    readonly min: number;
-    readonly max: number;
-}, usage?: string): (args: HandlerArgs, env: HandlerEnv) => Promise<number>;
-export declare function runAgentAdd(args: HandlerArgs, env: HandlerEnv): Promise<number>;
-export declare function runAgentRemove(args: HandlerArgs, env: HandlerEnv): Promise<number>;
-export declare function doctorFixSkillOverrideStub(): (args: HandlerArgs, env: HandlerEnv) => Promise<number>;
-export {};

package/dist/types/cli/commands/version.d.ts

@@ -1,2 +0,0 @@
-import type { HandlerArgs, HandlerEnv } from "../shared";
-export declare function runVersion(args: HandlerArgs, env: HandlerEnv): Promise<number>;

package/dist/types/cli/control-client.d.ts

@@ -1,59 +0,0 @@
-export type ControlErrorCodeLocal = "unauthorized" | "not_found" | "method_not_allowed" | "bad_request" | "unsupported_media_type" | "payload_too_large" | "not_implemented" | "service_unavailable" | "internal_error";
-export declare function isControlErrorCode(x: unknown): x is ControlErrorCodeLocal;
-export interface ControlErrorBodyLocal {
-    readonly error: {
-        readonly code: ControlErrorCodeLocal;
-        readonly message: string;
-        readonly details?: Readonly<Record<string, unknown>>;
-    };
-}
-export declare function isControlErrorBody(x: unknown): x is ControlErrorBodyLocal;
-export type ControlClientErrorKind = "daemon_unreachable" | "runtime_files_corrupt" | "auth_failed" | "request_timeout" | "server_error" | "transport_unparseable";
-export interface ControlClientErrorInit {
-    readonly serverCode?: ControlErrorCodeLocal;
-    readonly status?: number;
-    readonly body?: unknown;
-    readonly cause?: unknown;
-}
-export declare class ControlClientError extends Error {
-    readonly name = "ControlClientError";
-    readonly kind: ControlClientErrorKind;
-    readonly serverCode?: ControlErrorCodeLocal;
-    readonly status: number;
-    readonly body?: unknown;
-    readonly cause?: unknown;
-    constructor(kind: ControlClientErrorKind, message: string, init?: ControlClientErrorInit);
-}
-export interface ControlClient {
-    /** GET <path>. Returns parsed JSON body. 4xx/5xx → throw ControlClientError. */
-    get<T = unknown>(path: string): Promise<T>;
-    /** POST <path> with body.
-     *  - body === undefined → no Content-Type / no payload (use this for
-     *    /shutdown, /pause, /resume, /leave).
-     *  - body === null → Content-Type: application/json + literal "null".
-     *  - object → Content-Type: application/json + JSON.stringify. */
-    post<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /** DELETE <path>. */
-    delete<T = unknown>(path: string): Promise<T>;
-}
-export interface CreateControlClientOptions {
-    /** Sync, lazy — invoked at the moment of each request, NOT at client
-     *  construction. Construction MUST succeed even if the source would
-     *  throw, so bridge-independent commands (version / --help / doctor)
-     *  can construct a client without a running Bridge. */
-    readonly tokenSource: () => string;
-    /** Same lazy semantics + same wrap-at-boundary contract as tokenSource. */
-    readonly portSource: () => number;
-    /** Default "127.0.0.1". */
-    readonly host?: string;
-    /** Per-request timeout. Default 10000 ms. */
-    readonly baseTimeoutMs?: number;
-    /** Injectable for tests. Default globalThis.fetch. */
-    readonly fetchImpl?: typeof fetch;
-    /** Optional log hook (rebootstrap reason etc.). MUST NOT receive token. */
-    readonly onLog?: (event: {
-        code: string;
-        message: string;
-    }) => void;
-}
-export declare function createControlClient(opts: CreateControlClientOptions): ControlClient;

package/dist/types/cli/format.d.ts

@@ -1,52 +0,0 @@
-/** Minimal duck-type of M1-16 SanitizedAgentSnapshot we render. */
-interface AgentSnapshotLike {
-    readonly name: string;
-    readonly started: boolean;
-    readonly stopped: boolean;
-    readonly transport?: string;
-    readonly state: AgentStateLike | null;
-}
-interface AgentStateLike {
-    readonly phase?: string;
-    readonly agentId?: string;
-    readonly agentName?: string;
-    readonly availableGames?: readonly string[];
-    readonly autoConfirmMatches?: boolean;
-    readonly queue?: {
-        readonly game: string;
-        readonly mode: string;
-    };
-    readonly activeMatch?: {
-        readonly sessionId: string;
-        readonly game: string;
-        readonly startedAt: number;
-    };
-}
-interface DailyScheduleConfigLike {
-    readonly enabled: boolean;
-    readonly timezone: string;
-    readonly minIntervalSec?: number;
-    readonly days: Readonly<Record<string, {
-        readonly count: number;
-    }>>;
-}
-export declare function formatAgentTable(agents: readonly AgentSnapshotLike[]): string;
-export declare function formatAgentStatus(agent: AgentSnapshotLike): string;
-interface ScheduleSnapshotLike {
-    readonly running: boolean;
-    /** YYYY-MM-DD local date (M1-15 DailySchedulerSnapshot.today) or null
-     *  when scheduler has not yet computed the boundary. */
-    readonly today?: string | null;
-    readonly remaining?: Readonly<Record<string, number>>;
-    readonly nextFireInMs?: number | null;
-    readonly lastAttempt?: {
-        readonly outcome?: string;
-        readonly game?: string | null;
-        readonly atMs?: number;
-    } | null;
-}
-export declare function formatScheduleShow(cfg: DailyScheduleConfigLike | null, snap: ScheduleSnapshotLike): string;
-/** Compose a JSON-mode error envelope. Used by main.ts error funnel and
- *  by handlers that surface a usage error in JSON mode. */
-export declare function jsonErrorEnvelope(code: string, message: string, details?: Readonly<Record<string, unknown>>): string;
-export {};

package/dist/types/cli/main.d.ts

@@ -1,18 +0,0 @@
-import type { HelloResult } from "../index";
-import type { BridgeServiceDeps } from "../bridge/service";
-export interface RunOptions {
-    readonly stdout?: (s: string) => void;
-    readonly stderr?: (s: string) => void;
-    /** Override for M1-01 hello() (used by doctor schemas check). */
-    readonly hello?: () => HelloResult;
-    /** Override fetch (used by tests). */
-    readonly fetchImpl?: typeof fetch;
-    /** Reserved for injected command handlers that need a shorter network timeout. */
-    readonly baseTimeoutMs?: number;
-    readonly onLog?: (event: {
-        code: string;
-        message: string;
-    }) => void;
-    readonly bridgeService?: BridgeServiceDeps;
-}
-export declare function run(argv: readonly string[], opts?: RunOptions): Promise<number>;

package/dist/types/cli/runtime-files.d.ts

@@ -1,11 +0,0 @@
-export type RuntimeFilesErrorKind = "token_missing" | "port_missing" | "token_corrupt" | "port_corrupt";
-export declare class RuntimeFilesError extends Error {
-    readonly name = "RuntimeFilesError";
-    readonly kind: RuntimeFilesErrorKind;
-    readonly filePath: string;
-    constructor(kind: RuntimeFilesErrorKind, filePath: string, message: string);
-}
-export declare function tokenFilePath(): string;
-export declare function portFilePath(): string;
-export declare function readToken(): string;
-export declare function readPort(): number;

package/dist/types/cli/shared.d.ts

@@ -1,74 +0,0 @@
-import type { ControlClient, CreateControlClientOptions } from "./control-client";
-import type { HelloResult } from "../index";
-import type { BridgeServiceDeps } from "../bridge/service";
-/** Per-handler injectable environment. Defaults wired to process I/O +
- *  real fs + native fetch. Tests pass overrides for stdout/stderr capture
- *  + hello stub + fetchImpl pointing at a temporary M1-16 server. */
-export interface HandlerEnv {
-    readonly stdout: (s: string) => void;
-    readonly stderr: (s: string) => void;
-    /** Override for the M1-01 schemas/types self-test used by `doctor`.
-     *  Default: real `hello` from runtime/src/index.ts (lazy-imported by
-     *  the doctor handler so other commands do not pull in the
-     *  schemas-loading cost). */
-    readonly hello?: () => HelloResult;
-    /** Override fetch implementation for tests. Default globalThis.fetch. */
-    readonly fetchImpl?: typeof fetch;
-    /** Optional rebootstrap log hook (forwarded to control-client). */
-    readonly onLog?: (event: {
-        code: string;
-        message: string;
-    }) => void;
-    /** Default 10000 ms per Step 2b directive (must not drop below ~3000
-     *  for normal commands). doctor uses its own 3000 ms one-shot fetch. */
-    readonly baseTimeoutMs?: number;
-    /** Optional bridge service manager overrides for tests and controlled installs. */
-    readonly bridgeService?: BridgeServiceDeps;
-}
-export interface HandlerArgs {
-    /** Positional argv with the command (and subcommand for `agent`/`daily`)
-     *  already stripped by the dispatcher in main.ts. */
-    readonly positional: readonly string[];
-    /** All globally-known flags merged from the single argv pass. */
-    readonly flags: Readonly<Record<string, string | number | boolean>>;
-    /** True when `--json` was set (any position — floating flag, rev2 fix #1). */
-    readonly jsonMode: boolean;
-}
-/** Build a controlClient that lazily reads token+port from the daemon
- *  files. version / doctor / Tier B/C stubs do NOT call this. */
-export declare function makeClient(env: HandlerEnv, extra?: Partial<CreateControlClientOptions>): ControlClient;
-/** Centralised game enum for client-side validation (Risks #11 — CLI
- *  hard-codes the supported list rather than fetching from server, so a
- *  contract drift surfaces as a usage error rather than a daemon round
- *  trip). */
-export declare const SUPPORTED_GAMES: ReadonlyArray<string>;
-export declare function isSupportedGame(g: string): boolean;
-/** Class for argv-parser-style usage errors that should map to exit 2.
- *  Distinct from AgentResolverError (which uses its own kind discriminator). */
-export declare class UsageError extends Error {
-    readonly name = "UsageError";
-    readonly hint?: string;
-    constructor(message: string, hint?: string);
-}
-/** Expected runtime/API failures that should be shown as ordinary command
- * errors (exit 1), not catchall programmer failures (exit 99). */
-export declare class CommandError extends Error {
-    readonly name = "CommandError";
-    readonly code: string;
-    readonly exitCode: number;
-    readonly hint?: string;
-    constructor(code: string, message: string, opts?: {
-        readonly exitCode?: number;
-        readonly hint?: string;
-    });
-}
-/** Step 3b — assert positional arity at the top of every handler BEFORE
- *  any side-effect (controlClient / network / fs). Extra positionals
- *  must NOT silently fall through to a successful POST (e.g.
- *  `aifight shutdown anything` previously still POSTed /v1/shutdown).
- *
- *  Throws UsageError → main.ts funnel maps to exit 2 + usage hint.
- *  No-args handlers call `expectArity(args, 0, 0, "...")`;
- *  optional-arg handlers (e.g. agent status [<name>]) use min=0 max=1;
- *  fixed-arity handlers (e.g. daily set <game> <count>) use min=max=N. */
-export declare function expectArity(args: HandlerArgs, min: number, max: number, usage: string): void;