@aexol/spectral 0.8.2 → 0.8.5

package/dist/server/wire.d.ts

@@ -0,0 +1,448 @@
+/**
+ * WebSocket wire protocol types shared between the spectral local server and
+ * the (future) browser client in `landing/`.
+ *
+ * Keep this file dependency-free. It will be copied or imported by the
+ * frontend in Day 3, so we don't want it to drag in `better-sqlite3`,
+ * `ws`, or any pi SDK types.
+ *
+ * Naming: client → server messages are `ClientMessage`, server → client
+ * frames are `ServerEvent`. JSON-encoded one-per-frame on the wire.
+ */
+/** Base64-encoded image attached to a user message. */
+export interface ImageAttachment {
+    /** Raw base64 image data (no data URI prefix). */
+    data: string;
+    /** MIME type, e.g. "image/jpeg" or "image/png". */
+    mimeType: string;
+    /** Compressed width in pixels (optional). */
+    width?: number;
+    /** Compressed height in pixels (optional). */
+    height?: number;
+}
+/** Persisted message row as returned to the browser. */
+export interface WireMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    /** Newline-delimited JSON of pi events captured for this message (assistant only, may be ""). */
+    events: string;
+    createdAt: number;
+    /** Base64 images attached to user messages (empty for assistant/system). */
+    images?: ImageAttachment[];
+}
+/**
+ * Project — a user-declared root directory that owns 0..N sessions.
+ *
+ * Pi runs with `cwd = project.path`, so the project is the unit of "where on
+ * disk this conversation operates". Sessions are scoped to a project; the
+ * sidebar is a 2-tier projects → sessions view.
+ */
+export interface WireProject {
+    id: string;
+    name: string;
+    /** Absolute filesystem path. Server-side validated on create. */
+    path: string;
+    createdAt: number;
+    updatedAt: number;
+    /** Number of sessions currently associated with this project. */
+    sessionCount: number;
+    /** Studio project ID when the project is bound to Aexol Studio (from `.aexol/aexol.jsonc`). */
+    studioProjectId?: string;
+    /** Studio project display name when bound. Falls back to projectId if name is not set. */
+    studioProjectName?: string;
+    /** True when at least one of this project's sessions has an in-flight turn. */
+    hasActiveSession?: boolean;
+}
+/** Session row (list view — no messages). */
+export interface WireSessionSummary {
+    id: string;
+    /** Owning project. Always set — sessions cannot exist without a project. */
+    projectId: string;
+    title: string;
+    createdAt: number;
+    updatedAt: number;
+    messageCount: number;
+    /** True when this session currently has an in-flight assistant turn. */
+    hasActiveTurn?: boolean;
+}
+/** Session row with messages (detail view). */
+export interface WireSessionDetail {
+    id: string;
+    /** Owning project. Mirrors WireSessionSummary; included so the client can
+     *  recover the project context from a deep link without an extra fetch. */
+    projectId: string;
+    title: string;
+    createdAt: number;
+    updatedAt: number;
+    messages: WireMessage[];
+    /** True when this session was created via "Fork & Compact" and has not yet
+     *  had its first compaction. The UI uses this to show a special send button
+     *  for the first message. */
+    forkCompactPending?: boolean;
+}
+export interface WireSessionMemoryStatus {
+    mode: "active" | "passive";
+    phase: "idle" | "observing" | "compacting" | "reflecting" | "pruning";
+    inFlight: {
+        observer: boolean;
+        compaction: boolean;
+        reflection: boolean;
+        pruner: boolean;
+    };
+    reflections: {
+        count: number;
+        tokens: number;
+    };
+    observations: {
+        committedCount: number;
+        committedTokens: number;
+        pendingCount: number;
+        pendingTokens: number;
+    };
+    thresholds: {
+        observation: number;
+        compaction: number;
+        reflection: number;
+    };
+    progress: {
+        sinceObservationBoundTokens: number;
+        sinceLastCompactionTokens: number;
+        observationPoolTokens: number;
+    };
+}
+export interface WireObservationItem {
+    id: string;
+    content: string;
+    timestamp: string;
+    relevance: "low" | "medium" | "high" | "critical";
+    /** Whether this observation is pending (not yet covered by a compaction snapshot). */
+    pending: boolean;
+}
+export interface WireReflectionItem {
+    id: string;
+    content: string;
+    /** IDs of observations that support this reflection. May be empty for legacy reflections. */
+    supportingObservationIds: string[];
+}
+export interface WireSessionMemoryDetails {
+    summary: string | null;
+    observations: WireObservationItem[];
+    reflections: WireReflectionItem[];
+}
+export type ClientMessage = {
+    type: "user_message";
+    content: string;
+    /** Enable autonomous iterative loop for this message (Ralph Wiggum pattern). */
+    loop?: boolean;
+    /** Optional base64-encoded images attached to the message. */
+    images?: ImageAttachment[];
+};
+/**
+ * Subset of `ServerEvent` that's safe to buffer per turn and replay on
+ * reconnect. Excludes framing/lifecycle events (`session_ready`, `agent_end`)
+ * that are emitted at the session level rather than within a turn.
+ *
+ * NOTE: `message_start` IS included because the client uses it to flip into
+ * "streaming" status during replay, matching live behavior.
+ */
+export type ReplayableTurnEvent = Extract<ServerEvent, {
+    type: "message_start" | "text_delta" | "thinking_delta" | "tool_call" | "tool_result" | "message_end" | "token_usage" | "error";
+}>;
+/**
+ * Snapshot of an in-flight assistant turn — the buffered event log plus
+ * metadata. Sent inside `session_ready.currentTurn` so a reconnecting client
+ * can rebuild the timeline up to the present moment.
+ */
+export interface InProgressTurnSnapshot {
+    turnId: string;
+    startedAt: number;
+    events: ReplayableTurnEvent[];
+}
+export type ServerEvent = {
+    type: "session_ready";
+    sessionId: string;
+    history: WireMessage[];
+    /**
+     * If a turn is in flight when this WS attached, the buffered events
+     * for that turn so the client can rebuild it. `null`/absent when no
+     * turn is active. Additive: older clients ignoring this field still
+     * see consistent history.
+     */
+    currentTurn?: InProgressTurnSnapshot | null;
+    /** True when this session was created via "Fork & Compact" and is
+     *  awaiting its first compaction. The UI uses this to show a special
+     *  send button for the first message. */
+    forkCompactPending?: boolean;
+    /** Cumulative context tokens used across the session (from pi's getContextUsage()). Null when unknown. */
+    contextWindowUsed: number | null;
+    /** Model's total context window in tokens. Null when model metadata is not yet available. */
+    contextWindowMax: number | null;
+} | {
+    /**
+     * Broadcast right after a user message is persisted to SQLite. ALL
+     * subscribers receive this — including the tab that originated the
+     * `user_message`. The client de-duplicates by `message.id` (which is
+     * generated server-side at persistence time and is the source of
+     * truth). Allows multi-tab live sync to show the user's prompt in
+     * every tab without local optimistic appends.
+     */
+    type: "user_message_appended";
+    message: WireMessage;
+} | {
+    type: "message_start";
+    messageId: string;
+    role: "assistant";
+} | {
+    type: "text_delta";
+    messageId: string;
+    delta: string;
+} | {
+    type: "thinking_delta";
+    messageId: string;
+    delta: string;
+} | {
+    type: "tool_call";
+    messageId: string;
+    id: string;
+    name: string;
+    args: unknown;
+} | {
+    type: "tool_result";
+    messageId: string;
+    id: string;
+    result: unknown;
+    isError?: boolean;
+} | {
+    type: "message_end";
+    messageId: string;
+} | {
+    type: "agent_end";
+} | {
+    /**
+     * Broadcast to ALL subscribers of a session when the server changes the
+     * session's title — currently only fired by the server-side auto-titler
+     * after the first assistant turn completes. Manual user renames take a
+     * different code path (PATCH /api/sessions/:id) and the sidebar
+     * already updates locally for those.
+     *
+     * Clients should treat this as authoritative and reflect the new title
+     * everywhere it appears (sidebar list, browser tab title, etc.).
+     */
+    type: "session_renamed";
+    sessionId: string;
+    title: string;
+} | {
+    type: "error";
+    message: string;
+} | {
+    /** Emitted at the start of each loop iteration. */
+    type: "loop_iteration";
+    iteration: number;
+    maxIterations: number;
+    prompt: string;
+} | {
+    /** Emitted when the agent signals completion via <LOOP_DONE> marker. */
+    type: "loop_complete";
+    iterations: number;
+} | {
+    /** Emitted when the loop hits the safety iteration limit. */
+    type: "loop_max_iterations";
+    iterations: number;
+} | {
+    /**
+     * Emitted once per assistant message, right after `message_end`.
+     * Carries token counts and estimated usage for the just-completed
+     * assistant turn.
+     */
+    type: "token_usage";
+    messageId: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        totalTokens: number;
+        /** @deprecated Legacy USD estimate kept for wire compatibility. */
+        cost: number | null;
+        /** Estimated Aexol credits used for this message. */
+        creditsUsed: number;
+    };
+    /** Cumulative context tokens used across the session (from pi's getContextUsage()). Null if unknown. */
+    contextWindowUsed: number | null;
+    /** Model's total context window in tokens. Null if model metadata is not available. */
+    contextWindowMax: number | null;
+} | {
+    /**
+     * Emitted when pi starts context compaction (manual or auto).
+     * Non-replayable session lifecycle event; the client can use this
+     * to show a "Compacting context…" indicator.
+     */
+    type: "compaction_start";
+    /** Why compaction was triggered. */
+    reason: "manual" | "threshold" | "overflow";
+} | {
+    /**
+     * Emitted when pi completes context compaction. The session has
+     * been reloaded with the compacted context; subsequent prompts
+     * will see the reduced context window footprint.
+     */
+    type: "compaction_end";
+    /** Summary text generated by the compaction LLM call. */
+    summary: string;
+    /** Token count before compaction. */
+    tokensBefore: number;
+    /** UUID of the first branch entry kept after compaction (pi's cut point). */
+    firstKeptEntryId?: string;
+    /** True when compaction was aborted (e.g. by a new user message or manual abort). */
+    aborted?: boolean;
+} | {
+    /**
+     * Emitted by extensions (e.g. observational memory) to surface
+     * informational status updates in the browser UI. Not part of the
+     * turn timeline — purely a transient notification.
+     */
+    type: "agent_notification";
+    /** Human-readable message. */
+    message: string;
+    /** Severity level. */
+    level: "info" | "warning" | "error";
+    /**
+     * Subsystem that emitted the notification. Allows the UI to show
+     * targeted indicators (e.g. "Memory · observing").
+     */
+    system?: "memory_observer" | "memory_compaction" | "memory_reflection" | "memory_pruner" | "extension" | "vision";
+} | {
+    /**
+     * Emitted when auto-research starts for a project. The UI can show
+     * a progress indicator with the project name.
+     */
+    type: "auto_research_start";
+    projectId: string;
+} | {
+    /**
+     * Emitted periodically while auto-research is running. The `phase`
+     * field allows the UI to show granular status:
+     *   - "context_collecting" — reading project files and git state
+     *   - "context_analyzing" — LLM analyzing the collected context
+     *   - "extension_generating" — writing .ts extension files
+     *   - "extension_validating" — validating generated extensions
+     */
+    type: "auto_research_progress";
+    projectId: string;
+    phase: "context_collecting" | "context_analyzing" | "extension_generating" | "extension_validating";
+    message: string;
+} | {
+    /**
+     * Emitted when auto-research completes successfully. Contains the
+     * list of generated extensions with their names, paths, and brief
+     * descriptions. The UI can show a summary and offer to enable them.
+     */
+    type: "auto_research_complete";
+    projectId: string;
+    extensions: Array<{
+        name: string;
+        path: string;
+        description: string;
+        /** True if the extension uses LLM inference (Phase 5+). */
+        usesLLM?: boolean;
+        /** File count for multi-file extensions. */
+        fileCount?: number;
+    }>;
+    /** True if AGENTS.md was updated with an auto-research section. */
+    agentsMdUpdated?: boolean;
+} | {
+    /** Emitted when auto-research encounters an error. */
+    type: "auto_research_error";
+    projectId: string;
+    message: string;
+} | {
+    /**
+     * Emitted when a subagent tool invocation begins. The UI can show a
+     * dedicated expandable panel with agent name, task description, and
+     * a loading indicator. Parallel mode will show multiple cards.
+     */
+    type: "subagent_start";
+    /** Tool call ID so the frontend can correlate with tool_call/tool_result. */
+    toolCallId: string;
+    mode: "single" | "parallel" | "chain";
+    /** Single-mode: the agent name. */
+    agent?: string;
+    /** Single-mode: the task description. */
+    task?: string;
+    /** Parallel/chain mode: total task count. */
+    taskCount?: number;
+    /** Chain mode: total steps. */
+    totalSteps?: number;
+} | {
+    /**
+     * Emitted periodically during parallel/chain subagent execution.
+     * Carries a status message and completion counts so the UI can
+     * show live progress (e.g. "2/5 tasks done, 3 running").
+     */
+    type: "subagent_progress";
+    toolCallId: string;
+    mode: "single" | "parallel" | "chain";
+    completedCount?: number;
+    totalCount?: number;
+    currentStep?: number;
+    currentAgent?: string;
+    message: string;
+    /** Streaming text accumulated so far (single mode). Updated on text_delta. */
+    streamingText?: string;
+} | {
+    /**
+     * Emitted when a subagent tool invocation completes (all subagents
+     * finished). Carries structured results with usage stats so the
+     * frontend can render rich expandable panels with per-agent output,
+     * token counts, and model info.
+     */
+    type: "subagent_end";
+    toolCallId: string;
+    mode: "single" | "parallel" | "chain";
+    results: Array<{
+        agent: string;
+        agentSource: "user" | "project" | "unknown";
+        task: string;
+        exitCode: number;
+        /** Final output text from the subagent. */
+        output: string;
+        model?: string;
+        errorMessage?: string;
+        stopReason?: string;
+        /** Chain mode: step number (1-indexed). */
+        step?: number;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            cacheWriteTokens: number;
+            cost: number;
+            turns: number;
+        };
+    }>;
+    /** Aggregate usage across all subagents in this invocation. */
+    totalUsage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        cost: number;
+        turns: number;
+    };
+} | {
+    /**
+     * Broadcast when the prompt queue for this session changes
+     * (enqueue, remove, clear, auto-dequeue). Carries the full
+     * current queue state so clients can replace their local state
+     * atomically.
+     */
+    type: "queue_changed";
+    queue: Array<{
+        id: string;
+        content: string;
+        position: number;
+        createdAt: string;
+    }>;
+};
+//# sourceMappingURL=wire.d.ts.map

