@askdkc/kiokuko 0.1.0

package/dist/server/routes/agent-runs.js

@@ -0,0 +1,151 @@
+import { KiokukoError } from '../../errors.js';
+import { successEnvelope } from '../../serialization/envelope.js';
+import { attachInitialContext } from './task5-support.js';
+const RUNS_PATH = '/api/v1/agent/runs';
+const CONTROL_CHARACTERS = /\p{Cc}/u;
+const MAX_IDEMPOTENCY_KEY_BYTES = 256;
+const MAX_ID_LENGTH = 256;
+function invalid() {
+    throw new KiokukoError('VALIDATION_ERROR', 'Request is invalid');
+}
+export function queryParameters(url, allowed) {
+    const allowedSet = new Set(allowed);
+    const values = new Map();
+    for (const [key, value] of url.searchParams) {
+        if (!allowedSet.has(key) || values.has(key))
+            invalid();
+        values.set(key, value);
+    }
+    return values;
+}
+export function requireNoQuery(url) {
+    if (url.search.length > 0)
+        invalid();
+}
+export function decimalQuery(values, field) {
+    const value = values.get(field);
+    if (value === undefined)
+        return undefined;
+    if (!/^(?:0|[1-9]\d*)$/u.test(value))
+        invalid();
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed))
+        invalid();
+    return parsed;
+}
+export function decodeRunId(raw) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(raw);
+    }
+    catch {
+        invalid();
+    }
+    if (decoded.length === 0 || decoded.length > MAX_ID_LENGTH || decoded.includes('/') || decoded.includes('\\') || CONTROL_CHARACTERS.test(decoded)) {
+        invalid();
+    }
+    return decoded;
+}
+export function runIdSegment(pathname, suffix) {
+    const prefix = `${RUNS_PATH}/`;
+    if (!pathname.startsWith(prefix))
+        return undefined;
+    const rest = pathname.slice(prefix.length);
+    if (suffix !== undefined) {
+        const marker = `/${suffix}`;
+        if (!rest.endsWith(marker))
+            return undefined;
+        const raw = rest.slice(0, -marker.length);
+        if (raw.includes('/'))
+            return undefined;
+        return raw;
+    }
+    if (rest.includes('/'))
+        return undefined;
+    return rest;
+}
+export function requireIdempotencyKey(request) {
+    const value = request.headers['idempotency-key'];
+    if (Array.isArray(value) || typeof value !== 'string' || value.trim().length === 0
+        || Buffer.byteLength(value, 'utf8') > MAX_IDEMPOTENCY_KEY_BYTES || CONTROL_CHARACTERS.test(value)) {
+        invalid();
+    }
+    const rawHeaders = request.rawHeaders;
+    if (rawHeaders !== undefined) {
+        let occurrences = 0;
+        for (let index = 0; index < rawHeaders.length; index += 2) {
+            if (rawHeaders[index]?.toLowerCase() === 'idempotency-key')
+                occurrences += 1;
+        }
+        if (occurrences !== 1)
+            invalid();
+    }
+    return value;
+}
+export function isRunsPath(pathname) {
+    return pathname === RUNS_PATH;
+}
+export function createAgentRunsRoute(context) {
+    return async (request) => {
+        if (request.method === 'POST' && isRunsPath(request.url.pathname)) {
+            requireNoQuery(request.url);
+            const idempotencyKey = requireIdempotencyKey(request);
+            const data = await context.enqueueWrite(() => context.service.openRun({
+                idempotencyKey,
+                request: request.body,
+            }));
+            return successEnvelope('agent.open', await attachInitialContext(context, data.runId, data));
+        }
+        if (request.method === 'GET' && isRunsPath(request.url.pathname)) {
+            const values = queryParameters(request.url, ['workspace', 'client', 'status', 'cursor', 'limit']);
+            const workspace = values.get('workspace');
+            if (workspace === undefined || workspace.length === 0)
+                invalid();
+            const input = { workspace };
+            for (const field of ['client', 'status', 'cursor']) {
+                const value = values.get(field);
+                if (value !== undefined)
+                    input[field] = value;
+            }
+            const limit = decimalQuery(values, 'limit');
+            if (limit !== undefined)
+                input.limit = limit;
+            return successEnvelope('agent.runs.list', context.service.listRuns(input));
+        }
+        if (request.method === 'POST') {
+            const rawRunId = runIdSegment(request.url.pathname, 'close');
+            if (rawRunId !== undefined) {
+                requireNoQuery(request.url);
+                const runId = decodeRunId(rawRunId);
+                const idempotencyKey = requireIdempotencyKey(request);
+                const data = await context.enqueueWrite(() => context.service.closeRun({
+                    runId,
+                    idempotencyKey,
+                    request: request.body,
+                }));
+                return successEnvelope('agent.close', data);
+            }
+        }
+        if (request.method === 'GET') {
+            const rawRunId = runIdSegment(request.url.pathname);
+            if (rawRunId !== undefined) {
+                requireNoQuery(request.url);
+                return successEnvelope('agent.run.read', context.service.readRun({ runId: decodeRunId(rawRunId) }));
+            }
+        }
+        return undefined;
+    };
+}
+export function agentRunsOperation(method, pathname) {
+    if (method === 'POST' && isRunsPath(pathname))
+        return 'agent.open';
+    if (method === 'GET' && isRunsPath(pathname))
+        return 'agent.runs.list';
+    if (method === 'POST' && runIdSegment(pathname, 'close') !== undefined)
+        return 'agent.close';
+    if (method === 'GET' && runIdSegment(pathname) !== undefined)
+        return 'agent.run.read';
+    return undefined;
+}
+export { RUNS_PATH };
+//# sourceMappingURL=agent-runs.js.map

