@moorline/core 0.0.1

package/dist/app/control-api/services/runtimeHost.js

@@ -0,0 +1,117 @@
+import { RuntimeSupervisor } from '../../../core/runtime/supervision/runtimeSupervisor.js';
+import { resolveConfigPath, loadMoorlineConfig } from '../../../core/system/config/configStore.js';
+import { OperatorPackageService } from '../../bootstrap/operatorPackageService.js';
+import { evaluateRuntimeStartability } from '../../../core/extension/packages/runtimeStartability.js';
+import { defaultMainProcessConfig } from '../../../types/config.js';
+export class ControlApiRuntimeHostService {
+    input;
+    supervisor = null;
+    acceptingNewWork = true;
+    constructor(input) {
+        this.input = input;
+    }
+    async ensureAutostart() {
+        const config = this.loadConfig();
+        const main = config.main ?? defaultMainProcessConfig();
+        if (!main.autostart) {
+            return;
+        }
+        await this.startMain();
+    }
+    isRunning() {
+        return this.supervisor !== null;
+    }
+    mode() {
+        return this.isRunning() ? 'runtime' : 'management_only';
+    }
+    runtimeControlStatus() {
+        return {
+            acceptingNewWork: this.acceptingNewWork,
+            supervised: this.isRunning()
+        };
+    }
+    noteAcceptingNewWork(accepting) {
+        this.acceptingNewWork = accepting;
+    }
+    async stop() {
+        if (!this.supervisor) {
+            return;
+        }
+        await this.supervisor.stop('graceful');
+        this.supervisor = null;
+        this.acceptingNewWork = true;
+    }
+    async startMain() {
+        const configPath = this.requireConfigPath();
+        const config = this.loadConfig();
+        const inventory = new OperatorPackageService(config, configPath).getInventory();
+        const startability = evaluateRuntimeStartability(config, inventory);
+        if (!startability.startable || !config.transport || !config.provider) {
+            return {
+                running: false,
+                mode: this.mode(),
+                detail: startability.issues.join(' | ') || 'Runtime is not startable yet.'
+            };
+        }
+        if (this.supervisor) {
+            return {
+                running: true,
+                mode: 'runtime',
+                detail: 'Main process is already running.'
+            };
+        }
+        const supervisor = new RuntimeSupervisor({
+            entrypoint: this.input.entrypoint,
+            configPath
+        });
+        await supervisor.start();
+        this.supervisor = supervisor;
+        this.acceptingNewWork = true;
+        return {
+            running: true,
+            mode: 'runtime',
+            detail: 'Main process started.'
+        };
+    }
+    async stopMain() {
+        if (!this.supervisor) {
+            return {
+                running: false,
+                mode: this.mode(),
+                detail: 'Main process is already stopped.'
+            };
+        }
+        await this.supervisor.stop('graceful');
+        this.supervisor = null;
+        this.acceptingNewWork = true;
+        return {
+            running: false,
+            mode: 'management_only',
+            detail: 'Main process stopped.'
+        };
+    }
+    async restartMain() {
+        await this.stopMain();
+        return await this.startMain();
+    }
+    mainStatus(leases) {
+        const config = this.loadConfig();
+        const inventory = new OperatorPackageService(config, this.requireConfigPath()).getInventory();
+        const startability = evaluateRuntimeStartability(config, inventory);
+        return {
+            running: this.isRunning(),
+            mode: this.mode(),
+            startable: startability.startable && Boolean(config.transport && config.provider),
+            issues: startability.issues,
+            policy: config.main?.defaultLifecyclePolicy ?? defaultMainProcessConfig().defaultLifecyclePolicy,
+            leases
+        };
+    }
+    loadConfig() {
+        return loadMoorlineConfig(this.requireConfigPath());
+    }
+    requireConfigPath() {
+        return resolveConfigPath(this.input.configPath);
+    }
+}
+//# sourceMappingURL=runtimeHost.js.map

package/dist/app/control-api/services/runtimeHost.js.map

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

package/dist/app/control-api/services/state.d.ts

@@ -0,0 +1,19 @@
+import type { ManagementReadModel } from '../../../types/app.js';
+import { type MoorlineConfig } from '../../../types/config.js';
+export declare class ControlApiStateService {
+    private readonly input;
+    constructor(input: {
+        now?: () => string;
+        getRuntimeControlStatus: () => {
+            acceptingNewWork: boolean;
+            supervised: boolean;
+        };
+        getManagementSurface: () => {
+            enabled: boolean;
+            host: string;
+            port: number;
+            url: string | null;
+        };
+    });
+    build(config: MoorlineConfig): ManagementReadModel;
+}

