@opendatalabs/personal-server-ts-core 0.0.1-canary.01ca694 → 0.0.1-canary.052d47e

package/dist/derivatives/api.d.ts

@@ -0,0 +1,48 @@
+/**
+ * HTTP surface of the compute layer, mounted under `/v1/derivatives`:
+ *
+ *   POST   /questions                 register (builder write auth or owner)
+ *   GET    /questions                 list (owner; builder with ?derivedScope=)
+ *   GET    /questions/:id             status (owner or the registering builder)
+ *   POST   /questions/:id/recompute   owner or the registering builder
+ *   DELETE /questions/:id             owner or the registering builder
+ *
+ * Builder authentication is the Write API's: a write-session bearer token
+ * plus the X-Vana-Write-Signature proof over the request, authorized for
+ * `write:<derivedScope>` (api-auth authorizeWrite). No new credential.
+ *
+ * The proof signs the request URI INCLUDING its query string (see
+ * canonicalSignedUri in write/attribution.ts), because on the list route the
+ * query decides the authorization: `?derivedScope=X` is the scope the caller
+ * is authorized against, and a proof that did not commit to it could be
+ * captured on one scope and replayed on another.
+ */
+import type { PersonalServerApiAuthPort, PersonalServerApiDispatchOptions } from "../api/index.js";
+import type { RecomputeScheduler } from "./scheduler.js";
+import { type QuestionStore } from "./types.js";
+/** Registration bodies are small; anything larger is refused up front. */
+export declare const MAX_QUESTION_BODY_BYTES: number;
+export interface PersonalServerDerivativesApiDeps {
+    auth: Pick<PersonalServerApiAuthPort, "authorizeOwner" | "authorizeWrite" | "authorizeWriteSession" | "authorizeBuilderRead">;
+    /** Absent = the compute layer is not wired; every route answers 503. */
+    compute?: {
+        store: QuestionStore;
+        scheduler: Pick<RecomputeScheduler, "requestRecompute" | "markSourceChanged"> & {
+            /**
+             * Next scheduled automatic retry of a failed question (ISO time), or
+             * null. Optional so a minimal scheduler stays a valid dependency; the
+             * status route then reports no retry.
+             */
+            nextRetryAt?(questionId: string): string | null;
+            /** True while a retry compute is running (timer fired, not settled). */
+            retryInFlight?(questionId: string): boolean;
+        };
+    } | null;
+    now?: () => Date;
+    createQuestionId?: () => string;
+    logger?: {
+        info?(payload: Record<string, unknown>, message: string): void;
+    };
+}
+export declare function handlePersonalServerDerivativesRequest(request: Request, deps: PersonalServerDerivativesApiDeps, options?: PersonalServerApiDispatchOptions): Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/derivatives/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/derivatives/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH,OAAO,KAAK,EACV,yBAAyB,EACzB,gCAAgC,EAGjC,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,QAAY,CAAC;AAKjD,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,IAAI,CACR,yBAAyB,EACvB,gBAAgB,GAChB,gBAAgB,GAChB,uBAAuB,GACvB,sBAAsB,CACzB,CAAC;IACF,wEAAwE;IACxE,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,IAAI,CACb,kBAAkB,EAClB,kBAAkB,GAAG,mBAAmB,CACzC,GAAG;YACF;;;;eAIG;YACH,WAAW,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;YAChD,wEAAwE;YACxE,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;SAC7C,CAAC;KACH,GAAG,IAAI,CAAC;IACT,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAChE,CAAC;CACH;AAuOD,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,gCAAgC,EACtC,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,QAAQ,CAAC,CAqMnB"}

package/dist/derivatives/api.js

