@indigoai-us/hq-cli 5.345.170 → 5.345.172

package/dist/lib/bot/fleet-local.d.ts

@@ -0,0 +1,142 @@
+import { type BotEngineMetadata } from "./config.js";
+import type { BotMachineCreds } from "./creds.js";
+import { type FleetPython } from "./fleet-python.js";
+import type { LocalBotPromotionRuntime } from "./promote.js";
+export interface FleetLocalReleasePin {
+    repository: string;
+    tag: string;
+    version: string;
+    artifact: string;
+    artifactSha256: string;
+    runtimeArtifact: string;
+    runtimeArtifactSha256: string;
+    manifestSha256: string;
+    signatureSha256: string;
+    runtimeCommit: string;
+}
+export interface FleetLocalReleaseFiles {
+    archive: Buffer;
+    runtimeArchive: Buffer;
+    manifest: Buffer;
+    signature: Buffer;
+}
+export interface FleetLocalInstallation {
+    release: FleetLocalReleasePin;
+    dir: string;
+    archive: string;
+    runtimeArchive: string;
+    manifest: string;
+    signature: string;
+    engine: BotEngineMetadata;
+}
+export interface FleetLocalProfile {
+    schemaVersion: 1;
+    botId: string;
+    ownerUid: string;
+    provider: {
+        id: string;
+        model: string;
+        credentialProvider?: string;
+        baseUrl?: string;
+        transport?: string;
+    };
+    hqRoot: string;
+    profileDir: string;
+    runtime: {
+        commit: string;
+        path: string;
+    };
+    paths: {
+        pluginSource: string;
+        statusFile: string;
+        logsDir: string;
+    };
+}
+export interface FleetLocalInstallDeps {
+    fleetHome?: string;
+    fetch?: typeof fetch;
+    token?: () => string;
+    now?: () => Date;
+    release?: FleetLocalReleasePin;
+    publicKey?: string;
+}
+export interface FleetLocalProfileInput {
+    agentUid: string;
+    ownerUid: string;
+    hqRoot: string;
+    botDir: string;
+    installation: FleetLocalInstallation;
+    /** The bot's standing HQ instructions; written as the runtime's SOUL.md persona. */
+    systemPrompt?: string;
+}
+type FleetLocalExec = (executable: string, args: string[], options: Record<string, unknown>) => Buffer | string;
+export interface FleetLocalBootstrapDeps {
+    fleetHome?: string;
+    platform?: NodeJS.Platform;
+    run?: FleetLocalExec;
+    start?: boolean;
+    python?: FleetPython;
+}
+export interface FleetLocalBootstrapResult {
+    profile: string;
+    runtime: string;
+    helper: string;
+    running: boolean;
+}
+export type FleetLocalServiceAction = "install" | "start" | "stop" | "restart" | "status" | "remove";
+export interface FleetLocalControlDeps {
+    fleetHome?: string;
+    platform?: NodeJS.Platform;
+    run?: FleetLocalExec;
+}
+export interface FleetLocalAuthInput {
+    agentUid: string;
+    provider: string;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    transport?: "chat_completions" | "anthropic_messages" | "codex_responses";
+    openBrowser?: boolean;
+}
+export interface FleetLocalAuthResult {
+    provider: string;
+    runtimeProvider: string;
+    model: string;
+    authenticated: boolean;
+    restarted: boolean;
+}
+export interface FleetLocalRemovalResult {
+    removed: boolean;
+    credentialsRemoved: number;
+}
+export declare const HQ_FLEET_LOCAL_RELEASE: FleetLocalReleasePin;
+export declare const HQ_FLEET_LOCAL_PUBLIC_KEY = "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAOOL7NRKQgjMYI5cWxLY+HGppXf2AtwpQbCg5v+nBksM=\n-----END PUBLIC KEY-----\n";
+export declare function fleetHome(home?: string, env?: NodeJS.ProcessEnv): string;
+export declare function verifyFleetLocalRelease(files: FleetLocalReleaseFiles, release?: FleetLocalReleasePin, publicKey?: string): void;
+export declare function resolveFleetReleaseToken(env?: NodeJS.ProcessEnv): string;
+export declare const FLEET_LOCAL_METADATA_DOWNLOAD_TIMEOUT_MS = 30000;
+export declare const FLEET_LOCAL_ARCHIVE_DOWNLOAD_TIMEOUT_MS: number;
+export declare const FLEET_LOCAL_RUNTIME_DOWNLOAD_TIMEOUT_MS: number;
+export declare function installPinnedFleetLocalDistribution(deps?: FleetLocalInstallDeps): Promise<FleetLocalInstallation>;
+/** The process id the bot's gateway recorded, when its file reads; the caller checks whether it is alive. */
+export declare function fleetLocalGatewayPid(agentUid: string, deps?: Pick<FleetLocalControlDeps, "fleetHome">): number | null;
+export declare function controlFleetLocalBot(agentUid: string, action: FleetLocalServiceAction, deps?: FleetLocalControlDeps): Record<string, unknown>;
+export declare function exportFleetLocalMachineCredential(agentUid: string, deps?: FleetLocalControlDeps): BotMachineCreds;
+export declare function fleetLocalPromotionRuntime(agentUid: string, deps?: FleetLocalControlDeps): LocalBotPromotionRuntime;
+export declare function removeFleetLocalBot(agentUid: string, deps?: FleetLocalControlDeps): FleetLocalRemovalResult;
+export declare function authenticateFleetLocalBot(input: FleetLocalAuthInput, deps?: FleetLocalControlDeps): FleetLocalAuthResult;
+export declare function writeFleetLocalProfile(input: FleetLocalProfileInput, deps?: Pick<FleetLocalBootstrapDeps, "fleetHome" | "platform">): string;
+export declare function writeFleetLocalSoul(agentUid: string, systemPrompt: string, deps?: Pick<FleetLocalControlDeps, "fleetHome">): string;
+/**
+ * The pinned runtime refuses a persona file that trips its context-file
+ * scanner and then starts with no identity at all. The same scanner, run with
+ * the bot's own interpreter, says beforehand what it would refuse.
+ */
+export declare function scanFleetLocalInstructions(agentUid: string, text: string, deps?: FleetLocalControlDeps): string[];
+/** Checks the instructions with the runtime's scanner, then makes them the bot's persona. */
+export declare function refreshFleetLocalInstructions(agentUid: string, systemPrompt: string, deps?: FleetLocalControlDeps): string;
+export declare function bootstrapFleetLocalBot(input: FleetLocalProfileInput & {
+    machineCredentials: string;
+}, deps?: FleetLocalBootstrapDeps): Promise<FleetLocalBootstrapResult>;
+export {};
+//# sourceMappingURL=fleet-local.d.ts.map