package/dist/server/routes/agent-runs.js.map

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

package/dist/server/routes/task5-support.d.ts

@@ -0,0 +1,11 @@
+import type { ContextBrokerPersistence, ContextBrokerResult } from '../../context/broker.js';
+import type { AgentRouteContext } from './agent-runs.js';
+export declare function brokerPersistence(context: AgentRouteContext): ContextBrokerPersistence;
+export declare function attachInitialContext<T extends {
+    intakeStatus?: string;
+    context?: unknown;
+}>(context: AgentRouteContext, runId: string, value: T): Promise<T & {
+    context: ContextBrokerResult['context'];
+    recommendations: ContextBrokerResult['recommendations'];
+}>;
+//# sourceMappingURL=task5-support.d.ts.map

package/dist/server/routes/task5-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5-support.d.ts","sourceRoot":"","sources":["../../../src/server/routes/task5-support.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,wBAAwB,CAKtF;AAED,wBAAsB,oBAAoB,CAAC,CAAC,SAAS;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAAC,eAAe,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;CAAE,CAAC,CAUzQ"}

package/dist/server/routes/task5-support.js

@@ -0,0 +1,22 @@
+import { persistOfficialSourceSync } from '../../knowledge/sources.js';
+import { recordContextDeliveryInTransaction } from '../../context/delivery.js';
+import { withImmediateTransaction } from '../../db/transaction.js';
+export function brokerPersistence(context) {
+    return {
+        persistSources: (workspace, prepared) => context.enqueueWrite(() => persistOfficialSourceSync(context.database, { workspace, prepared })),
+        persistDelivery: (input) => context.enqueueWrite(() => withImmediateTransaction(context.database, () => recordContextDeliveryInTransaction(context.database, input))),
+    };
+}
+export async function attachInitialContext(context, runId, value) {
+    if (value.intakeStatus !== 'ready' && value.intakeStatus !== 'exhausted') {
+        return { ...value, context: null, recommendations: [] };
+    }
+    try {
+        const result = await context.broker.query({ workspace: 'run-bound', runId }, brokerPersistence(context));
+        return { ...value, context: result.context, recommendations: result.recommendations };
+    }
+    catch {
+        return { ...value, context: null, recommendations: [] };
+    }
+}
+//# sourceMappingURL=task5-support.js.map

