@aexol/spectral 0.8.2 → 0.8.5

package/dist/memory/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memory/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,+QAA+Q,CAAC;AAE1S,eAAO,MAAM,yBAAyB,6oHAmD+F,CAAC;AAEtI,eAAO,MAAM,0BAA0B,67CAkB+F,CAAC;AAEvI,eAAO,MAAM,gBAAgB,8+CAasI,CAAC;AAEpK,eAAO,MAAM,eAAe,knTAoC2G,CAAC;AAExI,eAAO,MAAM,gBAAgB,69UA0DwH,CAAC;AAEtJ,eAAO,MAAM,aAAa,u2cAgFuP,CAAC;AASlR,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlF;AASD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,eAAO,MAAM,0BAA0B,07BAOoS,CAAC"}

package/dist/memory/relevance.d.ts

@@ -0,0 +1,4 @@
+import { type ObservationRecord, type Relevance } from "./types.js";
+export declare function countByRelevance(records: ObservationRecord[]): Record<Relevance, number>;
+export declare function formatRelevanceHistogram(counts: Record<Relevance, number>): string;
+//# sourceMappingURL=relevance.d.ts.map

package/dist/memory/relevance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relevance.d.ts","sourceRoot":"","sources":["../../src/memory/relevance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAoB,MAAM,YAAY,CAAC;AAEtF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAIxF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,CAMlF"}

package/dist/memory/runtime.d.ts