@@ -0,0 +1,366 @@
+/**
+ * HTTP surface of the compute layer, mounted under `/v1/derivatives`:
+ *
+ *   POST   /questions                 register (builder write auth or owner)
+ *   GET    /questions                 list (owner; builder with ?derivedScope=)
+ *   GET    /questions/:id             status (owner or the registering builder)
+ *   POST   /questions/:id/recompute   owner or the registering builder
+ *   DELETE /questions/:id             owner or the registering builder
+ *
+ * Builder authentication is the Write API's: a write-session bearer token
+ * plus the X-Vana-Write-Signature proof over the request, authorized for
+ * `write:<derivedScope>` (api-auth authorizeWrite). No new credential.
+ *
+ * The proof signs the request URI INCLUDING its query string (see
+ * canonicalSignedUri in write/attribution.ts), because on the list route the
+ * query decides the authorization: `?derivedScope=X` is the scope the caller
+ * is authorized against, and a proof that did not commit to it could be
+ * captured on one scope and replayed on another.
+ */
+import { ContentTooLargeError, DerivativeComputeUnavailableError, DerivativeDerivedScopeRequiredError, DerivativeQuestionNotFoundError, DerivativeSourceNotGrantedError, ProtocolError, } from "../errors/catalog.js";
+import { parseJsonObjectBody } from "../contracts/http.js";
+import { parseDataScopeContract } from "../contracts/data.js";
+import { selectedGrantId } from "../api/index.js";
+import { createQuestionRegistration, parseQuestionInput, uncoveredSourceScopes, } from "./registration.js";
+import { questionRegistrationView, } from "./types.js";
+/** Registration bodies are small; anything larger is refused up front. */
+export const MAX_QUESTION_BODY_BYTES = 16 * 1024;
+/** Poll hint served while a retry compute is in flight (no scheduled time). */
+const RETRY_IN_FLIGHT_POLL_SECONDS = 5;
+function jsonResponse(body, init) {
+    const headers = new Headers(init?.headers);
+    headers.set("Content-Type", "application/json");
+    return new Response(JSON.stringify(body), { ...init, headers });
+}
+function errorResponse(status, errorCode, message) {
+    return jsonResponse({ error: { code: status, errorCode, message } }, { status });
+}
+function stripBasePath(pathname, basePath) {
+    if (!basePath || basePath === "/")
+        return pathname;
+    if (pathname === basePath)
+        return "/";
+    if (pathname.startsWith(`${basePath}/`))
+        return pathname.slice(basePath.length);
+    return pathname;
+}
+/**
+ * Authorize as the owner or, through the write-session path, as a builder
+ * holding `write:<scope>`. Returns the builder result or undefined (owner).
+ */
+async function authorizeOwnerOrWriter(deps, request, scope) {
+    if (deps.auth.authorizeWrite) {
+        return (await deps.auth.authorizeWrite({ request, scope })) ?? undefined;
+    }
+    await deps.auth.authorizeOwner(request);
+    return undefined;
+}
+function sameBuilder(a, b) {
+    return a.toLowerCase() === b.toLowerCase();
+}
+/**
+ * Is this a builder call at all? Identity only (no scope is authorized), for
+ * the two answers that have no scope to authorize against: an unknown
+ * question id and a list call with no `?derivedScope=`. Nothing is disclosed
+ * either way, and the caller's proof is handed straight back — the request
+ * ends in an error, so it must not burn the proof.
+ */
+async function recognizeWriteSession(deps, request) {
+    if (!deps.auth.authorizeWriteSession)
+        return undefined;
+    const session = (await deps.auth.authorizeWriteSession(request)) ?? undefined;
+    await session?.releaseProof?.();
+    return session;
+}
+/**
+ * The registration a caller may act on, or a 404 for everyone who may not:
+ * the owner sees every registration; a builder sees the ones it registered.
+ * An id the store does not hold is 404 for any authenticated caller (a
+ * builder holding a live write session, or the owner) and 401 for everyone
+ * else, so a builder learns nothing from probing ids that it could not learn
+ * from probing another builder's ids, which already answers 404.
+ */
+async function loadForCaller(deps, request, store, questionId) {
+    const registration = await store.get(questionId);
+    if (!registration) {
+        // No registration means no derived scope to authorize a builder against,
+        // so fall back to identity: a live write session is enough to be told
+        // 404. Without it the owner gate decides (and answers 401).
+        if (!(await recognizeWriteSession(deps, request))) {
+            await deps.auth.authorizeOwner(request);
+        }
+        throw new DerivativeQuestionNotFoundError({ questionId });
+    }
+    const writer = await authorizeOwnerOrWriter(deps, request, registration.derivedScope);
+    if (writer) {
+        const by = registration.registeredBy;
+        if (by.kind !== "builder" || !sameBuilder(by.builder, writer.builder)) {
+            await writer.releaseProof?.();
+            throw new DerivativeQuestionNotFoundError({ questionId });
+        }
+    }
+    return { registration, writer };
+}
+/**
+ * `GET /v1/derivatives/status?derivedScope=<scope>`: the lifecycle of the
+ * question behind a derived scope, for the party that will READ the answer.
+ *
+ * Authorization is the data read's (`authorizeBuilderRead`, i.e. a live
+ * grant covering the derived scope, or the owner) — deliberately NOT the
+ * write-session path, because a consent-flow reader holds only a bare read
+ * entry and can never open a write session. Nothing is served and nothing
+ * is charged: this is authorization only, no x402 challenge and no
+ * RECORD_DATA_ACCESS receipt, the same bar as the lineage read.
+ *
+ * The view is deliberately narrow: lifecycle only. The question text, the
+ * source scopes, the question id, the registrar and the raw error string
+ * stay owner-only — `errorCode` is a closed vocabulary precisely so a
+ * stored error like "source scope X is deleted" cannot leak a scope name.
+ * One class needs the same care as the raw string: `grant_invalid` arises
+ * only from a builder-registered question, so a third-party reader gets
+ * `internal` instead of learning who registered.
+ * Auth runs before the store lookup, so an uncovered caller cannot probe
+ * which scopes have questions behind them.
+ *
+ * Like every Web3Signed read (data, lineage), the signature covers the
+ * path, not the query; per-scope authorization is enforced live against
+ * the caller's grant on each request.
+ */
+async function handleStatusRoute(request, url, deps, store, scheduler, now) {
+    if (request.method !== "GET") {
+        return errorResponse(405, "METHOD_NOT_ALLOWED", "Method not allowed");
+    }
+    const derivedScopeParam = url.searchParams.get("derivedScope");
+    if (!derivedScopeParam) {
+        throw new DerivativeDerivedScopeRequiredError();
+    }
+    // Same grammar gate as every scope-taking route, before anything is
+    // authorized: an arbitrary string never reaches the grant policy.
+    const scopeResult = parseDataScopeContract(derivedScopeParam);
+    if (!scopeResult.ok) {
+        return errorResponse(scopeResult.status, scopeResult.body.error, scopeResult.body.message);
+    }
+    const derivedScope = scopeResult.scope;
+    const auth = (await deps.auth.authorizeBuilderRead({
+        request,
+        scope: derivedScope,
+        grantId: selectedGrantId(request, url),
+    })) ?? undefined;
+    const registrations = await store.list({ derivedScope });
+    if (registrations.length === 0) {
+        throw new DerivativeQuestionNotFoundError({ derivedScope });
+    }
+    // Several registrations may share a derived scope, and data serving is
+    // registration-agnostic: if ANY of them is ready, the scope has an answer
+    // and the reader must not be told "failed" by a duplicate that never
+    // wrote anything. Report the most optimistic true state — ready, then an
+    // in-flight recompute, then never-computed, then failed — and within a
+    // class let the most recently updated registration speak.
+    const STATUS_PRECEDENCE = {
+        ready: 0,
+        stale: 1,
+        pending: 2,
+        failed: 3,
+    };
+    const registration = registrations.reduce((best, candidate) => {
+        const byStatus = STATUS_PRECEDENCE[candidate.status] - STATUS_PRECEDENCE[best.status];
+        if (byStatus !== 0)
+            return byStatus < 0 ? candidate : best;
+        return candidate.updatedAt >= best.updatedAt ? candidate : best;
+    });
+    const nextRetryAt = scheduler.nextRetryAt?.(registration.questionId) ?? null;
+    // While the retry compute is RUNNING there is no scheduled time, but null
+    // would be the terminal "will never retry" signature; serve a short poll
+    // hint instead. 0 is never served — it invites a tight poll loop.
+    const retryAfterSeconds = nextRetryAt !== null
+        ? Math.max(1, Math.ceil((Date.parse(nextRetryAt) - now().getTime()) / 1000))
+        : scheduler.retryInFlight?.(registration.questionId)
+            ? RETRY_IN_FLIGHT_POLL_SECONDS
+            : null;
+    // `grant_invalid` can only come from the live re-check of a REGISTERING
+    // BUILDER's grant, which an owner-registered question never runs. Serving
+    // it to a third-party reader would therefore disclose the registrar class
+    // the rest of this view withholds. The owner and the registrar itself lose
+    // nothing — they are the two parties who can act on it — and everyone else
+    // reads the honest generic class: something is wrong server-side and no
+    // retry is coming.
+    const registrarView = auth === undefined ||
+        auth.grantId === "owner" ||
+        auth.grantId === "policy-bypass" ||
+        (registration.registeredBy.kind === "builder" &&
+            typeof auth.builder === "string" &&
+            sameBuilder(registration.registeredBy.builder, auth.builder));
+    const disclosedErrorCode = registration.errorCode === "grant_invalid" && !registrarView
+        ? "internal"
+        : registration.errorCode;
+    return jsonResponse({
+        derivedScope: registration.derivedScope,
+        status: registration.status,
+        lastComputedAt: registration.lastComputedAt,
+        derivedVersion: registration.derivedVersion,
+        derivedCollectedAt: registration.derivedCollectedAt,
+        // Null unless failed, whatever an old store row holds: a stale question
+        // is a recompute in progress, not a terminal failure.
+        errorCode: registration.status === "failed" ? disclosedErrorCode : null,
+        retryAfterSeconds,
+    });
+}
+export async function handlePersonalServerDerivativesRequest(request, deps, options = {}) {
+    try {
+        const url = new URL(request.url);
+        const pathname = stripBasePath(url.pathname, options.basePath);
+        const parts = pathname.split("/").filter(Boolean);
+        const isStatusRoute = parts[0] === "status" && parts.length === 1;
+        if (!isStatusRoute && (parts[0] !== "questions" || parts.length > 3)) {
+            return errorResponse(404, "NOT_FOUND", "Not found");
+        }
+        const compute = deps.compute;
+        if (!compute)
+            throw new DerivativeComputeUnavailableError();
+        const { store, scheduler } = compute;
+        const now = deps.now ?? (() => new Date());
+        // /status — the reader-facing lifecycle view of a derived scope.
+        if (isStatusRoute) {
+            return await handleStatusRoute(request, url, deps, store, scheduler, now);
+        }
+        // /questions
+        if (parts.length === 1) {
+            if (request.method === "GET") {
+                const derivedScope = url.searchParams.get("derivedScope") ?? undefined;
+                if (derivedScope) {
+                    const writer = await authorizeOwnerOrWriter(deps, request, derivedScope);
+                    const registrations = await store.list({
+                        derivedScope,
+                        ...(writer ? { builder: writer.builder } : {}),
+                    });
+                    return jsonResponse({
+                        questions: registrations.map(questionRegistrationView),
+                    });
+                }
+                // The unfiltered list is the owner's. A builder that reached it
+                // simply forgot the parameter, so say that instead of 401: the
+                // 401 would send a re-handshake-on-401 client through a handshake
+                // and then report an authentication problem it does not have.
+                if (await recognizeWriteSession(deps, request)) {
+                    throw new DerivativeDerivedScopeRequiredError();
+                }
+                await deps.auth.authorizeOwner(request);
+                const registrations = await store.list();
+                return jsonResponse({
+                    questions: registrations.map(questionRegistrationView),
+                });
+            }
+            if (request.method === "POST") {
+                // The derived scope decides which write grant must cover the call,
+                // so the body is read (from a clone: the proof check reads it too)
+                // before authorization. Nothing is stored until auth passed.
+                const declared = Number(request.headers.get("content-length") ?? "0");
+                if (declared > MAX_QUESTION_BODY_BYTES) {
+                    throw new ContentTooLargeError({ max: MAX_QUESTION_BODY_BYTES });
+                }
+                const bodyBytes = new Uint8Array(await request.clone().arrayBuffer());
+                if (bodyBytes.byteLength > MAX_QUESTION_BODY_BYTES) {
+                    throw new ContentTooLargeError({ max: MAX_QUESTION_BODY_BYTES });
+                }
+                const parsed = await parseJsonObjectBody(request.clone(), "Request body must be valid JSON");
+                if (!parsed.ok) {
+                    return jsonResponse(parsed.result.body, {
+                        status: parsed.result.status,
+                    });
+                }
+                const rawScope = parsed.body.derivedScope;
+                const scopeForAuth = typeof rawScope === "string" ? rawScope : "";
+                const writer = await authorizeOwnerOrWriter(deps, request, scopeForAuth);
+                const registeredBy = writer
+                    ? {
+                        kind: "builder",
+                        builder: writer.builder,
+                        grantId: writer.grantId,
+                    }
+                    : { kind: "owner" };
+                let registration;
+                try {
+                    if (writer) {
+                        // Consent: the answer exposes the sources to the builder, so
+                        // every source must be read-granted to it. Fail closed when
+                        // the auth port did not hand over the grant's scopes.
+                        const input = parseQuestionInput(parsed.body);
+                        const uncovered = uncoveredSourceScopes(input.sourceScopes, writer.grantScopes);
+                        if (uncovered.length > 0) {
+                            throw new DerivativeSourceNotGrantedError({ scopes: uncovered });
+                        }
+                    }
+                    registration = await createQuestionRegistration({
+                        body: parsed.body,
+                        registeredBy,
+                        store,
+                        questionId: deps.createQuestionId?.() ?? crypto.randomUUID(),
+                        now,
+                    });
+                }
+                catch (err) {
+                    // Nothing stored: hand the builder's proof back for a retry.
+                    await writer?.releaseProof?.();
+                    throw err;
+                }
+                deps.logger?.info?.({
+                    questionId: registration.questionId,
+                    derivedScope: registration.derivedScope,
+                    sourceScopes: registration.sourceScopes,
+                    registeredBy: registeredBy.kind,
+                    ...(writer
+                        ? { builder: writer.builder, grantId: writer.grantId }
+                        : {}),
+                }, "Derivative question registered");
+                scheduler.requestRecompute(registration.questionId, {
+                    immediate: true,
+                });
+                return jsonResponse(questionRegistrationView(registration), {
+                    status: 201,
+                });
+            }
+            return errorResponse(405, "METHOD_NOT_ALLOWED", "Method not allowed");
+        }
+        const questionId = decodeURIComponent(parts[1] ?? "");
+        // /questions/:id/recompute
+        if (parts.length === 3) {
+            if (parts[2] !== "recompute") {
+                return errorResponse(404, "NOT_FOUND", "Not found");
+            }
+            if (request.method !== "POST") {
+                return errorResponse(405, "METHOD_NOT_ALLOWED", "Method not allowed");
+            }
+            // Owner, or the registering builder (its retry after a transient
+            // failure); same gate as GET / DELETE.
+            const { registration } = await loadForCaller(deps, request, store, questionId);
+            scheduler.requestRecompute(questionId, { immediate: true });
+            // The same registration view every other route returns, so a client
+            // needs one schema. The status is the one the scheduled run starts
+            // from: a question that never computed stays `pending`, anything else
+            // is `stale` until the run lands.
+            return jsonResponse(questionRegistrationView({
+                ...registration,
+                status: registration.status === "pending" ? "pending" : "stale",
+            }), { status: 202 });
+        }
+        // /questions/:id
+        if (request.method === "GET") {
+            const { registration } = await loadForCaller(deps, request, store, questionId);
+            return jsonResponse(questionRegistrationView(registration));
+        }
+        if (request.method === "DELETE") {
+            const { registration } = await loadForCaller(deps, request, store, questionId);
+            await store.delete(questionId);
+            deps.logger?.info?.({ questionId, derivedScope: registration.derivedScope }, "Derivative question deleted");
+            return jsonResponse({ questionId, deleted: true });
+        }
+        return errorResponse(405, "METHOD_NOT_ALLOWED", "Method not allowed");
+    }
+    catch (err) {
+        if (err instanceof ProtocolError) {
+            return jsonResponse(err.toJSON(), { status: err.code });
+        }
+        return errorResponse(500, "INTERNAL_ERROR", "Internal server error");
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/derivatives/api.js.map

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

package/dist/derivatives/compute.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The compute job: answer one registered question from local data and
+ * write the answer as a derivative record (owner path, `$lineage` = the
+ * source data points).
+ */
+import type { ScopeDeletionTracker } from "../sync/scope-deletions.js";
+import type { DataStoragePort, RuntimeAvailabilityPort } from "../ports/index.js";
+import { type DataWritePolicyPorts } from "../policy/data-write.js";
+import { type InferenceProvider } from "./inference.js";
+import type { QuestionRegistration, QuestionStore } from "./types.js";
+export interface ComputeLogger {
+    info?(payload: Record<string, unknown>, message: string): void;
+    warn?(payload: Record<string, unknown>, message: string): void;
+}
+export interface ComputeSyncNotifier {
+    notifyNewData?(): void;
+    trigger?(): Promise<void>;
+}
+export interface QuestionComputeDeps {
+    storage: DataStoragePort;
+    store: QuestionStore;
+    provider: InferenceProvider;
+    /** Required: lineage ids are keccak256(owner, scope). */
+    serverOwner: `0x${string}` | undefined;
+    /** Newest-first items kept per source scope (default 50). */
+    maxSourceItems?: number;
+    maxSourceChars?: number;
+    maxTokens?: number;
+    /** Uploads the derivative after it is written locally. */
+    syncManager?: ComputeSyncNotifier | null;
+    /** Re-add marker, same as an HTTP ingest (see api/index.ts). */
+    scopeDeletions?: ScopeDeletionTracker;
+    /**
+     * When present, a builder-registered question re-checks its write grant
+     * before every compute (revoked / expired / scope no longer covered =>
+     * failed, no inference call). Owner registrations skip the check.
+     */
+    writePolicyPorts?: DataWritePolicyPorts;
+    /**
+     * Called after the derivative is written and the question marked ready,
+     * so a question that reads THIS derived scope recomputes in turn
+     * (A -> B -> C chains). The compute path never goes through the HTTP
+     * ingest hook.
+     */
+    onDerivedWritten?: (event: {
+        scope: string;
+        collectedAt: string;
+        lineageSources: string[];
+    }) => void;
+    /** When unavailable the compute is skipped and the status left as is. */
+    runtimeAvailability?: RuntimeAvailabilityPort;
+    /**
+     * Backoff between retries of a transient inference or gateway failure
+     * (default 1s, 4s: three attempts). Tests pass zeros.
+     */
+    retryDelaysMs?: readonly number[];
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => Date;
+    logger?: ComputeLogger;
+}
+export type ComputeOutcome = {
+    status: "ready";
+    registration: QuestionRegistration;
+} | {
+    status: "failed";
+    registration: QuestionRegistration;
+    error: string;
+} | {
+    status: "skipped";
+    reason: "unknown-question" | "runtime-unavailable";
+};
+/** The record written into the derived scope. */
+export interface DerivativeAnswerRecord {
+    questionId: string;
+    question: string;
+    answer: string;
+    evidence: string | null;
+    model: string;
+    computedAt: string;
+    sources: Array<{
+        scope: string;
+        version: number;
+        collectedAt: string;
+    }>;
+    /** Caller-side lineage field, mirrored by the server into `$lineage`. */
+    lineage: `0x${string}`[];
+    inference?: {
+        receiptId?: string;
+        aciIdentity?: string;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Version stamp for the derived record, second precision like an HTTP
+ * ingest. A recompute inside the same second as the previous one would
+ * collide on the (scope, collectedAt) path, so the stamp advances past any
+ * version the scope already holds (bounded: at most one minute ahead).
+ */
+export declare function collectedAtStamp(now: () => Date, isTaken: (collectedAt: string) => boolean): string;
+/**
+ * Compute one question end to end. Never throws for a compute failure: the
+ * registration is marked `failed` with a short reason and the outcome says
+ * so. Throws only when the store itself fails.
+ */
+export declare function computeQuestion(questionId: string, deps: QuestionComputeDeps): Promise<ComputeOutcome>;
+//# sourceMappingURL=compute.d.ts.map

package/dist/derivatives/compute.d.ts.map

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