@illumiarq/lumis 1.2.8 → 1.2.10

package/dist/launcher.js

@@ -0,0 +1,301 @@
+import { spawnSync } from 'node:child_process';
+import readline from 'node:readline';
+import { loadLumisConfig, saveLumisConfig } from './config-loader.js';
+import { SUPPORTED_RUNTIMES } from './commands/use.command.js';
+import { ansi } from './output/ansi.js';
+const RUNTIME_KEY_ENV = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    openrouter: 'OPENROUTER_API_KEY',
+    groq: 'GROQ_API_KEY',
+    deepseek: 'DEEPSEEK_API_KEY',
+    mistral: 'MISTRAL_API_KEY',
+    gemini: 'GEMINI_API_KEY',
+};
+const RUNTIME_GROUPS = [
+    { label: 'Agent CLIs', ids: ['claude-code', 'copilot'] },
+    { label: 'Model Providers', ids: ['ollama', 'anthropic', 'openai', 'openrouter', 'groq', 'deepseek', 'mistral', 'gemini'] },
+    { label: 'Fallback', ids: ['local'] },
+];
+function commandExists(command) {
+    const isWindows = process.platform === 'win32';
+    const lookup = isWindows ? 'where' : 'which';
+    const result = spawnSync(lookup, [command], {
+        stdio: 'ignore',
+        env: process.env,
+    });
+    return result.status === 0;
+}
+async function checkOllamaAvailability(baseUrl, timeoutMs = 1200) {
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        const response = await fetch(baseUrl, {
+            method: 'HEAD',
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        return response.status === 404 || response.status === 200;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectRuntimeScores(preferredRuntime) {
+    const preferred = preferredRuntime?.toLowerCase();
+    const env = process.env;
+    const scores = [];
+    const ollamaUrl = env['OLLAMA_BASE_URL'] ?? 'http://localhost:11434/v1';
+    const ollamaAvailable = await checkOllamaAvailability(ollamaUrl);
+    scores.push({
+        id: 'ollama',
+        score: ollamaAvailable ? (preferred === 'ollama' ? 100 : 55) : 0,
+        reason: ollamaAvailable ? `Running at ${ollamaUrl}` : 'Not running',
+        preferred: preferred === 'ollama',
+        available: ollamaAvailable,
+    });
+    const providers = [
+        { id: 'groq', key: 'GROQ_API_KEY', score: 90 },
+        { id: 'openrouter', key: 'OPENROUTER_API_KEY', score: 85 },
+        { id: 'anthropic', key: 'ANTHROPIC_API_KEY', score: 80 },
+        { id: 'openai', key: 'OPENAI_API_KEY', score: 75 },
+        { id: 'deepseek', key: 'DEEPSEEK_API_KEY', score: 70 },
+        { id: 'mistral', key: 'MISTRAL_API_KEY', score: 65 },
+        { id: 'gemini', key: 'GEMINI_API_KEY', score: 60 },
+    ];
+    for (const provider of providers) {
+        const configured = (env[provider.key] ?? '').trim().length > 0;
+        if (!configured)
+            continue;
+        const isPreferred = preferred === provider.id;
+        scores.push({
+            id: provider.id,
+            score: isPreferred ? 100 : provider.score,
+            reason: `Configured via ${provider.key}`,
+            preferred: isPreferred,
+            available: true,
+        });
+    }
+    if (preferred === 'claude-code') {
+        scores.push({ id: 'claude-code', score: 100, reason: 'Preferred runtime requested', preferred: true, available: true });
+    }
+    if (preferred === 'copilot') {
+        scores.push({ id: 'copilot', score: 100, reason: 'Preferred runtime requested', preferred: true, available: true });
+    }
+    scores.push({
+        id: 'local',
+        score: preferred === 'local' ? 100 : 5,
+        reason: 'Deterministic fallback',
+        preferred: preferred === 'local',
+        available: true,
+    });
+    scores.sort((a, b) => b.score - a.score);
+    return scores;
+}
+function runtimeStatusLabel(runtimeId, score) {
+    if (runtimeId === 'claude-code') {
+        if (commandExists('claude'))
+            return ansi.green('installed');
+        if (score?.preferred)
+            return ansi.yellow('preferred (not detected)');
+        return ansi.dim('not detected');
+    }
+    if (runtimeId === 'copilot') {
+        if (commandExists('github-copilot'))
+            return ansi.green('installed');
+        if (score?.preferred)
+            return ansi.yellow('preferred (not detected)');
+        return ansi.dim('not detected');
+    }
+    if (score?.available) {
+        return ansi.green('available');
+    }
+    const keyEnv = RUNTIME_KEY_ENV[runtimeId];
+    if (keyEnv) {
+        return ansi.dim(`missing ${keyEnv}`);
+    }
+    if (runtimeId === 'ollama') {
+        return ansi.dim('not running');
+    }
+    if (runtimeId === 'local') {
+        return ansi.green('always available');
+    }
+    return ansi.dim('unavailable');
+}
+function renderLauncher(args) {
+    const runtimeScores = new Map(args.runtimes.map((runtime) => [runtime.id, runtime]));
+    const runtimeIndex = new Map(SUPPORTED_RUNTIMES.map((runtimeId, index) => [runtimeId, index]));
+    const lines = [];
+    lines.push('\u001Bc');
+    lines.push(ansi.label('Interactive Launcher'));
+    lines.push('');
+    lines.push(ansi.bold('AI Runtime'));
+    for (const group of RUNTIME_GROUPS) {
+        lines.push(` ${ansi.dim(group.label)}`);
+        for (const runtimeId of group.ids) {
+            const index = runtimeIndex.get(runtimeId);
+            if (index === undefined) {
+                continue;
+            }
+            const score = runtimeScores.get(runtimeId);
+            const selected = args.mode === 'runtime' && args.selectedIndex === index;
+            const pointer = selected ? ansi.cyan('▸') : ' ';
+            const preferred = args.preferredRuntime === runtimeId ? ` ${ansi.yellow('★')}` : '';
+            const status = runtimeStatusLabel(runtimeId, score);
+            const scoreText = score?.available ? ansi.dim(`${score.score}%`) : ansi.dim('--');
+            lines.push(` ${pointer} ${runtimeId.padEnd(12)} ${status} ${scoreText}${preferred}`);
+        }
+        lines.push('');
+    }
+    lines.push(ansi.bold('Quick Actions'));
+    args.actions.forEach((action, index) => {
+        const selected = args.mode === 'action' && args.selectedIndex === index;
+        const pointer = selected ? ansi.cyan('▸') : ' ';
+        lines.push(` ${pointer} ${action.label}`);
+        lines.push(`     ${ansi.dim(action.description)}`);
+    });
+    lines.push('');
+    lines.push(ansi.dim(args.mode === 'runtime'
+        ? '↑/↓ navigate • tab switch sections • enter → set runtime & start session • esc quit'
+        : '↑/↓ navigate • tab switch sections • enter → run action • esc quit'));
+    return `${lines.join('\n')}\n`;
+}
+export async function runInteractiveLauncher(options) {
+    const stdin = options.stdin ?? process.stdin;
+    const stdout = options.stdout ?? process.stdout;
+    if (!stdin.isTTY || !stdout.isTTY || typeof stdin.setRawMode !== 'function') {
+        return { kind: 'exit', code: 0 };
+    }
+    const config = await loadLumisConfig(options.projectRoot);
+    const runtimes = await detectRuntimeScores(config.preferredRuntime);
+    const actions = [
+        {
+            label: 'Start AI session',
+            description: 'Open interactive AI session using the configured runtime (tinker mode)',
+            argv: ['tinker'],
+        },
+        {
+            label: 'Run doctor',
+            description: 'Diagnostics for environment and pack routing',
+            argv: ['doctor'],
+        },
+        {
+            label: 'Detect pack',
+            description: 'Probe this project and select the best adapter',
+            argv: ['pack', 'detect'],
+        },
+        {
+            label: 'List commands',
+            description: 'Show available pack/project commands',
+            argv: ['commands', 'list'],
+        },
+    ];
+    let preferredRuntime = config.preferredRuntime;
+    let mode = 'runtime';
+    let selectedIndex = 0;
+    const maxIndex = () => (mode === 'runtime' ? SUPPORTED_RUNTIMES.length - 1 : actions.length - 1);
+    const render = () => {
+        options.write(renderLauncher({
+            mode,
+            runtimes,
+            preferredRuntime,
+            actions,
+            selectedIndex,
+        }));
+    };
+    const setPreferredRuntime = (runtimeId) => {
+        saveLumisConfig(options.projectRoot, {
+            ...config,
+            preferredRuntime: runtimeId,
+        });
+        // Update local state so next render() shows the ★ on the new selection
+        preferredRuntime = runtimeId;
+    };
+    render();
+    return new Promise((resolve) => {
+        readline.emitKeypressEvents(stdin);
+        stdin.setRawMode(true);
+        stdin.resume();
+        const cleanup = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.removeListener('keypress', onKeyPress);
+        };
+        const finish = (result) => {
+            cleanup();
+            resolve(result);
+        };
+        const onKeyPress = (_str, key) => {
+            if (key.name === 'escape') {
+                finish({ kind: 'exit', code: 0 });
+                return;
+            }
+            if (key.ctrl && key.name === 'c') {
+                finish({ kind: 'exit', code: 130 });
+                return;
+            }
+            if (key.name === 'tab') {
+                mode = mode === 'runtime' ? 'action' : 'runtime';
+                selectedIndex = Math.min(selectedIndex, maxIndex());
+                render();
+                return;
+            }
+            if (key.name === 'up') {
+                selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : maxIndex();
+                render();
+                return;
+            }
+            if (key.name === 'down') {
+                selectedIndex = selectedIndex < maxIndex() ? selectedIndex + 1 : 0;
+                render();
+                return;
+            }
+            if (key.name === 'return' || key.name === 'right') {
+                if (mode === 'runtime') {
+                    const runtimeId = SUPPORTED_RUNTIMES[selectedIndex];
+                    if (!runtimeId) {
+                        finish({ kind: 'exit', code: 1 });
+                        return;
+                    }
+                    // 1. Persist preference — writes lumis.config.json
+                    setPreferredRuntime(runtimeId);
+                    // 2. Re-render so the ★ appears on the saved selection before proceeding
+                    render();
+                    // 3. Native CLI tools that are full replacements — spawn them directly
+                    if (runtimeId === 'claude-code' && commandExists('claude')) {
+                        cleanup();
+                        const result = spawnSync('claude', [], { stdio: 'inherit', env: process.env });
+                        resolve({ kind: 'exit', code: result.status ?? 0 });
+                        return;
+                    }
+                    if (runtimeId === 'copilot' && commandExists('gh')) {
+                        cleanup();
+                        const result = spawnSync('gh', ['copilot', 'suggest', '--target', 'shell'], {
+                            stdio: 'inherit',
+                            env: process.env,
+                        });
+                        resolve({ kind: 'exit', code: result.status ?? 0 });
+                        return;
+                    }
+                    if (runtimeId === 'ollama' && commandExists('ollama')) {
+                        cleanup();
+                        const result = spawnSync('ollama', ['run', 'llama3'], { stdio: 'inherit', env: process.env });
+                        resolve({ kind: 'exit', code: result.status ?? 0 });
+                        return;
+                    }
+                    // 4. API-based runtimes and local — dispatch to tinker so the AI session starts
+                    finish({ kind: 'dispatch', argv: ['tinker'] });
+                    return;
+                }
+                const action = actions[selectedIndex];
+                if (!action) {
+                    finish({ kind: 'exit', code: 1 });
+                    return;
+                }
+                finish({ kind: 'dispatch', argv: action.argv });
+            }
+        };
+        stdin.on('keypress', onKeyPress);
+    });
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

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

package/dist/lib/file-scanner.d.ts

@@ -0,0 +1,8 @@
+import type { RawDocument } from '@lumiarq/rag';
+type ScanProjectFilesOptions = {
+    maxFiles?: number;
+    maxFileSizeBytes?: number;
+};
+export declare function scanProjectFiles(projectRoot: string, options?: ScanProjectFilesOptions): Promise<RawDocument[]>;
+export {};
+//# sourceMappingURL=file-scanner.d.ts.map

package/dist/lib/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/lib/file-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,KAAK,uBAAuB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAsDD,wBAAsB,gBAAgB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,WAAW,EAAE,CAAC,CAyBxB"}

package/dist/lib/file-scanner.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+const DEFAULT_MAX_FILES = 300;
+const DEFAULT_MAX_FILE_SIZE_BYTES = 200_000;
+const ALLOWED_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.md']);
+const SKIP_DIRS = new Set([
+    '.git',
+    '.next',
+    'dist',
+    'build',
+    'coverage',
+    'node_modules',
+    '.turbo',
+    '.cache',
+]);
+function toContentHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+async function walkDirectory(root, current, files, maxFiles) {
+    if (files.length >= maxFiles)
+        return;
+    const entries = await fs.readdir(current, { withFileTypes: true });
+    for (const entry of entries) {
+        if (files.length >= maxFiles)
+            return;
+        const absolutePath = path.join(current, entry.name);
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            await walkDirectory(root, absolutePath, files, maxFiles);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const ext = path.extname(entry.name).toLowerCase();
+        if (!ALLOWED_EXTENSIONS.has(ext))
+            continue;
+        const relative = path.relative(root, absolutePath);
+        if (!relative || relative.startsWith('..'))
+            continue;
+        files.push(absolutePath);
+    }
+}
+export async function scanProjectFiles(projectRoot, options = {}) {
+    const maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
+    const maxFileSizeBytes = options.maxFileSizeBytes ?? DEFAULT_MAX_FILE_SIZE_BYTES;
+    const files = [];
+    await walkDirectory(projectRoot, projectRoot, files, maxFiles);
+    const docs = [];
+    for (const absolutePath of files) {
+        const stat = await fs.stat(absolutePath);
+        if (stat.size > maxFileSizeBytes)
+            continue;
+        const content = await fs.readFile(absolutePath, 'utf8');
+        if (!content.trim())
+            continue;
+        const relative = path.relative(projectRoot, absolutePath);
+        docs.push({
+            id: relative,
+            content,
+            contentHash: toContentHash(content),
+            metadata: { path: relative },
+        });
+    }
+    return docs;
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/lib/file-scanner.js.map

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

package/dist/lib/tinker-memory.d.ts

@@ -0,0 +1,19 @@
+export type MemoryEntry = {
+    timestamp: string;
+    project: string;
+    user: string;
+    assistant: string;
+    summary: string;
+};
+export type MemoryStore = {
+    version: 1;
+    entries: MemoryEntry[];
+};
+export declare function getMemoryFilePath(): string;
+export declare function projectFingerprint(projectRoot: string): string;
+export declare function loadMemoryStore(): MemoryStore;
+export declare function saveMemoryStore(store: MemoryStore): void;
+export declare function appendMemory(store: MemoryStore, projectRoot: string, user: string, assistant: string): MemoryStore;
+export declare function clearMemoryStore(): MemoryStore;
+export declare function retrieveMemoryContext(store: MemoryStore, projectRoot: string, query: string, maxItems?: number): string;
+//# sourceMappingURL=tinker-memory.d.ts.map

package/dist/lib/tinker-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-memory.d.ts","sourceRoot":"","sources":["../../src/lib/tinker-memory.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,EAAE,WAAW,EAAE,CAAA;CACtB,CAAA;AAID,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,eAAe,IAAI,WAAW,CAoC7C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAIxD;AAED,wBAAgB,YAAY,CAC3B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GACf,WAAW,CAkBb;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAE9C;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,SAAI,GACV,MAAM,CAyBR"}

package/dist/lib/tinker-memory.js

@@ -0,0 +1,107 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+const MAX_ENTRIES = 500;
+export function getMemoryFilePath() {
+    return path.join(os.homedir(), '.lumis', 'memory.json');
+}
+export function projectFingerprint(projectRoot) {
+    return crypto.createHash('sha256').update(projectRoot).digest('hex').slice(0, 12);
+}
+export function loadMemoryStore() {
+    const file = getMemoryFilePath();
+    try {
+        const raw = fs.readFileSync(file, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null) {
+            return { version: 1, entries: [] };
+        }
+        const obj = parsed;
+        if (obj.version !== 1 || !Array.isArray(obj.entries)) {
+            return { version: 1, entries: [] };
+        }
+        const entries = [];
+        for (const item of obj.entries) {
+            if (typeof item !== 'object' || item === null)
+                continue;
+            const e = item;
+            if (typeof e.timestamp === 'string' &&
+                typeof e.project === 'string' &&
+                typeof e.user === 'string' &&
+                typeof e.assistant === 'string' &&
+                typeof e.summary === 'string') {
+                entries.push({
+                    timestamp: e.timestamp,
+                    project: e.project,
+                    user: e.user,
+                    assistant: e.assistant,
+                    summary: e.summary,
+                });
+            }
+        }
+        return { version: 1, entries };
+    }
+    catch {
+        return { version: 1, entries: [] };
+    }
+}
+export function saveMemoryStore(store) {
+    const file = getMemoryFilePath();
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(store, null, 2), 'utf8');
+}
+export function appendMemory(store, projectRoot, user, assistant) {
+    const trimmedUser = user.trim();
+    const trimmedAssistant = assistant.trim();
+    if (!trimmedUser || !trimmedAssistant)
+        return store;
+    const summary = summarizeTurn(trimmedUser, trimmedAssistant);
+    const nextEntries = [...store.entries, {
+            timestamp: new Date().toISOString(),
+            project: projectFingerprint(projectRoot),
+            user: trimmedUser,
+            assistant: trimmedAssistant,
+            summary,
+        }];
+    return {
+        version: 1,
+        entries: nextEntries.slice(-MAX_ENTRIES),
+    };
+}
+export function clearMemoryStore() {
+    return { version: 1, entries: [] };
+}
+export function retrieveMemoryContext(store, projectRoot, query, maxItems = 5) {
+    const q = query.toLowerCase().trim();
+    if (!q)
+        return '';
+    const projectId = projectFingerprint(projectRoot);
+    const candidates = store.entries.filter((e) => e.project === projectId);
+    if (candidates.length === 0)
+        return '';
+    const tokens = q.split(/\s+/).filter((t) => t.length >= 3);
+    const scored = candidates
+        .map((entry) => {
+        const haystack = `${entry.summary}\n${entry.user}\n${entry.assistant}`.toLowerCase();
+        const score = tokens.reduce((acc, token) => acc + (haystack.includes(token) ? 1 : 0), 0);
+        return { entry, score };
+    })
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxItems);
+    if (scored.length === 0)
+        return '';
+    return [
+        'Persistent memory context (previous related turns):',
+        ...scored.map((s, idx) => `[m${idx + 1}] ${s.entry.summary}`),
+    ].join('\n');
+}
+function summarizeTurn(user, assistant) {
+    const u = user.replace(/\s+/g, ' ').trim();
+    const a = assistant.replace(/\s+/g, ' ').trim();
+    const uPart = u.length > 120 ? `${u.slice(0, 117)}...` : u;
+    const aPart = a.length > 140 ? `${a.slice(0, 137)}...` : a;
+    return `User: ${uPart} | Assistant: ${aPart}`;
+}
+//# sourceMappingURL=tinker-memory.js.map

package/dist/lib/tinker-memory.js.map

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

package/dist/lib/tinker-observer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tinker Observability
+ *
+ * Records agent turns, tool calls, and verification results to Trazze
+ * and local structured logs for replay and debugging.
+ */
+export type TinkerTurnEvent = {
+    timestamp: string;
+    sessionId: string;
+    projectFingerprint: string;
+    turnIndex: number;
+    eventType: 'user-message' | 'assistant-message' | 'tool-call' | 'tool-result' | 'verification' | 'error';
+    data: Record<string, unknown>;
+};
+export interface TinkerObserver {
+    recordTurn(event: TinkerTurnEvent): Promise<void>;
+    flush(): Promise<void>;
+}
+/**
+ * Default no-op observer.
+ */
+export declare const noopObserver: TinkerObserver;
+/**
+ * Composite observer that chains multiple observers.
+ */
+export declare class CompositeObserver implements TinkerObserver {
+    private observers;
+    constructor(observers: TinkerObserver[]);
+    recordTurn(event: TinkerTurnEvent): Promise<void>;
+    flush(): Promise<void>;
+}
+/**
+ * Trazze push observer — sends events to Trazze via HTTP/gRPC.
+ * (Stub: full implementation depends on Trazze client availability.)
+ */
+export declare class TrazzeObserver implements TinkerObserver {
+    private baseUrl;
+    private sessionId;
+    constructor(baseUrl: string, sessionId: string);
+    recordTurn(event: TinkerTurnEvent): Promise<void>;
+    flush(): Promise<void>;
+}
+/**
+ * Create an observer based on environment.
+ */
+export declare function createObserver(sessionId: string): TinkerObserver;
+//# sourceMappingURL=tinker-observer.d.ts.map

package/dist/lib/tinker-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-observer.d.ts","sourceRoot":"","sources":["../../src/lib/tinker-observer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,cAAc,GAAG,mBAAmB,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAA;IACxG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,cAG1B,CAAA;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IAC3C,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,cAAc,EAAE;IAEzC,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,cAAc;IACxC,OAAO,CAAC,OAAO;IAAU,OAAO,CAAC,SAAS;gBAAlC,OAAO,EAAE,MAAM,EAAU,SAAS,EAAE,MAAM;IAExD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAYhE"}