@loompad/cli 0.1.0 → 1.1.1

package/dist/daemon/routes/voice.js

@@ -0,0 +1,53 @@
+import express from "express";
+import { execFile, fileCommand } from "../../core/process.js";
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { logbook } from "../../core/logbook.js";
+/** Register voice routes in the order established by LoomDaemon.routes(). */
+export function registerVoiceRoutes(app, withRuntime) {
+    // ---- voice: hold-to-talk from any client ------------------------------
+    // Audio in, text out. Transcription is a CONFIGURED command (LOOM_STT_CMD,
+    // e.g. whisper.cpp: `whisper-cli -m model.bin -f {file} -otxt`), because
+    // Loom's contract is no accounts and no keys — shipping a cloud STT call
+    // would break the reason the rest works offline. No command configured is
+    // an honest 501 with the setup line, not a fake transcript.
+    app.post("/api/projects/:id/voice", express.raw({ type: ["audio/*", "application/octet-stream"], limit: "25mb" }), withRuntime(async (rt, req, res) => {
+        const cmd = process.env.LOOM_STT_CMD;
+        if (!cmd) {
+            return void res.status(501).json({
+                error: "no transcriber configured — set LOOM_STT_CMD to a command that takes {file} and prints text (e.g. whisper.cpp)",
+            });
+        }
+        const body = req.body;
+        if (!body?.length)
+            return void res.status(400).json({ error: "no audio" });
+        // Date.now() alone collides when two clients release the mic in the
+        // same millisecond — one request then transcribes the other's audio.
+        const tmp = path.join(os.tmpdir(), `loom-voice-${Date.now()}-${crypto.randomBytes(4).toString("hex")}.audio`);
+        try {
+            fs.writeFileSync(tmp, body);
+            const launch = fileCommand(cmd, tmp);
+            const text = await new Promise((resolve, reject) => {
+                execFile(launch.command, launch.args, { env: launch.env, windowsVerbatimArguments: launch.windowsVerbatimArguments, timeout: 60_000, maxBuffer: 1024 * 1024 }, (err, stdout) => (err ? reject(err) : resolve(stdout.trim())));
+            });
+            if (!text)
+                return void res.status(422).json({ error: "the transcriber returned nothing" });
+            logbook.info("voice", `transcribed ${body.length} bytes → ${text.length} chars`, undefined, rt.info.id);
+            res.json({ text });
+        }
+        catch (err) {
+            res.status(500).json({ error: `transcription failed: ${err instanceof Error ? err.message : err}` });
+        }
+        finally {
+            try {
+                fs.rmSync(tmp, { force: true });
+            }
+            catch {
+                /* gone */
+            }
+        }
+    }));
+}
+//# sourceMappingURL=voice.js.map

package/dist/daemon/routes/voice.js.map

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

