@jini-ai/http-kit 0.2.1

package/dist/media.js

@@ -0,0 +1,352 @@
+/**
+ * @module media
+ *
+ * `POST /api/media/generate`, `GET /api/media/tasks`, `GET /api/media/tasks/:id`, `DELETE
+ * /api/media/tasks/:id` — an HTTP route pack over narrow, transport-owned engine/task-store ports.
+ * A product composition root may satisfy those ports with `@jini-ai/media`; locked `@jini-ai/http-kit`
+ * deliberately does not point down into that incubating implementation package.
+ *
+ * Follows the "request-now, poll-later" async-task shape `@jini-ai/media`'s own `MediaTaskStore` doc
+ * describes: `POST /api/media/generate` creates a task, kicks off `MediaDispatchEngine.generate()`
+ * in the background (never awaited by the response — a real provider call can take tens of
+ * seconds), and returns the freshly-`'queued'` task immediately. A caller polls
+ * `GET /api/media/tasks/:id` until the task reaches a terminal status (`'done'`/`'failed'`/
+ * `'interrupted'`), mirroring `routines.ts`'s `POST /api/routines/:id/run` (`202`, poll separately)
+ * rather than `runs.ts`'s SSE stream — media generation has no meaningful intermediate event
+ * stream the way a run does, just one eventual result.
+ *
+ * **Where generated bytes land** (per `@jini-ai/media`'s own boundary doc on `MediaGenerationRequest`/
+ * `MediaGenerationResult`: "this engine performs no filesystem I/O... a host pairs this with its
+ * own wiring to decide where generated bytes land"): this route pack encodes the result as a
+ * base64 `data:` URL and stores it directly in `MediaTask.file` (a deliberately untyped `unknown`
+ * field — see `task-store.ts`'s own doc). This is the simplest host-owned answer that needs no new
+ * storage port of its own; a host that wants generated bytes written to a real asset store instead
+ * can layer that on top by reading `MediaTask.file` off a terminal task and re-persisting it
+ * elsewhere — this route pack does not preclude that, it just doesn't invent a new persistence
+ * abstraction to do it for a caller who hasn't asked for one (matching `packages/deploy/source-
+ * map.md`'s "no speculative port" precedent).
+ *
+ * **`ownerRef`** is the same opaque, host-defined scoping key `MediaTaskStore` itself already
+ * uses (e.g. a run id) — this route pack has no `Project`/`Workspace` noun of its own, matching
+ * `active-context.ts`/`delegated-tools.ts`'s precedent for the same category of coupling.
+ *
+ * **SEC-005 redaction**: `MediaDispatchEngine.generate()` can throw a raw vendor-SDK/network
+ * error (API keys, response bodies) that must never reach an HTTP caller verbatim — matching
+ * `delegated-tools.ts`'s `reportInternalError` pattern exactly (a correlation-id-bearing generic
+ * `INTERNAL_ERROR`, the real error only reaching a host-owned sink). Applied to the background
+ * generation failure path (recorded on the task's own `error` field, `message` already redacted
+ * the same way) as well as the sync per-request validation-throw path (`POST /api/media/generate`
+ * itself can throw before ever creating a task — an unregistered `toolId`-shaped programming
+ * error, per `MediaDispatchEngine.generate`'s own contract).
+ */
+import { randomUUID } from 'node:crypto';
+import { createApiError } from '@jini-ai/protocol';
+import { defineJsonRoute, mountJsonRoute } from './adapter.js';
+import { validationError } from './request.js';
+import { err, ok } from './types.js';
+const SURFACES = new Set(['image', 'video', 'audio']);
+const AUDIO_KINDS = new Set(['music', 'speech', 'sfx']);
+const SPEECH_FORMATS = new Set(['mp3', 'wav', 'flac', 'aac', 'opus']);
+function defaultInternalErrorSink(context) {
+    // eslint-disable-next-line no-console
+    console.error(`[@jini-ai/http-kit] internal error (${context.source}, correlationId=${context.correlationId})`, context.error);
+}
+function reportInternalError(deps, source, error, taskId, ownerRef) {
+    const correlationId = randomUUID();
+    const sink = deps.onInternalError ?? defaultInternalErrorSink;
+    sink({ source, taskId, ownerRef, correlationId, error });
+    return createApiError('INTERNAL_ERROR', 'an internal error occurred', { requestId: correlationId });
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function requireNonEmptyString(body, key) {
+    const value = body[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+function parseOptionalString(body, key) {
+    const value = body[key];
+    if (value === undefined)
+        return ok(undefined);
+    if (typeof value !== 'string')
+        return err(validationError(`${key} must be a string when provided`));
+    return ok(value);
+}
+function parseOptionalNumber(body, key) {
+    const value = body[key];
+    if (value === undefined)
+        return ok(undefined);
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return err(validationError(`${key} must be a finite number when provided`));
+    return ok(value);
+}
+function parseOptionalBoolean(body, key) {
+    const value = body[key];
+    if (value === undefined)
+        return ok(undefined);
+    if (typeof value !== 'boolean')
+        return err(validationError(`${key} must be a boolean when provided`));
+    return ok(value);
+}
+function parseImageReference(value, field) {
+    if (!isRecord(value) || typeof value.dataUrl !== 'string' || value.dataUrl.trim().length === 0) {
+        return err(validationError(`${field} must be an object with a non-empty dataUrl string`));
+    }
+    return ok({ dataUrl: value.dataUrl });
+}
+function parseOptionalImageRef(body) {
+    const value = body.imageRef;
+    if (value === undefined)
+        return ok(undefined);
+    return parseImageReference(value, 'imageRef');
+}
+function parseOptionalImageRefs(body) {
+    const value = body.imageRefs;
+    if (value === undefined)
+        return ok(undefined);
+    if (!Array.isArray(value))
+        return err(validationError('imageRefs must be an array when provided'));
+    const refs = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const parsed = parseImageReference(value[i], `imageRefs[${i}]`);
+        if (!parsed.ok)
+            return parsed;
+        refs.push(parsed.value);
+    }
+    return ok(refs);
+}
+function parseMediaGenerate(input) {
+    if (!isRecord(input.body))
+        return err(validationError('body must be a JSON object'));
+    const body = input.body;
+    const ownerRef = requireNonEmptyString(body, 'ownerRef');
+    if (ownerRef === undefined) {
+        return err(validationError('ownerRef must be a non-empty string', [{ path: 'ownerRef', message: 'required non-empty string' }]));
+    }
+    const surface = body.surface;
+    if (typeof surface !== 'string' || !SURFACES.has(surface)) {
+        return err(validationError('surface must be one of: image, video, audio'));
+    }
+    const model = requireNonEmptyString(body, 'model');
+    if (model === undefined) {
+        return err(validationError('model must be a non-empty string', [{ path: 'model', message: 'required non-empty string' }]));
+    }
+    const audioKind = body.audioKind;
+    if (audioKind !== undefined && (typeof audioKind !== 'string' || !AUDIO_KINDS.has(audioKind))) {
+        return err(validationError('audioKind must be one of: music, speech, sfx when provided'));
+    }
+    const speechFormat = body.speechFormat;
+    if (speechFormat !== undefined && (typeof speechFormat !== 'string' || !SPEECH_FORMATS.has(speechFormat))) {
+        return err(validationError('speechFormat must be one of: mp3, wav, flac, aac, opus when provided'));
+    }
+    const prompt = parseOptionalString(body, 'prompt');
+    if (!prompt.ok)
+        return prompt;
+    const aspect = parseOptionalString(body, 'aspect');
+    if (!aspect.ok)
+        return aspect;
+    const voice = parseOptionalString(body, 'voice');
+    if (!voice.ok)
+        return voice;
+    const language = parseOptionalString(body, 'language');
+    if (!language.ok)
+        return language;
+    const wireModel = parseOptionalString(body, 'wireModel');
+    if (!wireModel.ok)
+        return wireModel;
+    const length = parseOptionalNumber(body, 'length');
+    if (!length.ok)
+        return length;
+    const duration = parseOptionalNumber(body, 'duration');
+    if (!duration.ok)
+        return duration;
+    const promptInfluence = parseOptionalNumber(body, 'promptInfluence');
+    if (!promptInfluence.ok)
+        return promptInfluence;
+    const loop = parseOptionalBoolean(body, 'loop');
+    if (!loop.ok)
+        return loop;
+    const imageRef = parseOptionalImageRef(body);
+    if (!imageRef.ok)
+        return imageRef;
+    const imageRefs = parseOptionalImageRefs(body);
+    if (!imageRefs.ok)
+        return imageRefs;
+    return ok({
+        ownerRef,
+        request: {
+            surface: surface,
+            model,
+            ...(prompt.value !== undefined ? { prompt: prompt.value } : {}),
+            ...(aspect.value !== undefined ? { aspect: aspect.value } : {}),
+            ...(length.value !== undefined ? { length: length.value } : {}),
+            ...(duration.value !== undefined ? { duration: duration.value } : {}),
+            ...(voice.value !== undefined ? { voice: voice.value } : {}),
+            ...(audioKind !== undefined ? { audioKind: audioKind } : {}),
+            ...(language.value !== undefined ? { language: language.value } : {}),
+            ...(loop.value !== undefined ? { loop: loop.value } : {}),
+            ...(promptInfluence.value !== undefined ? { promptInfluence: promptInfluence.value } : {}),
+            ...(imageRef.value !== undefined ? { imageRef: imageRef.value } : {}),
+            ...(imageRefs.value !== undefined ? { imageRefs: imageRefs.value } : {}),
+            ...(wireModel.value !== undefined ? { wireModel: wireModel.value } : {}),
+            ...(speechFormat !== undefined ? { speechFormat: speechFormat } : {}),
+        },
+    });
+}
+function parseTaskId(input) {
+    const id = input.params.id;
+    return typeof id === 'string' && id.length > 0 ? ok(id) : err(validationError('id must be a non-empty path parameter'));
+}
+function parseMediaTaskListQuery(input) {
+    const raw = input.query.ownerRef;
+    const ownerRef = Array.isArray(raw) ? raw[0] : raw;
+    if (typeof ownerRef !== 'string' || ownerRef.trim().length === 0) {
+        return err(validationError('ownerRef query parameter is required', [{ path: 'ownerRef', message: 'required non-empty string' }]));
+    }
+    const includeTerminalRaw = input.query.includeTerminal;
+    const includeTerminal = (Array.isArray(includeTerminalRaw) ? includeTerminalRaw[0] : includeTerminalRaw) === 'true';
+    return ok({ ownerRef, options: { includeTerminal } });
+}
+/**
+ * Runs the real generation in the background and patches the task to its terminal state.
+ * Deliberately fire-and-forget from `mediaGenerateRoute.handle`'s own perspective — the HTTP
+ * response has already returned the `'queued'` task by the time this settles.
+ */
+async function runMediaGenerationInBackground(deps, taskId, ownerRef, request) {
+    try {
+        await deps.taskStore.update(taskId, { status: 'running' });
+        const result = await deps.engine.generate(request);
+        const base64 = result.bytes.toString('base64');
+        const mime = mimeTypeForSurface(request.surface, request.speechFormat);
+        await deps.taskStore.update(taskId, {
+            status: 'done',
+            file: {
+                dataUrl: `data:${mime};base64,${base64}`,
+                providerId: result.providerId,
+                providerNote: result.providerNote,
+                ...(result.suggestedExt !== undefined ? { suggestedExt: result.suggestedExt } : {}),
+                usedStubFallback: result.usedStubFallback,
+            },
+            progress: result.warnings,
+            endedAt: Date.now(),
+        });
+    }
+    catch (error) {
+        const apiError = reportInternalError(deps, 'media-generate-dispatch', error, taskId, ownerRef);
+        try {
+            await deps.taskStore.update(taskId, {
+                status: 'failed',
+                error: { message: apiError.message, code: apiError.code },
+                endedAt: Date.now(),
+            });
+        }
+        catch (writeError) {
+            // The task store can legitimately already be closed by the time a slow in-flight
+            // generation's failure settles (e.g. daemon shutdown mid-generation — a real vendor call
+            // can take "tens of seconds" per this module's own doc). This function is invoked
+            // fire-and-forget (`void runMediaGenerationInBackground(...)` in `mediaGenerateRoute.handle`
+            // below), so letting this secondary write failure propagate would reject an unobserved
+            // promise — an unhandled rejection that crashes a default-configured Node process over a
+            // condition that isn't actually fatal (the real generation failure was already reported
+            // above; this is only "the store couldn't also persist that fact"). Reported through the
+            // same sink, never rethrown.
+            reportInternalError(deps, 'media-generate-dispatch', writeError, taskId, ownerRef);
+        }
+    }
+}
+/** A minimal, real content-type per surface — enough for a caller to render/play the resulting data URL without needing to know each vendor's own response shape. */
+function mimeTypeForSurface(surface, speechFormat) {
+    if (surface === 'image')
+        return 'image/png';
+    if (surface === 'video')
+        return 'video/mp4';
+    const format = speechFormat ?? 'mp3';
+    const audioMimeByFormat = {
+        mp3: 'audio/mpeg',
+        wav: 'audio/wav',
+        flac: 'audio/flac',
+        aac: 'audio/aac',
+        opus: 'audio/opus',
+    };
+    return audioMimeByFormat[format];
+}
+export const mediaGenerateRoute = defineJsonRoute({
+    method: 'post',
+    path: '/api/media/generate',
+    requireSameOrigin: true,
+    parse: parseMediaGenerate,
+    handle: async ({ ownerRef, request }, deps) => {
+        let task;
+        try {
+            task = await deps.taskStore.create({
+                id: randomUUID(),
+                ownerRef,
+                status: 'queued',
+                surface: request.surface,
+                model: request.model,
+            });
+        }
+        catch (error) {
+            return err(reportInternalError(deps, 'media-task-store', error, null, ownerRef));
+        }
+        void runMediaGenerationInBackground(deps, task.id, ownerRef, request);
+        return ok({ task });
+    },
+    successStatus: 202,
+});
+export const mediaTaskGetRoute = defineJsonRoute({
+    method: 'get',
+    path: '/api/media/tasks/:id',
+    parse: parseTaskId,
+    handle: async (id, deps) => {
+        try {
+            const task = await deps.taskStore.get(id);
+            return task === null ? err(createApiError('NOT_FOUND', 'media task not found')) : ok({ task });
+        }
+        catch (error) {
+            return err(reportInternalError(deps, 'media-task-store', error, id, null));
+        }
+    },
+});
+export const mediaTaskDeleteRoute = defineJsonRoute({
+    method: 'delete',
+    path: '/api/media/tasks/:id',
+    requireSameOrigin: true,
+    parse: parseTaskId,
+    handle: async (id, deps) => {
+        let ownerRef = null;
+        try {
+            const existing = await deps.taskStore.get(id);
+            if (existing === null)
+                return err(createApiError('NOT_FOUND', 'media task not found'));
+            ownerRef = existing.ownerRef;
+            await deps.taskStore.delete(id);
+            return ok({ ok: true });
+        }
+        catch (error) {
+            return err(reportInternalError(deps, 'media-task-store', error, id, ownerRef));
+        }
+    },
+});
+export const mediaTaskListRoute = defineJsonRoute({
+    method: 'get',
+    path: '/api/media/tasks',
+    parse: parseMediaTaskListQuery,
+    handle: async ({ ownerRef, options }, deps) => {
+        try {
+            const tasks = await deps.taskStore.listByOwner(ownerRef, options);
+            return ok({ tasks });
+        }
+        catch (error) {
+            return err(reportInternalError(deps, 'media-task-store', error, null, ownerRef));
+        }
+    },
+});
+/** Mounts every media route on `app`. A pack's `http(app, services)` calls this directly. */
+export function registerMediaRoutes(app, deps, adapter) {
+    mountJsonRoute(app, mediaGenerateRoute, deps, adapter);
+    mountJsonRoute(app, mediaTaskGetRoute, deps, adapter);
+    mountJsonRoute(app, mediaTaskDeleteRoute, deps, adapter);
+    mountJsonRoute(app, mediaTaskListRoute, deps, adapter);
+}
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,230 @@
+/**
+ * @module memory
+ *
+ * Generic memory/notes HTTP surface — thin route wrappers over a
+ * frontmatter-backed note store, an extraction-attempt log, and a
+ * verify-outcome log, plus a multiplexed SSE change feed. Ported from OD's
+ * `apps/daemon/src/routes/memory.ts` (690 lines) — see `source-map.md`'s
+ * 2026-07-21 memory-routes section for the full per-route classification.
+ *
+ * **Deliberately does NOT depend on `@jini-ai/memory`.** That package exists in
+ * this repo (`packages/memory/`, `createNoteStore`/`createExtractionLog`/
+ * `createVerifyLog` structurally match every collaborator type below field
+ * for field), but it is listed in this repo's root `UNLOCKED.md` with
+ * `"lockedPackagesMayImport": false` — `@jini-ai/http-kit` is one of
+ * `scripts/check-engine-boundaries.ts`'s fourteen locked packages, so
+ * importing `@jini-ai/memory` directly would fail `pnpm guard`'s R7 check
+ * outright (the same constraint `packages/media/src/sqlite-task-store.ts`'s
+ * `ADS-memory/reports/proposals/PROP-media-durable-tasks-2026-07-21.md`
+ * documents for `@jini-ai/sqlite`/`@jini-ai/media`). The types below
+ * (`MemoryNoteStore`/`MemoryExtractionLog`/`MemoryVerifyLog`) are local,
+ * structural mirrors of `@jini-ai/memory`'s real `NoteStore`/`ExtractionLog`/
+ * `VerifyLog` interfaces — a real `@jini-ai/memory` instance satisfies them
+ * with zero adapter code (this is the same "host supplies the real
+ * collaborator" DI convention `daemon-status.ts`/`host-tools.ts`/`db-ops.ts`
+ * already established), but this package incurs no dependency on it, locked
+ * or not. If/when `@jini-ai/memory` is promoted to `"stable"`, a follow-up can
+ * replace these local types with direct imports — a mechanical change, not
+ * a redesign, since the shapes already match.
+ *
+ * **Ported (generic, no OD coupling):** the config `enabled` toggle, entry
+ * CRUD (`POST /api/memory`, `GET/PUT/DELETE /api/memory/:id`), the tree
+ * view and single-node patch, the raw index text, the extraction/
+ * verification history lists + clear/remove, and the multiplexed
+ * `change`/`extraction`/`verify` SSE feed.
+ *
+ * **Explicitly NOT ported (OD-PRODUCT or missing-primitive, see
+ * `source-map.md` for the full reasoning per route):**
+ * - `POST /api/memory/rules/suggest` — OD's canvas/deck-annotation shape.
+ * - `POST /api/memory/connectors/suggest` / `.../connectors/extract` — OD's
+ *   project-scoped connector-mining pipeline.
+ * - `POST /api/memory/extract` — the heuristic-regex pre-turn phase and the
+ *   BYOK-chat-provider-passthrough LLM post-turn phase are both OD-specific
+ *   composition, per this repo's root `AGENTS.md`'s existing note that
+ *   `@jini-ai/memory`'s "heuristic-regex... prompt-composition pieces" were
+ *   "explicitly left un-ported."
+ * - `GET /api/memory/system-prompt` — depends on `composeMemoryBody`, which
+ *   does not exist anywhere in `@jini-ai/memory` yet (same `AGENTS.md` note).
+ * - The four extra `MemoryConfigPatch` boolean toggles
+ *   (`chatExtractionEnabled`/`profileEnabled`/`rewriteEnabled`/
+ *   `verifyEnabled`) and the whole `extraction` (LLM-provider) config
+ *   sub-object: `@jini-ai/memory`'s `NoteStoreOptions` is `{enabled: boolean}`
+ *   only — a real, documented capability gap in the underlying store, not a
+ *   route-level scoping choice. A host needing those toggles today has to
+ *   layer its own config storage alongside `NoteStore.writeConfig`.
+ */
+import type { Express } from 'express';
+import { type AdapterContext } from './adapter.js';
+export interface MemoryNoteEntrySummary {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly type: string;
+    readonly updatedAt: number;
+}
+export interface MemoryNoteEntry extends MemoryNoteEntrySummary {
+    readonly body: string;
+}
+export interface MemoryTreeNode {
+    readonly id: string;
+    readonly parentId: string | null;
+    readonly path: string;
+    readonly name: string;
+    readonly description: string;
+    readonly kind: 'folder' | 'entry';
+    readonly type: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly childrenCount: number;
+}
+export interface MemoryNoteStoreOptions {
+    readonly enabled: boolean;
+}
+/** Minimal event-emitter surface every collaborator's `events` field needs — satisfied structurally by a real `node:events` `EventEmitter`. */
+export interface MemoryChangeEmitter {
+    on(event: string, listener: (event: unknown) => void): unknown;
+    off(event: string, listener: (event: unknown) => void): unknown;
+}
+export interface MemoryNoteStore {
+    readonly events: MemoryChangeEmitter;
+    dir(dataDir: string): string;
+    readConfig(dataDir: string): Promise<MemoryNoteStoreOptions>;
+    writeConfig(dataDir: string, patch: Partial<MemoryNoteStoreOptions>): Promise<MemoryNoteStoreOptions>;
+    readIndex(dataDir: string): Promise<string>;
+    writeIndex(dataDir: string, body: string): Promise<void>;
+    listEntries(dataDir: string): Promise<readonly MemoryNoteEntrySummary[]>;
+    readEntry(dataDir: string, id: string): Promise<MemoryNoteEntry | null>;
+    upsertEntry(dataDir: string, input: {
+        id?: string;
+        name: string;
+        description?: string;
+        type: string;
+        body?: string;
+    }): Promise<MemoryNoteEntry>;
+    deleteEntry(dataDir: string, id: string): Promise<void>;
+    updateTreeNode(dataDir: string, id: string, patch: {
+        name?: string;
+        description?: string;
+        type?: string;
+        body?: string;
+    }): Promise<MemoryNoteEntry>;
+    buildTree(dataDir: string): Promise<readonly MemoryTreeNode[]>;
+}
+export interface MemoryExtractionLog {
+    readonly events: MemoryChangeEmitter;
+    list(): readonly unknown[];
+    remove(id: string): number;
+    clear(): number;
+}
+export interface MemoryVerifyLog {
+    readonly events: MemoryChangeEmitter;
+    list(): readonly unknown[];
+    remove(id: string): number;
+    clear(): number;
+}
+export interface MemoryHttpDeps {
+    readonly notes: MemoryNoteStore;
+    readonly extractions: MemoryExtractionLog;
+    readonly verifications: MemoryVerifyLog;
+    /** Forwarded verbatim to every `MemoryNoteStore`/log call — the same `dataDir` a host passes to its own `createNoteStore`-backed instance. */
+    readonly dataDir: string;
+}
+export interface MemoryOverviewResponse {
+    readonly enabled: boolean;
+    readonly rootDir: string;
+    readonly index: string;
+    readonly entries: readonly MemoryNoteEntrySummary[];
+}
+export declare const memoryOverviewRoute: import("./types.js").JsonRouteSpec<void, MemoryOverviewResponse, MemoryHttpDeps>;
+export interface MemoryTreeResponse {
+    readonly enabled: boolean;
+    readonly rootDir: string;
+    readonly tree: readonly MemoryTreeNode[];
+}
+export declare const memoryTreeRoute: import("./types.js").JsonRouteSpec<void, MemoryTreeResponse, MemoryHttpDeps>;
+export interface MemoryTreeNodePatch {
+    readonly name?: string;
+    readonly description?: string;
+    readonly type?: string;
+    readonly body?: string;
+}
+interface MemoryUpdateTreeNodeInput {
+    readonly id: string;
+    readonly patch: MemoryTreeNodePatch;
+}
+export interface MemoryUpdateTreeNodeResponse {
+    readonly entry: MemoryNoteEntry;
+    readonly tree: readonly MemoryTreeNode[];
+}
+export declare const memoryUpdateTreeNodeRoute: import("./types.js").JsonRouteSpec<MemoryUpdateTreeNodeInput, MemoryUpdateTreeNodeResponse, MemoryHttpDeps>;
+export interface MemoryIndexResponse {
+    readonly index: string;
+}
+export declare const memoryWriteIndexRoute: import("./types.js").JsonRouteSpec<string, MemoryIndexResponse, MemoryHttpDeps>;
+export interface MemoryConfigResponse {
+    readonly enabled: boolean;
+}
+export declare const memoryWriteConfigRoute: import("./types.js").JsonRouteSpec<Partial<MemoryNoteStoreOptions>, MemoryConfigResponse, MemoryHttpDeps>;
+export interface MemoryExtractionsResponse {
+    readonly extractions: readonly unknown[];
+}
+export declare const memoryListExtractionsRoute: import("./types.js").JsonRouteSpec<void, MemoryExtractionsResponse, MemoryHttpDeps>;
+export interface MemoryRemovedResponse {
+    readonly removed: number;
+}
+export declare const memoryClearExtractionsRoute: import("./types.js").JsonRouteSpec<void, MemoryRemovedResponse, MemoryHttpDeps>;
+export declare const memoryRemoveExtractionRoute: import("./types.js").JsonRouteSpec<string, MemoryRemovedResponse, MemoryHttpDeps>;
+export interface MemoryVerificationsResponse {
+    readonly verifications: readonly unknown[];
+}
+export declare const memoryListVerificationsRoute: import("./types.js").JsonRouteSpec<void, MemoryVerificationsResponse, MemoryHttpDeps>;
+export declare const memoryClearVerificationsRoute: import("./types.js").JsonRouteSpec<void, MemoryRemovedResponse, MemoryHttpDeps>;
+export declare const memoryRemoveVerificationRoute: import("./types.js").JsonRouteSpec<string, MemoryRemovedResponse, MemoryHttpDeps>;
+export interface MemoryEntryInput {
+    readonly id?: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly type: string;
+    readonly body?: string;
+}
+export interface MemoryEntryResponse {
+    readonly entry: MemoryNoteEntry;
+}
+export declare const memoryCreateEntryRoute: import("./types.js").JsonRouteSpec<MemoryEntryInput, MemoryEntryResponse, MemoryHttpDeps>;
+export declare const memoryReadEntryRoute: import("./types.js").JsonRouteSpec<string, MemoryEntryResponse, MemoryHttpDeps>;
+interface MemoryUpdateEntryInput {
+    readonly id: string;
+    readonly input: MemoryEntryInput;
+}
+export declare const memoryUpdateEntryRoute: import("./types.js").JsonRouteSpec<MemoryUpdateEntryInput, MemoryEntryResponse, MemoryHttpDeps>;
+export interface MemoryDeleteEntryResponse {
+    readonly ok: true;
+}
+export declare const memoryDeleteEntryRoute: import("./types.js").JsonRouteSpec<string, MemoryDeleteEntryResponse, MemoryHttpDeps>;
+/**
+ * `GET /api/memory/events` — one SSE connection multiplexing three channels
+ * (matching OD's own reasoning: "so the browser opens one connection instead
+ * of two/three"): `connected` (once, on open), `change` (relayed from
+ * `deps.notes.events`), `extraction` (relayed from `deps.extractions.events`,
+ * whose underlying event name is `'attempt'` — see `@jini-ai/memory`'s
+ * `extraction-log.ts`), and `verify` (relayed from `deps.verifications.events`).
+ * Uses `sse.ts`'s generic channel rather than OD's bespoke `createSseResponse`;
+ * no Last-Event-ID replay (unlike `runs.ts`) since none of the three
+ * underlying emitters buffer history for reconnect — this mirrors the OD
+ * origin's own behavior (a live tail only, no replay).
+ *
+ * Bypasses `mountJsonRoute` (raw `app.get`, for the SSE response shape), so it does not get
+ * `requireSameOrigin` for free the way the JSON routes below do — the guard is applied here
+ * directly, before the SSE channel is opened, so a cross-origin request never gets a stream.
+ */
+export declare function registerMemoryEventStream(app: Express, deps: MemoryHttpDeps, adapter: AdapterContext): void;
+/**
+ * Mounts every ported memory route. Static sub-resources (`/tree`,
+ * `/index`, `/config`, `/events`, `/extractions`, `/verifications`) are
+ * mounted BEFORE the `/api/memory/:id` catch-all routes, preserving OD's own
+ * ordering discipline ("so an `index`/`config`/`extract` slug can't shadow
+ * the real handlers") — Express matches routes in registration order.
+ */
+export declare function registerMemoryRoutes(app: Express, deps: MemoryHttpDeps, adapter: AdapterContext): void;
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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