kiokuko-dsh 0.1.0

package/dist/dsh/prompt-policy.js

@@ -0,0 +1,16 @@
+import { loadStandardSkillParity } from './parity.js';
+export const KIOKUKO_SOUL_PROMPT_SECTION = 'kiokuko:soul';
+export const KIOKUKO_SOUL_PROMPT_ORDER = -100_000;
+export async function loadSoulPrompt() {
+    const parity = await loadStandardSkillParity();
+    return parity.files.find((file) => file.skillName === 'kiokuko-soul' && file.relativePath === 'SKILL.md').content;
+}
+/** Add the exact SOUL body as a stable, earliest prompt section. */
+export function mountSoulPrompt(ctx) {
+    return ctx.effect(async () => ctx.systemPrompt.section({
+        name: KIOKUKO_SOUL_PROMPT_SECTION,
+        order: Math.min(KIOKUKO_SOUL_PROMPT_ORDER, ctx.systemPrompt.getSectionOrder('HARNESS_IDENTITY') - 1),
+        text: await loadSoulPrompt(),
+    }), 'kiokuko-dsh soul prompt');
+}
+//# sourceMappingURL=prompt-policy.js.map

package/dist/dsh/prompt-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-policy.js","sourceRoot":"","sources":["../../src/dsh/prompt-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,CAAC,MAAM,2BAA2B,GAAG,cAAc,CAAA;AACzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAO,CAAA;AAUjD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,MAAM,uBAAuB,EAAE,CAAA;IAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,cAAc,IAAI,IAAI,CAAC,YAAY,KAAK,UAAU,CAAE,CAAC,OAAO,CAAA;AACpH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC;QACrD,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,yBAAyB,EAAE,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACpG,IAAI,EAAE,MAAM,cAAc,EAAE;KAC7B,CAAC,EAAE,yBAAyB,CAAC,CAAA;AAChC,CAAC"}

package/dist/dsh/runtime.d.ts

