@illumiarq/lumis 1.2.8 → 1.2.10

package/dist/lib/tinker-observer.js

@@ -0,0 +1,77 @@
+/**
+ * Tinker Observability
+ *
+ * Records agent turns, tool calls, and verification results to Trazze
+ * and local structured logs for replay and debugging.
+ */
+/**
+ * Default no-op observer.
+ */
+export const noopObserver = {
+    recordTurn: async () => { },
+    flush: async () => { },
+};
+/**
+ * Composite observer that chains multiple observers.
+ */
+export class CompositeObserver {
+    observers;
+    constructor(observers) {
+        this.observers = observers;
+    }
+    async recordTurn(event) {
+        await Promise.all(this.observers.map((o) => o.recordTurn(event)));
+    }
+    async flush() {
+        await Promise.all(this.observers.map((o) => o.flush()));
+    }
+}
+/**
+ * Trazze push observer — sends events to Trazze via HTTP/gRPC.
+ * (Stub: full implementation depends on Trazze client availability.)
+ */
+export class TrazzeObserver {
+    baseUrl;
+    sessionId;
+    constructor(baseUrl, sessionId) {
+        this.baseUrl = baseUrl;
+        this.sessionId = sessionId;
+    }
+    async recordTurn(event) {
+        if (!process.env.TRAZZE_ENABLED)
+            return;
+        try {
+            const response = await fetch(`${this.baseUrl}/events`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    event_type: 'tinker-turn',
+                    payload: event,
+                }),
+            });
+            if (!response.ok) {
+                console.error(`[tinker-observer] Trazze push failed: ${response.status}`);
+            }
+        }
+        catch (err) {
+            console.error(`[tinker-observer] Trazze push error:`, err);
+        }
+    }
+    async flush() {
+        // Trazze flushes on its own schedule; this is a no-op.
+    }
+}
+/**
+ * Create an observer based on environment.
+ */
+export function createObserver(sessionId) {
+    const observers = [];
+    if (process.env.TRAZZE_ENABLED && process.env.TRAZZE_BASE_URL) {
+        observers.push(new TrazzeObserver(process.env.TRAZZE_BASE_URL, sessionId));
+    }
+    if (observers.length === 0) {
+        return noopObserver;
+    }
+    return new CompositeObserver(observers);
+}
+//# sourceMappingURL=tinker-observer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-observer.js","sourceRoot":"","sources":["../../src/lib/tinker-observer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC3C,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IAC1B,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACT;IAApB,YAAoB,SAA2B;QAA3B,cAAS,GAAT,SAAS,CAAkB;IAAG,CAAC;IAEnD,KAAK,CAAC,UAAU,CAAC,KAAsB;QACtC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClE,CAAC;IAED,KAAK,CAAC,KAAK;QACV,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACxD,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IACN;IAAyB;IAA7C,YAAoB,OAAe,EAAU,SAAiB;QAA1C,YAAO,GAAP,OAAO,CAAQ;QAAU,cAAS,GAAT,SAAS,CAAQ;IAAG,CAAC;IAElE,KAAK,CAAC,UAAU,CAAC,KAAsB;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;YAAE,OAAM;QAEvC,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,SAAS,EAAE;gBACtD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACpB,UAAU,EAAE,aAAa;oBACzB,OAAO,EAAE,KAAK;iBACd,CAAC;aACF,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,yCAAyC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YAC1E,CAAC;QACF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAA;QAC3D,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAK;QACV,uDAAuD;IACxD,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,MAAM,SAAS,GAAqB,EAAE,CAAA;IAEtC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAC/D,SAAS,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAA;IACpB,CAAC;IAED,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAA;AACxC,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Tinker Enterprise Policy Controls
+ *
+ * Governs what operations are allowed in a session based on TINKER_POLICY env var.
+ */
+export type TinkerPolicy = 'read-only' | 'plan-only' | 'full';
+export interface PolicyGate {
+    canRead(): boolean;
+    canWrite(): boolean;
+    canExecute(): boolean;
+    canToolCall(): boolean;
+    describeLimitations(): string[];
+}
+export declare function getPolicyGate(policy: TinkerPolicy): PolicyGate;
+export declare function getTinkerPolicy(): TinkerPolicy;
+export declare function getPolicyForSession(): PolicyGate;
+/**
+ * Check if an operation is allowed; throw if not.
+ */
+export declare function enforcePolicy(gate: PolicyGate, operation: 'read' | 'write' | 'execute' | 'tool-call'): void;
+//# sourceMappingURL=tinker-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-policy.d.ts","sourceRoot":"","sources":["../../src/lib/tinker-policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAA;AAE7D,MAAM,WAAW,UAAU;IAC1B,OAAO,IAAI,OAAO,CAAA;IAClB,QAAQ,IAAI,OAAO,CAAA;IACnB,UAAU,IAAI,OAAO,CAAA;IACrB,WAAW,IAAI,OAAO,CAAA;IACtB,mBAAmB,IAAI,MAAM,EAAE,CAAA;CAC/B;AA4ED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAS9D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAM9C;AAED,wBAAgB,mBAAmB,IAAI,UAAU,CAGhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAgB3G"}

