kiokuko 1.0.0

package/dist/context/broker.d.ts

@@ -0,0 +1,99 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { TaskProfile } from '../akinator/types.js';
+import { listContextDeliveries } from './delivery.js';
+import { type Recommendation } from './recommendations.js';
+import { type RankedCandidate } from './ranking.js';
+import { type FederatedOrigin } from '../memory/federated-retrieval.js';
+import type { LedgerProjection } from '../ledger/projection.js';
+import type { RunRecord } from '../ledger/types.js';
+import type { EmbeddingRuntime } from '../embedding/types.js';
+export declare const CONTEXT_BROKER_POLICY_VERSION: "context-ranking-v1+recommendations.v1";
+export declare const CONTEXT_BROKER_DEFAULT_LIMIT = 20;
+export declare const CONTEXT_BROKER_MAX_LIMIT = 100;
+export declare const CONTEXT_BROKER_DEFAULT_CHARACTER_BUDGET = 8000;
+export declare const CONTEXT_BROKER_MAX_CHARACTER_BUDGET = 100000;
+export interface ContextBrokerQueryInput {
+    workspace?: string;
+    runId?: string;
+    task?: string;
+    taskProfile?: TaskProfile;
+    recommendedTags?: string[];
+    changedPaths?: string[];
+    errorSignatures?: string[];
+    limit?: number;
+    characterBudget?: number;
+}
+export interface ContextBrokerContextItem {
+    entryId: string;
+    entryRevision: number;
+    rank: number;
+    scoreComponents: RankedCandidate['scoreComponents'];
+    selectionReasons: string[];
+    content: RankedCandidate['content'];
+    untrusted: true;
+    origin?: FederatedOrigin;
+}
+export interface ContextBrokerContext {
+    deliveryId: string | null;
+    runId: string | null;
+    throughSequence: number;
+    taskProfileHash: string;
+    queryHash: string;
+    policyVersion: typeof CONTEXT_BROKER_POLICY_VERSION;
+    items: ContextBrokerContextItem[];
+    untrusted: true;
+}
+export interface ContextBrokerResult {
+    status: 'needs_answer' | 'ready' | 'exhausted' | 'unbound';
+    taskProfile: TaskProfile;
+    profileHash: string;
+    acceptedThrough: number;
+    intakeSessionId: string | null;
+    recommendedTags: string[];
+    projection: LedgerProjection | null;
+    context: ContextBrokerContext | null;
+    recommendations: Recommendation[];
+}
+export interface ContextBrokerPersistence {
+    enqueueWrite?: <T>(operation: () => T) => Promise<T> | T;
+}
+export interface ContextBrokerGateDecision<T> {
+    persist: boolean;
+    value: T;
+    assertBeforePersist?: () => void;
+}
+export interface ContextBrokerGatedResult<T> {
+    broker: ContextBrokerResult;
+    value: T;
+}
+export interface ContextBrokerRunState {
+    run: RunRecord;
+    taskProfile: TaskProfile;
+    profileHash: string;
+    recommendedTags: string[];
+    intakeSessionId: string;
+    status: 'needs_answer' | 'ready' | 'exhausted';
+}
+/** Read the same authoritative run/intake/profile snapshot used to rank broker context. */
+export declare function readContextBrokerRunState(database: SqliteDatabase, runId: string): ContextBrokerRunState;
+export declare class ContextBroker {
+    private readonly database;
+    private readonly embeddingRuntime?;
+    private readonly inFlight;
+    constructor(database: SqliteDatabase, embeddingRuntime?: EmbeddingRuntime | undefined);
+    listDeliveries(input: {
+        runId: string;
+        cursor?: string;
+        limit?: number;
+    }): ReturnType<typeof listContextDeliveries> & {
+        untrusted: true;
+    };
+    query(rawInput: unknown, persistence?: ContextBrokerPersistence): Promise<ContextBrokerResult>;
+    queryGated<T>(rawInput: unknown, decide: (candidate: ContextBrokerResult) => ContextBrokerGateDecision<T>, persistence?: ContextBrokerPersistence): Promise<ContextBrokerGatedResult<T>>;
+    private execute;
+    private queryPrepared;
+    private prepareResult;
+    private persistPrepared;
+    private validatePrepared;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/context/broker.d.ts.map

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