@askdkc/kiokuko 0.1.0

package/dist/serialization/validate.js

@@ -0,0 +1,168 @@
+import { createHash } from 'node:crypto';
+import { KiokukoError } from '../errors.js';
+export const ENTRY_KINDS = ['fact', 'decision', 'lesson', 'preference', 'reference'];
+export const ENTRY_STATUSES = ['candidate', 'verified', 'superseded'];
+export const TRUST_LEVELS = ['untrusted', 'user_asserted', 'source_verified', 'system_verified'];
+const RECORD_FIELDS = new Set([
+    'workspace',
+    'kind',
+    'status',
+    'title',
+    'body',
+    'summary',
+    'scope',
+    'provenance',
+    'trustLevel',
+    'confidence',
+    'tags',
+    'createdBy',
+    'actor',
+]);
+const PROVENANCE_FIELDS = new Set(['type', 'reference']);
+function validation(message, details = {}) {
+    throw new KiokukoError('VALIDATION_ERROR', message, details);
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function assertObject(value, field) {
+    if (!isPlainObject(value))
+        validation(`${field} must be a JSON object`);
+}
+function assertKnownFields(value, allowed, label) {
+    for (const field of Object.keys(value)) {
+        if (!allowed.has(field))
+            validation(`Unknown ${label} field: ${field}`, { field });
+    }
+}
+function assertJsonValue(value, path) {
+    if (value === null || typeof value === 'boolean' || typeof value === 'string')
+        return;
+    if (typeof value === 'number') {
+        if (Number.isFinite(value))
+            return;
+        validation(`${path} must contain only finite JSON numbers`);
+    }
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1)
+            assertJsonValue(value[index], `${path}[${index}]`);
+        return;
+    }
+    if (isPlainObject(value)) {
+        for (const [key, child] of Object.entries(value))
+            assertJsonValue(child, `${path}.${key}`);
+        return;
+    }
+    validation(`${path} must be JSON-compatible`);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function enumValue(value, allowed, field) {
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        validation(`${field} must be one of: ${allowed.join(', ')}`);
+    }
+    return value;
+}
+function cloneAndSort(value) {
+    if (Array.isArray(value))
+        return value.map(cloneAndSort);
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map((key) => [key, cloneAndSort(value[key])]));
+    }
+    return value;
+}
+/** Serialize JSON values with recursively sorted object keys and no insignificant whitespace. */
+export function canonicalJson(value) {
+    assertJsonValue(value, 'value');
+    return JSON.stringify(cloneAndSort(value));
+}
+export function canonicalContentHash(value) {
+    return createHash('sha256').update(canonicalJson(value), 'utf8').digest('hex');
+}
+export function requireWorkspace(value) {
+    if (!isNonEmptyString(value))
+        validation('workspace must be a non-empty string');
+    return value;
+}
+function validateObjectField(value, field) {
+    assertObject(value, field);
+    assertJsonValue(value, field);
+    return value;
+}
+function validateProvenance(value) {
+    const provenance = validateObjectField(value, 'provenance');
+    assertKnownFields(provenance, PROVENANCE_FIELDS, 'provenance');
+    if (Object.keys(provenance).length > 0) {
+        if (!isNonEmptyString(provenance.type))
+            validation('provenance.type must be a non-empty string');
+        if (!isNonEmptyString(provenance.reference))
+            validation('provenance.reference must be a non-empty string');
+    }
+    return provenance;
+}
+function validateTags(value) {
+    if (!Array.isArray(value))
+        validation('tags must be an array of strings');
+    if (value.length > 100)
+        validation('tags must contain at most 100 values');
+    const tags = value.map((tag, index) => {
+        if (!isNonEmptyString(tag) || tag.length > 200)
+            validation(`tags[${index}] must be a non-empty string of at most 200 characters`);
+        return tag;
+    });
+    return [...new Set(tags)].sort((left, right) => left.localeCompare(right));
+}
+export function validateRecordInput(value) {
+    assertObject(value, 'record input');
+    assertKnownFields(value, RECORD_FIELDS, 'record input');
+    const workspace = requireWorkspace(value.workspace);
+    const kind = enumValue(value.kind, ENTRY_KINDS, 'kind');
+    const status = value.status === undefined ? 'candidate' : enumValue(value.status, ENTRY_STATUSES, 'status');
+    const title = value.title;
+    if (!isNonEmptyString(title))
+        validation('title must be a non-empty string');
+    if (typeof value.body !== 'string')
+        validation('body must be a string');
+    let summary = null;
+    if (value.summary !== undefined && value.summary !== null) {
+        if (typeof value.summary !== 'string')
+            validation('summary must be a string or null');
+        summary = value.summary;
+    }
+    const scope = value.scope === undefined ? {} : validateObjectField(value.scope, 'scope');
+    const provenance = value.provenance === undefined ? {} : validateProvenance(value.provenance);
+    const trustLevel = value.trustLevel === undefined ? 'user_asserted' : enumValue(value.trustLevel, TRUST_LEVELS, 'trustLevel');
+    const confidence = value.confidence === undefined ? 1.0 : value.confidence;
+    if (typeof confidence !== 'number' || !Number.isFinite(confidence) || confidence < 0 || confidence > 1) {
+        validation('confidence must be between 0 and 1');
+    }
+    const tags = value.tags === undefined ? [] : validateTags(value.tags);
+    const createdBy = value.createdBy === undefined ? 'kiokuko-cli' : value.createdBy;
+    if (!isNonEmptyString(createdBy))
+        validation('createdBy must be a non-empty string');
+    const actor = value.actor === undefined ? createdBy : value.actor;
+    if (!isNonEmptyString(actor))
+        validation('actor must be a non-empty string');
+    return {
+        workspace,
+        kind,
+        status,
+        title,
+        body: value.body,
+        summary,
+        scope,
+        provenance,
+        trustLevel,
+        confidence,
+        tags,
+        createdBy,
+        actor,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/serialization/validate.js.map

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

package/dist/server/agent-application.d.ts

@@ -0,0 +1,6 @@
+import { type HttpApplicationContext, type HttpServerHandle, type HttpServerOptions } from './http.js';
+import type { V1RouteHandler } from './router.js';
+export type AgentHttpServerOptions = Omit<HttpServerOptions, 'app' | 'v1' | 'applicationFactory'>;
+export declare function createAgentV1Handler(context: HttpApplicationContext): V1RouteHandler;
+export declare function startAgentHttpServer(options?: AgentHttpServerOptions): Promise<HttpServerHandle>;
+//# sourceMappingURL=agent-application.d.ts.map

package/dist/server/agent-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-application.d.ts","sourceRoot":"","sources":["../../src/server/agent-application.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACxH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,IAAI,GAAG,oBAAoB,CAAC,CAAC;AAUlG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAyBpF;AAWD,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM1G"}

package/dist/server/agent-application.js

@@ -0,0 +1,60 @@
+import { KiokukoError } from '../errors.js';
+import { AgentGatewayService } from '../gateway/agent-service.js';
+import { CheckpointService, FeedbackService } from '../gateway/checkpoint-service.js';
+import { ContextBroker } from '../context/broker.js';
+import { startHttpServer } from './http.js';
+import { createAgentEventsRoute, agentEventsOperation } from './routes/agent-events.js';
+import { createAgentIntakeRoute, agentIntakeOperation } from './routes/agent-intake.js';
+import { createAgentRunsRoute, agentRunsOperation } from './routes/agent-runs.js';
+import { createAgentPromotionsRoute, agentPromotionsOperation } from './routes/agent-promotions.js';
+import { createTask5Route, task5Operation } from './routes/task5.js';
+function operationFor(method, pathname) {
+    return agentRunsOperation(method, pathname)
+        ?? agentPromotionsOperation(method, pathname)
+        ?? agentIntakeOperation(method, pathname)
+        ?? agentEventsOperation(method, pathname)
+        ?? task5Operation(method, pathname);
+}
+export function createAgentV1Handler(context) {
+    const routeContext = {
+        database: context.database,
+        service: new AgentGatewayService(context.database),
+        checkpointService: new CheckpointService(context.database),
+        feedbackService: new FeedbackService(context.database),
+        broker: new ContextBroker(context.database),
+        enqueueWrite: context.enqueueWrite,
+    };
+    const routes = [
+        createAgentRunsRoute(routeContext),
+        createAgentPromotionsRoute(routeContext),
+        createAgentIntakeRoute(routeContext),
+        createAgentEventsRoute(routeContext),
+        createTask5Route(routeContext),
+    ];
+    const handler = (async (request) => {
+        for (const route of routes) {
+            const result = await route(request);
+            if (result !== undefined)
+                return result;
+        }
+        return undefined;
+    });
+    handler.operationFor = ({ method, url }) => operationFor(method, url.pathname);
+    return handler;
+}
+function rejectConflictingOptions(options) {
+    const unsafe = options;
+    for (const key of ['app', 'v1', 'applicationFactory']) {
+        if (Object.prototype.hasOwnProperty.call(unsafe, key)) {
+            throw new KiokukoError('VALIDATION_ERROR', 'Agent server options cannot override the production application');
+        }
+    }
+}
+export async function startAgentHttpServer(options = {}) {
+    rejectConflictingOptions(options);
+    return startHttpServer({
+        ...options,
+        applicationFactory: (context) => context.createAuthenticatedApp(createAgentV1Handler(context)),
+    });
+}
+//# sourceMappingURL=agent-application.js.map

package/dist/server/agent-application.js.map

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

package/dist/server/app.d.ts

@@ -0,0 +1,5 @@
+import type { RequestListener } from 'node:http';
+import { type RouterDependencies } from './router.js';
+export type AppDependencies = RouterDependencies;
+export declare function createApp(dependencies: AppDependencies): RequestListener;
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAkC,KAAK,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AAE3G,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAoFjD,wBAAgB,SAAS,CAAC,YAAY,EAAE,eAAe,GAAG,eAAe,CAQxE"}

package/dist/server/app.js

@@ -0,0 +1,87 @@
+import { KiokukoError } from '../errors.js';
+import { createRouter } from './router.js';
+function writeJsonError(response, status, operation, code, message, details = {}, retryAfterSeconds) {
+    const body = JSON.stringify({
+        apiVersion: '1',
+        ok: false,
+        operation,
+        error: { code, message, details },
+    });
+    response.writeHead(status, {
+        'cache-control': 'no-store',
+        'content-length': Buffer.byteLength(body),
+        'content-type': 'application/json; charset=utf-8',
+        ...(retryAfterSeconds === undefined ? {} : { 'retry-after': String(retryAfterSeconds) }),
+    });
+    response.end(body);
+}
+function boundedRetryAfterSeconds(error) {
+    const value = error.details.retryAfterSeconds;
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return 1;
+    return Math.min(60, Math.max(1, Math.trunc(value)));
+}
+function operationFor(request, v1) {
+    const pathname = new URL(request.url ?? '/', 'http://127.0.0.1').pathname;
+    try {
+        const resolved = v1?.operationFor?.({
+            method: request.method ?? 'GET',
+            url: new URL(request.url ?? '/', 'http://127.0.0.1'),
+        });
+        if (typeof resolved === 'string' && resolved.length > 0)
+            return resolved;
+    }
+    catch {
+        // An operation resolver is advisory; error serialization must keep the safe fallback.
+    }
+    return pathname === '/health/ready' ? 'health.ready' : pathname === '/api/v1' || pathname.startsWith('/api/v1/') ? 'api.v1' : 'server.request';
+}
+function handleError(request, response, error, v1) {
+    if (error instanceof KiokukoError && error.code === 'AUTHENTICATION_ERROR') {
+        writeJsonError(response, 401, operationFor(request, v1), 'AUTHENTICATION_ERROR', 'Authorization is invalid');
+        return;
+    }
+    if (error instanceof KiokukoError && error.code === 'NOT_FOUND') {
+        writeJsonError(response, 404, operationFor(request, v1), 'NOT_FOUND', 'Endpoint not found');
+        return;
+    }
+    if (error instanceof KiokukoError && (error.code === 'VALIDATION_ERROR' || error.code === 'USAGE_ERROR')) {
+        writeJsonError(response, 400, operationFor(request, v1), error.code, 'Request is invalid');
+        return;
+    }
+    if (error instanceof KiokukoError && error.code === 'CONFLICT') {
+        writeJsonError(response, 409, operationFor(request, v1), 'CONFLICT', 'Request conflicts with current state');
+        return;
+    }
+    if (error instanceof KiokukoError && error.code === 'BACKPRESSURE') {
+        const retryAfterSeconds = boundedRetryAfterSeconds(error);
+        writeJsonError(response, 429, operationFor(request, v1), 'BACKPRESSURE', 'Service is busy', { retryAfterSeconds }, retryAfterSeconds);
+        return;
+    }
+    if (error instanceof KiokukoError && (error.code === 'SERVICE_UNAVAILABLE' || error.code === 'DATABASE_ERROR')) {
+        const message = error.code === 'DATABASE_ERROR' ? 'Database unavailable' : 'Service unavailable';
+        writeJsonError(response, 503, operationFor(request, v1), error.code, message);
+        return;
+    }
+    if (error instanceof KiokukoError && error.code === 'SECURITY_REJECTION') {
+        writeJsonError(response, 422, operationFor(request, v1), 'SECURITY_REJECTION', 'Request rejected');
+        return;
+    }
+    if (error instanceof KiokukoError && error.code === 'INTEGRITY_ERROR') {
+        writeJsonError(response, 500, operationFor(request, v1), 'INTEGRITY_ERROR', 'Internal integrity error');
+        return;
+    }
+    writeJsonError(response, 500, operationFor(request, v1), 'DATABASE_ERROR', 'Unexpected server error');
+}
+export function createApp(dependencies) {
+    const router = createRouter(dependencies);
+    return (request, response) => {
+        void Promise.resolve(router(request, response)).catch((error) => {
+            if (!response.headersSent)
+                handleError(request, response, error, dependencies.v1);
+            else
+                response.destroy();
+        });
+    };
+}
+//# sourceMappingURL=app.js.map

package/dist/server/app.js.map

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

package/dist/server/auth.d.ts

@@ -0,0 +1,2 @@
+export declare function requireBearerAuthorization(header: unknown, expectedToken: unknown): void;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"AASA,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAcxF"}

package/dist/server/auth.js

@@ -0,0 +1,22 @@
+import { createHash, timingSafeEqual } from 'node:crypto';
+import { KiokukoError } from '../errors.js';
+const TOKEN_PATTERN = /^[0-9a-f]{64}$/;
+function authenticationFailure() {
+    throw new KiokukoError('AUTHENTICATION_ERROR', 'Authorization is invalid');
+}
+export function requireBearerAuthorization(header, expectedToken) {
+    if (typeof expectedToken !== 'string' || !TOKEN_PATTERN.test(expectedToken)) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Server authentication token is invalid');
+    }
+    if (typeof header !== 'string')
+        authenticationFailure();
+    const match = /^Bearer ([0-9a-f]{64})$/.exec(header);
+    const suppliedToken = match?.[1];
+    if (suppliedToken === undefined)
+        authenticationFailure();
+    const expectedDigest = createHash('sha256').update(expectedToken, 'utf8').digest();
+    const suppliedDigest = createHash('sha256').update(suppliedToken, 'utf8').digest();
+    if (!timingSafeEqual(expectedDigest, suppliedDigest))
+        authenticationFailure();
+}
+//# sourceMappingURL=auth.js.map

