@suwujs/king-ai 0.2.0

package/dist/src/heartbeat.d.ts

@@ -0,0 +1,18 @@
+export interface HeartbeatData {
+    pid: number;
+    runId: string;
+    lastTick: string;
+    loopCount: number;
+    version?: string;
+    computerId?: string;
+    serverUrl?: string;
+}
+export declare class FileHeartbeat {
+    private readonly path;
+    private readonly data;
+    private loopCount;
+    constructor(path: string, data: Omit<HeartbeatData, "lastTick" | "loopCount">);
+    get count(): number;
+    write(): HeartbeatData;
+    tick(): HeartbeatData;
+}

package/dist/src/heartbeat.js

@@ -0,0 +1,28 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+export class FileHeartbeat {
+    path;
+    data;
+    loopCount = 0;
+    constructor(path, data) {
+        this.path = path;
+        this.data = data;
+        mkdirSync(dirname(this.path), { recursive: true });
+    }
+    get count() {
+        return this.loopCount;
+    }
+    write() {
+        const data = {
+            ...this.data,
+            lastTick: new Date().toISOString(),
+            loopCount: this.loopCount
+        };
+        writeFileSync(this.path, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+        return data;
+    }
+    tick() {
+        this.loopCount += 1;
+        return this.write();
+    }
+}

package/dist/src/host-api.d.ts

@@ -0,0 +1,40 @@
+import type { RunningEvent, RunningState } from "./service.js";
+import type { UsagePricingRule, UsageSummary } from "./usage.js";
+import type { WorktreePlan } from "./worktree.js";
+import type { RemediationAdvice } from "./remediation.js";
+import type { AgentConfigWarning } from "./agent-config-validation.js";
+export interface HostAgentStatus {
+    id: string;
+    name: string;
+    engine: string;
+    lifecycle?: string;
+    status?: string;
+    model?: string;
+    workspaceRoot?: string;
+    sharedSkillSnapshotId?: string;
+    hostHomeEntries?: Array<{
+        name: string;
+        linked: boolean;
+        reason?: string;
+    }>;
+    remediation?: Pick<RemediationAdvice, "category" | "severity" | "summary" | "actions"> | null;
+    configWarnings?: AgentConfigWarning[];
+}
+export interface HostStatusSnapshot {
+    ok: boolean;
+    version?: string;
+    pid?: number;
+    startedAt?: string;
+    serverUrl?: string;
+    computerId?: string;
+    capabilities: {
+        workspaces: string[];
+    };
+    agents: HostAgentStatus[];
+    usage: UsageSummary;
+    worktrees: WorktreePlan[];
+    events: RunningEvent[];
+    text: string;
+}
+export declare function buildHostStatusSnapshot(state: RunningState | null, budget?: number | null, pricingRules?: UsagePricingRule[]): HostStatusSnapshot;
+export declare function formatHostStatusSnapshot(snapshot: HostStatusSnapshot): string;

package/dist/src/host-api.js

@@ -0,0 +1,59 @@
+import { formatRunningStateSnapshot } from "./service.js";
+import { summarizeAgentUsage } from "./usage.js";
+import { worktreePlansFromRunningState } from "./service.js";
+export function buildHostStatusSnapshot(state, budget, pricingRules = []) {
+    return {
+        ok: Boolean(state),
+        version: state?.version,
+        pid: state?.pid,
+        startedAt: state?.startedAt,
+        serverUrl: state?.serverUrl,
+        computerId: state?.computerId,
+        capabilities: {
+            workspaces: state?.capabilities?.workspaces ?? []
+        },
+        agents: (state?.agents ?? []).map((agent) => ({
+            id: agent.id,
+            name: agent.name,
+            engine: agent.engine,
+            lifecycle: agent.lifecycle,
+            status: agent.status,
+            model: agent.model,
+            workspaceRoot: agent.workspaceRoot,
+            sharedSkillSnapshotId: agent.sharedSkillSnapshot?.id,
+            hostHomeEntries: agent.hostHomeEntries?.map((entry) => ({
+                name: entry.name,
+                linked: entry.linked,
+                reason: entry.reason
+            })),
+            remediation: agent.remediation
+                ? {
+                    category: agent.remediation.category,
+                    severity: agent.remediation.severity,
+                    summary: agent.remediation.summary,
+                    actions: agent.remediation.actions
+                }
+                : null,
+            configWarnings: agent.configWarnings ?? []
+        })),
+        usage: summarizeAgentUsage(state?.agents ?? [], budget, pricingRules),
+        worktrees: worktreePlansFromRunningState(state),
+        events: state?.events?.slice(-20) ?? [],
+        text: formatRunningStateSnapshot(state)
+    };
+}
+export function formatHostStatusSnapshot(snapshot) {
+    if (!snapshot.ok)
+        return "host status: daemon is not running or running.json is unavailable";
+    const lines = [
+        `host status: ${snapshot.version ?? "unknown"} pid=${snapshot.pid ?? "unknown"}`,
+        snapshot.computerId || snapshot.serverUrl
+            ? `paired: ${snapshot.computerId ?? "unknown"} @ ${snapshot.serverUrl ?? "unknown"}`
+            : "paired: unknown",
+        `agents=${snapshot.agents.length} workspaces=${snapshot.capabilities.workspaces.length} worktrees=${snapshot.worktrees.length}`,
+        `usage: runs=${snapshot.usage.turns} failed=${snapshot.usage.failed} tokens=${snapshot.usage.totalTokens}`
+    ];
+    if (snapshot.text)
+        lines.push(snapshot.text);
+    return lines.join("\n");
+}

package/dist/src/host-control.d.ts

@@ -0,0 +1,48 @@
+import type { DoctorResult } from "./daemon.js";
+import type { HostWorkflowCard } from "./host-ledger.js";
+import type { HandoffAction } from "./team-routing.js";
+import type { KingTeamSpec } from "./team-workflow.js";
+import type { RunningState } from "./service.js";
+import type { UsagePricingRule } from "./usage.js";
+export type HostCommandName = "status" | "usage" | "expenses" | "events" | "timeline" | "policy" | "doctor" | "plan-run" | "preflight" | "prepare-run-layout" | "submit-run" | "run-requests" | "run-request" | "update-run" | "cancel-run" | "execute-run" | "task-create" | "task-list" | "task-update" | "agenda" | "capsule-create" | "capsule-list" | "capsule-update" | "workflow-create" | "workflow-list" | "workflow-update" | "initiative-create" | "handoff-create" | "review-create" | "decision-create" | "artifact-create" | "feedback-record" | "feedback-list" | "feedback-summary" | "cron-check" | "emit-run-event" | "watch-run" | "run-results" | "run-heartbeat" | "run-meta" | "plan-export" | "export" | "compact-ledger" | "remote-config-get" | "remote-config-save" | "remote-list" | "remote-save-device" | "remote-delete-device" | "remote-default-device" | "remote-probe" | "remote-profile" | "remote-run" | "remote-logs" | "remote-find-logs" | "remote-pg" | "remote-redis";
+export type HostCommandFormat = "text" | "json";
+export interface HostCommandDefinition {
+    name: HostCommandName;
+    description: string;
+    destructive: boolean;
+}
+export interface HostCommandRequest {
+    command: string;
+    format?: HostCommandFormat;
+    input?: unknown;
+    actorRole?: string;
+}
+export interface HostCommandResult {
+    ok: boolean;
+    command: string;
+    exitCode: number;
+    text: string;
+    json?: unknown;
+    error?: string;
+}
+export interface HostCommandRunnerDeps {
+    readState?: () => Promise<RunningState | null>;
+    tokenBudget?: () => number | null | undefined;
+    usagePricing?: () => UsagePricingRule[];
+    collectDoctorResults?: () => Promise<DoctorResult[]>;
+    availableEngines?: () => string[];
+    recordTimeline?: boolean;
+    timelinePath?: string;
+    runsPath?: string;
+    teamSpec?: () => KingTeamSpec | null | undefined;
+    enforcePermission?: boolean;
+    autoHandoff?: boolean;
+    now?: () => Date;
+}
+export declare function listHostCommands(): HostCommandDefinition[];
+export declare function normalizeHostCommandName(raw: string): HostCommandName | null;
+export declare function runHostCommand(request: HostCommandRequest, deps?: HostCommandRunnerDeps): Promise<HostCommandResult>;
+export interface HostHandoffResult {
+    reason: HandoffAction["reason"];
+    card: HostWorkflowCard;
+}