package/dist/server/routes/task5-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5-support.js","sourceRoot":"","sources":["../../../src/server/routes/task5-support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAInE,MAAM,UAAU,iBAAiB,CAAC,OAA0B;IAC1D,OAAO;QACL,cAAc,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzI,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,kCAAkC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;KACtK,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAyD,OAA0B,EAAE,KAAa,EAAE,KAAQ;IACpJ,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,IAAI,KAAK,CAAC,YAAY,KAAK,WAAW,EAAE,CAAC;QACzE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QACzG,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/server/routes/task5.d.ts

@@ -0,0 +1,5 @@
+import type { V1RouteHandler } from '../router.js';
+import { type AgentRouteContext } from './agent-runs.js';
+export declare function createTask5Route(context: AgentRouteContext): V1RouteHandler;
+export declare function task5Operation(method: string, pathname: string): string | undefined;
+//# sourceMappingURL=task5.d.ts.map

package/dist/server/routes/task5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task5.d.ts","sourceRoot":"","sources":["../../../src/server/routes/task5.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAYzB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAoD3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMnF"}

package/dist/server/routes/task5.js

@@ -0,0 +1,72 @@
+import { successEnvelope } from '../../serialization/envelope.js';
+import { decodeRunId, decimalQuery, queryParameters, requireIdempotencyKey, requireNoQuery, runIdSegment, } from './agent-runs.js';
+import { brokerPersistence } from './task5-support.js';
+const CHECKPOINTS_SUFFIX = 'checkpoints';
+const FEEDBACK_SUFFIX = 'feedback';
+const DELIVERIES_SUFFIX = 'context-deliveries';
+const CONTEXT_QUERY_PATH = '/api/v1/context/query';
+async function brokerQuery(context, body) {
+    return context.broker.query(body, brokerPersistence(context));
+}
+export function createTask5Route(context) {
+    return async (request) => {
+        if (request.method === 'POST') {
+            const rawCheckpointRunId = runIdSegment(request.url.pathname, CHECKPOINTS_SUFFIX);
+            if (rawCheckpointRunId !== undefined) {
+                requireNoQuery(request.url);
+                const runId = decodeRunId(rawCheckpointRunId);
+                const idempotencyKey = requireIdempotencyKey(request);
+                const data = await context.enqueueWrite(() => context.checkpointService.checkpoint({ runId, idempotencyKey, request: request.body }));
+                let enriched = data;
+                try {
+                    const result = await context.broker.query({ workspace: 'run-bound', runId, characterBudget: data.characterBudget }, brokerPersistence(context));
+                    enriched = { ...data, context: result.context, recommendations: result.recommendations };
+                }
+                catch {
+                    enriched = { ...data, context: null };
+                }
+                return successEnvelope('agent.checkpoint', enriched);
+            }
+            const rawFeedbackRunId = runIdSegment(request.url.pathname, FEEDBACK_SUFFIX);
+            if (rawFeedbackRunId !== undefined) {
+                requireNoQuery(request.url);
+                const runId = decodeRunId(rawFeedbackRunId);
+                const idempotencyKey = requireIdempotencyKey(request);
+                const data = await context.enqueueWrite(() => context.feedbackService.feedback({ runId, idempotencyKey, request: request.body }));
+                return successEnvelope('agent.feedback', data);
+            }
+            if (request.url.pathname === CONTEXT_QUERY_PATH) {
+                requireNoQuery(request.url);
+                const data = await brokerQuery(context, request.body);
+                return successEnvelope('context.query', data);
+            }
+        }
+        if (request.method === 'GET') {
+            const rawRunId = runIdSegment(request.url.pathname, DELIVERIES_SUFFIX);
+            if (rawRunId !== undefined) {
+                const runId = decodeRunId(rawRunId);
+                const values = queryParameters(request.url, ['cursor', 'limit']);
+                const cursor = values.get('cursor');
+                const limit = decimalQuery(values, 'limit');
+                return successEnvelope('agent.context-deliveries.list', context.broker.listDeliveries({
+                    runId,
+                    ...(cursor === undefined ? {} : { cursor }),
+                    ...(limit === undefined ? {} : { limit }),
+                }));
+            }
+        }
+        return undefined;
+    };
+}
+export function task5Operation(method, pathname) {
+    if (runIdSegment(pathname, CHECKPOINTS_SUFFIX) !== undefined)
+        return 'agent.checkpoint';
+    if (runIdSegment(pathname, FEEDBACK_SUFFIX) !== undefined)
+        return 'agent.feedback';
+    if (pathname === CONTEXT_QUERY_PATH)
+        return 'context.query';
+    if (runIdSegment(pathname, DELIVERIES_SUFFIX) !== undefined)
+        return 'agent.context-deliveries.list';
+    return undefined;
+}
+//# sourceMappingURL=task5.js.map

