lastlight 0.1.15 → 0.2.1

package/dist/session-log.js

@@ -0,0 +1,290 @@
+import fs from "node:fs";
+import { promises as fsp } from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+export const CHAT_PROJECT_SLUG = "-app";
+/**
+ * Filesystem cwd → project-dir slug (matches the SDK convention). The
+ * absolute path with `/` replaced by `-`. `/app` → `-app`,
+ * `/home/agent/workspace` → `-home-agent-workspace`.
+ */
+export function projectSlugForCwd(cwd) {
+    return cwd.replace(/\//g, "-");
+}
+export class SessionLog {
+    homeDir;
+    constructor(homeDir) {
+        this.homeDir = homeDir;
+    }
+    normalizeSessionId(sessionId) {
+        const safeId = path.basename(sessionId);
+        if (safeId !== sessionId)
+            return null;
+        if (!/^[A-Za-z0-9_-]+$/.test(safeId))
+            return null;
+        return safeId;
+    }
+    pathForProject(projectSlug, sessionId, opts = {}) {
+        const safeId = this.normalizeSessionId(sessionId);
+        if (!safeId || !this.isSafeProjectSlug(projectSlug))
+            return null;
+        const file = path.join(this.homeDir, "projects", projectSlug, `${safeId}.jsonl`);
+        if (opts.requireExists && !fs.existsSync(file))
+            return null;
+        return file;
+    }
+    findSession(scope, sessionId) {
+        const safeId = this.normalizeSessionId(sessionId);
+        if (!safeId)
+            return null;
+        for (const projectDir of this.projectDirs(scope)) {
+            const projectSlug = path.basename(projectDir);
+            const filePath = this.pathForProject(projectSlug, safeId, { requireExists: true });
+            if (!filePath)
+                continue;
+            return {
+                id: safeId,
+                filePath,
+                mtimeMs: this.mtimeMs(filePath),
+                projectSlug,
+            };
+        }
+        return null;
+    }
+    listSessions(scope) {
+        const entries = [];
+        for (const dir of this.projectDirs(scope)) {
+            const projectSlug = path.basename(dir);
+            try {
+                for (const f of fs.readdirSync(dir)) {
+                    if (!f.endsWith(".jsonl"))
+                        continue;
+                    const id = f.slice(0, -6);
+                    if (id.startsWith("agent-"))
+                        continue;
+                    const filePath = path.join(dir, f);
+                    entries.push({ id, filePath, mtimeMs: this.mtimeMs(filePath), projectSlug });
+                }
+            }
+            catch {
+                // skip unreadable dirs
+            }
+        }
+        entries.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        return entries;
+    }
+    relatedFilesForSession(scope, sessionId, opts = {}) {
+        const entry = this.findSession(scope, sessionId);
+        if (!entry)
+            return [];
+        const files = [entry.filePath];
+        if (!opts.includeAgents)
+            return files;
+        const dir = path.dirname(entry.filePath);
+        for (const agentDir of [dir, path.join(dir, entry.id, "subagents")]) {
+            try {
+                for (const f of fs.readdirSync(agentDir)) {
+                    if (!f.startsWith("agent-") || !f.endsWith(".jsonl"))
+                        continue;
+                    files.push(path.join(agentDir, f));
+                }
+            }
+            catch {
+                // dir doesn't exist or is unreadable
+            }
+        }
+        return files;
+    }
+    async appendEnvelopeLines(ref, lines) {
+        if (lines.length === 0)
+            return;
+        const filePath = this.pathForProject(ref.projectSlug, ref.sessionId, { requireExists: false });
+        if (!filePath)
+            return;
+        const data = lines.map((l) => JSON.stringify(l)).join("\n") + "\n";
+        await fsp.mkdir(path.dirname(filePath), { recursive: true });
+        await fsp.appendFile(filePath, data);
+    }
+    async readNormalizedFile(filePath, opts = {}) {
+        const out = [];
+        const stream = fs.createReadStream(filePath, { encoding: "utf8" });
+        const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+        for await (const line of rl) {
+            if (!line.trim())
+                continue;
+            try {
+                const raw = JSON.parse(line);
+                for (const msg of this.normalizeLine(raw)) {
+                    if (opts.skipEmptySystem && msg.role === "system" && !msg.content)
+                        continue;
+                    const timestamp = msg.timestamp ?? raw.timestamp ?? "";
+                    out.push({ timestamp, msg, raw });
+                }
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        return out;
+    }
+    async readNormalizedSession(scope, sessionId, opts = {}) {
+        const allMessages = [];
+        for (const file of this.relatedFilesForSession(scope, sessionId, { includeAgents: opts.includeAgents })) {
+            allMessages.push(...await this.readNormalizedFile(file, { skipEmptySystem: opts.skipEmptySystem }));
+        }
+        allMessages.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+        return allMessages.map((m, i) => ({ index: i, msg: m.msg }));
+    }
+    normalizeLine(raw) {
+        return unwrapLine(raw);
+    }
+    isSafeProjectSlug(projectSlug) {
+        return Boolean(projectSlug) && path.basename(projectSlug) === projectSlug && projectSlug !== "." && projectSlug !== "..";
+    }
+    projectDirs(scope) {
+        const projectsDir = path.join(this.homeDir, "projects");
+        try {
+            return fs
+                .readdirSync(projectsDir)
+                .filter((name) => (scope === "chat" ? name === CHAT_PROJECT_SLUG : name !== CHAT_PROJECT_SLUG))
+                .map((d) => path.join(projectsDir, d))
+                .filter((p) => fs.statSync(p).isDirectory());
+        }
+        catch {
+            return [];
+        }
+    }
+    mtimeMs(filePath) {
+        try {
+            return fs.statSync(filePath).mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+function unwrapLine(raw) {
+    // Already in role-based format (Hermes / Agent SDK --print output)
+    if (typeof raw.role === "string") {
+        return [raw];
+    }
+    const type = raw.type;
+    if (!type)
+        return [];
+    // Skip internal types
+    if (type === "queue-operation" || type === "summary" || type === "login")
+        return [];
+    if (type === "last-prompt" || type === "attachment")
+        return [];
+    const timestamp = raw.timestamp;
+    // Parse the message field — can be a JSON string or an object
+    let msg = {};
+    if (raw.message != null) {
+        if (typeof raw.message === "string") {
+            try {
+                msg = JSON.parse(raw.message);
+            }
+            catch {
+                msg = { content: raw.message };
+            }
+        }
+        else if (typeof raw.message === "object") {
+            msg = raw.message;
+        }
+    }
+    if (type === "user") {
+        const content = msg.content ?? raw.content;
+        // User messages with tool_result blocks → emit each as a separate tool message
+        if (Array.isArray(content)) {
+            const hasToolResults = content.some((b) => b.type === "tool_result");
+            if (hasToolResults) {
+                return content
+                    .filter((b) => b.type === "tool_result")
+                    .map((b) => {
+                    const block = b;
+                    return {
+                        role: "tool",
+                        content: block.content,
+                        tool_call_id: block.tool_use_id,
+                        timestamp,
+                    };
+                });
+            }
+        }
+        return [{ role: "user", content, timestamp }];
+    }
+    if (type === "assistant") {
+        if (raw.isApiErrorMessage || raw.error) {
+            return [{ role: "system", content: String(raw.error ?? "API error"), timestamp }];
+        }
+        const content = msg.content;
+        const model = msg.model;
+        const stopReason = msg.stop_reason;
+        let textContent;
+        let toolCalls;
+        let reasoning;
+        if (Array.isArray(content)) {
+            const textBlocks = [];
+            const tools = [];
+            for (const block of content) {
+                const b = block;
+                if (b.type === "text" && typeof b.text === "string") {
+                    textBlocks.push(b.text);
+                }
+                else if (b.type === "tool_use") {
+                    tools.push({
+                        id: b.id,
+                        function: { name: b.name, arguments: b.input },
+                    });
+                }
+                else if (b.type === "thinking" || b.type === "reasoning") {
+                    reasoning = b.thinking ?? b.text;
+                }
+            }
+            if (textBlocks.length)
+                textContent = textBlocks.join("\n");
+            if (tools.length)
+                toolCalls = tools;
+        }
+        else if (typeof content === "string") {
+            textContent = content;
+        }
+        // Skip lines that only have thinking (no text, no tools) — they're noise
+        if (!textContent && !toolCalls && reasoning)
+            return [];
+        // Skip completely empty assistant messages
+        if (!textContent && !toolCalls)
+            return [];
+        return [{
+                role: "assistant",
+                content: textContent,
+                tool_calls: toolCalls,
+                reasoning,
+                finish_reason: stopReason,
+                model,
+                timestamp,
+            }];
+    }
+    if (type === "tool_result") {
+        const content = msg.content ?? raw.content;
+        const toolUseId = msg.tool_use_id ?? raw.tool_use_id;
+        return [{
+                role: "tool",
+                content,
+                tool_call_id: toolUseId,
+                timestamp,
+            }];
+    }
+    if (type === "tool_use") {
+        return [{
+                role: "assistant",
+                tool_calls: [{
+                        id: msg.id ?? raw.uuid,
+                        function: { name: msg.name, arguments: msg.input },
+                    }],
+                timestamp,
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=session-log.js.map

package/dist/session-log.js.map

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

package/dist/session-log.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/session-log.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { SessionLog, projectSlugForCwd } from "./session-log.js";
+const tmpDirs = [];
+afterEach(async () => {
+    for (const d of tmpDirs.splice(0)) {
+        await fs.rm(d, { recursive: true, force: true });
+    }
+});
+async function makeLog() {
+    const homeDir = await fs.mkdtemp(path.join(os.tmpdir(), "session-log-test-"));
+    tmpDirs.push(homeDir);
+    return { homeDir, log: new SessionLog(homeDir) };
+}
+describe("SessionLog", () => {
+    it("round-trips appended envelope lines as normalized messages", async () => {
+        const { log } = await makeLog();
+        const ref = { projectSlug: projectSlugForCwd("/home/agent/workspace"), sessionId: "sess1" };
+        const t1 = "2026-01-01T00:00:00.000Z";
+        const t2 = "2026-01-01T00:00:01.000Z";
+        const t3 = "2026-01-01T00:00:02.000Z";
+        await log.appendEnvelopeLines(ref, [
+            { type: "user", message: { role: "user", content: "hello" }, timestamp: t1, sessionId: ref.sessionId },
+            {
+                type: "assistant",
+                message: {
+                    role: "assistant",
+                    content: [
+                        { type: "text", text: "hi there" },
+                        { type: "tool_use", id: "tool-1", name: "read", input: { path: "README.md" } },
+                    ],
+                },
+                timestamp: t2,
+                sessionId: ref.sessionId,
+            },
+            {
+                type: "user",
+                message: {
+                    role: "user",
+                    content: [{ type: "tool_result", tool_use_id: "tool-1", content: "file contents" }],
+                },
+                timestamp: t3,
+                sessionId: ref.sessionId,
+            },
+        ]);
+        const messages = await log.readNormalizedSession("sandbox", ref.sessionId);
+        expect(messages).toHaveLength(3);
+        expect(messages[0]).toEqual({ index: 0, msg: { role: "user", content: "hello", timestamp: t1 } });
+        expect(messages[1].msg).toMatchObject({
+            role: "assistant",
+            content: "hi there",
+            timestamp: t2,
+            tool_calls: [{ id: "tool-1", function: { name: "read", arguments: { path: "README.md" } } }],
+        });
+        expect(messages[2]).toEqual({
+            index: 2,
+            msg: { role: "tool", content: "file contents", tool_call_id: "tool-1", timestamp: t3 },
+        });
+    });
+    it("normalizes legacy role-based records", async () => {
+        const { log } = await makeLog();
+        const ref = { projectSlug: projectSlugForCwd("/home/agent/workspace"), sessionId: "legacy1" };
+        const timestamp = "2026-01-02T00:00:00.000Z";
+        await log.appendEnvelopeLines(ref, [{ role: "assistant", content: "legacy assistant", timestamp }]);
+        const messages = await log.readNormalizedSession("sandbox", ref.sessionId);
+        expect(messages).toEqual([
+            { index: 0, msg: { role: "assistant", content: "legacy assistant", timestamp } },
+        ]);
+    });
+    it("owns project slugs, paths, and session id validation", async () => {
+        const { homeDir, log } = await makeLog();
+        const projectSlug = projectSlugForCwd("/home/agent/workspace");
+        expect(projectSlug).toBe("-home-agent-workspace");
+        expect(log.normalizeSessionId("sess1")).toBe("sess1");
+        expect(log.normalizeSessionId("../bad")).toBeNull();
+        expect(log.normalizeSessionId("bad.jsonl")).toBeNull();
+        const resolved = log.pathForProject(projectSlug, "sess1", { requireExists: false });
+        expect(resolved).toBe(path.join(homeDir, "projects", projectSlug, "sess1.jsonl"));
+        expect(log.pathForProject(projectSlug, "../bad", { requireExists: false })).toBeNull();
+        expect(log.pathForProject(projectSlug, "bad.jsonl", { requireExists: false })).toBeNull();
+    });
+});
+//# sourceMappingURL=session-log.test.js.map

package/dist/session-log.test.js.map

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

package/dist/setup.d.ts

@@ -11,7 +11,14 @@ export interface SetupConfig {
     WEBHOOK_SECRET: string;
     ADMIN_SECRET: string;
     DOMAIN: string;
-    ANTHROPIC_API_KEY: string;
+    /** Model id consumed by agentic-pi / pi-ai, e.g. "anthropic/claude-sonnet-4-6" or "openai/gpt-5.5". */
+    LASTLIGHT_MODEL: string;
+    /** Set when the chosen model uses an OpenAI-prefixed provider. */
+    OPENAI_API_KEY?: string;
+    /** Set when the chosen model uses an Anthropic-prefixed provider. */
+    ANTHROPIC_API_KEY?: string;
+    /** Set when the chosen model uses an OpenRouter-prefixed provider. */
+    OPENROUTER_API_KEY?: string;
     ADMIN_PASSWORD?: string;
     SLACK_BOT_TOKEN?: string;
     SLACK_APP_TOKEN?: string;
@@ -19,11 +26,33 @@ export interface SetupConfig {
     SLACK_ALLOWED_USERS?: string;
     useCaddy: boolean;
     pemSourcePath: string;
+    /** Repositories the bot manages — written to instance/config.yaml (the overlay). */
+    managedRepos: string[];
 }
 export declare function isPositiveInt(s: string): boolean;
 export declare function isPemFile(filePath: string): boolean;
 export declare function isAnthropicKey(s: string): boolean;
+export declare function isOpenaiKey(s: string): boolean;
+export declare function isOpenrouterKey(s: string): boolean;
+/**
+ * Default model — kept aligned with `config.ts`'s `DEFAULT_MODEL`.
+ * Update both in lockstep when the canonical default changes.
+ */
+export declare const DEFAULT_LASTLIGHT_MODEL = "anthropic/claude-sonnet-4-6";
 export declare function isSlackBotToken(s: string): boolean;
 export declare function isSlackAppToken(s: string): boolean;
 export declare function buildEnvContent(config: SetupConfig): string;
+/** Build the overlay config.yaml (instance/config.yaml) — merged over config/default.yaml. */
+export declare function buildOverlayConfig(config: SetupConfig): string;
+/** Compose override (overlay): disable Caddy when the operator opts out of its TLS. */
+export declare const CADDY_DISABLED_OVERRIDE: string;
+/**
+ * Symlink the overlay's compose override into the project dir so plain
+ * `docker compose` auto-discovers it (Compose only auto-loads
+ * ./docker-compose.override.yml). No-op if the overlay has no override.
+ * Leaves a pre-existing regular file untouched.
+ */
+export declare function ensureOverrideSymlink(): void;
+/** Parse a free-text list of `owner/repo` entries (comma/space/newline separated). */
+export declare function parseManagedRepos(input: string): string[];
 export declare function runSetup(): Promise<void>;