@aexol/spectral 0.7.0 → 0.7.3

package/dist/pi/agent-core/harness/session/memory-storage.js

@@ -0,0 +1,113 @@
+import { SessionError, } from "../types.js";
+import { uuidv7 } from "./uuid.js";
+function updateLabelCache(labelsById, entry) {
+    if (entry.type !== "label")
+        return;
+    const label = entry.label?.trim();
+    if (label) {
+        labelsById.set(entry.targetId, label);
+    }
+    else {
+        labelsById.delete(entry.targetId);
+    }
+}
+function buildLabelsById(entries) {
+    const labelsById = new Map();
+    for (const entry of entries) {
+        updateLabelCache(labelsById, entry);
+    }
+    return labelsById;
+}
+function generateEntryId(byId) {
+    for (let i = 0; i < 100; i++) {
+        const id = uuidv7().slice(0, 8);
+        if (!byId.has(id))
+            return id;
+    }
+    return uuidv7();
+}
+function leafIdAfterEntry(entry) {
+    return entry.type === "leaf" ? entry.targetId : entry.id;
+}
+export class InMemorySessionStorage {
+    metadata;
+    entries;
+    byId;
+    labelsById;
+    leafId;
+    constructor(options) {
+        this.entries = options?.entries ? [...options.entries] : [];
+        this.byId = new Map(this.entries.map((entry) => [entry.id, entry]));
+        this.labelsById = buildLabelsById(this.entries);
+        this.leafId = null;
+        for (const entry of this.entries)
+            this.leafId = leafIdAfterEntry(entry);
+        if (this.leafId !== null && !this.byId.has(this.leafId)) {
+            throw new SessionError("invalid_session", `Entry ${this.leafId} not found`);
+        }
+        this.metadata = options?.metadata ?? { id: uuidv7(), createdAt: new Date().toISOString() };
+    }
+    async getMetadata() {
+        return this.metadata;
+    }
+    async getLeafId() {
+        if (this.leafId !== null && !this.byId.has(this.leafId)) {
+            throw new SessionError("invalid_session", `Entry ${this.leafId} not found`);
+        }
+        return this.leafId;
+    }
+    async setLeafId(leafId) {
+        if (leafId !== null && !this.byId.has(leafId)) {
+            throw new SessionError("not_found", `Entry ${leafId} not found`);
+        }
+        const entry = {
+            type: "leaf",
+            id: generateEntryId(this.byId),
+            parentId: this.leafId,
+            timestamp: new Date().toISOString(),
+            targetId: leafId,
+        };
+        this.entries.push(entry);
+        this.byId.set(entry.id, entry);
+        this.leafId = leafId;
+    }
+    async createEntryId() {
+        return generateEntryId(this.byId);
+    }
+    async appendEntry(entry) {
+        this.entries.push(entry);
+        this.byId.set(entry.id, entry);
+        updateLabelCache(this.labelsById, entry);
+        this.leafId = leafIdAfterEntry(entry);
+    }
+    async getEntry(id) {
+        return this.byId.get(id);
+    }
+    async findEntries(type) {
+        return this.entries.filter((entry) => entry.type === type);
+    }
+    async getLabel(id) {
+        return this.labelsById.get(id);
+    }
+    async getPathToRoot(leafId) {
+        if (leafId === null)
+            return [];
+        const path = [];
+        let current = this.byId.get(leafId);
+        if (!current)
+            throw new SessionError("not_found", `Entry ${leafId} not found`);
+        while (current) {
+            path.unshift(current);
+            if (!current.parentId)
+                break;
+            const parent = this.byId.get(current.parentId);
+            if (!parent)
+                throw new SessionError("invalid_session", `Entry ${current.parentId} not found`);
+            current = parent;
+        }
+        return path;
+    }
+    async getEntries() {
+        return [...this.entries];
+    }
+}

package/dist/pi/agent-core/harness/session/repo-utils.js

