@askdkc/kiokuko 0.1.0

package/dist/commands/record.js

@@ -0,0 +1,4 @@
+import { recordEntry } from '../memory/entries.js';
+export const record = recordEntry;
+export function runRecord(database, input) { return recordEntry(database, input); }
+//# sourceMappingURL=record.js.map

package/dist/commands/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC;AAElC,MAAM,UAAU,SAAS,CAAC,QAAwB,EAAE,KAAyB,IAAI,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/search.d.ts

@@ -0,0 +1,6 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import { searchEntries } from '../memory/retrieval.js';
+export declare const search: typeof searchEntries;
+export type SearchCommandInput = Parameters<typeof searchEntries>[1];
+export declare function runSearch(database: SqliteDatabase, input: SearchCommandInput): import("../memory/retrieval.js").SearchResult;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,eAAO,MAAM,MAAM,sBAAgB,CAAC;AACpC,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,iDAA4C"}

package/dist/commands/search.js

@@ -0,0 +1,4 @@
+import { searchEntries } from '../memory/retrieval.js';
+export const search = searchEntries;
+export function runSearch(database, input) { return searchEntries(database, input); }
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;AAEpC,MAAM,UAAU,SAAS,CAAC,QAAwB,EAAE,KAAyB,IAAI,OAAO,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,34 @@
+import type { RuntimeDescriptorView } from '../server/runtime-descriptor.js';
+type SignalName = 'SIGINT' | 'SIGTERM';
+type SignalListener = () => void;
+export interface SignalSource {
+    once(signal: SignalName, listener: SignalListener): unknown;
+    off(signal: SignalName, listener: SignalListener): unknown;
+}
+export interface ServeCommandOptions {
+    readonly host?: string;
+    readonly port?: number;
+    readonly json?: boolean;
+}
+export interface ServeStartup {
+    readonly status: 'running';
+    readonly url: string;
+    readonly descriptor: RuntimeDescriptorView;
+}
+export interface ServeRuntime {
+    readonly url: string;
+    readonly descriptor: RuntimeDescriptorView;
+    close(): Promise<void> | void;
+}
+export type ServeStarter = (options: {
+    readonly host: string;
+    readonly port: number;
+}) => PromiseLike<ServeRuntime>;
+export interface ServeCommandDependencies {
+    readonly startServer?: ServeStarter;
+    readonly signals?: SignalSource;
+    readonly onStarted?: (startup: ServeStartup) => void | PromiseLike<void>;
+}
+export declare function runServeCommand(options?: ServeCommandOptions, dependencies?: ServeCommandDependencies): Promise<void>;
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAI7E,KAAK,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvC,KAAK,cAAc,GAAG,MAAM,IAAI,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC;IAC5D,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;CAC5C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,WAAW,CAAC,YAAY,CAAC,CAAC;AAEpH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;CAC1E;AAiDD,wBAAsB,eAAe,CACnC,OAAO,GAAE,mBAAwB,EACjC,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/dist/commands/serve.js