package/dist/daemon/runner.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Runner — a member's always-on Loom daemon that takes goals from the team hub
+ * (Loom Teams, Phase 5; docs/teams-architecture.md D67–D78).
+ *
+ * A runner is a normal Loom daemon in runner mode. It registers one of its
+ * owner's devices as a runner (D74) and claims jobs from the hub (D71):
+ *   start     a new goal on this machine
+ *   continue  a goal moved here mid-run (its branches on refs/loom/run/<id>/*)
+ *   fix       make the owner's goal PR green while they're away (D69)
+ *   return    hand a goal back to the owner's laptop (D76 "Bring back")
+ *   land      the owner clicked Land on a goal that lives here
+ *
+ * Each goal gets a fresh clone as its own project (D70). The runner process
+ * runs with a scrubbed environment; with Docker, the claimed job runs in a
+ * container instead (`loom runner exec`). A job stays claimed, heartbeating a
+ * progress snapshot, until its goal lands, fails or moves on (D76).
+ */
+import { type OrchestraRun } from "../core/orchestra.js";
+import { type TeamKey } from "../core/team-crypto.js";
+import type { FeedEvent, HubClient, Job, Presence, Runner as RunnerRecord } from "../core/team-hub.js";
+import type { Landing } from "./landing.js";
+import type { ProjectRuntime } from "./runtime.js";
+import type { CrewConfig, CrewGoal } from "../core/crew.js";
+import type { AgentConfig } from "../types.js";
+export interface RunnerConfig {
+    enabled: boolean;
+    /** Take teammates' goals too, when the repo's policy allows (D68). */
+    shared: boolean;
+    capacity: number;
+    /** auto = Docker when it's running, else a fresh clone in this process (D70). */
+    isolation: "auto" | "docker" | "inline";
+    /** Agent kinds this runner offers; empty = whatever is installed. */
+    kinds: string[];
+    label?: string;
+    image?: string;
+}
+export declare const DEFAULT_RUNNER: RunnerConfig;
+export declare function runnerConfigPath(): string;
+export declare function readRunnerConfig(): RunnerConfig;
+export declare function writeRunnerConfig(c: RunnerConfig): void;
+/** The runner's GitHub token lives beside its config, 0600, and never goes through the hub (D77). */
+export declare function runnerTokenPath(): string;
+export declare function readRunnerToken(): string | null;
+export declare function writeRunnerToken(token: string): void;
+/**
+ * What stays in a runner's environment: everything that isn't secret-shaped,
+ * plus the agent keys and GitHub token it's meant to have. A box someone also
+ * uses for production work doesn't hand its secrets to agents.
+ */
+export declare function scrubEnv(env: NodeJS.ProcessEnv): {
+    env: NodeJS.ProcessEnv;
+    removed: string[];
+};
+/** The container a job runs in when Docker is available (D70). Agent logins mount read-only. */
+export declare function dockerCommand(opts: {
+    jobId: string;
+    teamId: string;
+    image: string;
+    jobHome: string;
+    home?: string;
+}): string[];
+export interface JobPayload {
+    nativeCrew?: boolean;
+    crew?: CrewConfig & {
+        agents: Array<Pick<AgentConfig, "id" | "kind">>;
+    };
+    crewAction?: {
+        jobId: string;
+        action: "approve" | "say" | "pause" | "resume" | "stop" | "pick";
+        text?: string;
+        to?: string;
+    };
+    goal?: string;
+    orchestrator?: string;
+    workers?: string[];
+    plan?: boolean;
+    /** continue: the moved run. */
+    record?: OrchestraRun;
+    /** return / land: the run it's about. */
+    runId?: string;
+    /** fix: the PR to make green. */
+    pr?: number;
+    url?: string;
+    branch?: string;
+    ownerRunId?: string;
+    /** A human-readable "from" (the laptop's name). */
+    from?: string;
+}
+export interface JobProgress {
+    crew?: {
+        id: string;
+        name: string;
+        pr?: string;
+    };
+    runId: string | null;
+    goal: string;
+    status: string;
+    tasks: Array<Record<string, unknown>>;
+    costUsd: number;
+    landing: OrchestraRun["landing"] | null;
+    question?: string;
+    at: number;
+}
+export declare function progressOf(run: OrchestraRun | undefined, fallbackGoal?: string): JobProgress;
+export declare function crewProgress(id: string, name: string, goal: CrewGoal | undefined, runId: string | null): JobProgress;
+export interface RunnerDeps {
+    hub(): HubClient | null;
+    deviceId(): string | null;
+    userId(): string | null;
+    github(): string | null;
+    teams(): string[];
+    keys(teamId: string): TeamKey[];
+    feed(teamId: string): FeedEvent[];
+    presence(teamId: string): Presence[];
+    /** Open a directory as a project (registered, runtime attached to Team Link). */
+    openProject(dir: string, name: string): Promise<ProjectRuntime>;
+    closeProject(rt: ProjectRuntime): Promise<void>;
+    share(rt: ProjectRuntime, teamId: string): Promise<void>;
+    landing(rt: ProjectRuntime): Landing;
+    /** Where to clone a repo from; defaults to GitHub. Tests point it at a bare repo. */
+    cloneUrl?(repo: string): string;
+    /** Agent kinds available here (config override, else installed). */
+    kinds(): Promise<string[]>;
+    config(): RunnerConfig;
+    /** team.json, copied into a job's container home (Docker isolation). */
+    statePath(): string;
+    /** `loom runner exec`: run exactly this job, then call done (inside a container). */
+    exec?: {
+        teamId: string;
+        jobId: string;
+        done(ok: boolean): void;
+    };
+    /** Tests: how long the owner must be away before the runner takes a CI fix (D69). */
+    awayMs?: number;
+}
+export declare class Runner {
+    private deps;
+    private active;
+    private timer;
+    private claiming;
+    private registered;
+    private autoFixed;
+    lastError: string | null;
+    constructor(deps: RunnerDeps);
+    get running(): boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private fail;
+    register(): Promise<RunnerRecord | null>;
+    /** A hub event: a job appeared, changed, or was cancelled. */
+    onJob(teamId: string, job: Job): void;
+    /** Claim what we can, beat for what we hold, finish what's done, look for goals to rescue. */
+    tick(): Promise<void>;
+    /** Goals being worked on (return/land jobs are instant and don't count). */
+    private goalCount;
+    /** Inside a container: the dispatcher claimed this job; run it here, then exit (D70). */
+    private execOne;
+    private dockerOk;
+    /** D70: Docker per goal when it's running (auto), always (docker), or never (inline). */
+    useDocker(): Promise<boolean>;
+    /** Hand a claimed goal to its own container; it heartbeats and finishes the job itself. */
+    private dispatchDocker;
+    /** Run one claimed job. */
+    execute(teamId: string, job: Job, opts?: {
+        inline?: boolean;
+    }): Promise<void>;
+    /** return and land: act on a goal this runner holds, answer at once. */
+    private instant;
+    /** A fresh clone of the job's repo, opened as its own project (D70). */
+    private prepare;
+    private seal;
+    /** Heartbeat the job with a progress snapshot. */
+    private beat;
+    /** D76: a job is done when its goal lands, fails, or moves on. */
+    private checkDone;
+    private finish;
+    /** The goal is over here: its branches are pushed; the clone goes (D70). */
+    private cleanup;
+    private cancel;
+    /**
+     * D69: the owner's goal needs a CI fix and the owner has been away 15+
+     * minutes — ask for it as a job for this runner, like an Adopt.
+     */
+    private rescueOwnGoals;
+    status(): Record<string, unknown>;
+}