@@ -0,0 +1,38 @@
+import { SessionError, } from "../types.js";
+import { Session } from "./session.js";
+import { uuidv7 } from "./uuid.js";
+export function createSessionId() {
+    return uuidv7();
+}
+export function createTimestamp() {
+    return new Date().toISOString();
+}
+export function toSession(storage) {
+    return new Session(storage);
+}
+export function getFileSystemResultOrThrow(result, message) {
+    if (!result.ok) {
+        const code = result.error.code === "not_found" ? "not_found" : "storage";
+        throw new SessionError(code, `${message}: ${result.error.message}`, result.error);
+    }
+    return result.value;
+}
+export async function getEntriesToFork(storage, options) {
+    if (!options.entryId)
+        return storage.getEntries();
+    const target = await storage.getEntry(options.entryId);
+    if (!target) {
+        throw new SessionError("invalid_fork_target", `Entry ${options.entryId} not found`);
+    }
+    let effectiveLeafId;
+    if ((options.position ?? "before") === "at") {
+        effectiveLeafId = target.id;
+    }
+    else {
+        if (target.type !== "message" || target.message.role !== "user") {
+            throw new SessionError("invalid_fork_target", `Entry ${options.entryId} is not a user message`);
+        }
+        effectiveLeafId = target.parentId;
+    }
+    return storage.getPathToRoot(effectiveLeafId);
+}

package/dist/pi/agent-core/harness/session/session.js

@@ -0,0 +1,196 @@
+import { createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage } from "../messages.js";
+import { SessionError } from "../types.js";
+export function buildSessionContext(pathEntries) {
+    let thinkingLevel = "off";
+    let model = null;
+    let compaction = null;
+    for (const entry of pathEntries) {
+        if (entry.type === "thinking_level_change") {
+            thinkingLevel = entry.thinkingLevel;
+        }
+        else if (entry.type === "model_change") {
+            model = { provider: entry.provider, modelId: entry.modelId };
+        }
+        else if (entry.type === "message" && entry.message.role === "assistant") {
+            model = { provider: entry.message.provider, modelId: entry.message.model };
+        }
+        else if (entry.type === "compaction") {
+            compaction = entry;
+        }
+    }
+    const messages = [];
+    const appendMessage = (entry) => {
+        if (entry.type === "message") {
+            messages.push(entry.message);
+        }
+        else if (entry.type === "custom_message") {
+            messages.push(createCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp));
+        }
+        else if (entry.type === "branch_summary" && entry.summary) {
+            messages.push(createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp));
+        }
+    };
+    if (compaction) {
+        messages.push(createCompactionSummaryMessage(compaction.summary, compaction.tokensBefore, compaction.timestamp));
+        const compactionIdx = pathEntries.findIndex((e) => e.type === "compaction" && e.id === compaction.id);
+        let foundFirstKept = false;
+        for (let i = 0; i < compactionIdx; i++) {
+            const entry = pathEntries[i];
+            if (entry.id === compaction.firstKeptEntryId)
+                foundFirstKept = true;
+            if (foundFirstKept)
+                appendMessage(entry);
+        }
+        for (let i = compactionIdx + 1; i < pathEntries.length; i++) {
+            appendMessage(pathEntries[i]);
+        }
+    }
+    else {
+        for (const entry of pathEntries) {
+            appendMessage(entry);
+        }
+    }
+    return { messages, thinkingLevel, model };
+}
+export class Session {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    getMetadata() {
+        return this.storage.getMetadata();
+    }
+    getStorage() {
+        return this.storage;
+    }
+    getLeafId() {
+        return this.storage.getLeafId();
+    }
+    getEntry(id) {
+        return this.storage.getEntry(id);
+    }
+    getEntries() {
+        return this.storage.getEntries();
+    }
+    async getBranch(fromId) {
+        const leafId = fromId ?? (await this.storage.getLeafId());
+        return this.storage.getPathToRoot(leafId);
+    }
+    async buildContext() {
+        return buildSessionContext(await this.getBranch());
+    }
+    getLabel(id) {
+        return this.storage.getLabel(id);
+    }
+    async getSessionName() {
+        const entries = await this.storage.findEntries("session_info");
+        return entries[entries.length - 1]?.name?.trim() || undefined;
+    }
+    async appendTypedEntry(entry) {
+        await this.storage.appendEntry(entry);
+        return entry.id;
+    }
+    async appendMessage(message) {
+        return this.appendTypedEntry({
+            type: "message",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            message,
+        });
+    }
+    async appendThinkingLevelChange(thinkingLevel) {
+        return this.appendTypedEntry({
+            type: "thinking_level_change",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            thinkingLevel,
+        });
+    }
+    async appendModelChange(provider, modelId) {
+        return this.appendTypedEntry({
+            type: "model_change",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            provider,
+            modelId,
+        });
+    }
+    async appendCompaction(summary, firstKeptEntryId, tokensBefore, details, fromHook) {
+        return this.appendTypedEntry({
+            type: "compaction",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            summary,
+            firstKeptEntryId,
+            tokensBefore,
+            details,
+            fromHook,
+        });
+    }
+    async appendCustomEntry(customType, data) {
+        return this.appendTypedEntry({
+            type: "custom",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            customType,
+            data,
+        });
+    }
+    async appendCustomMessageEntry(customType, content, display, details) {
+        return this.appendTypedEntry({
+            type: "custom_message",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            customType,
+            content,
+            display,
+            details,
+        });
+    }
+    async appendLabel(targetId, label) {
+        if (!(await this.storage.getEntry(targetId))) {
+            throw new SessionError("not_found", `Entry ${targetId} not found`);
+        }
+        return this.appendTypedEntry({
+            type: "label",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            targetId,
+            label,
+        });
+    }
+    async appendSessionName(name) {
+        return this.appendTypedEntry({
+            type: "session_info",
+            id: await this.storage.createEntryId(),
+            parentId: await this.storage.getLeafId(),
+            timestamp: new Date().toISOString(),
+            name: name.trim(),
+        });
+    }
+    async moveTo(entryId, summary) {
+        if (entryId !== null && !(await this.storage.getEntry(entryId))) {
+            throw new SessionError("not_found", `Entry ${entryId} not found`);
+        }
+        await this.storage.setLeafId(entryId);
+        if (!summary)
+            return undefined;
+        return this.appendTypedEntry({
+            type: "branch_summary",
+            id: await this.storage.createEntryId(),
+            parentId: entryId,
+            timestamp: new Date().toISOString(),
+            fromId: entryId ?? "root",
+            summary: summary.summary,
+            details: summary.details,
+            fromHook: summary.fromHook,
+        });
+    }
+}

