pi-kot 0.1.0

package/dist/server/routes/orchestration.js

@@ -0,0 +1,251 @@
+import { getSession, rebuildSessionTools } from "../session-registry.js";
+import { enableSupervisor, disableSupervisor, isSupervisor, isWorker, getWorkerIds, getWorkerRecord, getSupervisorIdForWorker, readAllInbox, clearInbox, } from "../orchestration/store.js";
+import { killWorkerAndArchive, } from "../orchestration/worker-lifecycle.js";
+import { unregisterWorker } from "../orchestration/store.js";
+import { isOrchestrationAvailable, availableReason, maxWorkersPerSupervisor, } from "../orchestration/config.js";
+/**
+ * Orchestration REST routes — all under /api/v1/orchestration/.
+ */
+function disabledResponse(reason) {
+    return { disabled: true, disabledReason: reason };
+}
+export const orchestrationRoutes = async (fastify) => {
+    // GET /api/v1/orchestration/config — instance availability + caps
+    fastify.get("/orchestration/config", {
+        schema: {
+            description: "Orchestration availability and configuration",
+            tags: ["orchestration"],
+        },
+    }, async () => {
+        if (!isOrchestrationAvailable()) {
+            return disabledResponse(availableReason());
+        }
+        return {
+            available: true,
+            maxWorkersPerSupervisor: maxWorkersPerSupervisor(),
+            tools: [
+                "orchestrate_spawn_worker",
+                "orchestrate_list_workers",
+                "orchestrate_read_worker",
+                "orchestrate_send_to_worker",
+                "orchestrate_interrupt_worker",
+                "orchestrate_kill_worker",
+                "orchestrate_detach_worker",
+                "orchestrate_read_inbox",
+            ],
+        };
+    });
+    // GET /api/v1/orchestration/sessions/:id — role + linkage
+    fastify.get("/orchestration/sessions/:id", {
+        schema: {
+            description: "Get orchestration role for a session",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+        },
+    }, async (req) => {
+        const { id } = req.params;
+        const [sup, wrk] = await Promise.all([isSupervisor(id), isWorker(id)]);
+        let role;
+        if (sup)
+            role = "supervisor";
+        else if (wrk)
+            role = "worker";
+        else
+            role = "standalone";
+        const supervisorId = wrk ? await getSupervisorIdForWorker(id) : undefined;
+        return { sessionId: id, role, supervisorId };
+    });
+    // POST /api/v1/orchestration/sessions/:id/enable — enable supervisor
+    fastify.post("/orchestration/sessions/:id/enable", {
+        schema: {
+            description: "Enable supervisor mode for a session",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+        },
+    }, async (req, reply) => {
+        const { id } = req.params;
+        const live = getSession(id);
+        if (live === undefined) {
+            return reply.status(400).send({ error: "session_not_live" });
+        }
+        try {
+            await enableSupervisor(id);
+        }
+        catch (e) {
+            return reply.status(400).send({
+                error: e instanceof Error ? e.message : String(e),
+            });
+        }
+        await rebuildSessionTools(id);
+        return { enabled: true, sessionId: id };
+    });
+    // POST /api/v1/orchestration/sessions/:id/disable — disable supervisor
+    fastify.post("/orchestration/sessions/:id/disable", {
+        schema: {
+            description: "Disable supervisor mode for a session",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+        },
+    }, async (req, reply) => {
+        const { id } = req.params;
+        const live = getSession(id);
+        if (live === undefined) {
+            return reply.status(400).send({ error: "session_not_live" });
+        }
+        await disableSupervisor(id);
+        await rebuildSessionTools(id);
+        return { disabled: true, sessionId: id };
+    });
+    // GET /api/v1/orchestration/sessions/:id/workers — worker list
+    fastify.get("/orchestration/sessions/:id/workers", {
+        schema: {
+            description: "List workers for a supervisor session",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+        },
+    }, async (req) => {
+        const { id } = req.params;
+        if (!(await isSupervisor(id))) {
+            return { workers: [] };
+        }
+        const ids = await getWorkerIds(id);
+        const workers = await Promise.all(ids.map(async (workerId) => {
+            const rec = await getWorkerRecord(workerId);
+            const live = getSession(workerId);
+            return {
+                workerId,
+                state: rec?.state ?? "cold",
+                isLive: live !== undefined,
+                name: live?.session.sessionName ?? null,
+                messageCount: live?.session.messages.length ?? null,
+                lastStateAt: rec?.lastStateAt ?? null,
+            };
+        }));
+        return { workers };
+    });
+    // GET /api/v1/orchestration/sessions/:id/inbox — inbox history
+    fastify.get("/orchestration/sessions/:id/inbox", {
+        schema: {
+            description: "Get supervisor inbox (delivered + pending)",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+        },
+    }, async (req) => {
+        const { id } = req.params;
+        if (!(await isSupervisor(id))) {
+            return { items: [], count: 0 };
+        }
+        const items = await readAllInbox(id);
+        return { items, count: items.length };
+    });
+    // POST /api/v1/orchestration/sessions/:id/inbox/clear — clear inbox
+    fastify.post("/orchestration/sessions/:id/inbox/clear", {
+        schema: {
+            description: "Clear supervisor inbox",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+        },
+    }, async (req) => {
+        await clearInbox(req.params.id);
+        return { cleared: true };
+    });
+    // POST /api/v1/orchestration/sessions/:id/workers/:wid/detach
+    fastify.post("/orchestration/sessions/:id/workers/:wid/detach", {
+        schema: {
+            description: "Detach a worker from its supervisor",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id", "wid"],
+                properties: { id: { type: "string" }, wid: { type: "string" } },
+            },
+        },
+    }, async (req) => {
+        const { wid } = req.params;
+        await unregisterWorker(wid);
+        return { detached: true, workerId: wid };
+    });
+    // POST /api/v1/orchestration/sessions/:id/workers/:wid/kill
+    fastify.post("/orchestration/sessions/:id/workers/:wid/kill", {
+        schema: {
+            description: "Kill a worker session",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id", "wid"],
+                properties: { id: { type: "string" }, wid: { type: "string" } },
+            },
+        },
+    }, async (req, reply) => {
+        const { id, wid } = req.params;
+        try {
+            const result = await killWorkerAndArchive({
+                supervisorId: id,
+                workerId: wid,
+            });
+            return {
+                killed: true,
+                workerId: wid,
+                wasLive: result.wasLive,
+            };
+        }
+        catch (e) {
+            return reply
+                .status(400)
+                .send({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
+    // POST /api/v1/orchestration/sessions/:id/workers/:wid/resume
+    fastify.post("/orchestration/sessions/:id/workers/:wid/resume", {
+        schema: {
+            description: "Force-resume a cold worker into the registry",
+            tags: ["orchestration"],
+            params: {
+                type: "object",
+                required: ["id", "wid"],
+                properties: { id: { type: "string" }, wid: { type: "string" } },
+            },
+        },
+    }, async (req, reply) => {
+        const { wid } = req.params;
+        const alreadyLive = getSession(wid);
+        if (alreadyLive !== undefined) {
+            return { resumed: true, workerId: wid, wasCold: false };
+        }
+        try {
+            const { resumeSessionById, disposeSession } = await import("../session-registry.js");
+            await resumeSessionById(wid);
+            return { resumed: true, workerId: wid, wasCold: true };
+        }
+        catch (e) {
+            return reply
+                .status(400)
+                .send({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
+};
+//# sourceMappingURL=orchestration.js.map

package/dist/server/routes/orchestration.js.map

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

package/dist/server/routes/projects.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from "fastify";
+export declare const projectRoutes: FastifyPluginAsync;
+//# sourceMappingURL=projects.d.ts.map

package/dist/server/routes/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/routes/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAuBlD,eAAO,MAAM,aAAa,EAAE,kBA6c3B,CAAC"}

package/dist/server/routes/projects.js

@@ -0,0 +1,412 @@
+import { listProjects, createProject, updateProject, deleteProject, ProjectNotFoundError, InvalidNameError, DuplicatePathError, } from "../project-manager.js";
+import { validateCloneUrl, cloneRepository, assertTargetClonable, GitCloneError, } from "../git-clone.js";
+import { join, resolve } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { config } from "../config.js";
+export const projectRoutes = async (fastify) => {
+    // GET /api/v1/projects — list all projects
+    fastify.get("/projects", {
+        schema: {
+            description: "List all projects.",
+            tags: ["projects"],
+            response: {
+                200: {
+                    type: "object",
+                    required: ["projects"],
+                    properties: {
+                        projects: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                required: ["id", "name", "path", "createdAt"],
+                                properties: {
+                                    id: { type: "string" },
+                                    name: { type: "string" },
+                                    path: { type: "string" },
+                                    createdAt: { type: "string" },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    }, async () => {
+        const projects = await listProjects();
+        return { projects };
+    });
+    // GET /api/v1/projects/browse — directory autocomplete
+    fastify.get("/projects/browse", {
+        schema: {
+            description: "List matching directory paths for the Add Project path autocomplete.",
+            tags: ["projects"],
+            querystring: {
+                type: "object",
+                properties: {
+                    q: {
+                        type: "string",
+                        description: "Partial path query — returns matching directory suggestions.",
+                    },
+                },
+            },
+            response: {
+                200: {
+                    type: "object",
+                    required: ["suggestions"],
+                    properties: {
+                        suggestions: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                    },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        const { readdir, stat } = await import("node:fs/promises");
+        const query = (req.query.q ?? "").trim();
+        const suggestions = [];
+        const ws = config.workspacePath;
+        // Resolve the query to a filesystem path
+        let targetPath;
+        if (query.length === 0) {
+            // No query — show workspace dir itself
+            suggestions.push(ws);
+            return reply.send({ suggestions });
+        }
+        if (query.startsWith("~/")) {
+            const { homedir } = await import("node:os");
+            targetPath = resolve(join(homedir(), query.slice(2)));
+        }
+        else if (query.startsWith("/")) {
+            // Try workspace-relative first: /foo → workspace/foo
+            // If that doesn't exist as a directory, fall back to filesystem root
+            const sub = query.slice(1);
+            if (sub.length === 0) {
+                targetPath = ws;
+            }
+            else {
+                const wsPath = resolve(join(ws, sub));
+                try {
+                    const st = await stat(wsPath);
+                    targetPath = st.isDirectory() ? wsPath : resolve(query);
+                }
+                catch {
+                    targetPath = resolve(query);
+                }
+            }
+        }
+        else {
+            // Relative — search from workspace root
+            targetPath = resolve(join(ws, query));
+        }
+        // Try to list children of targetPath (directory browsing mode)
+        // If targetPath doesn't exist, list siblings that match (autocomplete mode)
+        let listedChildren = false;
+        try {
+            const st = await stat(targetPath);
+            if (st.isDirectory()) {
+                const entries = await readdir(targetPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    if (entry.name.startsWith("."))
+                        continue;
+                    suggestions.push(join(targetPath, entry.name));
+                }
+                listedChildren = suggestions.length > 0;
+            }
+        }
+        catch {
+            // targetPath doesn't exist — fall through to prefix matching
+        }
+        if (!listedChildren) {
+            // Prefix/autocomplete mode: list siblings and filter
+            try {
+                const parent = resolve(targetPath, "..");
+                const baseName = resolve(targetPath);
+                const entries = await readdir(parent, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    if (entry.name.startsWith("."))
+                        continue;
+                    const fullPath = join(parent, entry.name);
+                    if (fullPath.startsWith(baseName) || baseName.startsWith(fullPath)) {
+                        suggestions.push(fullPath);
+                    }
+                }
+            }
+            catch {
+                // No suggestions
+            }
+        }
+        // Sort: closest match first, then alphabetical
+        suggestions.sort((a, b) => {
+            const aMatch = a.startsWith(targetPath) ? 0 : 1;
+            const bMatch = b.startsWith(targetPath) ? 0 : 1;
+            if (aMatch !== bMatch)
+                return aMatch - bMatch;
+            return a.localeCompare(b);
+        });
+        return reply.send({ suggestions: suggestions.slice(0, 20) });
+    });
+    // POST /api/v1/projects — create a new project
+    fastify.post("/projects", {
+        schema: {
+            description: "Create a new project.",
+            tags: ["projects"],
+            body: {
+                type: "object",
+                required: ["name"],
+                properties: {
+                    name: { type: "string", minLength: 1 },
+                    path: { type: "string" },
+                },
+            },
+            response: {
+                201: {
+                    type: "object",
+                    required: ["id", "name", "path", "createdAt"],
+                    properties: {
+                        id: { type: "string" },
+                        name: { type: "string" },
+                        path: { type: "string" },
+                        createdAt: { type: "string" },
+                    },
+                },
+                400: {
+                    type: "object",
+                    properties: { error: { type: "string" }, message: { type: "string" } },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        try {
+            const path = req.body.path?.trim() || config.workspacePath;
+            const project = await createProject(req.body.name, path);
+            return reply.code(201).send(project);
+        }
+        catch (err) {
+            if (err instanceof InvalidNameError ||
+                err instanceof DuplicatePathError) {
+                return reply.code(400).send({ error: err.name, message: err.message });
+            }
+            throw err;
+        }
+    });
+    // PATCH /api/v1/projects/:id — update a project
+    fastify.patch("/projects/:id", {
+        schema: {
+            description: "Update a project's name or path.",
+            tags: ["projects"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+            body: {
+                type: "object",
+                properties: {
+                    name: { type: "string" },
+                    path: { type: "string" },
+                },
+            },
+            response: {
+                200: {
+                    type: "object",
+                    required: ["id", "name", "path", "createdAt"],
+                    properties: {
+                        id: { type: "string" },
+                        name: { type: "string" },
+                        path: { type: "string" },
+                        createdAt: { type: "string" },
+                    },
+                },
+                400: {
+                    type: "object",
+                    properties: { error: { type: "string" }, message: { type: "string" } },
+                },
+                404: {
+                    type: "object",
+                    properties: { error: { type: "string" } },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        try {
+            const project = await updateProject(req.params.id, req.body);
+            return project;
+        }
+        catch (err) {
+            if (err instanceof ProjectNotFoundError) {
+                return reply.code(404).send({ error: "project_not_found" });
+            }
+            if (err instanceof InvalidNameError ||
+                err instanceof DuplicatePathError) {
+                return reply.code(400).send({ error: err.name, message: err.message });
+            }
+            throw err;
+        }
+    });
+    // DELETE /api/v1/projects/:id — delete a project
+    fastify.delete("/projects/:id", {
+        schema: {
+            description: "Delete a project.",
+            tags: ["projects"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+            response: {
+                200: {
+                    type: "object",
+                    required: ["deleted"],
+                    properties: { deleted: { type: "boolean" } },
+                },
+                404: {
+                    type: "object",
+                    properties: { error: { type: "string" } },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        try {
+            await deleteProject(req.params.id);
+            return { deleted: true };
+        }
+        catch (err) {
+            if (err instanceof ProjectNotFoundError) {
+                return reply.code(404).send({ error: "project_not_found" });
+            }
+            throw err;
+        }
+    });
+    // POST /api/v1/projects/clone — clone a git repo and create a project
+    fastify.post("/projects/clone", {
+        schema: {
+            description: "Clone a git repository into the workspace, then create a project. " +
+                "Streams progress as SSE events.\n\n" +
+                "Events: started, progress, stderr, done (with project), error.",
+            tags: ["projects"],
+            body: {
+                type: "object",
+                required: ["url", "folderName", "projectName"],
+                properties: {
+                    url: { type: "string" },
+                    folderName: { type: "string" },
+                    projectName: { type: "string" },
+                    branch: { type: "string" },
+                    token: { type: "string" },
+                    insecureTls: { type: "boolean" },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        const { url, folderName, projectName, branch, token, insecureTls } = req.body;
+        // ---- pre-stream validation ----
+        try {
+            validateCloneUrl(url);
+        }
+        catch (err) {
+            if (err instanceof GitCloneError) {
+                return reply.code(400).send({ error: err.code, message: err.message });
+            }
+            throw err;
+        }
+        if (folderName.includes("/") ||
+            folderName.includes("\\") ||
+            folderName === "." ||
+            folderName === "..") {
+            return reply.code(400).send({ error: "invalid_directory_name" });
+        }
+        const targetPath = resolve(config.workspacePath, folderName);
+        try {
+            await assertTargetClonable(targetPath);
+        }
+        catch (err) {
+            if (err instanceof GitCloneError) {
+                const status = err.code === "target_not_empty" ? 409 : 400;
+                return reply.code(status).send({ error: err.code, message: err.message });
+            }
+            throw err;
+        }
+        // Ensure parent exists
+        await mkdir(config.workspacePath, { recursive: true });
+        // ---- start SSE stream ----
+        reply.hijack();
+        const raw = reply.raw;
+        raw.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+        });
+        // Heartbeat to keep connection alive
+        const heartbeat = setInterval(() => {
+            raw.write(": heartbeat\n\n");
+        }, 15_000);
+        let closed = false;
+        const close = () => {
+            if (closed)
+                return;
+            closed = true;
+            clearInterval(heartbeat);
+            raw.end();
+        };
+        req.raw.on("close", close);
+        req.raw.on("error", close);
+        const writeEvent = (event) => {
+            if (closed)
+                return;
+            try {
+                raw.write(`data: ${JSON.stringify(event)}\n\n`);
+            }
+            catch {
+                close();
+            }
+        };
+        try {
+            const gen = cloneRepository({
+                url,
+                target: targetPath,
+                branch,
+                token,
+                insecureTls,
+            });
+            for await (const event of gen) {
+                // Skip the generator's done — we handle project creation ourselves
+                if (event.type === "done") {
+                    try {
+                        const project = await createProject(projectName, targetPath);
+                        writeEvent({ type: "done", target: targetPath });
+                        writeEvent({
+                            type: "project_created",
+                            id: project.id,
+                            name: project.name,
+                            path: project.path,
+                        });
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : "Failed to create project";
+                        writeEvent({ type: "error", message: msg });
+                    }
+                    break;
+                }
+                if (event.type === "error") {
+                    break;
+                }
+                // Forward all other events (started, progress, stderr)
+                writeEvent(event);
+            }
+        }
+        catch (err) {
+            writeEvent({
+                type: "error",
+                message: err instanceof Error ? err.message : "Clone failed",
+            });
+        }
+        close();
+    });
+};
+//# sourceMappingURL=projects.js.map