package/dist/lib/tinker-policy.js

@@ -0,0 +1,102 @@
+/**
+ * Tinker Enterprise Policy Controls
+ *
+ * Governs what operations are allowed in a session based on TINKER_POLICY env var.
+ */
+class ReadOnlyPolicy {
+    canRead() {
+        return true;
+    }
+    canWrite() {
+        return false;
+    }
+    canExecute() {
+        return false;
+    }
+    canToolCall() {
+        return false;
+    }
+    describeLimitations() {
+        return [
+            'Read-only mode: file writes disabled',
+            'Read-only mode: command execution disabled',
+            'Read-only mode: tool calls disabled',
+        ];
+    }
+}
+class PlanOnlyPolicy {
+    canRead() {
+        return true;
+    }
+    canWrite() {
+        return false;
+    }
+    canExecute() {
+        return false;
+    }
+    canToolCall() {
+        return true;
+    }
+    describeLimitations() {
+        return [
+            'Plan-only mode: file writes disabled',
+            'Plan-only mode: command execution disabled',
+            'Plan-only mode: tool calls allowed for planning only',
+        ];
+    }
+}
+class FullPolicy {
+    canRead() {
+        return true;
+    }
+    canWrite() {
+        return true;
+    }
+    canExecute() {
+        return true;
+    }
+    canToolCall() {
+        return true;
+    }
+    describeLimitations() {
+        return [];
+    }
+}
+export function getPolicyGate(policy) {
+    switch (policy) {
+        case 'read-only':
+            return new ReadOnlyPolicy();
+        case 'plan-only':
+            return new PlanOnlyPolicy();
+        case 'full':
+            return new FullPolicy();
+    }
+}
+export function getTinkerPolicy() {
+    const raw = process.env.TINKER_POLICY;
+    if (raw === 'read-only' || raw === 'plan-only' || raw === 'full') {
+        return raw;
+    }
+    return 'full'; // default to unrestricted
+}
+export function getPolicyForSession() {
+    const policy = getTinkerPolicy();
+    return getPolicyGate(policy);
+}
+/**
+ * Check if an operation is allowed; throw if not.
+ */
+export function enforcePolicy(gate, operation) {
+    const allowed = operation === 'read'
+        ? gate.canRead()
+        : operation === 'write'
+            ? gate.canWrite()
+            : operation === 'execute'
+                ? gate.canExecute()
+                : gate.canToolCall();
+    if (!allowed) {
+        const policy = getTinkerPolicy();
+        throw new Error(`Operation '${operation}' is not allowed under TINKER_POLICY=${policy}. ${gate.describeLimitations().join(' ')}`);
+    }
+}
+//# sourceMappingURL=tinker-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-policy.js","sourceRoot":"","sources":["../../src/lib/tinker-policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,cAAc;IACnB,OAAO;QACN,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,QAAQ;QACP,OAAO,KAAK,CAAA;IACb,CAAC;IAED,UAAU;QACT,OAAO,KAAK,CAAA;IACb,CAAC;IAED,WAAW;QACV,OAAO,KAAK,CAAA;IACb,CAAC;IAED,mBAAmB;QAClB,OAAO;YACN,sCAAsC;YACtC,4CAA4C;YAC5C,qCAAqC;SACrC,CAAA;IACF,CAAC;CACD;AAED,MAAM,cAAc;IACnB,OAAO;QACN,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,QAAQ;QACP,OAAO,KAAK,CAAA;IACb,CAAC;IAED,UAAU;QACT,OAAO,KAAK,CAAA;IACb,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,mBAAmB;QAClB,OAAO;YACN,sCAAsC;YACtC,4CAA4C;YAC5C,sDAAsD;SACtD,CAAA;IACF,CAAC;CACD;AAED,MAAM,UAAU;IACf,OAAO;QACN,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,QAAQ;QACP,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,UAAU;QACT,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,mBAAmB;QAClB,OAAO,EAAE,CAAA;IACV,CAAC;CACD;AAED,MAAM,UAAU,aAAa,CAAC,MAAoB;IACjD,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,WAAW;YACf,OAAO,IAAI,cAAc,EAAE,CAAA;QAC5B,KAAK,WAAW;YACf,OAAO,IAAI,cAAc,EAAE,CAAA;QAC5B,KAAK,MAAM;YACV,OAAO,IAAI,UAAU,EAAE,CAAA;IACzB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrC,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAClE,OAAO,GAAG,CAAA;IACX,CAAC;IACD,OAAO,MAAM,CAAA,CAAC,0BAA0B;AACzC,CAAC;AAED,MAAM,UAAU,mBAAmB;IAClC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,SAAqD;IACpG,MAAM,OAAO,GACZ,SAAS,KAAK,MAAM;QACnB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE;QAChB,CAAC,CAAC,SAAS,KAAK,OAAO;YACtB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE;YACjB,CAAC,CAAC,SAAS,KAAK,SAAS;gBACxB,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE;gBACnB,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;IAExB,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,IAAI,KAAK,CACd,cAAc,SAAS,wCAAwC,MAAM,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAChH,CAAA;IACF,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,51 @@
+export type AuditEntry = {
+    timestamp: string;
+    sessionId: string;
+    eventType: 'file-write' | 'file-delete' | 'command-execute' | 'tool-call' | 'verification';
+    path?: string;
+    tool?: string;
+    outcome: 'success' | 'failure' | 'skipped';
+    details?: Record<string, unknown>;
+};
+export type SessionReplayEntry = {
+    timestamp: string;
+    sessionId: string;
+    turnIndex: number;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    toolCalls?: Array<{
+        tool: string;
+        args: Record<string, unknown>;
+    }>;
+};
+/**
+ * Audit trail writer — appends entries to ~/.lumis/audit.jsonl
+ */
+export declare class AuditTrail {
+    private auditPath;
+    constructor(projectRoot: string);
+    record(entry: AuditEntry): void;
+    recordFileWrite(filePath: string, outcome: 'success' | 'failure', details?: Record<string, unknown>): void;
+    recordFileDelete(filePath: string, outcome: 'success' | 'failure', details?: Record<string, unknown>): void;
+    recordToolCall(tool: string, outcome: 'success' | 'failure' | 'skipped', details?: Record<string, unknown>): void;
+    recordVerification(outcome: 'success' | 'failure', details?: Record<string, unknown>): void;
+}
+/**
+ * Session replay writer — appends turn entries to ~/.lumis/replays/<sessionId>.jsonl
+ */
+export declare class SessionReplayer {
+    private sessionId;
+    private replayPath;
+    private turnIndex;
+    constructor(projectRoot: string, sessionId?: string);
+    recordUserMessage(content: string): void;
+    recordAssistantMessage(content: string, toolCalls?: Array<{
+        tool: string;
+        args: Record<string, unknown>;
+    }>): void;
+    private recordEntry;
+    getReplayPath(): string;
+    getSessionId(): string;
+}
+export declare function generateSessionId(): string;
+//# sourceMappingURL=tinker-replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-replay.d.ts","sourceRoot":"","sources":["../../src/lib/tinker-replay.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,YAAY,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,GAAG,cAAc,CAAA;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CAClE,CAAA;AAED;;GAEG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,SAAS,CAAQ;gBAEb,WAAW,EAAE,MAAM;IAI/B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAS/B,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW1G,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW3G,cAAc,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI;IAWP,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAS3F;AAED;;GAEG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAY;gBAEjB,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAKnD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI;IAkBjH,OAAO,CAAC,WAAW;IAiBnB,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,MAAM;CAGtB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/lib/tinker-replay.js