package/dist/pi/agent-core/harness/session/uuid.js

@@ -0,0 +1,49 @@
+let lastTimestamp = -Infinity;
+let sequence = 0;
+function fillRandomBytes(bytes) {
+    const crypto = globalThis.crypto;
+    if (crypto?.getRandomValues) {
+        crypto.getRandomValues(bytes);
+        return;
+    }
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = Math.floor(Math.random() * 256);
+    }
+}
+export function uuidv7() {
+    const random = new Uint8Array(16);
+    fillRandomBytes(random);
+    const timestamp = Date.now();
+    if (timestamp > lastTimestamp) {
+        sequence = random[6] * 0x1000000 + random[7] * 0x10000 + random[8] * 0x100 + random[9];
+        lastTimestamp = timestamp;
+    }
+    else {
+        sequence = (sequence + 1) >>> 0;
+        if (sequence === 0) {
+            lastTimestamp++;
+        }
+    }
+    const bytes = new Uint8Array(16);
+    bytes[0] = (lastTimestamp / 0x10000000000) & 0xff;
+    bytes[1] = (lastTimestamp / 0x100000000) & 0xff;
+    bytes[2] = (lastTimestamp / 0x1000000) & 0xff;
+    bytes[3] = (lastTimestamp / 0x10000) & 0xff;
+    bytes[4] = (lastTimestamp / 0x100) & 0xff;
+    bytes[5] = lastTimestamp & 0xff;
+    bytes[6] = 0x70 | ((sequence >>> 28) & 0x0f);
+    bytes[7] = (sequence >>> 20) & 0xff;
+    bytes[8] = 0x80 | ((sequence >>> 14) & 0x3f);
+    bytes[9] = (sequence >>> 6) & 0xff;
+    bytes[10] = ((sequence & 0x3f) << 2) | (random[10] & 0x03);
+    bytes[11] = random[11];
+    bytes[12] = random[12];
+    bytes[13] = random[13];
+    bytes[14] = random[14];
+    bytes[15] = random[15];
+    return formatUuid(bytes);
+}
+function formatUuid(bytes) {
+    const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0"));
+    return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10, 16).join("")}`;
+}