@@ -0,0 +1,120 @@
+import { KiokukoError } from '../errors.js';
+import { startAgentHttpServer } from '../server/agent-application.js';
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_PORT = 0;
+const processSignals = {
+    once: (signal, listener) => {
+        process.once(signal, listener);
+    },
+    off: (signal, listener) => {
+        process.off(signal, listener);
+    },
+};
+function safeCommandError(error, phase) {
+    if (error instanceof KiokukoError) {
+        const messages = {
+            VALIDATION_ERROR: 'Runtime configuration is invalid',
+            CONFLICT: 'Request conflicts with current runtime state',
+            SECURITY_REJECTION: 'Runtime file was rejected',
+            SERVICE_UNAVAILABLE: phase === 'close' ? 'Unable to close the HTTP server' : 'The HTTP server is unavailable',
+            DATABASE_ERROR: phase === 'close' ? 'Unable to close the HTTP server' : 'Unable to start the HTTP server',
+        };
+        return new KiokukoError(error.code, messages[error.code] ?? 'Unable to run the HTTP server');
+    }
+    return new KiokukoError(phase === 'close' ? 'SERVICE_UNAVAILABLE' : 'DATABASE_ERROR', phase === 'close' ? 'Unable to close the HTTP server' : 'Unable to start the HTTP server');
+}
+function publicDescriptor(descriptor) {
+    return {
+        protocolVersion: descriptor.protocolVersion,
+        instanceId: descriptor.instanceId,
+        pid: descriptor.pid,
+        baseUrl: descriptor.baseUrl,
+        databaseFingerprint: descriptor.databaseFingerprint,
+        startedAt: descriptor.startedAt,
+    };
+}
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((resolvePromise, rejectPromise) => {
+        resolve = resolvePromise;
+        reject = rejectPromise;
+    });
+    return { promise, resolve, reject };
+}
+export async function runServeCommand(options = {}, dependencies = {}) {
+    const startServer = dependencies.startServer ?? startAgentHttpServer;
+    const signals = dependencies.signals ?? processSignals;
+    let runtime;
+    try {
+        try {
+            runtime = await startServer({
+                host: options.host ?? DEFAULT_HOST,
+                port: options.port ?? DEFAULT_PORT,
+            });
+        }
+        catch (error) {
+            throw safeCommandError(error, 'startup');
+        }
+        const startup = {
+            status: 'running',
+            url: runtime.url,
+            descriptor: publicDescriptor(runtime.descriptor),
+        };
+        const shutdown = deferred();
+        let closePromise;
+        const closeOnce = () => {
+            if (closePromise !== undefined)
+                return closePromise;
+            closePromise = Promise.resolve()
+                .then(() => runtime?.close())
+                .then(() => undefined)
+                .catch((error) => {
+                throw safeCommandError(error, 'close');
+            });
+            return closePromise;
+        };
+        const onSignal = () => {
+            void closeOnce().then(shutdown.resolve, shutdown.reject);
+        };
+        try {
+            signals.once('SIGINT', onSignal);
+            signals.once('SIGTERM', onSignal);
+            try {
+                await dependencies.onStarted?.(startup);
+            }
+            catch (error) {
+                if (closePromise === undefined)
+                    await closeOnce().catch(() => undefined);
+                throw safeCommandError(error, 'post-start');
+            }
+            await shutdown.promise;
+        }
+        catch (error) {
+            if (closePromise === undefined)
+                await closeOnce().catch(() => undefined);
+            throw error instanceof KiokukoError ? error : safeCommandError(error, 'post-start');
+        }
+        finally {
+            try {
+                signals.off('SIGINT', onSignal);
+            }
+            catch {
+                // Listener cleanup must not replace the command result.
+            }
+            try {
+                signals.off('SIGTERM', onSignal);
+            }
+            catch {
+                // Listener cleanup must not replace the command result.
+            }
+        }
+    }
+    catch (error) {
+        if (runtime !== undefined && !(error instanceof KiokukoError)) {
+            throw safeCommandError(error, 'post-start');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

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

package/dist/commands/server-status.d.ts

@@ -0,0 +1,20 @@
+import { type PidLiveness } from '../server/instance-lock.js';
+import { type RuntimeDescriptorView } from '../server/runtime-descriptor.js';
+export type ServerStatus = {
+    running: false;
+    stale: false;
+} | {
+    running: true;
+    stale: false;
+    descriptor: RuntimeDescriptorView;
+} | {
+    running: false;
+    stale: true;
+    descriptor: RuntimeDescriptorView;
+};
+export interface ServerStatusOptions {
+    descriptorPath?: string;
+    isPidAlive?: PidLiveness;
+}
+export declare function getServerStatus(options?: ServerStatusOptions): Promise<ServerStatus>;
+//# sourceMappingURL=server-status.d.ts.map

package/dist/commands/server-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-status.d.ts","sourceRoot":"","sources":["../../src/commands/server-status.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,YAAY,GACpB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAChC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,qBAAqB,CAAA;CAAE,GAClE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAc9F"}

package/dist/commands/server-status.js

@@ -0,0 +1,21 @@
+import { getRuntimeDescriptorPath } from '../config/paths.js';
+import { KiokukoError } from '../errors.js';
+import { isPidAlive, } from '../server/instance-lock.js';
+import { readRuntimeDescriptor, toPublicRuntimeDescriptor, } from '../server/runtime-descriptor.js';
+export async function getServerStatus(options = {}) {
+    const descriptor = await readRuntimeDescriptor(options.descriptorPath ?? getRuntimeDescriptorPath());
+    if (!descriptor)
+        return { running: false, stale: false };
+    let alive;
+    try {
+        alive = await (options.isPidAlive ?? isPidAlive)(descriptor.pid);
+    }
+    catch {
+        throw new KiokukoError('SERVICE_UNAVAILABLE', 'Unable to determine server process liveness');
+    }
+    const publicDescriptor = toPublicRuntimeDescriptor(descriptor);
+    if (!alive)
+        return { running: false, stale: true, descriptor: publicDescriptor };
+    return { running: true, stale: false, descriptor: publicDescriptor };
+}
+//# sourceMappingURL=server-status.js.map

package/dist/commands/server-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-status.js","sourceRoot":"","sources":["../../src/commands/server-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,UAAU,GAEX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,iCAAiC,CAAC;AAYzC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAA+B,EAAE;IACrE,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,cAAc,IAAI,wBAAwB,EAAE,CAAC,CAAC;IACrG,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAEzD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CAAC,qBAAqB,EAAE,6CAA6C,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;IACjF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AACvE,CAAC"}

package/dist/commands/server.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+import { type ServerStatus, type ServerStatusOptions } from './server-status.js';
+import { type ServeCommandDependencies } from './serve.js';
+export type ServerStatusReader = (options: ServerStatusOptions) => PromiseLike<ServerStatus>;
+export type ServerOutputWriter = (text: string) => void;
+export interface ServerCommandDependencies extends ServeCommandDependencies {
+    readonly getServerStatus?: ServerStatusReader;
+    readonly stdout?: ServerOutputWriter;
+    readonly onServeStarted?: () => void;
+}
+export declare function runServerStatusCommand(options?: ServerStatusOptions, dependencies?: Pick<ServerCommandDependencies, 'getServerStatus'>): Promise<ServerStatus>;
+export declare function registerServerCommands(cli: Command, dependencies?: ServerCommandDependencies): Command;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,WAAW,CAAC,YAAY,CAAC,CAAC;AAC7F,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAExD,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACzE,QAAQ,CAAC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CACtC;AA8CD,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,mBAAwB,EACjC,YAAY,GAAE,IAAI,CAAC,yBAAyB,EAAE,iBAAiB,CAAM,GACpE,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,GAAE,yBAA8B,GAAG,OAAO,CAoC1G"}

package/dist/commands/server.js

@@ -0,0 +1,89 @@
+import { KiokukoError } from '../errors.js';
+import { successEnvelope } from '../serialization/envelope.js';
+import { getServerStatus } from './server-status.js';
+import { runServeCommand, } from './serve.js';
+function writeOutput(dependencies, text) {
+    (dependencies.stdout ?? ((value) => process.stdout.write(value)))(text);
+}
+function writeServeStartup(dependencies, options, startup) {
+    if (options.json === true) {
+        writeOutput(dependencies, `${JSON.stringify(successEnvelope('serve', startup))}\n`);
+        dependencies.onServeStarted?.();
+        return;
+    }
+    writeOutput(dependencies, `${startup.url}\n`);
+    dependencies.onServeStarted?.();
+}
+function safeStatusError(error) {
+    if (error instanceof KiokukoError) {
+        const messages = {
+            VALIDATION_ERROR: 'Server runtime descriptor is invalid',
+            SECURITY_REJECTION: 'Server runtime descriptor was rejected',
+            SERVICE_UNAVAILABLE: 'Unable to query server status',
+        };
+        return new KiokukoError(error.code, messages[error.code] ?? 'Unable to query server status');
+    }
+    return new KiokukoError('SERVICE_UNAVAILABLE', 'Unable to query server status');
+}
+function publicStatus(status) {
+    if (!status.running && !status.stale)
+        return { running: false, stale: false };
+    const descriptor = {
+        protocolVersion: status.descriptor.protocolVersion,
+        instanceId: status.descriptor.instanceId,
+        pid: status.descriptor.pid,
+        baseUrl: status.descriptor.baseUrl,
+        databaseFingerprint: status.descriptor.databaseFingerprint,
+        startedAt: status.descriptor.startedAt,
+    };
+    if (status.running)
+        return { running: true, stale: false, descriptor };
+    return { running: false, stale: true, descriptor };
+}
+export async function runServerStatusCommand(options = {}, dependencies = {}) {
+    try {
+        return publicStatus(await (dependencies.getServerStatus ?? getServerStatus)(options));
+    }
+    catch (error) {
+        throw safeStatusError(error);
+    }
+}
+export function registerServerCommands(cli, dependencies = {}) {
+    cli.command('serve')
+        .description('Start the Kiokuko server in the foreground')
+        .option('--host <host>', 'Loopback host', '127.0.0.1')
+        .option('--port <number>', 'HTTP port', '0')
+        .option('--json', 'Emit a JSON response')
+        .action(async (options) => {
+        const serveOptions = {
+            host: options.host,
+            port: Number(options.port),
+        };
+        await runServeCommand(serveOptions, {
+            ...dependencies,
+            onStarted: (startup) => writeServeStartup(dependencies, options, startup),
+        });
+    });
+    const server = cli.command('server').description('Inspect the Kiokuko server');
+    server.command('status')
+        .description('Show the Kiokuko server status')
+        .option('--json', 'Emit a JSON response')
+        .action(async (options) => {
+        const status = await runServerStatusCommand({}, dependencies);
+        if (options.json === true) {
+            writeOutput(dependencies, `${JSON.stringify(successEnvelope('server.status', status))}\n`);
+            return;
+        }
+        if (status.running) {
+            writeOutput(dependencies, `${status.descriptor.baseUrl}\n`);
+        }
+        else if (status.stale) {
+            writeOutput(dependencies, 'stale\n');
+        }
+        else {
+            writeOutput(dependencies, 'not running\n');
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/commands/server.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,32 @@
+import { type PathEnvironment } from '../config/paths.js';
+export declare const SETUP_CLIENTS: readonly ["codex", "opencode"];
+export type SetupClient = (typeof SETUP_CLIENTS)[number];
+type SetupAction = 'created' | 'updated' | 'unchanged';
+interface PlannedFile {
+    path: string;
+    content: string;
+    mode: number;
+    original: string | undefined;
+    action: SetupAction;
+    purpose: 'mcp-config' | 'instructions';
+    client: SetupClient;
+}
+export interface SetupOptions extends PathEnvironment {
+    clients?: SetupClient[];
+    command?: string;
+    dryRun?: boolean;
+    databasePath?: string;
+    migrationsDirectory?: string;
+}
+export interface SetupResult {
+    clients: SetupClient[];
+    databasePath: string;
+    databaseAction: 'initialized' | 'planned';
+    files: Array<Pick<PlannedFile, 'path' | 'action' | 'purpose' | 'client'>>;
+    dryRun: boolean;
+    nextStep: string;
+}
+export declare function parseSetupClients(value: string): SetupClient[];
+export declare function setupGlobalClients(options?: SetupOptions): Promise<SetupResult>;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAQ5B,eAAO,MAAM,aAAa,gCAAiC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,KAAK,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG,cAAc,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC1E,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAM9D;AAiDD,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwDzF"}

package/dist/commands/setup.js

@@ -0,0 +1,121 @@
+import { access, unlink } from 'node:fs/promises';
+import path from 'node:path';
+import { atomicWriteText, readRegularFile } from '../agent-file/atomic-write.js';
+import { getCodexConfigPath, getCodexInstructionsPath, getGlobalDatabasePath, getOpenCodeConfigDirectory, getOpenCodeInstructionsPath, } from '../config/paths.js';
+import { initializeDatabase } from './init.js';
+import { openConnection } from '../db/connection.js';
+import { ensureGlobalWorkspace } from '../memory/workspaces.js';
+import { KiokukoError } from '../errors.js';
+import { renderOpenCodeConfig } from '../setup/opencode-config.js';
+import { renderCodexMcpConfig, renderGlobalInstructions } from '../setup/render.js';
+export const SETUP_CLIENTS = ['codex', 'opencode'];
+export function parseSetupClients(value) {
+    const clients = [...new Set(value.split(',').map((client) => client.trim()).filter(Boolean))];
+    if (clients.length === 0 || clients.some((client) => !SETUP_CLIENTS.includes(client))) {
+        throw new KiokukoError('VALIDATION_ERROR', `clients must be a comma-separated subset of: ${SETUP_CLIENTS.join(', ')}`);
+    }
+    return clients;
+}
+async function exists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function planFile(filePath, client, purpose, render) {
+    const original = await readRegularFile(filePath);
+    const rendered = render(original?.content);
+    const action = original === undefined
+        ? 'created'
+        : rendered.content === original.content ? 'unchanged' : 'updated';
+    return {
+        path: filePath,
+        content: rendered.content,
+        mode: original?.mode ?? 0o600,
+        original: original?.content,
+        action,
+        purpose,
+        client,
+    };
+}
+async function openCodeConfigPath(options) {
+    const directory = getOpenCodeConfigDirectory(options);
+    const jsonc = path.join(directory, 'opencode.jsonc');
+    if (await exists(jsonc))
+        return jsonc;
+    return path.join(directory, 'opencode.json');
+}
+async function restoreFiles(files) {
+    for (const file of [...files].reverse()) {
+        if (file.action === 'unchanged')
+            continue;
+        if (file.original === undefined)
+            await unlink(file.path).catch(() => undefined);
+        else
+            await atomicWriteText(file.path, file.original, file.mode).catch(() => undefined);
+    }
+}
+export async function setupGlobalClients(options = {}) {
+    const clients = options.clients ?? [...SETUP_CLIENTS];
+    if (clients.length === 0 || clients.some((client) => !SETUP_CLIENTS.includes(client))) {
+        throw new KiokukoError('VALIDATION_ERROR', `clients must be a non-empty subset of: ${SETUP_CLIENTS.join(', ')}`);
+    }
+    const command = options.command ?? 'kiokuko';
+    if (command.trim().length === 0 || command.includes('\0'))
+        throw new KiokukoError('VALIDATION_ERROR', 'command must be a non-empty executable path or name');
+    const pathEnvironment = {
+        ...(options.platform === undefined ? {} : { platform: options.platform }),
+        ...(options.env === undefined ? {} : { env: options.env }),
+    };
+    const databasePath = options.databasePath ?? getGlobalDatabasePath(pathEnvironment);
+    const files = [];
+    if (clients.includes('codex')) {
+        files.push(await planFile(getCodexConfigPath(pathEnvironment), 'codex', 'mcp-config', (existing) => renderCodexMcpConfig(existing ?? '', command)));
+        files.push(await planFile(getCodexInstructionsPath(pathEnvironment), 'codex', 'instructions', (existing) => renderGlobalInstructions(existing ?? '')));
+    }
+    if (clients.includes('opencode')) {
+        files.push(await planFile(await openCodeConfigPath(pathEnvironment), 'opencode', 'mcp-config', (existing) => renderOpenCodeConfig(existing, command)));
+        files.push(await planFile(getOpenCodeInstructionsPath(pathEnvironment), 'opencode', 'instructions', (existing) => renderGlobalInstructions(existing ?? '')));
+    }
+    const result = {
+        clients,
+        databasePath,
+        databaseAction: options.dryRun ? 'planned' : 'initialized',
+        files: files.map(({ path: filePath, action, purpose, client }) => ({ path: filePath, action, purpose, client })),
+        dryRun: options.dryRun ?? false,
+        nextStep: `Restart ${clients.map((client) => client === 'codex' ? 'Codex' : 'OpenCode').join(' and ')} so ${clients.length === 1 ? 'it reloads' : 'they reload'} global MCP and AGENTS.md configuration.`,
+    };
+    if (options.dryRun)
+        return result;
+    await initializeDatabase({
+        databasePath,
+        ...(options.migrationsDirectory === undefined ? {} : { migrationsDirectory: options.migrationsDirectory }),
+    });
+    const database = openConnection(databasePath);
+    try {
+        ensureGlobalWorkspace(database);
+    }
+    finally {
+        database.close();
+    }
+    const written = [];
+    try {
+        for (const file of files) {
+            if (file.action === 'unchanged')
+                continue;
+            await atomicWriteText(file.path, file.content, file.mode);
+            written.push(file);
+        }
+    }
+    catch (error) {
+        await restoreFiles(written);
+        throw error;
+    }
+    return result;
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,GAE5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,UAAU,CAAU,CAAC;AA+B5D,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAqB,CAAC,CAAC,EAAE,CAAC;QACrG,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,gDAAgD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,OAAwB,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAClH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,QAAgB,EAChB,MAAmB,EACnB,OAA+B,EAC/B,MAAkF;IAElF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAgB,QAAQ,KAAK,SAAS;QAChD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,KAAK;QAC7B,QAAQ,EAAE,QAAQ,EAAE,OAAO;QAC3B,MAAM;QACN,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAAwB;IACxD,MAAM,SAAS,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACrD,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAoB;IAC9C,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QAC1C,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;;YAC3E,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAwB,EAAE;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,0CAA0C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;IAC7C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,qDAAqD,CAAC,CAAC;IAC7J,MAAM,eAAe,GAAoB;QACvC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC3D,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACpF,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACpJ,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,wBAAwB,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,wBAAwB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzJ,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,kBAAkB,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACvJ,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,2BAA2B,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,wBAAwB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/J,CAAC;IAED,MAAM,MAAM,GAAgB;QAC1B,OAAO;QACP,YAAY;QACZ,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa;QAC1D,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAChH,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,QAAQ,EAAE,WAAW,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,0CAA0C;KAC1M,CAAC;IACF,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAElC,MAAM,kBAAkB,CAAC;QACvB,YAAY;QACZ,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC;KAC3G,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;gBAAE,SAAS;YAC1C,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/supersede.d.ts

@@ -0,0 +1,6 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import { supersedeEntry } from '../memory/lifecycle.js';
+export declare const supersede: typeof supersedeEntry;
+export type SupersedeCommandOptions = Parameters<typeof supersedeEntry>[1];
+export declare function runSupersede(database: SqliteDatabase, options: SupersedeCommandOptions): import("../memory/entries.js").EntryRecord;
+//# sourceMappingURL=supersede.d.ts.map

package/dist/commands/supersede.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede.d.ts","sourceRoot":"","sources":["../../src/commands/supersede.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,eAAO,MAAM,SAAS,uBAAiB,CAAC;AACxC,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,8CAEtF"}

package/dist/commands/supersede.js

@@ -0,0 +1,6 @@
+import { supersedeEntry } from '../memory/lifecycle.js';
+export const supersede = supersedeEntry;
+export function runSupersede(database, options) {
+    return supersedeEntry(database, options);
+}
+//# sourceMappingURL=supersede.js.map

package/dist/commands/supersede.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede.js","sourceRoot":"","sources":["../../src/commands/supersede.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,CAAC;AAExC,MAAM,UAAU,YAAY,CAAC,QAAwB,EAAE,OAAgC;IACrF,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/commands/use.d.ts

@@ -0,0 +1,28 @@
+export interface UseOptions {
+    cwd?: string;
+    root?: string;
+    workspace?: string;
+    agentFile?: string;
+    dryRun?: boolean;
+    noAgentFile?: boolean;
+    forceRebind?: boolean;
+    allowDirectory?: boolean;
+    databasePath?: string;
+    migrationsDirectory?: string;
+    repositoryId?: string;
+}
+export interface UseResult {
+    repositoryRoot: string;
+    repositoryId: string;
+    workspace: string;
+    databasePath: string;
+    bindingFile: string;
+    agentFile: string | null;
+    agentFileAction: 'created' | 'updated' | 'unchanged' | 'skipped';
+    bindingAction: 'created' | 'updated' | 'unchanged' | 'planned';
+    dryRun: boolean;
+    templateVersion: number;
+}
+export declare function useRepository(options?: UseOptions): Promise<UseResult>;
+export declare const use: typeof useRepository;
+//# sourceMappingURL=use.d.ts.map

package/dist/commands/use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../src/commands/use.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACjE,aAAa,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAmCD,wBAAsB,aAAa,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAmHhF;AAED,eAAO,MAAM,GAAG,sBAAgB,CAAC"}