package/dist/server/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,SAAS,qBAAqB;IAC5B,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAe,EAAE,aAAsB;IAChF,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,wCAAwC,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,qBAAqB,EAAE,CAAC;IAExD,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,aAAa,KAAK,SAAS;QAAE,qBAAqB,EAAE,CAAC;IAEzD,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IACnF,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IACnF,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,cAAc,CAAC;QAAE,qBAAqB,EAAE,CAAC;AAChF,CAAC"}

package/dist/server/http.d.ts

@@ -0,0 +1,69 @@
+import { type RequestListener, type Server } from 'node:http';
+import { type PathEnvironment } from '../config/paths.js';
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type InstanceLock, type InstanceLockOptions, type PidLiveness } from './instance-lock.js';
+import { type CreateRuntimeDescriptorInput, type RuntimeDescriptor, type RuntimeDescriptorView } from './runtime-descriptor.js';
+import { type WriteQueueState } from './write-queue.js';
+import type { V1RouteHandler } from './router.js';
+export type DatabaseOpener = (databasePath: string) => SqliteDatabase | PromiseLike<SqliteDatabase>;
+export type DatabaseMigrator = (database: SqliteDatabase, migrationsDirectory?: string) => unknown | PromiseLike<unknown>;
+export type HttpServerFactory = (listener: RequestListener) => Server;
+export type InstanceLockAcquirer = (databasePath: string, options: InstanceLockOptions) => InstanceLock | PromiseLike<InstanceLock>;
+export type RuntimeDescriptorFactory = (input: CreateRuntimeDescriptorInput) => RuntimeDescriptor;
+export type RuntimeDescriptorReader = (filePath: string) => RuntimeDescriptor | undefined | PromiseLike<RuntimeDescriptor | undefined>;
+export type RuntimeDescriptorWriter = (filePath: string, descriptor: RuntimeDescriptor) => void | PromiseLike<void>;
+export type RuntimeDescriptorRemover = (filePath: string, expectedInstanceId: string) => boolean | PromiseLike<boolean>;
+export interface HttpApplicationContext {
+    readonly database: SqliteDatabase;
+    enqueueWrite<T>(operation: () => T | PromiseLike<T>): Promise<T>;
+    createAuthenticatedApp(v1?: V1RouteHandler): RequestListener;
+}
+export type HttpApplicationFactory = (context: HttpApplicationContext) => RequestListener;
+export interface HttpServerDependencies {
+    readonly openDatabase?: DatabaseOpener;
+    readonly migrateDatabase?: DatabaseMigrator;
+    readonly createServer?: HttpServerFactory;
+    readonly acquireInstanceLock?: InstanceLockAcquirer;
+    readonly isPidAlive?: PidLiveness;
+    readonly createRuntimeDescriptor?: RuntimeDescriptorFactory;
+    readonly readRuntimeDescriptor?: RuntimeDescriptorReader;
+    readonly writeRuntimeDescriptor?: RuntimeDescriptorWriter;
+    readonly removeRuntimeDescriptor?: RuntimeDescriptorRemover;
+}
+export interface HttpServerOptions extends PathEnvironment {
+    readonly databasePath?: string;
+    readonly migrationsDirectory?: string;
+    readonly descriptorPath?: string;
+    readonly runtimeDirectory?: string;
+    readonly host?: string;
+    readonly port?: number;
+    readonly queueCapacity?: number;
+    readonly pid?: number;
+    readonly instanceId?: string;
+    readonly startedAt?: string;
+    readonly capabilityToken?: string;
+    readonly app?: RequestListener;
+    readonly v1?: V1RouteHandler;
+    readonly applicationFactory?: HttpApplicationFactory;
+    readonly dependencies?: HttpServerDependencies;
+    readonly openDatabase?: DatabaseOpener;
+    readonly migrateDatabase?: DatabaseMigrator;
+    readonly createServer?: HttpServerFactory;
+    readonly acquireInstanceLock?: InstanceLockAcquirer;
+    readonly isPidAlive?: PidLiveness;
+    readonly createRuntimeDescriptor?: RuntimeDescriptorFactory;
+    readonly readRuntimeDescriptor?: RuntimeDescriptorReader;
+    readonly writeRuntimeDescriptor?: RuntimeDescriptorWriter;
+    readonly removeRuntimeDescriptor?: RuntimeDescriptorRemover;
+}
+export interface HttpServerHandle {
+    readonly server: Server;
+    readonly url: string;
+    readonly descriptor: RuntimeDescriptorView;
+    readonly runtimeDescriptor: RuntimeDescriptorView;
+    readonly queueState: WriteQueueState;
+    enqueueWrite<T>(operation: () => T | PromiseLike<T>): Promise<T>;
+    close(): Promise<void>;
+}
+export declare function startHttpServer(options?: HttpServerOptions): Promise<HttpServerHandle>;
+//# sourceMappingURL=http.d.ts.map

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

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