package/dist/server/routes/task5.js.map

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

package/dist/server/runtime-descriptor.d.ts

@@ -0,0 +1,24 @@
+export interface RuntimeDescriptor {
+    protocolVersion: '1';
+    instanceId: string;
+    pid: number;
+    baseUrl: string;
+    databaseFingerprint: string;
+    startedAt: string;
+    capabilityToken: string;
+}
+export interface CreateRuntimeDescriptorInput {
+    databasePath: string;
+    baseUrl: string;
+    pid?: number;
+    instanceId?: string;
+    startedAt?: string;
+    capabilityToken?: string;
+}
+export declare function createRuntimeDescriptor(input: CreateRuntimeDescriptorInput): RuntimeDescriptor;
+export type RuntimeDescriptorView = Omit<RuntimeDescriptor, 'capabilityToken'>;
+export declare function toPublicRuntimeDescriptor(descriptor: RuntimeDescriptor): RuntimeDescriptorView;
+export declare function writeRuntimeDescriptor(filePath: string, descriptor: RuntimeDescriptor): Promise<void>;
+export declare function readRuntimeDescriptor(filePath: string): Promise<RuntimeDescriptor | undefined>;
+export declare function removeRuntimeDescriptor(filePath: string, expectedInstanceId: string): Promise<boolean>;
+//# sourceMappingURL=runtime-descriptor.d.ts.map

package/dist/server/runtime-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-descriptor.d.ts","sourceRoot":"","sources":["../../src/server/runtime-descriptor.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,GAAG,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,iBAAiB,CAa9F;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AAE/E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,qBAAqB,CAS9F;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3G;AAcD,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAapG;AAED,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK5G"}

package/dist/server/runtime-descriptor.js