package/dist/server/wire.d.ts.map

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

package/dist/studio-binding.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Studio Binding utilities.
+ *
+ * Read/write/delete `.aexol/aexol.jsonc` — the local file that links a
+ * repository directory to an Aexol Studio project.
+ */
+export interface StudioBinding {
+    projectId: string;
+    teamId?: string;
+    name?: string;
+    $schema?: string;
+}
+/**
+ * Strip JSONC comments (// line and /* block *​/) from raw source text.
+ * Kept simple — the binding file shape is well-known.
+ */
+export declare function stripJsoncComments(raw: string): string;
+/**
+ * Read and parse the local Studio binding file.
+ * Returns `null` when no binding file exists (file missing, or directory
+ * absent — treated the same way: not bound).
+ */
+export declare function readStudioBinding(): Promise<StudioBinding | null>;
+/**
+ * Read and parse the Studio binding file at an arbitrary project path.
+ * Works like `readStudioBinding()` but reads from `projectPath/.aexol/aexol.jsonc`
+ * instead of `process.cwd()`.
+ */
+export declare function readStudioBindingAt(projectPath: string): Promise<StudioBinding | null>;
+/**
+ * Persist a Studio binding. Creates `.aexol/` if it does not exist.
+ */
+export declare function writeStudioBinding(binding: StudioBinding): Promise<void>;
+/**
+ * Persist a Studio binding at an arbitrary project path (creates `.aexol/`
+ * under that directory). Uses the same format as `writeStudioBinding`.
+ */
+export declare function writeStudioBindingAt(projectPath: string, binding: StudioBinding): Promise<void>;
+/**
+ * Remove the local Studio binding file.
+ * Returns `true` when the file existed and was deleted, `false` otherwise (no-op).
+ */
+export declare function deleteStudioBinding(): Promise<boolean>;
+//# sourceMappingURL=studio-binding.d.ts.map

package/dist/studio-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-binding.d.ts","sourceRoot":"","sources":["../src/studio-binding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAUvE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAa/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS5D"}

package/dist/studio-binding.js

@@ -4,7 +4,7 @@
  * Read/write/delete `.aexol/aexol.jsonc` — the local file that links a
  * repository directory to an Aexol Studio project.
  */
-import { readFile, writeFile, mkdir, unlink, access } from "node:fs/promises";
+import { access, mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 import { constants } from "node:fs";
 import { join } from "node:path";
 const BINDING_DIR = ".aexol";

package/package.json

@@ -1,13 +1,23 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.8.2",
+  "version": "0.8.5",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
     "spectral": "dist/cli.js",
     "aexol": "dist/cli.js"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist",
     "README.md",