@@ -0,0 +1,123 @@
+/**
+ * Tinker Deterministic Replay and Audit Trail
+ *
+ * Records session interactions to JSONL for debugging, regression testing, and compliance.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+/**
+ * Audit trail writer — appends entries to ~/.lumis/audit.jsonl
+ */
+export class AuditTrail {
+    auditPath;
+    constructor(projectRoot) {
+        this.auditPath = path.join(projectRoot, '.lumis', 'audit.jsonl');
+    }
+    record(entry) {
+        try {
+            fs.mkdirSync(path.dirname(this.auditPath), { recursive: true });
+            fs.appendFileSync(this.auditPath, `${JSON.stringify(entry)}\n`, 'utf8');
+        }
+        catch (err) {
+            console.error(`[audit-trail] Failed to write: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    recordFileWrite(filePath, outcome, details) {
+        this.record({
+            timestamp: new Date().toISOString(),
+            sessionId: process.env.TINKER_SESSION_ID || 'unknown',
+            eventType: 'file-write',
+            path: filePath,
+            outcome,
+            ...(details ? { details } : {}),
+        });
+    }
+    recordFileDelete(filePath, outcome, details) {
+        this.record({
+            timestamp: new Date().toISOString(),
+            sessionId: process.env.TINKER_SESSION_ID || 'unknown',
+            eventType: 'file-delete',
+            path: filePath,
+            outcome,
+            ...(details ? { details } : {}),
+        });
+    }
+    recordToolCall(tool, outcome, details) {
+        this.record({
+            timestamp: new Date().toISOString(),
+            sessionId: process.env.TINKER_SESSION_ID || 'unknown',
+            eventType: 'tool-call',
+            tool,
+            outcome,
+            ...(details ? { details } : {}),
+        });
+    }
+    recordVerification(outcome, details) {
+        this.record({
+            timestamp: new Date().toISOString(),
+            sessionId: process.env.TINKER_SESSION_ID || 'unknown',
+            eventType: 'verification',
+            outcome,
+            ...(details ? { details } : {}),
+        });
+    }
+}
+/**
+ * Session replay writer — appends turn entries to ~/.lumis/replays/<sessionId>.jsonl
+ */
+export class SessionReplayer {
+    sessionId;
+    replayPath;
+    turnIndex = 0;
+    constructor(projectRoot, sessionId) {
+        this.sessionId = sessionId || generateSessionId();
+        this.replayPath = path.join(projectRoot, '.lumis', 'replays', `${this.sessionId}.jsonl`);
+    }
+    recordUserMessage(content) {
+        this.recordEntry('user', content);
+    }
+    recordAssistantMessage(content, toolCalls) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            sessionId: this.sessionId,
+            turnIndex: this.turnIndex++,
+            role: 'assistant',
+            content,
+            ...(toolCalls ? { toolCalls } : {}),
+        };
+        try {
+            fs.mkdirSync(path.dirname(this.replayPath), { recursive: true });
+            fs.appendFileSync(this.replayPath, `${JSON.stringify(entry)}\n`, 'utf8');
+        }
+        catch (err) {
+            console.error(`[session-replay] Failed to write: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    recordEntry(role, content) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            sessionId: this.sessionId,
+            turnIndex: this.turnIndex++,
+            role,
+            content,
+        };
+        try {
+            fs.mkdirSync(path.dirname(this.replayPath), { recursive: true });
+            fs.appendFileSync(this.replayPath, `${JSON.stringify(entry)}\n`, 'utf8');
+        }
+        catch (err) {
+            console.error(`[session-replay] Failed to write: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    getReplayPath() {
+        return this.replayPath;
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+}
+export function generateSessionId() {
+    return `tinker-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+}
+//# sourceMappingURL=tinker-replay.js.map

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

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

package/dist/{console.d.ts → output/ansi.d.ts}

@@ -1,19 +1,15 @@
-export declare const ui: {
+export declare const ansi: {
     bold: (value: string) => string;
     dim: (value: string) => string;
     red: (value: string) => string;
     green: (value: string) => string;
     yellow: (value: string) => string;
-    blue: (value: string) => string;
-    magenta: (value: string) => string;
     cyan: (value: string) => string;
+    magenta: (value: string) => string;
     gray: (value: string) => string;
-    section: (label: string) => string;
+    label: (value: string) => string;
     ok: (value: string) => string;
     warn: (value: string) => string;
     fail: (value: string) => string;
-    bullet: (value: string) => string;
 };
-export declare function writeLine(message?: string): void;
-export declare function writeError(message: string): void;
-//# sourceMappingURL=console.d.ts.map
+//# sourceMappingURL=ansi.d.ts.map

package/dist/output/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/output/ansi.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,IAAI;kBACD,MAAM,KAAG,MAAM;iBAChB,MAAM,KAAG,MAAM;iBACf,MAAM,KAAG,MAAM;mBACb,MAAM,KAAG,MAAM;oBACd,MAAM,KAAG,MAAM;kBACjB,MAAM,KAAG,MAAM;qBACZ,MAAM,KAAG,MAAM;kBAClB,MAAM,KAAG,MAAM;mBACd,MAAM,KAAG,MAAM;gBAClB,MAAM,KAAG,MAAM;kBACb,MAAM,KAAG,MAAM;kBACf,MAAM,KAAG,MAAM;CAC9B,CAAA"}

package/dist/{console.js → output/ansi.js}

@@ -2,26 +2,18 @@ const ESC = '\u001B[';
 function wrap(code, value) {
     return `${ESC}${code}m${value}${ESC}0m`;
 }
-export const ui = {
+export const ansi = {
     bold: (value) => wrap('1', value),
     dim: (value) => wrap('2', value),
     red: (value) => wrap('31', value),
     green: (value) => wrap('32', value),
     yellow: (value) => wrap('33', value),
-    blue: (value) => wrap('34', value),
-    magenta: (value) => wrap('35', value),
     cyan: (value) => wrap('36', value),
+    magenta: (value) => wrap('35', value),
     gray: (value) => wrap('90', value),
-    section: (label) => `${wrap('1;35', 'Lumis')} ${wrap('2', '::')} ${wrap('1;36', label)}`,
+    label: (value) => `${wrap('1;35', 'Lumis')} ${wrap('2', '::')} ${wrap('1;36', value)}`,
     ok: (value) => `${wrap('32', '✓')} ${value}`,
     warn: (value) => `${wrap('33', '▲')} ${value}`,
     fail: (value) => `${wrap('31', '✖')} ${value}`,
-    bullet: (value) => `${wrap('36', '•')} ${value}`,
 };
-export function writeLine(message = '') {
-    process.stdout.write(`${message}\n`);
-}
-export function writeError(message) {
-    process.stderr.write(`${message}\n`);
-}
-//# sourceMappingURL=console.js.map
+//# sourceMappingURL=ansi.js.map

package/dist/output/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/output/ansi.ts"],"names":[],"mappings":"AAAA,MAAM,GAAG,GAAG,SAAS,CAAA;AAErB,SAAS,IAAI,CAAC,IAAY,EAAE,KAAa;IACvC,OAAO,GAAG,GAAG,GAAG,IAAI,IAAI,KAAK,GAAG,GAAG,IAAI,CAAA;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;IACjD,GAAG,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;IAChD,GAAG,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;IACjD,KAAK,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;IACnD,MAAM,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;IACpD,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;IAClD,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;IACrD,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;IAClD,KAAK,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;IACtG,EAAE,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE;IAC5D,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE;IAC9D,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE;CAC/D,CAAA"}

package/dist/output/plan-display.d.ts

@@ -0,0 +1,4 @@
+import type { CoreExecutionPlan } from '@lumiarq/context';
+import type { CommandContext } from '../commands/runtime.js';
+export declare function renderPlanDetail(context: CommandContext, plan: CoreExecutionPlan, packLabel: string): void;
+//# sourceMappingURL=plan-display.d.ts.map

package/dist/output/plan-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-display.d.ts","sourceRoot":"","sources":["../../src/output/plan-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,kBAAkB,CAAA;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAiB5D,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,GACf,IAAI,CAoCN"}

package/dist/output/plan-display.js

@@ -0,0 +1,49 @@
+import { ansi } from './ansi.js';
+function stepRiskLabel(step) {
+    if (step.operation === 'delete')
+        return 'destructive';
+    if (step.operation === 'update')
+        return 'overwrite';
+    if (step.operation === 'append')
+        return 'append';
+    return 'safe';
+}
+function rollbackDescription(step) {
+    if (step.rollback.operation === 'delete')
+        return `delete ${step.rollback.targetFile}`;
+    return `restore ${step.rollback.targetFile}`;
+}
+export function renderPlanDetail(context, plan, packLabel) {
+    context.write(`${ansi.label('Execution Plan')}\n`);
+    context.write(`  ${ansi.bold('Pack')}: ${packLabel}\n`);
+    context.write(`  ${ansi.bold('Plan id')}: ${ansi.dim(plan.id)}\n`);
+    context.write(`  ${ansi.bold('Plan steps')}: ${plan.steps.length}\n`);
+    context.write(`  ${ansi.bold('Estimated files')}: ${plan.estimatedFiles}\n`);
+    if (plan.steps.length === 0) {
+        return;
+    }
+    context.write('\n');
+    for (let idx = 0; idx < plan.steps.length; idx++) {
+        const step = plan.steps[idx];
+        const risk = stepRiskLabel(step);
+        const riskLabel = risk === 'destructive'
+            ? ansi.red(risk)
+            : risk === 'overwrite'
+                ? ansi.yellow(risk)
+                : risk === 'append'
+                    ? ansi.cyan(risk)
+                    : ansi.green(risk);
+        context.write(`  ${ansi.magenta(`[${idx + 1}/${plan.steps.length}]`)} ${ansi.bold(step.operation)} ${step.artifactKind} ${step.name}\n`);
+        context.write(`    module:   ${step.module}\n`);
+        context.write(`    target:   ${step.targetFile}\n`);
+        context.write(`    risk:     ${riskLabel}\n`);
+        context.write(`    rollback: ${rollbackDescription(step)}\n`);
+        if (step.rationale) {
+            context.write(`    rationale: ${step.rationale}\n`);
+        }
+        if (step.requiresConfirmation) {
+            context.write(`    confirm:  required before write\n`);
+        }
+    }
+}
+//# sourceMappingURL=plan-display.js.map

package/dist/output/plan-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-display.js","sourceRoot":"","sources":["../../src/output/plan-display.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,SAAS,aAAa,CAAC,IAAuB;IAC7C,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAA;IACrD,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAA;IACnD,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAChD,OAAO,MAAM,CAAA;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAuB;IACnD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,UAAU,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA;IACrF,OAAO,WAAW,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,OAAuB,EACvB,IAAuB,EACvB,SAAiB;IAEjB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAClD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,CAAC,CAAA;IACvD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IAClE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAA;IACrE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC,cAAc,IAAI,CAAC,CAAA;IAE5E,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAM;IACP,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEnB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAE,CAAA;QAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,SAAS,GACd,IAAI,KAAK,aAAa;YACrB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAChB,CAAC,CAAC,IAAI,KAAK,WAAW;gBACrB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACnB,CAAC,CAAC,IAAI,KAAK,QAAQ;oBAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBACjB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACtB,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAA;QACxI,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAA;QAC/C,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAA;QACnD,OAAO,CAAC,KAAK,CAAC,iBAAiB,SAAS,IAAI,CAAC,CAAA;QAC7C,OAAO,CAAC,KAAK,CAAC,iBAAiB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAA;QACvD,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/output/result-display.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutionSummary } from '@lumiarq/agent';
+import type { CoreExecutionStep } from '@lumiarq/context';
+import type { CommandContext } from '../commands/runtime.js';
+export declare function renderExecutionResult(context: CommandContext, summary: ExecutionSummary, steps: CoreExecutionStep[]): void;
+//# sourceMappingURL=result-display.d.ts.map

package/dist/output/result-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-display.d.ts","sourceRoot":"","sources":["../../src/output/result-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAG5D,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,iBAAiB,EAAE,GACxB,IAAI,CAgBN"}

package/dist/output/result-display.js

@@ -0,0 +1,17 @@
+import { ansi } from './ansi.js';
+export function renderExecutionResult(context, summary, steps) {
+    for (let idx = 0; idx < steps.length; idx++) {
+        const step = steps[idx];
+        const isFailed = step.id === summary.failedStepId;
+        const isDone = !isFailed && idx < summary.completed;
+        const label = isFailed ? ansi.fail('FAIL') : isDone ? ansi.ok('ok') : ansi.dim('SKIP');
+        context.write(`  [${label}] ${step.operation} ${step.artifactKind} ${step.name}\n`);
+    }
+    context.write('\n');
+    context.write(`${ansi.label('Execution Result')}\n`);
+    context.write(`  ${ansi.bold('Completed steps')}: ${summary.completed}\n`);
+    if (!summary.rolledBack) {
+        context.write(`  ${ansi.bold('Written files')}: ${summary.writtenFiles.length}\n`);
+    }
+}
+//# sourceMappingURL=result-display.js.map

package/dist/output/result-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-display.js","sourceRoot":"","sources":["../../src/output/result-display.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,UAAU,qBAAqB,CACpC,OAAuB,EACvB,OAAyB,EACzB,KAA0B;IAE1B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAE,CAAA;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,YAAY,CAAA;QACjD,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,GAAG,GAAG,OAAO,CAAC,SAAS,CAAA;QACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtF,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAA;IACpF,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACpD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,SAAS,IAAI,CAAC,CAAA;IAE1E,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAA;IACnF,CAAC;AACF,CAAC"}

package/dist/plugins/tinker-plugin.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Tinker Plugin System
+ *
+ * Enables third-party extensions to add custom commands, tools, and session hooks.
+ */
+import type { ToolCall, ToolResult } from '../tools/index.js';
+export type TinkerCommand = {
+    name: string;
+    description: string;
+    handler: (args: string[], context: TinkerPluginContext) => Promise<void> | void;
+};
+export type TinkerPluginContext = {
+    projectRoot: string;
+    session: {
+        context: {
+            write: (msg: string) => void;
+            writeError: (msg: string) => void;
+        };
+        chatModel?: string | undefined;
+        chatEnabled: boolean;
+    };
+};
+export interface TinkerPlugin {
+    /**
+     * Unique plugin identifier (e.g., 'plugin-name').
+     */
+    readonly name: string;
+    /**
+     * Human-readable description.
+     */
+    readonly description?: string;
+    /**
+     * Version (semver).
+     */
+    readonly version?: string;
+    /**
+     * Custom Tinker commands this plugin adds.
+     */
+    readonly commands?: TinkerCommand[];
+    /**
+     * Custom tools (tool-call dispatch) this plugin provides.
+     * Each tool becomes available as a potential LLM-emitted tool call.
+     */
+    readonly tools?: ToolCall[];
+    /**
+     * Called when a Tinker session starts.
+     */
+    onSessionStart?(context: TinkerPluginContext): void | Promise<void>;
+    /**
+     * Called after each user message is sent (before LLM processing).
+     * Return a string to pre-process the message, or undefined to pass through.
+     */
+    onUserMessage?(msg: string, context: TinkerPluginContext): string | undefined | Promise<string | undefined>;
+    /**
+     * Called after each LLM response.
+     * Can observe/transform the response.
+     */
+    onAssistantMessage?(msg: string, context: TinkerPluginContext): void | Promise<void>;
+    /**
+     * Called when a tool is about to be executed.
+     * Return false to reject/cancel the tool call.
+     */
+    onToolCall?(tool: ToolCall, context: TinkerPluginContext): boolean | Promise<boolean>;
+    /**
+     * Called after a tool executes.
+     * Can log, monitor, or transform the result.
+     */
+    onToolResult?(call: ToolCall, result: ToolResult, context: TinkerPluginContext): ToolResult | Promise<ToolResult>;
+    /**
+     * Called when session ends.
+     */
+    onSessionEnd?(context: TinkerPluginContext): void | Promise<void>;
+}
+/**
+ * Registry for loaded plugins.
+ */
+export declare class TinkerPluginRegistry {
+    private plugins;
+    register(plugin: TinkerPlugin): void;
+    unregister(name: string): boolean;
+    get(name: string): TinkerPlugin | undefined;
+    getAll(): TinkerPlugin[];
+    getAllCommands(): TinkerCommand[];
+    callHook(hookName: keyof TinkerPlugin, args: unknown[]): Promise<unknown[]>;
+}
+//# sourceMappingURL=tinker-plugin.d.ts.map