daycare-cli 0.0.0-canary.f57680e

package/dist/engine/plugins/registry.spec.js

@@ -0,0 +1,69 @@
+import { describe, expect, it, vi } from "vitest";
+import { ModuleRegistry } from "../modules/moduleRegistry.js";
+import { PluginRegistry } from "./registry.js";
+describe("PluginRegistrar command registration", () => {
+    it("registers and unregisters plugin commands", () => {
+        const modules = new ModuleRegistry({
+            onMessage: async () => undefined
+        });
+        const registry = new PluginRegistry(modules);
+        const registrar = registry.createRegistrar("upgrade-instance");
+        const handler = vi.fn(async () => undefined);
+        registrar.registerCommand({
+            command: "upgrade",
+            description: "Upgrade daycare to latest version",
+            handler
+        });
+        expect(modules.commands.get("upgrade")).toEqual({
+            command: "upgrade",
+            description: "Upgrade daycare to latest version",
+            handler
+        });
+        registrar.unregisterCommand("upgrade");
+        expect(modules.commands.get("upgrade")).toBeNull();
+    });
+    it("cleans up registered commands on unregisterAll", async () => {
+        const modules = new ModuleRegistry({
+            onMessage: async () => undefined
+        });
+        const registry = new PluginRegistry(modules);
+        const registrar = registry.createRegistrar("upgrade-instance");
+        registrar.registerCommand({
+            command: "upgrade",
+            description: "Upgrade daycare to latest version",
+            handler: async () => undefined
+        });
+        registrar.registerCommand({
+            command: "hello",
+            description: "Greeting command",
+            handler: async () => undefined
+        });
+        await registrar.unregisterAll();
+        expect(modules.commands.list()).toEqual([]);
+    });
+    it("sends messages through registered connectors", async () => {
+        const modules = new ModuleRegistry({
+            onMessage: async () => undefined
+        });
+        const registry = new PluginRegistry(modules);
+        const registrar = registry.createRegistrar("upgrade-instance");
+        const sendMessage = vi.fn(async () => undefined);
+        const connector = {
+            capabilities: { sendText: true },
+            onMessage: () => () => undefined,
+            sendMessage
+        };
+        modules.connectors.register("telegram", connector);
+        await registrar.sendMessage({
+            type: "user",
+            connector: "telegram",
+            userId: "123",
+            channelId: "123"
+        }, { messageId: "77" }, { text: "Upgrading..." });
+        expect(sendMessage).toHaveBeenCalledWith("123", {
+            text: "Upgrading...",
+            replyToMessageId: "77"
+        });
+    });
+});
+//# sourceMappingURL=registry.spec.js.map

package/dist/engine/plugins/registry.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.spec.js","sourceRoot":"","sources":["../../../sources/engine/plugins/registry.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/plugins/types.d.ts

