@botcord/daemon 0.1.1

package/dist/log.d.ts

@@ -0,0 +1,7 @@
+export declare const log: {
+    info: (msg: string, fields?: Record<string, unknown>) => void;
+    warn: (msg: string, fields?: Record<string, unknown>) => void;
+    error: (msg: string, fields?: Record<string, unknown>) => void;
+    debug: (msg: string, fields?: Record<string, unknown>) => void;
+};
+export declare const LOG_FILE_PATH: string;

package/dist/log.js

@@ -0,0 +1,44 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+const LOG_DIR = path.join(homedir(), ".botcord", "logs");
+const LOG_FILE = path.join(LOG_DIR, "daemon.log");
+let inited = false;
+function ensureDir() {
+    if (inited)
+        return;
+    try {
+        mkdirSync(LOG_DIR, { recursive: true, mode: 0o700 });
+    }
+    catch {
+        // best-effort
+    }
+    inited = true;
+}
+function write(level, msg, fields) {
+    ensureDir();
+    const line = JSON.stringify({
+        ts: new Date().toISOString(),
+        level,
+        msg,
+        ...(fields ?? {}),
+    });
+    try {
+        appendFileSync(LOG_FILE, line + "\n", { mode: 0o600 });
+    }
+    catch {
+        // ignore log write errors
+    }
+    // Mirror to stderr so `--foreground` and `logs -f` both see it.
+    process.stderr.write(line + "\n");
+}
+export const log = {
+    info: (msg, fields) => write("info", msg, fields),
+    warn: (msg, fields) => write("warn", msg, fields),
+    error: (msg, fields) => write("error", msg, fields),
+    debug: (msg, fields) => {
+        if (process.env.BOTCORD_DAEMON_DEBUG)
+            write("debug", msg, fields);
+    },
+};
+export const LOG_FILE_PATH = LOG_FILE;

package/dist/provision.d.ts

@@ -0,0 +1,88 @@
+import { BotCordClient, type ControlAck, type ControlFrame, type ListRuntimesResult } from "@botcord/protocol-core";
+import type { Gateway } from "./gateway/index.js";
+import { type DaemonConfig } from "./config.js";
+/** Options accepted by {@link createProvisioner}. */
+export interface ProvisionerOptions {
+    /** Live gateway handle used to hot-plug channels. */
+    gateway: Gateway;
+    /**
+     * Override for `BotCordClient.register` — tests inject a stub so they can
+     * run without a real Hub.
+     */
+    register?: typeof BotCordClient.register;
+}
+/** The value a frame handler returns (minus the `id` which the channel fills in). */
+type AckBody = Omit<ControlAck, "id">;
+/**
+ * Build a dispatcher function that routes a `ControlFrame` to the right
+ * handler. Returned function signature matches
+ * `ControlChannelOptions.handle`.
+ */
+export declare function createProvisioner(opts: ProvisionerOptions): (frame: ControlFrame) => Promise<AckBody>;
+/**
+ * Append `agentId` to the daemon config if not already present. Returns a
+ * new config object or `null` if nothing changed (so callers can skip the
+ * disk write).
+ */
+export declare function addAgentToConfig(cfg: DaemonConfig, agentId: string): DaemonConfig | null;
+/** Inverse of {@link addAgentToConfig}. Returns `null` on no-op. */
+export declare function removeAgentFromConfig(cfg: DaemonConfig, agentId: string): DaemonConfig | null;
+/**
+ * Probe every registered adapter and shape the result as the wire-level
+ * {@link ListRuntimesResult} — used by both the `list_runtimes` ack path and
+ * the daemon-side first-connect `runtime_snapshot` push in `daemon.ts`.
+ *
+ * Kept pure: the only side effects are `detectRuntimes()` itself (which the
+ * gateway already isolates from throwing) and reading the wall clock.
+ */
+export declare function collectRuntimeSnapshot(): ListRuntimesResult;
+interface ReloadResult {
+    reloaded: true;
+    added: string[];
+    removed: string[];
+}
+/**
+ * Re-read `config.json` and reconcile the running gateway against it. New
+ * agents in config but not in gateway snapshot → `addChannel`; agents in
+ * gateway but no longer in config → `removeChannel`. The agent's
+ * credentials must already exist on disk; we don't re-register identities
+ * here (that's `provision_agent`'s job).
+ */
+export declare function reloadConfig(ctx: {
+    gateway: Gateway;
+}): Promise<ReloadResult>;
+/**
+ * Per-agent entry returned by `list_agents`. Shape follows
+ * `docs/daemon-control-plane-api-contract.md` §3.2 — `{id, name, online}`.
+ * `status` and `lastMessageAt` are extra daemon-only fields the dashboard
+ * may ignore; kept so future contract revisions can promote them without
+ * breaking the wire.
+ */
+export interface AgentListEntry {
+    id: string;
+    /** Display name from credentials, when known. Falls back to the agent id. */
+    name: string;
+    /** True when the gateway channel is currently running + connected. */
+    online: boolean;
+    status: "running" | "stopped" | "unknown";
+    lastMessageAt?: number;
+}
+interface SetRouteResult {
+    ok: true;
+    agentId: string;
+    routeIndex: number;
+    inserted: boolean;
+}
+/**
+ * Persist a route in `config.json` for the given agent. If a route already
+ * matches `agentId` exactly (single-key match), it is replaced; otherwise a
+ * new entry is appended. `match.accountId` is forced to `agentId` so the
+ * route is always agent-scoped. The change is applied at next
+ * `reload_config` — it does not mutate the live router immediately.
+ *
+ * Accepts the contract's `{pattern, agentId}` shape (treats `pattern` as a
+ * conversation-id prefix) AND the richer `{agentId, route: {...}}` shape
+ * for daemon-side callers that need to set adapter/cwd explicitly.
+ */
+export declare function setRoute(params: unknown): SetRouteResult;
+export {};