@@ -0,0 +1,156 @@
+import { createHash, randomBytes, randomUUID } from 'node:crypto';
+import { chmod, lstat, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { KiokukoError } from '../errors.js';
+const DESCRIPTOR_FIELDS = new Set([
+    'protocolVersion',
+    'instanceId',
+    'pid',
+    'baseUrl',
+    'databaseFingerprint',
+    'startedAt',
+    'capabilityToken',
+]);
+function validation(field) {
+    throw new KiokukoError('VALIDATION_ERROR', `Invalid runtime descriptor field: ${field}`);
+}
+function isLoopbackHttpUrl(value) {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:'
+            && (url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]')
+            && url.username === ''
+            && url.password === ''
+            && url.search === ''
+            && url.hash === '';
+    }
+    catch {
+        return false;
+    }
+}
+function isCanonicalUtc(value) {
+    if (typeof value !== 'string')
+        return false;
+    const date = new Date(value);
+    return !Number.isNaN(date.getTime()) && date.toISOString() === value;
+}
+function validateDescriptor(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Runtime descriptor must be an object');
+    }
+    for (const field of Object.keys(value)) {
+        if (!DESCRIPTOR_FIELDS.has(field)) {
+            throw new KiokukoError('VALIDATION_ERROR', `Unknown runtime descriptor field: ${field}`);
+        }
+    }
+    const descriptor = value;
+    for (const field of DESCRIPTOR_FIELDS) {
+        if (!(field in descriptor))
+            validation(field);
+    }
+    if (descriptor.protocolVersion !== '1')
+        validation('protocolVersion');
+    if (typeof descriptor.instanceId !== 'string'
+        || descriptor.instanceId.length === 0
+        || descriptor.instanceId.length > 128
+        || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(descriptor.instanceId)) {
+        validation('instanceId');
+    }
+    if (typeof descriptor.pid !== 'number' || !Number.isInteger(descriptor.pid) || descriptor.pid <= 0) {
+        validation('pid');
+    }
+    if (!isLoopbackHttpUrl(descriptor.baseUrl))
+        validation('baseUrl');
+    if (typeof descriptor.databaseFingerprint !== 'string' || !/^sha256:[a-f0-9]{64}$/.test(descriptor.databaseFingerprint)) {
+        validation('databaseFingerprint');
+    }
+    if (!isCanonicalUtc(descriptor.startedAt))
+        validation('startedAt');
+    if (typeof descriptor.capabilityToken !== 'string' || !/^[a-f0-9]{64}$/.test(descriptor.capabilityToken)) {
+        validation('capabilityToken');
+    }
+    return descriptor;
+}
+export function createRuntimeDescriptor(input) {
+    const databaseFingerprint = createHash('sha256')
+        .update(path.resolve(input.databasePath), 'utf8')
+        .digest('hex');
+    return validateDescriptor({
+        protocolVersion: '1',
+        instanceId: input.instanceId ?? randomUUID(),
+        pid: input.pid ?? process.pid,
+        baseUrl: input.baseUrl,
+        databaseFingerprint: `sha256:${databaseFingerprint}`,
+        startedAt: input.startedAt ?? new Date().toISOString(),
+        capabilityToken: input.capabilityToken ?? randomBytes(32).toString('hex'),
+    });
+}
+export function toPublicRuntimeDescriptor(descriptor) {
+    return {
+        protocolVersion: descriptor.protocolVersion,
+        instanceId: descriptor.instanceId,
+        pid: descriptor.pid,
+        baseUrl: descriptor.baseUrl,
+        databaseFingerprint: descriptor.databaseFingerprint,
+        startedAt: descriptor.startedAt,
+    };
+}
+export async function writeRuntimeDescriptor(filePath, descriptor) {
+    validateDescriptor(descriptor);
+    try {
+        assertSecureDescriptorFile(await lstat(filePath));
+    }
+    catch (error) {
+        if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
+            throw error;
+        }
+    }
+    const directory = path.dirname(filePath);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const temporaryPath = path.join(directory, `.${path.basename(filePath)}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporaryPath, `${JSON.stringify(descriptor)}\n`, { encoding: 'utf8', mode: 0o600 });
+        await chmod(temporaryPath, 0o600);
+        await rename(temporaryPath, filePath);
+    }
+    catch (error) {
+        await unlink(temporaryPath).catch(() => undefined);
+        throw error;
+    }
+}
+function assertSecureDescriptorFile(info) {
+    if (info.isSymbolicLink()) {
+        throw new KiokukoError('SECURITY_REJECTION', 'Runtime descriptor must not be a symbolic link');
+    }
+    if (!info.isFile()) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Runtime descriptor must be a regular file');
+    }
+    if (process.platform !== 'win32' && (Number(info.mode) & 0o077) !== 0) {
+        throw new KiokukoError('SECURITY_REJECTION', 'Runtime descriptor permissions are too broad');
+    }
+}
+export async function readRuntimeDescriptor(filePath) {
+    try {
+        assertSecureDescriptorFile(await lstat(filePath));
+        return validateDescriptor(JSON.parse(await readFile(filePath, 'utf8')));
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return undefined;
+        }
+        if (error instanceof SyntaxError) {
+            throw new KiokukoError('VALIDATION_ERROR', 'Runtime descriptor JSON is invalid');
+        }
+        throw error;
+    }
+}
+export async function removeRuntimeDescriptor(filePath, expectedInstanceId) {
+    const descriptor = await readRuntimeDescriptor(filePath);
+    if (!descriptor || descriptor.instanceId !== expectedInstanceId)
+        return false;
+    await unlink(filePath);
+    return true;
+}
+//# sourceMappingURL=runtime-descriptor.js.map

package/dist/server/runtime-descriptor.js.map

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

package/dist/server/write-queue.d.ts

@@ -0,0 +1,20 @@
+export interface WriteQueueState {
+    readonly accepting: boolean;
+    readonly running: boolean;
+    readonly waiting: number;
+}
+type WriteOperation<T> = () => T | PromiseLike<T>;
+export declare const WRITE_QUEUE_RETRY_AFTER_SECONDS = 1;
+export declare class WriteQueue<T> {
+    #private;
+    constructor(waitingCapacity: number);
+    get accepting(): boolean;
+    get running(): boolean;
+    get waiting(): number;
+    get state(): WriteQueueState;
+    enqueue(operation: WriteOperation<T>): Promise<T>;
+    close(): Promise<void>;
+    drain(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=write-queue.d.ts.map

package/dist/server/write-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-queue.d.ts","sourceRoot":"","sources":["../../src/server/write-queue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,cAAc,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAElD,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAQjD,qBAAa,UAAU,CAAC,CAAC;;gBAOX,eAAe,EAAE,MAAM;IAOnC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,KAAK,IAAI,eAAe,CAM3B;IAED,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkCvB"}

package/dist/server/write-queue.js

@@ -0,0 +1,83 @@
+import { KiokukoError } from '../errors.js';
+export const WRITE_QUEUE_RETRY_AFTER_SECONDS = 1;
+export class WriteQueue {
+    #waitingCapacity;
+    #items = [];
+    #accepting = true;
+    #running = false;
+    #drainWaiters = [];
+    constructor(waitingCapacity) {
+        if (!Number.isInteger(waitingCapacity) || waitingCapacity <= 0) {
+            throw new KiokukoError('VALIDATION_ERROR', 'waitingCapacity must be a positive integer');
+        }
+        this.#waitingCapacity = waitingCapacity;
+    }
+    get accepting() {
+        return this.#accepting;
+    }
+    get running() {
+        return this.#running;
+    }
+    get waiting() {
+        return this.#items.length;
+    }
+    get state() {
+        return {
+            accepting: this.#accepting,
+            running: this.#running,
+            waiting: this.#items.length,
+        };
+    }
+    enqueue(operation) {
+        if (!this.#accepting) {
+            return Promise.reject(new KiokukoError('SERVICE_UNAVAILABLE', 'Write queue is closed'));
+        }
+        if (this.#items.length >= this.#waitingCapacity) {
+            return Promise.reject(new KiokukoError('BACKPRESSURE', 'Write queue is at capacity', {
+                retryAfterSeconds: WRITE_QUEUE_RETRY_AFTER_SECONDS,
+            }));
+        }
+        return new Promise((resolve, reject) => {
+            this.#items.push({ operation, resolve, reject });
+            this.#startNext();
+        });
+    }
+    close() {
+        this.#accepting = false;
+        return this.drain();
+    }
+    drain() {
+        if (!this.#running && this.#items.length === 0)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            this.#drainWaiters.push(resolve);
+        });
+    }
+    #startNext() {
+        if (this.#running)
+            return;
+        const item = this.#items.shift();
+        if (item === undefined)
+            return;
+        this.#running = true;
+        void Promise.resolve()
+            .then(item.operation)
+            .then((value) => {
+            this.#finishCurrent();
+            item.resolve(value);
+        }, (error) => {
+            this.#finishCurrent();
+            item.reject(error);
+        });
+    }
+    #finishCurrent() {
+        this.#running = false;
+        this.#startNext();
+        if (this.#running || this.#items.length > 0)
+            return;
+        const waiters = this.#drainWaiters.splice(0);
+        for (const resolve of waiters)
+            resolve();
+    }
+}
+//# sourceMappingURL=write-queue.js.map

package/dist/server/write-queue.js.map

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

package/dist/setup/managed-text.d.ts

@@ -0,0 +1,6 @@
+export interface DelimitedBlockResult {
+    content: string;
+    action: 'created' | 'updated' | 'unchanged';
+}
+export declare function upsertDelimitedBlock(existing: string, block: string, beginMarker: string, endMarker: string, label: string): DelimitedBlockResult;
+//# sourceMappingURL=managed-text.d.ts.map

package/dist/setup/managed-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-text.d.ts","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAiBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAsBtB"}