@@ -0,0 +1,77 @@
+import type { Logger } from "pino";
+import type { ZodType } from "zod";
+import type { FileStore } from "../../files/store.js";
+import type { AuthStore } from "../../auth/store.js";
+import type { PluginInstanceSettings, SettingsConfig } from "../../settings.js";
+import type { PluginEventInput } from "./events.js";
+import type { PluginRegistrar } from "./registry.js";
+import type { EngineEventBus } from "../ipc/events.js";
+import type { PluginInference } from "./inference.js";
+import type { Processes } from "../processes/processes.js";
+import type { ExposeProviderRegistrationApi } from "@/types";
+export type PluginApi<TSettings = unknown> = {
+    instance: PluginInstanceSettings;
+    settings: TSettings;
+    engineSettings: SettingsConfig;
+    logger: Logger;
+    auth: AuthStore;
+    dataDir: string;
+    registrar: PluginRegistrar;
+    exposes: ExposeProviderRegistrationApi;
+    fileStore: FileStore;
+    inference: PluginInference;
+    processes: Processes;
+    mode: "runtime" | "validate";
+    engineEvents?: EngineEventBus;
+    events: {
+        emit: (event: PluginEventInput) => void;
+    };
+};
+export type PluginInstance = {
+    load?: () => Promise<void>;
+    unload?: () => Promise<void>;
+    preStart?: () => Promise<void>;
+    postStart?: () => Promise<void>;
+    systemPrompt?: (() => Promise<string | null> | string | null) | string | null;
+};
+export type PromptChoice<TValue extends string> = {
+    value: TValue;
+    name: string;
+    description?: string;
+};
+export type PromptSelectConfig<TValue extends string> = {
+    message: string;
+    choices: Array<PromptChoice<TValue>>;
+};
+export type PromptInputConfig = {
+    message: string;
+    default?: string;
+    placeholder?: string;
+};
+export type PromptConfirmConfig = {
+    message: string;
+    default?: boolean;
+};
+export type PluginPrompt = {
+    input: (config: PromptInputConfig) => Promise<string | null>;
+    confirm: (config: PromptConfirmConfig) => Promise<boolean | null>;
+    select: <TValue extends string>(config: PromptSelectConfig<TValue>) => Promise<TValue | null>;
+};
+export type PluginOnboardingApi = {
+    instanceId: string;
+    pluginId: string;
+    dataDir: string;
+    auth: AuthStore;
+    prompt: PluginPrompt;
+    note: (message: string, title?: string) => void;
+};
+export type PluginOnboardingResult = {
+    settings?: Record<string, unknown>;
+};
+export type PluginModule<TSettings = unknown> = {
+    settingsSchema: ZodType<TSettings>;
+    create: (api: PluginApi<TSettings>) => PluginInstance | Promise<PluginInstance>;
+    onboarding?: (api: PluginOnboardingApi) => Promise<PluginOnboardingResult | null>;
+};
+export declare function definePlugin<TSettings>(module: PluginModule<TSettings>): PluginModule<TSettings>;
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/types.ts"],"names":[],"mappings":"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"}

package/dist/engine/plugins/types.js

@@ -0,0 +1,4 @@
+export function definePlugin(module) {
+    return module;
+}
+//# sourceMappingURL=types.js.map

package/dist/engine/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../sources/engine/plugins/types.ts"],"names":[],"mappings":"AAyFA,MAAM,UAAU,YAAY,CAC1B,MAA+B;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/processes/processBootTimeRead.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves system boot time as unix milliseconds.
+ * Returns null when the platform does not expose a supported boot-time source.
+ */
+export declare function processBootTimeRead(): Promise<number | null>;
+//# sourceMappingURL=processBootTimeRead.d.ts.map

package/dist/engine/processes/processBootTimeRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processBootTimeRead.d.ts","sourceRoot":"","sources":["../../../sources/engine/processes/processBootTimeRead.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYlE"}

package/dist/engine/processes/processBootTimeRead.js