@@ -0,0 +1,40 @@
+import { type Config } from "./config.js";
+export type ResolveResult = {
+    ok: true;
+    model: unknown;
+    apiKey: string;
+    headers?: Record<string, string>;
+} | {
+    ok: false;
+    reason: string;
+};
+type NotifyLevel = "warning" | "info" | "error";
+type Notify = (message: string, type?: NotifyLevel) => void;
+export interface ResolveCtx {
+    model: unknown;
+    modelRegistry: any;
+    hasUI: boolean;
+    ui?: {
+        notify: Notify;
+    };
+}
+export interface LaunchCtx {
+    hasUI: boolean;
+    ui?: {
+        notify: Notify;
+    };
+}
+export declare class Runtime {
+    config: Config;
+    configLoaded: boolean;
+    observerInFlight: boolean;
+    observerPromise: Promise<void> | null;
+    compactInFlight: boolean;
+    compactHookInFlight: boolean;
+    resolveFailureNotified: boolean;
+    ensureConfig(cwd: string): void;
+    resolveModel(ctx: ResolveCtx): Promise<ResolveResult>;
+    launchObserverTask(ctx: LaunchCtx, label: string, work: () => Promise<void>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/memory/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/memory/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAwB,MAAM,aAAa,CAAC;AAEhE,MAAM,MAAM,aAAa,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAChD,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;AAE5D,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,GAAG,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAED,qBAAa,OAAO;IACnB,MAAM,EAAE,MAAM,CAAmB;IACjC,YAAY,UAAS;IACrB,gBAAgB,UAAS;IACzB,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC7C,eAAe,UAAS;IACxB,mBAAmB,UAAS;IAC5B,sBAAsB,UAAS;IAE/B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB3D,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB3F"}

package/dist/memory/serialize.d.ts

@@ -0,0 +1,26 @@
+import type { Message } from "../sdk/ai/index.js";
+export declare function serializeConversation(messages: Message[]): string;
+export declare function nowTimestamp(): string;
+export declare const MAX_RECORD_CONTENT_CHARS = 10000;
+export declare function truncateRecordContent(content: string): string;
+export type RenderableEntry = {
+    type: string;
+    id?: string;
+    timestamp?: string;
+    message?: unknown;
+    customType?: string;
+    content?: unknown;
+    summary?: unknown;
+};
+export declare function serializeBranchEntries(entries: RenderableEntry[]): string;
+export type SourceAddressedSerialization = {
+    text: string;
+    sourceEntryIds: string[];
+};
+export declare const DURABLE_SOURCE_ENTRY_ID_PREFIX = "srcv1:";
+export declare function durableSourceEntryId(entry: RenderableEntry): string | undefined;
+export declare function sourceEntryReferenceIds(entry: RenderableEntry): string[];
+export declare function serializeSourceAddressedBranchEntries(entries: RenderableEntry[]): SourceAddressedSerialization;
+export declare function renderRecallSourceEntry(entry: RenderableEntry): string | null;
+export declare function renderRecallSourceEntries(entries: RenderableEntry[]): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/memory/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/memory/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAkC,MAAM,oBAAoB,CAAC;AAuElF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAwBjE;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAsBF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAkBzE;AAED,MAAM,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAevD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAY/E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAMxE;AAED,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,4BAA4B,CAY9G;AAuBD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAQ7E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAK5E"}

package/dist/memory/tokens.d.ts

@@ -0,0 +1,8 @@
+export declare function estimateStringTokens(text: string): number;
+export declare function estimateEntryTokens(entry: {
+    type: string;
+    message?: unknown;
+    content?: unknown;
+    summary?: unknown;
+}): number;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/memory/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/memory/tokens.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAmB5H"}

package/dist/memory/tools/read-project-observations.d.ts

@@ -0,0 +1,8 @@
+import { Type } from "../../sdk/ai/index.js";
+import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export declare const READ_PROJECT_OBSERVATIONS_TOOL_NAME = "read_project_observations";
+export declare const readProjectObservationsTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
+    query: Type.TString;
+}>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
+export declare function registerReadProjectObservationsTool(pi: ExtensionAPI): void;
+//# sourceMappingURL=read-project-observations.d.ts.map

package/dist/memory/tools/read-project-observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFAqFtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE1E"}

package/dist/memory/tools/recall-observation.d.ts

@@ -0,0 +1,63 @@
+import { Type } from "../../sdk/ai/index.js";
+import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
+import { type RecallMemoryObservation } from "../branch.js";
+import type { ObservationRecord, ReflectionRecord } from "../types.js";
+export declare const RECALL_OBSERVATION_TOOL_NAME = "recall";
+type RecallObservationToolStatus = "ok" | "partial" | "invalid_id" | "not_found" | "no_source" | "source_unavailable" | "no_provenance";
+type ObservationDetails = Pick<ObservationRecord, "id" | "content" | "timestamp" | "relevance">;
+type ReflectionDetails = Pick<ReflectionRecord, "id" | "content" | "supportingObservationIds" | "legacy"> & {
+    reflectionIndex: number;
+};
+export type RecallSourceEntryDetails = {
+    id: string;
+    origin: string;
+    timestamp: string;
+    tokens: number;
+    qualifiers: string[];
+    content?: string;
+};
+type RecallObservationMatchDetails = {
+    status: RecallMemoryObservation["status"];
+    observationEntryId: string;
+    observationRecordIndex: number;
+    observation: ObservationDetails;
+    sourceEntryIds?: string[];
+    sourceEntries?: RecallSourceEntryDetails[];
+    missingSourceEntryIds?: string[];
+    nonSourceEntryIds?: string[];
+    sourceCharacterCount?: number;
+};
+type RecallUnavailableSupportingObservationDetails = {
+    reflectionId: string;
+    reflectionIndex: number;
+    observationId: string;
+};
+type RecallUnavailableReflectionProvenanceDetails = {
+    reflectionId: string;
+    reflectionIndex: number;
+    reason: "legacy";
+};
+export type RecallObservationToolDetails = {
+    status: RecallObservationToolStatus;
+    memoryId: string;
+    observationId: string;
+    collision: boolean;
+    partial: boolean;
+    reflections: ReflectionDetails[];
+    directObservationMatches: RecallObservationMatchDetails[];
+    observations: RecallObservationMatchDetails[];
+    matches: RecallObservationMatchDetails[];
+    sourceEntries: RecallSourceEntryDetails[];
+    unavailableSupportingObservations: RecallUnavailableSupportingObservationDetails[];
+    unavailableReflectionProvenance: RecallUnavailableReflectionProvenanceDetails[];
+    missingSourceEntryIds: string[];
+    nonSourceEntryIds: string[];
+    sourceCharacterCount?: number;
+    message?: string;
+};
+export declare const recallObservationTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
+    id: Type.TString;
+}>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
+export declare function registerRecallTool(pi: ExtensionAPI): void;
+export {};
+//# sourceMappingURL=recall-observation.d.ts.map

package/dist/memory/tools/recall-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/recall-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAGN,KAAK,uBAAuB,EAE5B,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAIrD,KAAK,2BAA2B,GAC7B,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,eAAe,CAAC;AAEnB,KAAK,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAChG,KAAK,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,0BAA0B,GAAG,QAAQ,CAAC,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAExI,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACpC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,6CAA6C,GAAG;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4CAA4C,GAAG;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,wBAAwB,EAAE,6BAA6B,EAAE,CAAC;IAC1D,YAAY,EAAE,6BAA6B,EAAE,CAAC;IAC9C,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,iCAAiC,EAAE,6CAA6C,EAAE,CAAC;IACnF,+BAA+B,EAAE,4CAA4C,EAAE,CAAC;IAChF,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuUF,eAAO,MAAM,qBAAqB;;iFAuChC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEzD"}

