paperkite 0.1.0

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { access, copyFile, mkdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { loadCatalog } from "./config/loader.js";
+import { defaultFlowsFile, defaultSettingsFile, paperkiteHome } from "./config/paths.js";
+import { coreRoot } from "./extensions/loader.js";
+import { ensureProfile } from "./extensions/profile.js";
+import { managePlugins } from "./extensions/manager.js";
+import { createApp, defaultLockFile } from "./app.js";
+import { acquireProcessLock } from "./control/process-lock.js";
+import { requestControl, startControlServer } from "./control/socket.js";
+import { loginSession } from "./telegram/login.js";
+const program = new Command()
+    .name("paperkite")
+    .description("A focused TypeScript automation runtime for Telegram workflows")
+    .version("0.1.0");
+program
+    .command("init")
+    .description("create the local plugin profile directory")
+    .option("--profile <name>", "profile name", "default")
+    .action(async ({ profile }) => {
+    const directory = await ensureProfile(profile);
+    const examples = join(coreRoot(), "data");
+    const home = paperkiteHome();
+    await copyIfMissing(join(examples, "settings.example.yml"), join(home, "settings.yml"));
+    await copyIfMissing(join(examples, "flows.example.yml"), join(home, "flows.yml"));
+    process.stdout.write(directory + "\n");
+});
+program
+    .command("plugin")
+    .description("install, remove, or update plugins in a profile")
+    .argument("[pnpmArgs...]", "arguments passed to pnpm")
+    .option("--profile <name>", "profile name", "default")
+    .allowUnknownOption(true)
+    .action((args, options) => {
+    process.exitCode = managePlugins(options.profile, args);
+});
+program
+    .command("flows")
+    .description("list configured flows")
+    .option("--flows <file>", "flows file", defaultFlowsFile())
+    .action(async (options) => {
+    const catalog = await loadCatalog(options.flows);
+    const output = {
+        triggers: catalog.definitions("trigger"),
+        commands: catalog.definitions("command"),
+        schedules: catalog.definitions("schedule"),
+        services: catalog.definitions("service")
+    };
+    process.stdout.write(JSON.stringify(output, null, 2) + "\n");
+});
+program
+    .command("once")
+    .description("run one configured flow")
+    .argument("<flow>", "command or schedule id")
+    .option("--profile <name>", "profile name", "default")
+    .option("--settings <file>", "settings file", defaultSettingsFile())
+    .option("--flows <file>", "flows file", defaultFlowsFile())
+    .action(async (flow, options) => {
+    const app = await createApp({ profile: options.profile, settingsFile: options.settings, flowsFile: options.flows });
+    try {
+        await app.runtime.runFlow(flow);
+    }
+    finally {
+        await app.runtime.stop();
+    }
+});
+const service = program
+    .command("service")
+    .description("inspect or run one configured service");
+service
+    .command("list")
+    .description("list configured services")
+    .option("--flows <file>", "flows file", defaultFlowsFile())
+    .action(async (options) => {
+    const catalog = await loadCatalog(options.flows);
+    process.stdout.write(JSON.stringify(catalog.definitions("service"), null, 2) + "\n");
+});
+service
+    .command("run <id>")
+    .description("run one service in the foreground")
+    .option("--profile <name>", "profile name", "default")
+    .option("--settings <file>", "settings file", defaultSettingsFile())
+    .option("--flows <file>", "flows file", defaultFlowsFile())
+    .action(async (id, options) => {
+    const lock = await acquireProcessLock(defaultLockFile());
+    let app;
+    let control;
+    try {
+        const runningApp = await createApp({ profile: options.profile, settingsFile: options.settings, flowsFile: options.flows });
+        app = runningApp;
+        await runningApp.runtime.startService(id);
+        control = await startControlServer(runningApp.runtime);
+        await waitForSignals(async () => {
+            await runningApp.runtime.stop();
+            await control?.close();
+            await lock.release();
+        });
+    }
+    catch (error) {
+        await app?.runtime.stop().catch(() => undefined);
+        await control?.close().catch(() => undefined);
+        await lock.release();
+        throw error;
+    }
+});
+service
+    .command("status [id]")
+    .description("read the running process snapshot")
+    .action(async (id) => {
+    try {
+        const snapshot = await requestControl({ action: "snapshot" });
+        if (!id) {
+            process.stdout.write(JSON.stringify(snapshot, null, 2) + "\n");
+            return;
+        }
+        const active = Array.isArray(snapshot.activeServices) && snapshot.activeServices.includes(id);
+        process.stdout.write(JSON.stringify({ id, active }, null, 2) + "\n");
+    }
+    catch {
+        process.stdout.write(JSON.stringify({ running: false }, null, 2) + "\n");
+    }
+});
+for (const operation of ["start", "stop"]) {
+    service
+        .command(`${operation} <id>`)
+        .description(`${operation} a service in the running process`)
+        .action(async (id) => {
+        await requestControl({ action: `service.${operation}`, id });
+    });
+}
+service
+    .command("restart <id>")
+    .description("reload a service so its current definition applies")
+    .action(async (id) => {
+    await requestControl({ action: "flow.reload", id });
+});
+const session = program
+    .command("session")
+    .description("inspect or manage telegram sessions of the running process");
+session
+    .command("status [id]")
+    .description("read session states")
+    .action(async (id) => {
+    try {
+        const snapshot = await requestControl({ action: "snapshot" });
+        const sessions = Array.isArray(snapshot.sessions) ? snapshot.sessions : [];
+        if (id) {
+            const entry = sessions.find((item) => item.name === id);
+            if (!entry)
+                throw new Error("unknown session: " + id);
+            process.stdout.write(JSON.stringify(entry, null, 2) + "\n");
+            return;
+        }
+        process.stdout.write(JSON.stringify(sessions, null, 2) + "\n");
+    }
+    catch {
+        process.stdout.write(JSON.stringify({ running: false }, null, 2) + "\n");
+    }
+});
+session
+    .command("reconnect <id>")
+    .description("trigger a session reconnect attempt now")
+    .action(async (id) => {
+    await requestControl({ action: "session.reconnect", id });
+});
+session
+    .command("login <id>")
+    .description("log in a session without a running process")
+    .option("--settings <file>", "settings file", defaultSettingsFile())
+    .action(async (id, options) => {
+    await loginSession(id, options.settings);
+    process.stdout.write("session login ok: " + id + "\n");
+    await requestControl({ action: "session.reconnect", id }).catch(() => undefined);
+});
+program
+    .command("plugins")
+    .description("list plugins loaded by the running process")
+    .action(async () => {
+    try {
+        const plugins = await requestControl({ action: "plugins" });
+        process.stdout.write(JSON.stringify(plugins, null, 2) + "\n");
+    }
+    catch {
+        process.stdout.write(JSON.stringify({ running: false }, null, 2) + "\n");
+    }
+});
+program
+    .command("run")
+    .description("start configured triggers, schedules, and services")
+    .option("--profile <name>", "profile name", "default")
+    .option("--settings <file>", "settings file", defaultSettingsFile())
+    .option("--flows <file>", "flows file", defaultFlowsFile())
+    .action(async (options) => {
+    const lock = await acquireProcessLock(defaultLockFile());
+    let app;
+    let control;
+    try {
+        const runningApp = await createApp({ profile: options.profile, settingsFile: options.settings, flowsFile: options.flows });
+        app = runningApp;
+        await runningApp.runtime.start();
+        control = await startControlServer(runningApp.runtime);
+        await waitForSignals(async () => {
+            await runningApp.runtime.stop();
+            await control?.close();
+            await lock.release();
+        });
+    }
+    catch (error) {
+        await app?.runtime.stop().catch(() => undefined);
+        await control?.close().catch(() => undefined);
+        await lock.release();
+        throw error;
+    }
+});
+async function waitForSignals(stop) {
+    await new Promise((resolve, reject) => {
+        let finished = false;
+        const keepAlive = setInterval(() => undefined, 60_000);
+        const finish = () => {
+            if (finished)
+                return;
+            finished = true;
+            clearInterval(keepAlive);
+            process.off("SIGINT", finish);
+            process.off("SIGTERM", finish);
+            void stop().then(resolve, reject);
+        };
+        process.once("SIGINT", finish);
+        process.once("SIGTERM", finish);
+    });
+}
+async function copyIfMissing(source, target) {
+    try {
+        await access(target);
+    }
+    catch {
+        await mkdir(dirname(target), { recursive: true });
+        await copyFile(source, target);
+    }
+}
+try {
+    await program.parseAsync(process.argv);
+}
+catch (error) {
+    process.stderr.write((error instanceof Error ? error.message : String(error)) + "\n");
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/config/editor.d.ts

@@ -0,0 +1,2 @@
+import type { FlowSection } from "./model.js";
+export declare function updateItemInFile(file: string, section: FlowSection, id: string, patch: Record<string, unknown>): Promise<void>;

package/dist/src/config/editor.js

@@ -0,0 +1,19 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { YAMLMap, YAMLSeq, parseDocument } from "yaml";
+export async function updateItemInFile(file, section, id, patch) {
+    const text = await readFile(file, "utf8");
+    const doc = parseDocument(text, { merge: true });
+    const items = doc.get(section);
+    if (!(items instanceof YAMLSeq))
+        throw new Error(`missing ${section} section`);
+    const index = items.items.findIndex((item) => item instanceof YAMLMap && item.get("id") === id);
+    if (index < 0)
+        throw new Error(`missing ${section} item: ${id}`);
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined)
+            continue;
+        doc.setIn([section, index, key], value);
+    }
+    await writeFile(file, doc.toString(), "utf8");
+}
+//# sourceMappingURL=editor.js.map