package/dist/app/control-api/services/state.js

@@ -0,0 +1,177 @@
+import { EventEmitter } from 'node:events';
+import { join } from 'node:path';
+import { MissionRegistry } from '../../../core/domain/missions/missionRegistry.js';
+import { SkillRegistry } from '../../../core/extension/skills/skillRegistry.js';
+import { loadInstallationState, runtimePaths } from '../../../core/system/config/configStore.js';
+import { ManagementReadModelService } from '../../../core/system/projection/managementReadModelService.js';
+import { RuntimeSnapshotQuery } from '../../../core/system/projection/runtimeSnapshotQuery.js';
+import { SqliteSessionStore } from '../../../core/system/state/sqliteSessionStore.js';
+import { computeRuntimeStatus } from '../../../core/runtime/runtimeStatus.js';
+import { SidecarManager } from '../../../core/runtime/supervision/sidecarManager.js';
+import { homeRootForRuntime } from '../../../types/config.js';
+import { OFFICIAL_CATALOG } from '../../bootstrap/officialCatalog.js';
+import { ProviderSessionDirectory } from '../../../core/runtime/execution/providerSessionDirectory.js';
+class SnapshotRuntimeProvider extends EventEmitter {
+    store;
+    constructor(store) {
+        super();
+        this.store = store;
+    }
+    listSessions() {
+        return new ProviderSessionDirectory(this.store).list().map((binding) => ({
+            providerPackageId: binding.providerPackageId,
+            provider: binding.providerPackageId,
+            threadId: binding.threadId,
+            runtimeMode: binding.runtimeMode,
+            cwd: binding.workspacePath,
+            model: binding.model ?? undefined,
+            status: binding.status,
+            resumeCursor: binding.providerThreadId ? { threadId: binding.providerThreadId } : undefined,
+            createdAt: binding.updatedAt,
+            updatedAt: binding.updatedAt,
+            lastError: binding.lastError ?? undefined
+        }));
+    }
+    getDiagnostics() {
+        const bindings = new ProviderSessionDirectory(this.store).list();
+        const latest = bindings.at(-1) ?? null;
+        const statusCounts = bindings.reduce((counts, binding) => {
+            counts[binding.status] = (counts[binding.status] ?? 0) + 1;
+            return counts;
+        }, {});
+        return {
+            accountLabel: latest?.accountLabel ?? null,
+            availableModels: latest?.availableModels ?? [],
+            connectedSessions: bindings.length,
+            statusCounts,
+            capabilityMetadata: latest?.capabilityMetadata ?? {}
+        };
+    }
+    async startOrResumeSession(_) {
+        throw new Error('Provider session start is only available from the running main process.');
+    }
+    async recoverSessions(_) {
+        throw new Error('Provider recovery is only available from the running main process.');
+    }
+    async sendTurn(_, __, ___) {
+        throw new Error('Provider turns are only available from the running main process.');
+    }
+    async compactThread(_) {
+        throw new Error('Provider thread compaction is only available from the running main process.');
+    }
+    async respondToRequest(_, __, ___) {
+        throw new Error('Pending request responses are only available from the running main process.');
+    }
+    async respondToUserInput(_, __, ___) {
+        throw new Error('Pending request responses are only available from the running main process.');
+    }
+    async interruptTurn(_) {
+        throw new Error('Turn interruption is only available from the running main process.');
+    }
+    async drain() {
+        return undefined;
+    }
+    stopSession() {
+        return undefined;
+    }
+    stopAll() {
+        return undefined;
+    }
+}
+function controlApiPresentation() {
+    return {
+        productDirection: 'Moorline runtime with an API-first control plane and independent clients.',
+        setupReadyNextAction: 'Use the CLI against the Control API.',
+        setupIncompleteNextAction: 'Finish transport and provider setup through the Control API, then start the main process.',
+        contract: {
+            readableResources: ['runtime.status', 'runtime.control', 'packages', 'history', 'pending_requests'],
+            writableActions: ['runtime.reload', 'runtime.accepting', 'provider.control', 'packages.apply', 'history.restore'],
+            trust: {
+                authMode: 'bearer-token',
+                loopbackOnly: true,
+                tokenSource: 'local-connection-record',
+                restartBehavior: 'adapter-restart-required'
+            },
+            navigation: ['operations', 'configure', 'history', 'requests'],
+            deliveryTracks: [],
+            recoveryActions: []
+        },
+        delivery: {
+            install: {
+                packageTargets: [],
+                installedComponents: ['control-api', 'cli', 'main-process'],
+                uninstallBehavior: 'Preserve runtime root by default.'
+            },
+            onboarding: {
+                steps: ['configure', 'apply', 'start-main'],
+                requiredInputs: ['transport package', 'provider package'],
+                prerequisiteChecks: ['local runtime root'],
+                completionState: 'ready when transport and provider are selected and applied'
+            },
+            lifecycle: {
+                clientDisconnectBehavior: 'CLI and remote clients disconnect independently from the Control API and main process.',
+                runtimeStopBehavior: 'Stop the main process explicitly or via stop_on_last_lease.',
+                startAtLogin: 'manual',
+                backgroundMode: 'Control API and main process run independently.',
+                failureRecovery: 'Restart the main process through the Control API.'
+            },
+            updates: {
+                appUpdates: 'Operator triggered.',
+                officialPackageUpdates: 'Applied through package management and restart.',
+                localPackageHandling: 'Never overwrite local packages.',
+                operatorTrigger: 'Use the Control API through the CLI.'
+            }
+        }
+    };
+}
+export class ControlApiStateService {
+    input;
+    constructor(input) {
+        this.input = input;
+    }
+    build(config) {
+        const now = this.input.now ?? (() => new Date().toISOString());
+        const paths = runtimePaths(config.runtimeRoot);
+        const store = new SqliteSessionStore(paths.sqlitePath);
+        try {
+            const snapshots = new RuntimeSnapshotQuery(store, store.database());
+            const missions = new MissionRegistry(store, paths.workspacesDir);
+            const skills = new SkillRegistry([join(config.runtimeRoot, 'packages', 'skills')]);
+            const provider = new SnapshotRuntimeProvider(store);
+            const sidecars = new SidecarManager({
+                runtimeRoot: config.runtimeRoot,
+                store,
+                now,
+                appendAuditEvent: () => undefined
+            });
+            const startedAtIso = store.getMetadata('runtime.started_at') ?? null;
+            const namespaceState = loadInstallationState(paths.installationPath);
+            const service = new ManagementReadModelService({
+                homeRoot: homeRootForRuntime(config.runtimeRoot),
+                runtimeRoot: config.runtimeRoot,
+                config,
+                snapshots,
+                missions,
+                skills,
+                provider,
+                sidecars,
+                now,
+                getRuntimeControlStatus: () => this.input.getRuntimeControlStatus(),
+                getRuntimeStatus: () => computeRuntimeStatus({
+                    snapshots,
+                    startedAtIso,
+                    now
+                }),
+                getNamespaceState: () => namespaceState,
+                getManagementSurface: () => this.input.getManagementSurface(),
+                packageCatalog: OFFICIAL_CATALOG,
+                presentation: controlApiPresentation()
+            });
+            return service.build();
+        }
+        finally {
+            store.close();
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/app/control-api/services/state.js.map

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

package/dist/core/domain/memory/operatorMemoryService.d.ts

@@ -0,0 +1,36 @@
+interface MemoryStatus {
+    scopeId: string;
+    runtimeRoot: string;
+    sqlitePath: string;
+    files: {
+        server: number;
+        sessions: number;
+        projects: number;
+        total: number;
+    };
+    retrievalIndex: {
+        chunks: number;
+        embeddings: number;
+    };
+}
+interface MemorySearchResult {
+    id: string;
+    content: string;
+    sourceRefs: string[];
+    strategy: 'symbolic' | 'semantic' | 'metadata';
+    score: number;
+}
+export declare function getOperatorMemoryStatus(input: {
+    runtimeRoot: string;
+    sqlitePath: string;
+    scopeId: string;
+}): MemoryStatus;
+export declare function searchOperatorMemory(input: {
+    runtimeRoot: string;
+    sqlitePath: string;
+    scopeId: string;
+    query: string;
+    maxResults?: number;
+    enableRerank?: boolean;
+}): Promise<MemorySearchResult[]>;
+export {};

package/dist/core/domain/memory/operatorMemoryService.js

@@ -0,0 +1,81 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { retrieveFromMemoryWithSQLite } from './retrieval.js';
+import { openRuntimeSqliteDatabase } from '../../system/state/sqlite/connection.js';
+import { ensureRetrievalSchema } from './retrieval/schema.js';
+function countMarkdownFiles(root) {
+    if (!existsSync(root)) {
+        return 0;
+    }
+    let count = 0;
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current) {
+            continue;
+        }
+        try {
+            readdirSync(current, { withFileTypes: true }).forEach((entry) => {
+                if (entry.isDirectory()) {
+                    stack.push(join(current, entry.name));
+                }
+                else if (entry.isFile() && entry.name.toLowerCase().endsWith('.md')) {
+                    count += 1;
+                }
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return count;
+}
+function queryIndexCounts(sqlitePath) {
+    if (!existsSync(sqlitePath)) {
+        return { chunks: 0, embeddings: 0 };
+    }
+    const db = openRuntimeSqliteDatabase(sqlitePath);
+    try {
+        ensureRetrievalSchema(db);
+        const chunks = db.prepare('SELECT COUNT(*) as count FROM retrieval_chunks').get()?.count ?? 0;
+        const embeddings = db.prepare('SELECT COUNT(*) as count FROM retrieval_embeddings').get()?.count ?? 0;
+        return { chunks, embeddings };
+    }
+    finally {
+        db.close();
+    }
+}
+export function getOperatorMemoryStatus(input) {
+    const scopeDir = `g${input.scopeId}`;
+    const server = countMarkdownFiles(join(input.runtimeRoot, 'memory', 'server', scopeDir));
+    const sessions = countMarkdownFiles(join(input.runtimeRoot, 'memory', 'sessions', scopeDir));
+    const projects = countMarkdownFiles(join(input.runtimeRoot, 'memory', 'projects'));
+    const index = queryIndexCounts(input.sqlitePath);
+    return {
+        scopeId: input.scopeId,
+        runtimeRoot: input.runtimeRoot,
+        sqlitePath: input.sqlitePath,
+        files: {
+            server,
+            sessions,
+            projects,
+            total: server + sessions + projects
+        },
+        retrievalIndex: index
+    };
+}
+export async function searchOperatorMemory(input) {
+    const query = input.query.trim();
+    if (!query) {
+        throw new Error('memory search query is required.');
+    }
+    const docs = await retrieveFromMemoryWithSQLite(query, input.runtimeRoot, { scopeId: input.scopeId, projectKey: 'default' }, input.sqlitePath, { maxResults: input.maxResults, enableRerank: input.enableRerank ?? true });
+    return docs.map((entry) => ({
+        id: entry.id,
+        content: entry.content,
+        sourceRefs: [...entry.sourceRefs],
+        strategy: entry.strategy,
+        score: entry.score
+    }));
+}
+//# sourceMappingURL=operatorMemoryService.js.map

package/dist/core/domain/memory/operatorMemoryService.js.map

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

package/dist/core/domain/memory/pathSafety.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizePathSegment(value: string, label: string): string;
+export declare function resolveContainedPath(rootDir: string, pathSegments: string[], label: string): string;

package/dist/core/domain/memory/pathSafety.js

@@ -0,0 +1,36 @@
+import { isAbsolute, relative, resolve } from 'node:path';
+function containsForbiddenPathChar(value) {
+    for (const char of value) {
+        if (char === '/' || char === '\\') {
+            return true;
+        }
+        const code = char.charCodeAt(0);
+        if ((code >= 0 && code <= 31) || code === 127) {
+            return true;
+        }
+    }
+    return false;
+}
+export function sanitizePathSegment(value, label) {
+    const normalized = value.trim().normalize('NFKC');
+    if (!normalized) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+    if (normalized === '.' || normalized === '..' || normalized.includes('..')) {
+        throw new Error(`${label} must not include dot-segments.`);
+    }
+    if (containsForbiddenPathChar(normalized)) {
+        throw new Error(`${label} contains forbidden path characters.`);
+    }
+    return normalized;
+}
+export function resolveContainedPath(rootDir, pathSegments, label) {
+    const resolvedRoot = resolve(rootDir);
+    const resolvedPath = resolve(resolvedRoot, ...pathSegments);
+    const rel = relative(resolvedRoot, resolvedPath);
+    if (rel === '' || (!rel.startsWith('..') && !isAbsolute(rel))) {
+        return resolvedPath;
+    }
+    throw new Error(`${label} resolved outside the runtime memory root.`);
+}
+//# sourceMappingURL=pathSafety.js.map

package/dist/core/domain/memory/pathSafety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSafety.js","sourceRoot":"","sources":["../../../../../../../src/core/domain/memory/pathSafety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,SAAS,yBAAyB,CAAC,KAAa;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iCAAiC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,yBAAyB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,YAAsB,EAAE,KAAa;IACzF,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,YAAY,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4CAA4C,CAAC,CAAC;AACxE,CAAC"}

package/dist/core/domain/memory/retrieval/fileWalker.d.ts

@@ -0,0 +1 @@
+export declare function walkMarkdownFiles(rootDir: string): Promise<string[]>;

package/dist/core/domain/memory/retrieval/fileWalker.js

@@ -0,0 +1,31 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function walkMarkdownFiles(rootDir) {
+    const files = [];
+    const stack = [rootDir];
+    while (stack.length) {
+        const dir = stack.pop();
+        if (!dir) {
+            continue;
+        }
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fullPath);
+                continue;
+            }
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=fileWalker.js.map

package/dist/core/domain/memory/retrieval/fileWalker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWalker.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/fileWalker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;IAExB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QAED,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/domain/memory/retrieval/indexTargets.d.ts

@@ -0,0 +1,3 @@
+import type { IndexTarget } from './types.js';
+import type { NormalizedRetrievalScope } from './scope.js';
+export declare function buildIndexTargets(repoPath: string, scope: NormalizedRetrievalScope): IndexTarget[];

package/dist/core/domain/memory/retrieval/indexTargets.js

@@ -0,0 +1,43 @@
+import { resolveContainedPath } from '../pathSafety.js';
+export function buildIndexTargets(repoPath, scope) {
+    const targets = [
+        {
+            layer: 'project',
+            rootPath: resolveContainedPath(repoPath, ['memory', 'projects', scope.projectKey], 'Project retrieval root'),
+            projectKey: scope.projectKey,
+            scopeId: null,
+            spaceId: null,
+            threadId: null
+        },
+        {
+            layer: 'server',
+            rootPath: resolveContainedPath(repoPath, ['memory', 'server', `g${scope.scopeId}`], 'Server retrieval root'),
+            projectKey: null,
+            scopeId: scope.scopeId,
+            spaceId: null,
+            threadId: null
+        }
+    ];
+    if (scope.spaceId) {
+        targets.push({
+            layer: 'session',
+            rootPath: resolveContainedPath(repoPath, ['memory', 'sessions', `g${scope.scopeId}`, `c${scope.spaceId}`, scope.threadId ?? 'root'], 'Session retrieval root'),
+            projectKey: null,
+            scopeId: scope.scopeId,
+            spaceId: scope.spaceId,
+            threadId: scope.threadId ?? 'root'
+        });
+    }
+    else {
+        targets.push({
+            layer: 'session',
+            rootPath: resolveContainedPath(repoPath, ['memory', 'sessions', `g${scope.scopeId}`], 'Session retrieval root'),
+            projectKey: null,
+            scopeId: scope.scopeId,
+            spaceId: null,
+            threadId: null
+        });
+    }
+    return targets;
+}
+//# sourceMappingURL=indexTargets.js.map

package/dist/core/domain/memory/retrieval/indexTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTargets.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/indexTargets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIxD,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAA+B;IACjF,MAAM,OAAO,GAAkB;QAC7B;YACE,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,wBAAwB,CAAC;YAC5G,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;SACf;QACD;YACE,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,uBAAuB,CAAC;YAC5G,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;SACf;KACF,CAAC;IAEF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,oBAAoB,CAC5B,QAAQ,EACR,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,EAC1F,wBAAwB,CACzB;YACD,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,MAAM;SACnC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,wBAAwB,CAAC;YAC/G,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/domain/memory/retrieval/markdownChunker.d.ts

@@ -0,0 +1,3 @@
+export declare function extractHeadings(content: string): string[];
+export declare function tokenizeMetadata(input: string): string[];
+export declare function markdownAwareChunks(content: string): string[];