package/dist/memory/tools/write-project-observation.d.ts

@@ -0,0 +1,9 @@
+import { Type } from "../../sdk/ai/index.js";
+import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export declare const WRITE_PROJECT_OBSERVATION_TOOL_NAME = "write_project_observation";
+export declare const writeProjectObservationTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
+    content: Type.TString;
+    relevance: Type.TUnion<[Type.TLiteral<"low">, Type.TLiteral<"medium">, Type.TLiteral<"high">, Type.TLiteral<"critical">]>;
+}>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
+export declare function registerWriteProjectObservationTool(pi: ExtensionAPI): void;
+//# sourceMappingURL=write-project-observation.d.ts.map

package/dist/memory/tools/write-project-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA6DtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE1E"}

package/dist/memory/types.d.ts

@@ -0,0 +1,65 @@
+export declare const OBSERVATION_CUSTOM_TYPE = "om.observation";
+export declare const OBSERVATIONAL_MEMORY_SNAPSHOT_CUSTOM_TYPE = "om.snapshot";
+export declare const OBSERVATIONAL_MEMORY_CONTEXT_CUSTOM_TYPE = "om.snapshot.context";
+export type Relevance = "low" | "medium" | "high" | "critical";
+export declare const RELEVANCE_VALUES: readonly Relevance[];
+export declare const MEMORY_ID_PATTERN: RegExp;
+export interface ObservationRecord {
+    id: string;
+    content: string;
+    timestamp: string;
+    relevance: Relevance;
+    sourceEntryIds?: string[];
+}
+export type LegacyReflection = string;
+export interface ReflectionRecord {
+    id: string;
+    content: string;
+    supportingObservationIds: string[];
+    legacy?: boolean;
+}
+export type MemoryReflection = LegacyReflection | ReflectionRecord;
+/**
+ * Current runtime reflection alias used by pre-v4 consumers. Later producer/consumer
+ * steps should migrate surfaces that need id-bearing records to MemoryReflection.
+ */
+export type Reflection = LegacyReflection;
+export interface MemoryDetailsV3 {
+    type: "observational-memory";
+    version: 3;
+    observations: ObservationRecord[];
+    reflections: LegacyReflection[];
+}
+export interface MemoryDetailsV4 {
+    type: "observational-memory";
+    version: 4;
+    observations: ObservationRecord[];
+    reflections: MemoryReflection[];
+}
+export type SupportedMemoryDetails = MemoryDetailsV3 | MemoryDetailsV4;
+export type MemoryDetails = MemoryDetailsV3;
+export interface ObservationEntryData {
+    records: ObservationRecord[];
+    coversFromId: string;
+    coversUpToId: string;
+    tokenCount: number;
+}
+export interface RestoredMemorySnapshot {
+    type: "observational-memory-snapshot";
+    version: 1;
+    coveredSourceCount: number;
+    summary: string;
+    details: SupportedMemoryDetails;
+}
+export declare function isReflectionRecord(v: unknown): v is ReflectionRecord;
+export declare function isMemoryReflection(v: unknown): v is MemoryReflection;
+export declare function reflectionContent(reflection: MemoryReflection): string;
+export declare function reflectionId(reflection: MemoryReflection): string | undefined;
+export declare function reflectionToPromptLine(reflection: MemoryReflection): string;
+export declare function isMemoryDetailsV3(d: unknown): d is MemoryDetailsV3;
+export declare function isMemoryDetailsV4(d: unknown): d is MemoryDetailsV4;
+export declare function isSupportedMemoryDetails(d: unknown): d is SupportedMemoryDetails;
+export declare function isMemoryDetails(d: unknown): d is MemoryDetails;
+export declare function isObservationEntryData(d: unknown): d is ObservationEntryData;
+export declare function isRestoredMemorySnapshot(d: unknown): d is RestoredMemorySnapshot;
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

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

