@indigoai-us/hq-cli 5.312.2-beta.0 → 5.314.0

package/dist/commands/bot.d.ts

@@ -1,278 +0,0 @@
-import { Command } from "commander";
-import { type RuntimeSignInIssue } from "../lib/bot/runtime-sign-in.js";
-import { type BotLocalConfig, type MyLocalBot, type BotKind, type BotMemoryMode, type BotNotRunnableReason, type BotConfig, type BotRuntimeId, type LaunchctlExec } from "../lib/bot/index.js";
-/** Real launchctl; every failure is a non-ok result, never a throw. */
-export declare const defaultLaunchctl: LaunchctlExec;
-/** The desktop app creates HQ's setup bot under this name, always from the `setup` worker. */
-export declare const RESERVED_SETUP_BOT_NAME = "setup";
-export interface BotRow {
-    name: string;
-    agentUid: string;
-    ownerUid: string;
-    runtime: BotRuntimeId;
-    model?: string;
-    /** Thinking level the bot runs with (its setting, or the default). */
-    effort: string;
-    /** True when no thinking level was picked (running the default). */
-    effortIsDefault: boolean;
-    state: string;
-    pid: number | null;
-    processAlive: boolean;
-    hosting: "local" | "cloud";
-    promotionHold?: {
-        companyUid: string | null;
-    } | null;
-    online: boolean | null;
-    lastHeartbeatAt: string | null;
-    lastHeartbeatOk: boolean | null;
-    lastInboxPollAt: string | null;
-    lastInboxPollOk: boolean | null;
-    /**
-     * The bot is mid-turn right now: it has taken a message and has not finished
-     * answering. Read from the bot's own in-flight marker on this machine, so it
-     * is true even while the model is still thinking and nothing has been posted
-     * yet. Surfaces are what show "thinking"; a progress post in the middle of a
-     * turn does not end it.
-     */
-    busy: boolean;
-    /** When the oldest turn still in flight started (ISO), else null. */
-    busySince: string | null;
-    /** Present while the coding tool needs a new sign-in before the bot can work. */
-    runtimeSignIn: RuntimeSignInIssue | null;
-    daemonInstalled: boolean;
-    daemonLoaded: boolean;
-    /**
-     * The startup agent's node binary is gone (a node upgrade removed the
-     * versioned path it names), so launchd cannot start the bot. Null when fine.
-     */
-    daemonNodeMissing: string | null;
-    dir: string;
-    introSentAt?: string;
-    /** "personal" acts as its owner everywhere; "company" acts as itself. */
-    kind: BotKind;
-    /** Company bots: the companies the bot is a member of (empty for a personal bot). */
-    companies: string[];
-    workerSource: "scaffold" | "worker";
-    workerDir: string;
-    workerId?: string;
-    companySlug?: string;
-    /** "synced" = personal/workers/<name>/memory in HQ; "local" = ~/.hq/bots/<name>/memory. */
-    memory: BotMemoryMode;
-    /** Absolute memory folder. */
-    memoryDir: string;
-    displayName?: string;
-    intro?: string;
-    kickoff?: string;
-}
-export declare function listBotNames(root: string): string[];
-/** Bot-identity token supplier: per-bot creds + per-bot token cache dir. */
-export declare function botTokenSupplier(dir: string): () => Promise<string>;
-/** Spawn `hq bot run <name>` detached (no launchd). */
-export declare function spawnDetachedRun(name: string, dir: string): number;
-/**
- * `output`: "json" | "text" print a result; "silent" prints nothing — used
- * when stop is a step inside rm/restart, whose own JSON must be the only
- * document on stdout (the desktop app parses it; a second object made it
- * "unreadable output: trailing characters").
- */
-/** Seams for the self-stop path, replaced in tests. */
-export declare const botStopSeams: {
-    /** True when this process runs inside the bot process `botPid` (one of its turns). */
-    isInsideBot: (botPid: number) => boolean;
-    /** Ask the bot to finish its running turns and exit 0 (the drain signal). */
-    signalDrain: (botPid: number) => boolean;
-};
-/**
- * The kind a new bot gets, before anything is provisioned. Personal unless
- * `--kind company` is given (the desktop app always passes --kind). A company
- * bot needs at least one company: `--company`, or the company worker's own
- * company when created from one. A personal bot takes no `--company`, and
- * HQ's setup bot is always personal.
- */
-export declare function resolveCreateKind(opts: {
-    kind?: string;
-    company?: string[];
-    worker?: string;
-}, worker: {
-    id: string;
-    company?: string | null;
-} | null): {
-    kind: BotKind;
-    companies: string[];
-};
-export declare function runBotCreate(nameArg: string, opts: {
-    runtime?: string;
-    model?: string;
-    effort?: string;
-    autoApprove?: boolean;
-    daemon?: boolean;
-    start?: boolean;
-    json?: boolean;
-    worker?: string;
-    intro?: string;
-    kickoff?: string;
-    displayName?: string;
-    memory?: string;
-    kind?: string;
-    company?: string[];
-}): Promise<void>;
-export declare function runBotCompanies(nameArg: string, opts: {
-    add?: string[];
-    remove?: string[];
-    json?: boolean;
-}): Promise<void>;
-export declare function runBotWorkers(opts: {
-    json?: boolean;
-}): Promise<void>;
-/**
- * `hq bot set <name> --model <id|default> --effort <level|default>`: change
- * what the bot thinks with. bot.json is re-read on every turn, so the next
- * message uses it; no restart.
- */
-export declare function runBotSet(nameArg: string, opts: {
-    model?: string;
-    effort?: string;
-    json?: boolean;
-}): Promise<void>;
-/**
- * The one bot the caller means. Matches the local folder name, the cloud slug,
- * the display name, or the agt_ uid; an ambiguous name is refused rather than
- * guessed at.
- */
-export declare function matchRemoteBots(bots: readonly MyLocalBot[], wanted: string): MyLocalBot[];
-export declare function resolveRemoteBot(bots: readonly MyLocalBot[], wanted: string): MyLocalBot;
-/**
- * Why HQ could not say which bots the account owns. The desktop app switches
- * on these values, so they are contract, not prose:
- *
- *   server-unsupported  the HQ Cloud in front of us has no listing route
- *   auth                the sign-in was refused
- *   network             HQ could not be reached at all
- *   server-error        HQ answered 5xx
- *   error               anything else
- */
-export type RemoteBotsUnavailableReason = "server-unsupported" | "auth" | "network" | "server-error" | "error";
-export interface RemoteBotsUnavailable {
-    reason: RemoteBotsUnavailableReason;
-    message: string;
-}
-/**
- * Turn any failure of `GET /v1/agents/mine` into one plain sentence plus a
- * stable reason. Production HQ Cloud does not serve that route yet, and an
- * uncaught 404 reached the person verbatim as "HQ API /v1/agents/mine → 404:
- * Not found" — and, under --json, as no document at all.
- */
-export declare function remoteBotsUnavailable(err: unknown): RemoteBotsUnavailable;
-/**
- * A cloud teardown that only got part of the way, said in the same vocabulary
- * the desktop switches on, plus the one decision that follows from it.
- *
- * `DELETE /v1/agents/{uid}` answers 200 with `terminal:false` and a per-step
- * `failures` map when it could do only part of the job. Those strings are raw
- * infrastructure: one real answer carried the AWS account id, an assumed-role
- * ARN and a DynamoDB table ARN. They are classified here and never repeated —
- * `detail` is a plain clause, `steps` is the server's own step names and
- * nothing of what they said.
- *
- * `retryable` is the local-state decision. Running `hq bot rm` again can only
- * finish the job when the step that failed might behave differently next time.
- * A refusal, or a step whose target was already gone, answers the same way
- * forever, so the local copy goes and the message says the leftover is HQ's.
- *
- * `reason` reuses {@link RemoteBotsUnavailableReason}: `auth` for a refused
- * step (a permission problem, on either side of the call), `error` for a step
- * whose target was already gone, `server-error` for anything HQ may yet
- * finish.
- */
-export interface BotRemovalIncomplete {
-    reason: RemoteBotsUnavailableReason;
-    /** One plain clause naming what stopped. Never a transport string. */
-    detail: string;
-    /** Whether running the same command again can still finish the removal. */
-    retryable: boolean;
-    /** The server's step names only — no ids, ARNs or messages. */
-    steps: string[];
-}
-export declare function botRemovalIncomplete(failures?: Record<string, string>): BotRemovalIncomplete;
-/**
- * Rebuild a bot.json from the settings the cloud kept for it. A bot created
- * before HQ saved settings comes back on defaults, and anything this HQ can no
- * longer provide (a worker that is not here, a thinking level the chosen
- * runtime does not accept) is reported rather than silently kept.
- */
-export declare function configFromLocalConfig(input: {
-    name: string;
-    agentUid: string;
-    ownerUid: string;
-    hqRoot: string;
-    dir: string;
-    local: BotLocalConfig | null;
-    overrides?: {
-        runtime?: BotRuntimeId;
-        model?: string;
-    };
-    preserveFirstStart?: boolean;
-    now?: () => Date;
-}): {
-    config: BotConfig;
-    notes: string[];
-};
-export interface BotAdoptResult {
-    name: string;
-    agentUid: string;
-    runtime: BotRuntimeId;
-    kind: BotKind;
-    companies: string[];
-    dir: string;
-    worker: string;
-    memory: BotMemoryMode;
-    memoryDir: string;
-    /** True when the cloud had no saved settings and defaults were used. */
-    defaulted: boolean;
-    notes: string[];
-    daemon: string | null;
-}
-export declare function runBotAdopt(nameArg: string, opts: {
-    runtime?: string;
-    model?: string;
-    daemon?: boolean;
-    start?: boolean;
-    json?: boolean;
-}): Promise<void>;
-export interface BotRestoreRow {
-    name: string;
-    agentUid: string;
-    /** restored = brought back here; repaired = new credentials for one already here. */
-    action: "restored" | "repaired" | "skipped" | "failed" | "would-restore" | "would-repair" | "would-skip";
-    detail: string;
-    /** Present only on a bot skipped because this computer cannot run it. */
-    reason?: BotNotRunnableReason;
-}
-/**
- * `hq bot restore` — every local bot this account owns that is not set up on
- * this computer comes back. This is what the desktop app and a post-install
- * hook call after a reinstall or on a new Mac.
- */
-export declare function runBotRestore(opts: {
-    all?: boolean;
-    dryRun?: boolean;
-    daemon?: boolean;
-    start?: boolean;
-    json?: boolean;
-}): Promise<void>;
-export interface RemoteBotRow {
-    name: string;
-    agentUid: string;
-    kind: string;
-    online: boolean;
-    lastHeartbeatAt: string | null;
-    /** True when this bot is set up on this computer. */
-    here: boolean;
-    settings: string;
-    /** False when this computer cannot run it, whatever the listing says. */
-    runnable: boolean;
-    /** Why not, when `runnable` is false: the same vocabulary adopt and restore use. */
-    reason: BotNotRunnableReason | null;
-}
-export declare function registerBotCommand(program: Command): void;
-//# sourceMappingURL=bot.d.ts.map