@@ -0,0 +1,40 @@
+import { type InitOptions } from '../commands/init.js';
+import { type PathEnvironment } from '../config/paths.js';
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type EmbeddingDatabaseOpener } from '../embedding/backend.js';
+import type { EmbeddingConfig, EmbeddingProvider, EmbeddingRuntime, VectorSearchBackend } from '../embedding/types.js';
+import { type DshAgentIdentity, type DshAgentState } from './agent-state.js';
+import { type AdapterDecision } from '../enno-oduno/adapters.js';
+export interface DshRuntimeOptions extends PathEnvironment {
+    readonly repositoryRoot: string;
+    readonly databasePath?: string;
+    readonly migrationsDirectory?: string;
+    readonly initializeDatabase?: (options: InitOptions) => unknown | PromiseLike<unknown>;
+    readonly openDatabase?: EmbeddingDatabaseOpener;
+    readonly embeddingConfig?: EmbeddingConfig;
+    readonly embeddingProvider?: EmbeddingProvider;
+    readonly embeddingBackend?: VectorSearchBackend;
+    readonly now?: () => string;
+}
+export type DshDatabaseOperation<T> = (database: SqliteDatabase, runtime: EmbeddingRuntime) => Promise<T> | T;
+/** Own the Kiokuko resources for one dsh process and its agent turns. */
+export declare class DshRuntime {
+    #private;
+    constructor(options: DshRuntimeOptions);
+    start(): Promise<void>;
+    withDatabase<T>(operation: DshDatabaseOperation<T>): Promise<T>;
+    enqueueWrite<T>(operation: () => T | PromiseLike<T>): Promise<T>;
+    openAgent(identity: DshAgentIdentity): Promise<DshAgentState>;
+    /** Resume only through the exact dsh session and canonical repository route. */
+    resume(input: {
+        readonly dshSessionId: string;
+        readonly cwd?: string;
+        readonly runId?: string;
+        readonly resumeToken?: string;
+    }): Promise<AdapterDecision>;
+    closeAgent(identity: DshAgentIdentity): boolean;
+    get continuationCount(): number;
+    get activeAgentCount(): number;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/dsh/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAE7F,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAGtH,OAAO,EAAyB,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEnG,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3F,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAA;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAA;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,CAAA;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAkE7G,yEAAyE;AACzE,qBAAa,UAAU;;gBAUT,OAAO,EAAE,iBAAiB;IA6ChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/D,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMhE,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAKnE,gFAAgF;IAC1E,MAAM,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAyD/J,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO;IAI/C,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB7B"}

package/dist/dsh/runtime.js

@@ -0,0 +1,237 @@
+import { realpathSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { initializeDatabase } from '../commands/init.js';
+import { getGlobalDatabasePath } from '../config/paths.js';
+import { openConnection } from '../db/connection.js';
+import { KiokukoError } from '../errors.js';
+import { openEmbeddingDatabase } from '../embedding/backend.js';
+import { createEmbeddingRuntime } from '../embedding/runtime.js';
+import { createEmbeddingWorker } from '../embedding/worker.js';
+import { WriteQueue } from '../server/write-queue.js';
+import { DshAgentStateRegistry } from './agent-state.js';
+import { DshContinuationRegistry } from './agent-state.js';
+import { decideAdapterContinuation } from '../enno-oduno/adapters.js';
+function requireRepositoryRoot(root) {
+    if (typeof root !== 'string' || root.length === 0 || !resolve(root)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'repositoryRoot must be a non-empty path');
+    }
+    const canonical = realpathSync(root);
+    if (!statSync(canonical).isDirectory()) {
+        throw new KiokukoError('VALIDATION_ERROR', 'repositoryRoot must be a directory');
+    }
+    return canonical;
+}
+function findRepositoryBinding(database, repositoryRoot) {
+    const row = database.prepare(`
+    SELECT l.repository_id AS repositoryId, r.workspace AS workspace
+      FROM repository_locations AS l
+      JOIN repositories AS r ON r.repository_id = l.repository_id
+     WHERE l.canonical_root = ?
+  `).get(repositoryRoot);
+    if (row === undefined) {
+        throw new KiokukoError('CONFLICT', 'The repository is not registered with Kiokuko');
+    }
+    return Object.freeze(row);
+}
+async function closeResources(resources) {
+    const errors = [];
+    try {
+        if (resources.worker !== undefined)
+            await resources.worker.close();
+        else
+            await resources.embeddingRuntime?.close();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    try {
+        await resources.queue?.close();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    try {
+        resources.database?.close();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    if (errors.length === 1)
+        throw errors[0];
+    if (errors.length > 1)
+        throw new AggregateError(errors, 'dsh runtime cleanup failed');
+}
+/** Own the Kiokuko resources for one dsh process and its agent turns. */
+export class DshRuntime {
+    #options;
+    #agents = new DshAgentStateRegistry();
+    #continuations = new DshContinuationRegistry();
+    #initialization;
+    #resources;
+    #closing = false;
+    #closed = false;
+    #closePromise;
+    constructor(options) {
+        this.#options = options;
+    }
+    async #initialize() {
+        const repositoryRoot = requireRepositoryRoot(this.#options.repositoryRoot);
+        const databasePath = this.#options.databasePath ?? getGlobalDatabasePath(this.#options);
+        const initialize = this.#options.initializeDatabase ?? initializeDatabase;
+        let database;
+        let embeddingRuntime;
+        let worker;
+        let queue;
+        try {
+            await initialize({
+                databasePath,
+                ...(this.#options.migrationsDirectory === undefined ? {} : { migrationsDirectory: this.#options.migrationsDirectory }),
+            });
+            const opened = await openEmbeddingDatabase(databasePath, {
+                ...(this.#options.embeddingConfig === undefined ? {} : { config: this.#options.embeddingConfig }),
+                openDatabase: this.#options.openDatabase ?? openConnection,
+                ...(this.#options.embeddingBackend === undefined ? {} : { backend: this.#options.embeddingBackend }),
+            });
+            database = opened.database;
+            const binding = findRepositoryBinding(database, repositoryRoot);
+            queue = new WriteQueue(64);
+            embeddingRuntime = createEmbeddingRuntime(database, this.#options.embeddingConfig, {
+                ...(this.#options.embeddingProvider === undefined ? {} : { provider: this.#options.embeddingProvider }),
+                ...(opened.backend === undefined ? {} : { backend: opened.backend }),
+                enqueueWrite: (operation) => queue.enqueue(operation),
+            });
+            worker = embeddingRuntime.profileId === null ? undefined : createEmbeddingWorker({ runtime: embeddingRuntime });
+            const resources = { database, embeddingRuntime, worker, queue, binding };
+            this.#resources = resources;
+            worker?.start();
+            return resources;
+        }
+        catch (error) {
+            try {
+                await closeResources({ database, embeddingRuntime, worker, queue });
+            }
+            catch (closeError) {
+                throw new AggregateError([error, closeError], 'dsh runtime initialization failed and cleanup also failed');
+            }
+            throw error;
+        }
+    }
+    async start() {
+        if (this.#closed || this.#closing)
+            throw new KiokukoError('SERVICE_UNAVAILABLE', 'dsh runtime is closed');
+        if (this.#resources !== undefined)
+            return;
+        if (this.#initialization === undefined) {
+            this.#initialization = this.#initialize();
+        }
+        await this.#initialization;
+    }
+    async #requireResources() {
+        if (this.#closing || this.#closed)
+            throw new KiokukoError('SERVICE_UNAVAILABLE', 'dsh runtime is closed');
+        await this.start();
+        if (this.#resources === undefined)
+            throw new KiokukoError('INTEGRITY_ERROR', 'dsh runtime initialized without resources');
+        return this.#resources;
+    }
+    async withDatabase(operation) {
+        const resources = await this.#requireResources();
+        return operation(resources.database, resources.embeddingRuntime);
+    }
+    async enqueueWrite(operation) {
+        if (this.#closing || this.#closed)
+            throw new KiokukoError('SERVICE_UNAVAILABLE', 'dsh runtime is closed');
+        const resources = this.#resources ?? await this.#requireResources();
+        return resources.queue.enqueue(operation);
+    }
+    async openAgent(identity) {
+        const resources = await this.#requireResources();
+        return this.#agents.open(identity, resources.binding.repositoryId, resources.binding.workspace, this.#options.now?.());
+    }
+    /** Resume only through the exact dsh session and canonical repository route. */
+    async resume(input) {
+        const cwd = realpathSync(this.#options.repositoryRoot);
+        const runId = input.runId;
+        if (runId === undefined)
+            throw new KiokukoError('VALIDATION_ERROR', 'runId is required for exact dsh resume');
+        const route = await this.withDatabase((database) => {
+            const row = database.prepare(`
+        SELECT ec.workspace AS workspace, ec.route_epoch AS routeEpoch,
+               ec.client_kind AS clientKind, ec.client_session_id AS clientSessionId
+        FROM enno_contracts AS ec
+        JOIN ledger_runs AS lr ON lr.run_id = ec.run_id AND lr.workspace = ec.workspace
+        WHERE ec.run_id = ? AND ec.repository_root = ?
+      `).get(runId, cwd);
+            if (row === undefined)
+                throw new KiokukoError('CONFLICT', 'The resume run is not registered for this repository');
+            return row;
+        });
+        let previousBinding;
+        if (input.resumeToken !== undefined) {
+            if (route.clientKind !== 'dsh' || route.clientSessionId !== input.dshSessionId) {
+                throw new KiokukoError('CONFLICT', 'resumeToken is not bound to the current dsh session');
+            }
+            previousBinding = this.#continuations.resolveExact({
+                resumeToken: input.resumeToken,
+                dshSessionId: input.dshSessionId,
+                runId,
+                workspace: route.workspace,
+            });
+            if (route.routeEpoch !== previousBinding.routeEpoch)
+                throw new KiokukoError('CONFLICT', 'resumeToken route epoch is stale');
+        }
+        const decision = await this.withDatabase((database) => decideAdapterContinuation(database, 'dsh', {
+            session_id: input.dshSessionId,
+            cwd,
+        }));
+        if (decision.runId !== null && decision.runId !== runId)
+            throw new KiokukoError('CONFLICT', 'dsh resume resolved a different run');
+        if (previousBinding !== undefined && decision.routeEpoch !== previousBinding.routeEpoch)
+            throw new KiokukoError('CONFLICT', 'dsh resume route epoch changed');
+        if (decision.resumeToken !== null && decision.runId !== null && decision.routeEpoch !== null && decision.directive !== null) {
+            const workspace = await this.withDatabase((database) => {
+                const row = database.prepare('SELECT workspace FROM ledger_runs WHERE run_id = ?').get(decision.runId);
+                if (row === undefined)
+                    throw new KiokukoError('CONFLICT', 'The resumed run is not registered');
+                return row.workspace;
+            });
+            const binding = {
+                resumeToken: decision.resumeToken,
+                dshSessionId: input.dshSessionId,
+                runId: decision.runId,
+                workspace,
+                routeEpoch: decision.routeEpoch,
+            };
+            this.#continuations.bind(binding);
+        }
+        return decision;
+    }
+    closeAgent(identity) {
+        return this.#agents.close(identity);
+    }
+    get continuationCount() {
+        return this.#continuations.size;
+    }
+    get activeAgentCount() {
+        return this.#agents.size;
+    }
+    async close() {
+        if (this.#closePromise !== undefined)
+            return this.#closePromise;
+        this.#closing = true;
+        this.#agents.closeAll();
+        this.#continuations.clear();
+        this.#closePromise = (async () => {
+            const resources = this.#resources ?? await this.#initialization?.catch(() => undefined);
+            if (resources === undefined) {
+                this.#closed = true;
+                return;
+            }
+            await closeResources(resources);
+            this.#resources = undefined;
+            this.#closed = true;
+        })();
+        return this.#closePromise;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/dsh/runtime.js.map

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

package/dist/dsh/session-bridge.d.ts

@@ -0,0 +1,98 @@
+import { type BoundaryJsonValue } from '../serialization/boundary-json.js';
+import type { LedgerEventInput } from '../ledger/types.js';
+import type { DshRuntime } from './runtime.js';
+export interface DshSessionEvent {
+    readonly type: string;
+    readonly seq: number;
+    readonly time: number;
+    readonly data?: unknown;
+    readonly ignorable?: true;
+}
+export interface DshSessionEventInput {
+    readonly sessionId: string;
+    readonly runId: string;
+    readonly event: DshSessionEvent;
+}
+export interface DshQueuedSessionEvent {
+    readonly runId: string;
+    readonly sessionId: string;
+    readonly sourceEventId: string;
+    readonly sourceSequence: number;
+    readonly event: Readonly<{
+        type: string;
+        seq: number;
+        time: number;
+        data: BoundaryJsonValue;
+        ignorable?: true;
+    }>;
+}
+export interface DshSessionBridgeOptions {
+    readonly runtime: Pick<DshRuntime, 'withDatabase'>;
+    readonly appendBatch?: (runId: string, events: readonly LedgerEventInput[]) => unknown | PromiseLike<unknown>;
+}
+export interface DshDurabilityContext {
+    on(name: 'session/flush' | 'llm/stream' | 'tools/execute' | 'agent/pre-step', listener: (...args: any[]) => any, options?: {
+        readonly prepend?: boolean;
+    }): () => void;
+}
+/** Minimal native dsh session surface used by the post-commit bridge. */
+export interface DshNativeSession {
+    readonly id: string;
+}
+export interface DshSessionBridgeContext {
+    on(name: 'session/created' | 'session/disposed' | 'session/event', listener: (...args: any[]) => any, options?: {
+        readonly prepend?: boolean;
+    }): () => void;
+}
+export type DshSessionRunResolver = (session: DshNativeSession) => string | undefined;
+export interface DshRunLifecycleOptions {
+    readonly bridge: Pick<DshSessionBridge, 'flush' | 'close'>;
+    readonly closeRun: (input: {
+        readonly runId: string;
+        readonly status: 'completed' | 'failed' | 'cancelled';
+    }) => void | PromiseLike<void>;
+}
+/** Close a run only after the ordered dsh suffix is durably bridged. */
+export declare class DshRunLifecycle {
+    #private;
+    constructor(options: DshRunLifecycleOptions);
+    closeTurn(input: {
+        readonly runId: string;
+        readonly status: 'completed' | 'failed' | 'cancelled';
+    }): Promise<void>;
+    dispose(): Promise<void>;
+}
+/** Bridge committed dsh session events into Kiokuko's ordered ledger. */
+export declare class DshSessionBridge {
+    #private;
+    constructor(options: DshSessionBridgeOptions);
+    bindSession(sessionId: string, runId: string): void;
+    /** Post-commit observer: malformed events are recorded and never veto the session append. */
+    observe(input: DshSessionEventInput): void;
+    get pendingCount(): number;
+    get observerErrors(): readonly unknown[];
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Install prepend durability barriers around the four model/session boundaries. */
+export declare function mountDshDurabilityBarriers(ctx: DshDurabilityContext, bridge: DshSessionBridge): () => void;
+/**
+ * Attach the bridge to dsh's real session event contract. `session/event` is
+ * deliberately an observer: errors are captured by DshSessionBridge and can
+ * only surface at the awaited flush boundary.
+ */
+export declare function mountDshSessionBridge(ctx: DshSessionBridgeContext, bridge: DshSessionBridge, resolveRunId: DshSessionRunResolver): () => void;
+export interface DshIdleLifecycleContext {
+    on(name: 'agent/status', listener: (event: {
+        readonly agent: {
+            readonly id: string;
+        };
+        readonly status: string;
+    }) => unknown): () => void;
+}
+/** Flush and close a bound run after dsh reports the agent's true idle state. */
+export declare function mountDshIdleLifecycle(ctx: DshIdleLifecycleContext, lifecycle: DshRunLifecycle, resolveClose: (agentId: string) => {
+    readonly runId: string;
+    readonly status: 'completed' | 'failed' | 'cancelled';
+} | undefined): () => void;
+//# sourceMappingURL=session-bridge.d.ts.map

package/dist/dsh/session-bridge.d.ts.map

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

package/dist/dsh/session-bridge.js

@@ -0,0 +1,202 @@
+import { cloneBoundaryJson } from '../serialization/boundary-json.js';
+import { KiokukoError } from '../errors.js';
+import { LedgerStore } from '../ledger/store.js';
+import { dshSessionEventSourceId } from './agent-state.js';
+/** Close a run only after the ordered dsh suffix is durably bridged. */
+export class DshRunLifecycle {
+    #bridge;
+    #closeRun;
+    constructor(options) {
+        this.#bridge = options.bridge;
+        this.#closeRun = options.closeRun;
+    }
+    async closeTurn(input) {
+        await this.#bridge.flush();
+        await this.#closeRun(input);
+    }
+    async dispose() {
+        await this.#bridge.close();
+    }
+}
+function validation(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function validId(value, label) {
+    if (typeof value !== 'string' || value.length === 0 || value.length > 256 || /[\p{Cc}]/u.test(value))
+        validation(`${label} must be a bounded non-empty string`);
+    return value;
+}
+function validEvent(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        validation('SessionEvent must be a plain object');
+    const event = value;
+    if (typeof event.type !== 'string' || event.type.length === 0 || event.type.length > 256 || /[\p{Cc}]/u.test(event.type))
+        validation('SessionEvent type is invalid');
+    if (!Number.isSafeInteger(event.seq) || event.seq < 0)
+        validation('SessionEvent sequence is invalid');
+    if (!Number.isFinite(event.time))
+        validation('SessionEvent time is invalid');
+    return { type: event.type, seq: event.seq, time: event.time, data: event.data, ...(event.ignorable === true ? { ignorable: true } : {}) };
+}
+function queuedFingerprint(item) {
+    return JSON.stringify(item.event);
+}
+function ledgerEvent(item) {
+    return {
+        sourceEventId: item.sourceEventId,
+        sourceSequence: item.sourceSequence,
+        eventType: 'source.event',
+        sourceType: 'dsh-session',
+        actor: 'dsh',
+        occurredAt: new Date(item.event.time).toISOString(),
+        payload: { sessionId: item.sessionId, event: item.event },
+    };
+}
+/** Bridge committed dsh session events into Kiokuko's ordered ledger. */
+export class DshSessionBridge {
+    #runtime;
+    #appendBatch;
+    #runs = new Map();
+    #pending = new Map();
+    #committed = new Map();
+    #observerErrors = [];
+    #flushPromise;
+    #closed = false;
+    constructor(options) {
+        this.#runtime = options.runtime;
+        this.#appendBatch = options.appendBatch ?? ((runId, events) => this.#runtime.withDatabase((database) => new LedgerStore(database).appendBatch(runId, { events })));
+    }
+    bindSession(sessionId, runId) {
+        const session = validId(sessionId, 'sessionId');
+        const run = validId(runId, 'runId');
+        const existing = this.#runs.get(session);
+        if (existing !== undefined && existing !== run)
+            throw new KiokukoError('CONFLICT', 'dsh session is already bound to another run');
+        this.#runs.set(session, run);
+    }
+    /** Post-commit observer: malformed events are recorded and never veto the session append. */
+    observe(input) {
+        if (this.#closed)
+            return;
+        try {
+            const sessionId = validId(input.sessionId, 'sessionId');
+            const runId = this.#runs.get(sessionId);
+            if (runId === undefined || runId !== input.runId)
+                validation('dsh session has no matching run binding');
+            const event = validEvent(input.event);
+            const sourceEventId = dshSessionEventSourceId(sessionId, event.seq);
+            const data = cloneBoundaryJson(event.data ?? null, { maximumDepth: 32, maximumNodes: 2_000, maximumStringBytes: 64 * 1024, failure: () => new KiokukoError('VALIDATION_ERROR', 'SessionEvent data is not JSON-safe') });
+            const queued = Object.freeze({ runId, sessionId, sourceEventId, sourceSequence: event.seq, event: Object.freeze({ ...event, data }) });
+            const existing = this.#pending.get(sourceEventId);
+            const committed = this.#committed.get(sourceEventId);
+            const fingerprint = queuedFingerprint(queued);
+            if (existing !== undefined) {
+                if (queuedFingerprint(existing) !== fingerprint)
+                    this.#observerErrors.push(new KiokukoError('CONFLICT', 'Duplicate dsh session event identity has different content'));
+                return;
+            }
+            if (committed !== undefined) {
+                if (committed !== fingerprint)
+                    this.#observerErrors.push(new KiokukoError('CONFLICT', 'Committed dsh session event identity has different content'));
+                return;
+            }
+            this.#pending.set(sourceEventId, queued);
+        }
+        catch (error) {
+            this.#observerErrors.push(error);
+        }
+    }
+    get pendingCount() { return this.#pending.size; }
+    get observerErrors() { return [...this.#observerErrors]; }
+    async flush() {
+        if (this.#flushPromise !== undefined)
+            return this.#flushPromise;
+        this.#flushPromise = this.#flushPending().finally(() => { this.#flushPromise = undefined; });
+        return this.#flushPromise;
+    }
+    async #flushPending() {
+        const grouped = new Map();
+        for (const item of this.#pending.values()) {
+            const group = grouped.get(item.runId) ?? [];
+            group.push(item);
+            grouped.set(item.runId, group);
+        }
+        const batches = [...grouped.entries()].map(async ([runId, items]) => {
+            items.sort((left, right) => left.sourceSequence - right.sourceSequence);
+            await this.#appendBatch(runId, items.map(ledgerEvent));
+            return items;
+        });
+        const completed = await Promise.all(batches);
+        for (const items of completed) {
+            for (const item of items) {
+                if (this.#pending.get(item.sourceEventId) === item) {
+                    this.#pending.delete(item.sourceEventId);
+                    this.#committed.set(item.sourceEventId, queuedFingerprint(item));
+                }
+            }
+        }
+    }
+    async close() {
+        await this.flush();
+        this.#closed = true;
+        this.#runs.clear();
+    }
+}
+/** Install prepend durability barriers around the four model/session boundaries. */
+export function mountDshDurabilityBarriers(ctx, bridge) {
+    const disposers = [
+        ctx.on('session/flush', async (_payload, next) => { await bridge.flush(); return next(); }, { prepend: true }),
+        ctx.on('agent/pre-step', async (_payload, next) => { await bridge.flush(); return next(); }, { prepend: true }),
+        ctx.on('tools/execute', async (_payload, next) => { await bridge.flush(); return next(); }, { prepend: true }),
+        ctx.on('llm/stream', (payload, next) => (async function* () {
+            await bridge.flush();
+            yield* next();
+        })(), { prepend: true }),
+    ];
+    return () => { for (const dispose of disposers.reverse())
+        dispose(); };
+}
+/**
+ * Attach the bridge to dsh's real session event contract. `session/event` is
+ * deliberately an observer: errors are captured by DshSessionBridge and can
+ * only surface at the awaited flush boundary.
+ */
+export function mountDshSessionBridge(ctx, bridge, resolveRunId) {
+    const bound = new Map();
+    const bind = (session) => {
+        const existing = bound.get(session.id);
+        if (existing !== undefined)
+            return existing;
+        const runId = resolveRunId(session);
+        if (runId !== undefined) {
+            bridge.bindSession(session.id, runId);
+            bound.set(session.id, runId);
+        }
+        return runId;
+    };
+    const disposers = [
+        ctx.on('session/created', (session) => { bind(session); }),
+        ctx.on('session/event', (session, event) => {
+            const runId = bind(session);
+            if (runId !== undefined)
+                bridge.observe({ sessionId: session.id, runId, event });
+        }),
+        ctx.on('session/disposed', (session) => { bound.delete(session.id); }),
+    ];
+    return () => {
+        for (const dispose of disposers.reverse())
+            dispose();
+        bound.clear();
+    };
+}
+/** Flush and close a bound run after dsh reports the agent's true idle state. */
+export function mountDshIdleLifecycle(ctx, lifecycle, resolveClose) {
+    return ctx.on('agent/status', (event) => {
+        if (event.status !== 'idle')
+            return;
+        const close = resolveClose(event.agent.id);
+        if (close !== undefined)
+            void lifecycle.closeTurn(close);
+    });
+}
+//# sourceMappingURL=session-bridge.js.map

package/dist/dsh/session-bridge.js.map

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