package/dist/preflight.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared pre-flight check: every authenticated `spectral` subcommand (and the
+ * fall-through to pi) must verify that credentials exist in
+ * `~/.spectral/config.json` before proceeding.
+ *
+ * Extracted from `cli.ts` so `serve` (and any future subcommand) reuses the
+ * exact same UX — message wording, exit code, stderr formatting.
+ *
+ * `requireLogin()` writes to stderr and calls `process.exit(1)` on failure;
+ * `checkLogin()` is the testable variant that just reports the result so we
+ * can assert on it without killing the test runner.
+ */
+import { type SpectralConfig } from "./config.js";
+export interface LoginCheckResult {
+    ok: boolean;
+    config: SpectralConfig | null;
+    /** Path that was inspected. Surfaced so callers can include it in messages. */
+    configFile: string;
+}
+/** Inspect login state without side effects. Safe to call from tests. */
+export declare function checkLogin(): Promise<LoginCheckResult>;
+/**
+ * Enforce login: returns the config on success, prints a friendly error and
+ * exits 1 on failure. Matches the wording used by the main spawn path.
+ */
+export declare function requireLogin(): Promise<SpectralConfig>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD,yEAAyE;AACzE,wBAAsB,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAG5D;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,CAQ5D"}

package/dist/preflight.js

@@ -14,7 +14,9 @@ import { getConfigFile, readConfig } from "./config.js";
 // Plain ANSI red. Mirrors the helper in cli.ts; we intentionally keep this
 // dependency-light so pre-flight stays cheap on cold start.
 function red(s) {
-    return process.stdout.isTTY || process.stderr.isTTY ? `\x1b[31m${s}\x1b[0m` : s;
+    return process.stdout.isTTY || process.stderr.isTTY
+        ? `\x1b[31m${s}\x1b[0m`
+        : s;
 }
 /** Inspect login state without side effects. Safe to call from tests. */
 export async function checkLogin() {

package/dist/relay/auto-research.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Auto-research handler — sends an auto-research task through the existing
+ * AgentBridge (backend proxy) instead of spawning a separate pi process.
+ *
+ * This ensures auto-research uses the same model and API keys as the active
+ * session — no separate subprocess, no missing API key errors.
+ *
+ * Flow:
+ *   1. Build the auto-research task prompt
+ *   2. Ensure session subscriber exists (borrows handleClientMessage pattern)
+ *   3. Emit auto_research_start via relay
+ *   4. Send task via manager.prompt() — goes through backend proxy with session's model
+ *   5. Attach a watcher subscriber to detect turn completion
+ *   6. On agent_end, scan for generated extensions and emit auto_research_complete
+ *   7. On error, emit auto_research_error
+ */
+import type { SessionStore } from "../server/storage.js";
+import type { SessionStreamManager, Subscriber } from "../server/session-stream.js";
+import type { RelayClient } from "./client.js";
+/** Input shape consumed by `handleAutoResearch`. */
+export interface AutoResearchInput {
+    projectId: string;
+    sessionId: string;
+}
+/** Dependencies injected by the dispatcher. */
+export interface AutoResearchDeps {
+    store: SessionStore;
+    manager: SessionStreamManager;
+    relay: Pick<RelayClient, "send">;
+    /** Subscriber map shared with handleClientMessage — ensures the session
+     *  already has a wire subscriber before we prompt. */
+    subscribers: Map<string, Subscriber>;
+    /** Project working directory (cwd from serve.ts). Used for file scanning. */
+    cwd: string;
+    /** Optional logger. Defaults to console.error. */
+    logger?: {
+        error: (...args: unknown[]) => void;
+    };
+}
+/**
+ * An extension discovered or generated by auto-research.
+ * Mirrors the shape in `ServerEvent["auto_research_complete"]["extensions"]`.
+ */
+export interface AutoResearchExtension {
+    name: string;
+    path: string;
+    description: string;
+    usesLLM?: boolean;
+    fileCount?: number;
+}
+/**
+ * Execute auto-research for a project through the existing AgentBridge.
+ *
+ * Caller (dispatcher) is fire-and-forget — this function is `void` and
+ * all errors are surfaced as `auto_research_error` events on the wire
+ * rather than thrown.
+ *
+ * This replaces the old subprocess-spawning approach. Instead of launching
+ * a separate pi process (which lacks backend proxy credentials), we send
+ * the auto-research task through the session's existing AgentBridge. The agent
+ * uses the session's model, backend proxy, and all available tools.
+ */
+export declare function handleAutoResearch(input: AutoResearchInput, deps: AutoResearchDeps): void;
+//# sourceMappingURL=auto-research.d.ts.map

package/dist/relay/auto-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-research.d.ts","sourceRoot":"","sources":["../../src/relay/auto-research.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC;0DACsD;IACtD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAksBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAmLN"}