@@ -0,0 +1,56 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { promises as fs } from "node:fs";
+import { promisify } from "node:util";
+const execFile = promisify(execFileCallback);
+/**
+ * Resolves system boot time as unix milliseconds.
+ * Returns null when the platform does not expose a supported boot-time source.
+ */
+export async function processBootTimeRead() {
+    try {
+        if (process.platform === "linux") {
+            return processBootTimeReadLinux();
+        }
+        if (process.platform === "darwin") {
+            return processBootTimeReadDarwin();
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+async function processBootTimeReadLinux() {
+    const raw = await fs.readFile("/proc/stat", "utf8");
+    const line = raw
+        .split(/\r?\n/)
+        .find((entry) => entry.startsWith("btime "));
+    if (!line) {
+        return null;
+    }
+    const seconds = Number(line.slice(6).trim());
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        return null;
+    }
+    return Math.floor(seconds * 1_000);
+}
+async function processBootTimeReadDarwin() {
+    const result = await execFile("sysctl", ["-n", "kern.boottime"], {
+        encoding: "utf8"
+    });
+    const output = result.stdout ?? "";
+    const secMatch = /sec\s*=\s*(\d+)/.exec(output);
+    if (!secMatch) {
+        return null;
+    }
+    const secText = secMatch[1];
+    if (!secText) {
+        return null;
+    }
+    const sec = Number(secText);
+    if (!Number.isFinite(sec) || sec <= 0) {
+        return null;
+    }
+    return Math.floor(sec * 1_000);
+}
+//# sourceMappingURL=processBootTimeRead.js.map

package/dist/engine/processes/processBootTimeRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processBootTimeRead.js","sourceRoot":"","sources":["../../../sources/engine/processes/processBootTimeRead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,wBAAwB,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,yBAAyB,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,wBAAwB;IACrC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG;SACb,KAAK,CAAC,OAAO,CAAC;SACd,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,yBAAyB;IACtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE;QAC/D,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/engine/processes/processes.d.ts

@@ -0,0 +1,82 @@
+import type { Logger } from "pino";
+import type { SessionPermissions, SandboxPackageManager } from "@/types";
+declare const SIGNALS: readonly ["SIGTERM", "SIGINT", "SIGHUP", "SIGKILL"];
+export type ProcessSignal = (typeof SIGNALS)[number];
+export type ProcessOwner = {
+    type: "plugin";
+    id: string;
+};
+export type ProcessCreateInput = {
+    command: string;
+    name?: string;
+    cwd?: string;
+    env?: Record<string, string | number | boolean>;
+    home?: string;
+    packageManagers?: SandboxPackageManager[];
+    allowedDomains?: string[];
+    keepAlive?: boolean;
+    allowLocalBinding?: boolean;
+    owner?: ProcessOwner;
+};
+export type ProcessInfo = {
+    id: string;
+    name: string;
+    command: string;
+    cwd: string;
+    home: string | null;
+    pid: number | null;
+    keepAlive: boolean;
+    desiredState: "running" | "stopped";
+    status: "running" | "stopped" | "exited";
+    restartCount: number;
+    createdAt: number;
+    updatedAt: number;
+    lastStartedAt: number | null;
+    lastExitedAt: number | null;
+    logPath: string;
+};
+/**
+ * Manages durable sandboxed background processes persisted on disk.
+ * Expects: all state writes happen through this facade to keep pid/status files in sync.
+ */
+export declare class Processes {
+    private readonly baseDir;
+    private readonly recordsDir;
+    private readonly lock;
+    private readonly logger;
+    private readonly bootTimeProvider;
+    private readonly socketPath;
+    private readonly records;
+    private readonly children;
+    private currentBootTimeMs;
+    private currentBootTimeKnown;
+    private monitorHandle;
+    constructor(baseDir: string, logger: Logger, options?: {
+        bootTimeProvider?: () => Promise<number | null>;
+        socketPath?: string;
+    });
+    load(): Promise<void>;
+    unload(): void;
+    create(input: ProcessCreateInput, permissions: SessionPermissions): Promise<ProcessInfo>;
+    listByOwner(owner: ProcessOwner): Promise<ProcessInfo[]>;
+    list(): Promise<ProcessInfo[]>;
+    get(processId: string): Promise<ProcessInfo>;
+    stop(processId: string, signal?: ProcessSignal): Promise<ProcessInfo>;
+    remove(processId: string, signal?: ProcessSignal): Promise<void>;
+    removeByOwner(owner: ProcessOwner, signal?: ProcessSignal): Promise<number>;
+    stopAll(signal?: ProcessSignal): Promise<ProcessInfo[]>;
+    private startMonitor;
+    private refreshRecordStatusLocked;
+    private restartRecordWithBackoffLocked;
+    private removeRecordLocked;
+    private startRecordLocked;
+    private attachChildListeners;
+    private stopRecordLocked;
+    private writeRecordLocked;
+    private processDir;
+    private recordPath;
+    private resolveCurrentBootTimeMsLocked;
+    private clearStalePidForBootMismatch;
+}
+export {};
+//# sourceMappingURL=processes.d.ts.map

package/dist/engine/processes/processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.ts","sourceRoot":"","sources":["../../../sources/engine/processes/processes.ts"],"names":[],"mappings":"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"}