package/dist/src/config/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../../src/config/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,OAAoB,EACpB,EAAU,EACV,KAA8B;IAE9B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,KAAK,YAAY,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,UAAU,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAChG,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,UAAU,EAAE,EAAE,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/config/loader.d.ts

@@ -0,0 +1,6 @@
+import { FlowCatalog, type FlowKind, type FlowSection } from "./model.js";
+export declare const DEFAULT_FLOWS_PATH: string;
+export declare function loadCatalog(path?: string): Promise<FlowCatalog>;
+export declare function fromMapping(value: Record<string, unknown>, path?: string): FlowCatalog;
+export declare function updateFlowItem(catalog: FlowCatalog, identifier: string, patch: Record<string, unknown>, kind?: FlowKind): Promise<FlowCatalog | undefined>;
+export declare function sectionFor(kind: FlowKind): FlowSection;

package/dist/src/config/loader.js

@@ -0,0 +1,188 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { parse } from "yaml";
+import { defaultFlowsFile } from "./paths.js";
+import { updateItemInFile } from "./editor.js";
+import { FlowCatalog, isRecord, normalizeBool, normalizeMaxRuns, normalizePositiveInt, normalizeSession } from "./model.js";
+export const DEFAULT_FLOWS_PATH = defaultFlowsFile();
+export async function loadCatalog(path = DEFAULT_FLOWS_PATH) {
+    const absolutePath = resolve(path);
+    let text = "";
+    try {
+        text = await readFile(absolutePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return fromMapping({}, absolutePath);
+        throw error;
+    }
+    const parsed = parse(text, { merge: true });
+    return fromMapping(isRecord(parsed) ? parsed : {}, absolutePath);
+}
+export function fromMapping(value, path) {
+    const definitions = {
+        trigger: parseTriggers(value.triggers),
+        command: parseCommands(value.commands),
+        schedule: parseSchedules(value.schedules),
+        service: parseServices(value.services)
+    };
+    for (const [kind, items] of Object.entries(definitions)) {
+        const ids = new Set();
+        for (const item of items) {
+            if (ids.has(item.id))
+                throw new Error(`duplicate ${kind} id: ${item.id}`);
+            ids.add(item.id);
+        }
+    }
+    return new FlowCatalog(definitions, path);
+}
+const PATCH_FIELDS = {
+    trigger: ["enabled", "config", "session", "maxRuns", "logFile", "actions"],
+    command: ["title", "symbol", "run"],
+    schedule: ["enabled", "session", "cron", "intervalSeconds", "logFile", "run"],
+    service: ["enabled", "config", "session", "autoStart", "logFile"]
+};
+export async function updateFlowItem(catalog, identifier, patch, kind) {
+    const item = catalog.find(identifier, kind);
+    if (!item || !item.explicitId || !catalog.path)
+        return undefined;
+    const allowed = PATCH_FIELDS[item.kind];
+    for (const key of Object.keys(patch)) {
+        if (!allowed.includes(key))
+            throw new Error(`flow ${item.id} does not accept field ${key}`);
+    }
+    const section = sectionFor(item.kind);
+    const root = parse(await readFile(catalog.path, "utf8"), { merge: true });
+    const entries = list(root[section], section);
+    const index = entries.findIndex((entry) => String(entry.id ?? "").trim() === item.id);
+    if (index < 0)
+        throw new Error(`missing ${section} item: ${item.id}`);
+    entries[index] = { ...entries[index], ...patch };
+    const next = fromMapping({ ...root, [section]: entries }, catalog.path);
+    await updateItemInFile(catalog.path, section, item.id, patch);
+    return next;
+}
+function parseTriggers(value) {
+    return list(value, "triggers").map((item, index) => {
+        const capability = text(item.capability, "trigger capability");
+        const actions = list(item.actions, "trigger actions").map((action) => parseAction(action));
+        return {
+            kind: "trigger",
+            id: makeId(capability, item.id, index),
+            capability,
+            enabled: normalizeBool(item.enabled, true),
+            session: normalizeSession(item.session),
+            config: item.config ?? {},
+            actions,
+            maxRuns: normalizeMaxRuns(item.maxRuns),
+            logFile: normalizeBool(item.logFile, false),
+            sourceIndex: index,
+            explicitId: hasId(item.id)
+        };
+    });
+}
+function parseCommands(value) {
+    return list(value, "commands").map((item, index) => {
+        if ("enabled" in item)
+            throw new Error("commands do not support enabled; remove the entry to hide it");
+        const action = parseAction(item.run);
+        const id = makeId(action.capability, item.id, index);
+        return {
+            kind: "command",
+            id,
+            title: text(item.title, "command title", false) || id,
+            symbol: text(item.symbol, "command symbol", false) || undefined,
+            action,
+            sourceIndex: index,
+            explicitId: hasId(item.id)
+        };
+    });
+}
+function parseSchedules(value) {
+    return list(value, "schedules").map((item, index) => {
+        const action = parseAction(item.run);
+        const cron = text(item.cron, "schedule cron", false) || undefined;
+        const intervalSeconds = normalizePositiveInt(item.intervalSeconds, "intervalSeconds");
+        if ((cron ? 1 : 0) + (intervalSeconds ? 1 : 0) !== 1) {
+            throw new Error(`schedule ${item.id ?? index + 1} needs exactly one of cron or intervalSeconds`);
+        }
+        return {
+            kind: "schedule",
+            id: makeId(action.capability, item.id, index),
+            enabled: normalizeBool(item.enabled, true),
+            session: normalizeSession(item.session),
+            action,
+            cron,
+            intervalSeconds,
+            logFile: normalizeBool(item.logFile, false),
+            sourceIndex: index,
+            explicitId: hasId(item.id)
+        };
+    });
+}
+function parseServices(value) {
+    return list(value, "services").map((item, index) => {
+        const capability = text(item.capability, "service capability");
+        return {
+            kind: "service",
+            id: makeId(capability, item.id, index),
+            capability,
+            enabled: normalizeBool(item.enabled, true),
+            session: normalizeSession(item.session),
+            config: item.config ?? {},
+            autoStart: normalizeBool(item.autoStart, true),
+            logFile: normalizeBool(item.logFile, false),
+            sourceIndex: index,
+            explicitId: hasId(item.id)
+        };
+    });
+}
+function parseAction(value) {
+    if (typeof value === "string")
+        return { capability: value.trim(), config: {} };
+    if (!isRecord(value))
+        throw new Error("action requires a capability string or mapping");
+    const capability = text(value.capability, "action capability");
+    if ("enabled" in value)
+        throw new Error("inline actions do not support enabled");
+    const hook = text(value.hook, "action hook", false) || undefined;
+    return {
+        capability,
+        session: normalizeSession(value.session),
+        config: value.config ?? {},
+        hook
+    };
+}
+function list(value, field) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new Error(`${field} must be a list`);
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item))
+            throw new Error(`${field}[${index + 1}] must be a mapping`);
+        return item;
+    });
+}
+function text(value, field, required = true) {
+    const result = value === undefined || value === null ? "" : String(value).trim();
+    if (required && !result)
+        throw new Error(`${field} is required`);
+    return result;
+}
+function hasId(value) {
+    return value !== undefined && value !== null && String(value).trim().length > 0;
+}
+function makeId(capability, value, index) {
+    if (hasId(value))
+        return String(value).trim();
+    return `${capability.replaceAll(/[^a-zA-Z0-9._-]+/g, "-")}-${index + 1}`;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+export function sectionFor(kind) {
+    return `${kind}s`;
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/config/loader.js.map

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

package/dist/src/config/model.d.ts

@@ -0,0 +1,71 @@
+export declare const FLOW_SECTIONS: readonly ["triggers", "commands", "schedules", "services"];
+export type FlowKind = "trigger" | "command" | "schedule" | "service";
+export interface ActionSpec {
+    capability: string;
+    session?: string;
+    config: unknown;
+    hook?: string;
+}
+export interface TriggerDefinition {
+    kind: "trigger";
+    id: string;
+    capability: string;
+    enabled: boolean;
+    session?: string;
+    config: unknown;
+    actions: readonly ActionSpec[];
+    maxRuns?: number;
+    logFile: boolean;
+    sourceIndex: number;
+    explicitId: boolean;
+}
+export interface CommandDefinition {
+    kind: "command";
+    id: string;
+    title: string;
+    symbol?: string;
+    action: ActionSpec;
+    sourceIndex: number;
+    explicitId: boolean;
+}
+export interface ScheduleDefinition {
+    kind: "schedule";
+    id: string;
+    enabled: boolean;
+    session?: string;
+    action: ActionSpec;
+    cron?: string;
+    intervalSeconds?: number;
+    logFile: boolean;
+    sourceIndex: number;
+    explicitId: boolean;
+}
+export interface ServiceDefinition {
+    kind: "service";
+    id: string;
+    capability: string;
+    enabled: boolean;
+    session?: string;
+    config: unknown;
+    autoStart: boolean;
+    logFile: boolean;
+    sourceIndex: number;
+    explicitId: boolean;
+}
+export type FlowDefinition = TriggerDefinition | CommandDefinition | ScheduleDefinition | ServiceDefinition;
+export type FlowSection = (typeof FLOW_SECTIONS)[number];
+export declare class FlowCatalog {
+    readonly definitionsByKind: Readonly<Record<FlowKind, readonly FlowDefinition[]>>;
+    readonly path?: string | undefined;
+    constructor(definitionsByKind: Readonly<Record<FlowKind, readonly FlowDefinition[]>>, path?: string | undefined);
+    definitions(kind?: FlowKind | FlowSection): FlowDefinition[];
+    enabled(kind?: FlowKind | FlowSection): FlowDefinition[];
+    capabilityRefs(): Set<string>;
+    find(identifier: string, kind?: FlowKind): FlowDefinition | undefined;
+}
+export declare function normalizeKind(kind: string): FlowKind;
+export declare function normalizeBool(value: unknown, fallback: boolean): boolean;
+export declare function normalizeSession(value: unknown): string | undefined;
+export declare function normalizePositiveInt(value: unknown, field: string, fallback?: number): number | undefined;
+export declare function normalizeMaxRuns(value: unknown): number | undefined;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;