@cogenta/agents 0.2.1 → 0.4.0

package/dist/providers/types.d.ts

@@ -13,10 +13,33 @@ export interface ProviderToolCall {
     readonly name: string;
     readonly input: Readonly<Record<string, unknown>>;
 }
+/** A plain-text segment of a multimodal message. */
+export interface ChatTextPart {
+    readonly type: 'text';
+    readonly text: string;
+}
+/**
+ * An inline image segment of a multimodal message. `data` is raw base64 —
+ * no `data:` URI prefix — so each adapter can format it however its own
+ * wire protocol wants it (a data URL for OpenAI, a bare base64 field for
+ * Anthropic and Google).
+ */
+export interface ChatImagePart {
+    readonly type: 'image';
+    readonly mediaType: string;
+    readonly data: string;
+}
+export type ChatContentPart = ChatTextPart | ChatImagePart;
 export interface ChatMessage {
     readonly role: ChatRole;
-    /** Absent (not empty-string) when a turn is tool calls with no accompanying text. */
-    readonly content?: string;
+    /**
+     * Absent (not empty-string) when a turn is tool calls with no accompanying
+     * text. A plain `string` is the common case and every existing caller
+     * keeps compiling and behaving identically; an array of `ChatContentPart`
+     * lets a caller attach images alongside text (e.g. the Theme Creator
+     * agent handing a model a screenshot a user uploaded).
+     */
+    readonly content?: string | readonly ChatContentPart[];
     /** Set on an `assistant` message that requested tool calls. */
     readonly toolCalls?: readonly ProviderToolCall[];
     /** Set on a `tool` message: which call this is the result of. */
@@ -35,7 +58,14 @@ export interface ChatRequest {
     readonly system?: string;
     readonly messages: readonly ChatMessage[];
     readonly tools?: readonly ProviderToolSpec[];
-    readonly maxTokens: number;
+    /**
+     * Absent lets the client fall back to its own configured
+     * `maxOutputTokens` (an admin-set property of the provider/model, not a
+     * literal a caller should be picking) — see `ProviderClient.maxOutputTokens`.
+     * A caller only sets this for a genuine, call-specific reason to differ
+     * from that default.
+     */
+    readonly maxTokens?: number;
     readonly temperature?: number;
 }
 export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence';
@@ -58,6 +88,51 @@ export interface ChatOptions {
 export interface ProviderClient {
     readonly name: string;
     readonly model: string;
+    /**
+     * Whether this client can accept a `ChatImagePart` in a message's content.
+     * Absent means "unknown, assume no" — a caller building a multimodal
+     * message should check this before attaching an image, and degrade
+     * (text-only, with an explicit note) when it is not `true`.
+     */
+    readonly supportsVision?: boolean;
+    /**
+     * The completion budget every call through this client defaults to when
+     * a request does not set its own `maxTokens` — a property of *which
+     * model this is*, not of any one call site. A reasoning-tier model can
+     * spend thousands of tokens "thinking" before it ever writes a visible
+     * answer, and that reasoning counts against this same budget; a plain
+     * instruct model needs far less. This is why it lives on the provider
+     * (admin-configurable from `/admin/providers`, `resolve.ts` resolves it
+     * from `ProviderConfigStore`), not as a constant scattered across every
+     * caller — a real, reproduced bug (`docs`/changeset history: DeepSeek's
+     * `deepseek-v4-flash` hitting `finish_reason: "length"` with empty
+     * content at a too-low hardcoded ceiling) is exactly what a per-call
+     * hardcoded number cannot adapt to. Resolved adapters
+     * (`createAnthropicClient`/`createOpenAiClient`/`createGoogleClient`)
+     * always set this to a concrete number — the admin's value, or a built-in
+     * fallback when unset — so a caller never needs its own `?? literal`.
+     */
+    readonly maxOutputTokens?: number;
+    /**
+     * How many times a generate-validate-correct loop (skin generation, brief
+     * analysis, content-model/demo-content proposals, the base-theme choice)
+     * retries this client before giving up. Same reasoning as
+     * `maxOutputTokens`: a model that needs more coaxing to produce valid
+     * structured output benefits from more attempts, and that is a fact about
+     * the model, set by the admin who chose it — not a number a given call
+     * site should be guessing at.
+     */
+    readonly maxCorrectionAttempts?: number;
+    /**
+     * How long a single HTTP call to this provider is allowed to run before
+     * being aborted — both the raw request timeout each adapter applies via
+     * `requestSignalWithTimeout`, and the per-model-call timeout the LangGraph
+     * agent loop (`runtime/loop.ts`) enforces around `chat()`. A slower
+     * (often reasoning-tier) model genuinely needs more wall-clock time, not
+     * just more tokens; a fixed timeout picked without knowing which model an
+     * admin configured is the same class of mistake as a fixed token budget.
+     */
+    readonly requestTimeoutMs?: number;
     chat(request: ChatRequest, options?: ChatOptions): Promise<ChatResponse>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;AAEpD,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAChD,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,oJAAoJ;AACpJ,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACxD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,CAAA;AAEjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC/C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,yHAAyH;IACzH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,wHAAwH;AACxH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACzE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"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"}

package/dist/rag/reference-documents/ingest.d.ts

@@ -0,0 +1,22 @@
+import type { ExtractedDocument } from '../../documents/extract-text.js';
+import type { EmbeddingProvider } from '../embeddings/types.js';
+import type { VectorStore } from '../vector/types.js';
+export interface ReferenceDocumentIngestOptions {
+    readonly store: VectorStore;
+    readonly embeddings: EmbeddingProvider;
+    readonly siteId: string;
+}
+/**
+ * Chunks, embeds and stores one uploaded reference document under the
+ * reserved pseudo-collection (`types.ts`). `documentId` is the
+ * `ReferenceDocumentStore` row's own id — reusing it as the vector
+ * `entryId` is what lets `removeReferenceDocument` and a re-upload address
+ * exactly the chunks this document produced, the same way a content entry's
+ * id already does for `withVectorIndexing`.
+ */
+export declare function ingestReferenceDocument(document: Pick<ExtractedDocument, 'filename' | 'text'>, documentId: string, options: ReferenceDocumentIngestOptions): Promise<{
+    readonly chunkCount: number;
+}>;
+/** Removes every chunk a document produced — an upload's own undo, and what a delete from the admin screen calls. */
+export declare function removeReferenceDocumentVectors(store: VectorStore, siteId: string, documentId: string): Promise<void>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/rag/reference-documents/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/rag/reference-documents/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAGxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,oBAAoB,CAAA;AA4BnE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,MAAM,CAAC,EACtD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA8B1C;AAED,qHAAqH;AACrH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/rag/reference-documents/ingest.js

@@ -0,0 +1,69 @@
+import { chunkDocument } from '../chunking/chunk-document.js';
+import { REFERENCE_DOCUMENT_COLLECTION, REFERENCE_DOCUMENT_LOCALE, REFERENCE_DOCUMENT_STATUS, } from './types.js';
+/**
+ * The one real user of `chunkDocument` (L18 task 15) against an actual
+ * multi-chunk document — `withVectorIndexing`'s own `recordFor` deliberately
+ * uses one chunk per entry instead (see that file's comment: real chunking
+ * "is a piece of work of its own"). A reference document has no blocks to
+ * read, only the flat string `extractDocumentText` already produced, so this
+ * is that piece of work, scoped to exactly what an uploaded document needs:
+ * paragraphs standing in for blocks, a blank line standing in for the
+ * boundary between them, and nothing claiming to be a heading (a plain-text
+ * or a PDF extraction has no reliable way to tell one from a paragraph, so
+ * claiming otherwise would just fabricate section boundaries `chunkDocument`
+ * would then treat as if a human had marked them).
+ */
+function paragraphsOf(text) {
+    return text
+        .split(/\n{2,}/u)
+        .map((paragraph) => paragraph.trim())
+        .filter((paragraph) => paragraph.length > 0)
+        .map((paragraph, index) => ({ id: String(index), text: paragraph }));
+}
+/**
+ * Chunks, embeds and stores one uploaded reference document under the
+ * reserved pseudo-collection (`types.ts`). `documentId` is the
+ * `ReferenceDocumentStore` row's own id — reusing it as the vector
+ * `entryId` is what lets `removeReferenceDocument` and a re-upload address
+ * exactly the chunks this document produced, the same way a content entry's
+ * id already does for `withVectorIndexing`.
+ */
+export async function ingestReferenceDocument(document, documentId, options) {
+    const blocks = paragraphsOf(document.text);
+    if (blocks.length === 0)
+        return { chunkCount: 0 };
+    const chunks = chunkDocument({
+        documentId,
+        title: document.filename,
+        blocks,
+    });
+    if (chunks.length === 0)
+        return { chunkCount: 0 };
+    const vectors = await options.embeddings.embed(chunks.map((chunk) => chunk.text));
+    const records = [];
+    chunks.forEach((chunk, index) => {
+        const vector = vectors[index];
+        if (vector === undefined)
+            return;
+        records.push({
+            siteId: options.siteId,
+            collection: REFERENCE_DOCUMENT_COLLECTION,
+            entryId: documentId,
+            locale: REFERENCE_DOCUMENT_LOCALE,
+            status: REFERENCE_DOCUMENT_STATUS,
+            chunk,
+            vector,
+        });
+    });
+    await options.store.upsert(records);
+    return { chunkCount: records.length };
+}
+/** Removes every chunk a document produced — an upload's own undo, and what a delete from the admin screen calls. */
+export async function removeReferenceDocumentVectors(store, siteId, documentId) {
+    await store.removeEntries({
+        siteId,
+        collection: REFERENCE_DOCUMENT_COLLECTION,
+        entryIds: [documentId],
+    });
+}
+//# sourceMappingURL=ingest.js.map

package/dist/rag/reference-documents/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/rag/reference-documents/ingest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAI7D,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;GAYG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI;SACR,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;SACpC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;AACxE,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAsD,EACtD,UAAkB,EAClB,OAAuC;IAEvC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;IAEjD,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,UAAU;QACV,KAAK,EAAE,QAAQ,CAAC,QAAQ;QACxB,MAAM;KACP,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;IAEjD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAEjF,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QAChC,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,6BAA6B;YACzC,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,yBAAyB;YACjC,MAAM,EAAE,yBAAyB;YACjC,KAAK;YACL,MAAM;SACP,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,CAAA;AACvC,CAAC;AAED,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,KAAkB,EAClB,MAAc,EACd,UAAkB;IAElB,MAAM,KAAK,CAAC,aAAa,CAAC;QACxB,MAAM;QACN,UAAU,EAAE,6BAA6B;QACzC,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB,CAAC,CAAA;AACJ,CAAC"}

package/dist/rag/reference-documents/store.d.ts

@@ -0,0 +1,23 @@
+import { type DatabaseHandle } from '@cogenta/core';
+import type { DocumentFormat } from '../../documents/extract-text.js';
+import type { ReferenceDocumentRecord } from './types.js';
+export interface CreateReferenceDocumentInput {
+    readonly siteId: string;
+    readonly filename: string;
+    readonly format: DocumentFormat;
+    readonly characters: number;
+    readonly warnings: readonly string[];
+    readonly uploadedBy: string | null;
+}
+export interface ReferenceDocumentStore {
+    ensureTable(): Promise<void>;
+    list(siteId: string): Promise<readonly ReferenceDocumentRecord[]>;
+    get(siteId: string, id: string): Promise<ReferenceDocumentRecord | null>;
+    /** Inserted with `status: 'pending'` — indexing (embedding + vector upsert) happens after, and reports back via `markIndexed`/`markError`. */
+    create(input: CreateReferenceDocumentInput): Promise<ReferenceDocumentRecord>;
+    markIndexed(siteId: string, id: string, chunkCount: number, at: string): Promise<void>;
+    markError(siteId: string, id: string, message: string): Promise<void>;
+    remove(siteId: string, id: string): Promise<void>;
+}
+export declare function createReferenceDocumentStore(db: DatabaseHandle, now?: () => number): ReferenceDocumentStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/rag/reference-documents/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/rag/reference-documents/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAMpB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAA2B,MAAM,YAAY,CAAA;AAqElF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAA;IACjE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAA;IACxE,8IAA8I;IAC9I,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC7E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAWD,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,cAAc,EAClB,GAAG,GAAE,MAAM,MAAiB,GAC3B,sBAAsB,CAwFxB"}

package/dist/rag/reference-documents/store.js

@@ -0,0 +1,140 @@
+import { CogentaError, identifier, newId, sql, unsafeRaw, } from '@cogenta/core';
+/**
+ * Metadata for every reference document a site has uploaded — L22 task 4's
+ * "état clair de ce qui est indexé/en cours/en erreur". The vector store
+ * (`VectorStore`) holds the embedded chunks; this table holds the one row
+ * per upload that the admin screen actually renders a list from, because a
+ * `VectorStore` has no notion of "a document", only of chunks that happen to
+ * share an `entryId`.
+ *
+ * Column helpers are written out by hand rather than imported from
+ * `@cogenta/schema`'s `store/columns.ts`: that module is not part of
+ * `@cogenta/schema`'s public `exports` map (only `.` is), and `@cogenta/agents`
+ * may not deep-import another package's `src/`. Three columns' worth of
+ * per-dialect typing is not worth widening that package's public surface for.
+ */
+const REFERENCE_DOCUMENTS_TABLE = 'cogenta_reference_documents';
+function textColumn(dialect, length) {
+    return unsafeRaw(dialect === 'sqlite' ? 'text' : `varchar(${length})`);
+}
+function idColumn(dialect) {
+    if (dialect === 'postgres')
+        return unsafeRaw('uuid');
+    if (dialect === 'mysql')
+        return unsafeRaw('char(36)');
+    return unsafeRaw('text');
+}
+function timestampColumn(dialect) {
+    return textColumn(dialect, 32);
+}
+function integerColumn() {
+    return unsafeRaw('integer');
+}
+function toRecord(row) {
+    return {
+        id: row.id,
+        siteId: row.site_id,
+        filename: row.filename,
+        format: row.format,
+        characters: Number(row.characters),
+        chunkCount: Number(row.chunk_count),
+        status: row.status,
+        errorMessage: row.error_message,
+        warnings: JSON.parse(row.warnings),
+        uploadedAt: row.uploaded_at,
+        uploadedBy: row.uploaded_by,
+        indexedAt: row.indexed_at,
+    };
+}
+function notFound(id) {
+    return new CogentaError({
+        code: 'ASSIST_DOCUMENT_NOT_FOUND',
+        message: `No reference document "${id}" exists on this site.`,
+        hint: 'Check the id against GET /api/assistant/documents — it may already have been removed.',
+        details: { id },
+    });
+}
+export function createReferenceDocumentStore(db, now = Date.now) {
+    const d = db.dialect;
+    const table = identifier(REFERENCE_DOCUMENTS_TABLE, d);
+    return {
+        async ensureTable() {
+            await db.query(sql `
+        create table if not exists ${table} (
+          id ${idColumn(d)} not null primary key,
+          site_id ${textColumn(d, 500)} not null,
+          filename ${textColumn(d, 300)} not null,
+          format ${textColumn(d, 16)} not null,
+          characters ${integerColumn()} not null,
+          chunk_count ${integerColumn()} not null,
+          status ${textColumn(d, 16)} not null,
+          error_message ${textColumn(d, 2000)},
+          warnings ${textColumn(d, 4000)} not null,
+          uploaded_at ${timestampColumn(d)} not null,
+          uploaded_by ${idColumn(d)},
+          indexed_at ${timestampColumn(d)}
+        )`);
+        },
+        async list(siteId) {
+            // `id` (UUIDv7) breaks a tie on `uploaded_at` in the same direction —
+            // two uploads landing in the same millisecond still sort newest first,
+            // deterministically, rather than by whatever order SQLite feels like.
+            const result = await db.query(sql `
+        select * from ${table} where site_id = ${siteId} order by uploaded_at desc, id desc`);
+            return result.rows.map(toRecord);
+        },
+        async get(siteId, id) {
+            const result = await db.query(sql `
+        select * from ${table} where site_id = ${siteId} and id = ${id}`);
+            const row = result.rows[0];
+            return row === undefined ? null : toRecord(row);
+        },
+        async create(input) {
+            const id = newId(now);
+            const uploadedAt = new Date(now()).toISOString();
+            await db.query(sql `
+        insert into ${table}
+          (id, site_id, filename, format, characters, chunk_count, status,
+           error_message, warnings, uploaded_at, uploaded_by, indexed_at)
+        values (
+          ${id}, ${input.siteId}, ${input.filename}, ${input.format}, ${input.characters}, 0,
+          ${'pending'}, ${null}, ${JSON.stringify([...input.warnings])}, ${uploadedAt},
+          ${input.uploadedBy}, ${null}
+        )`);
+            return {
+                id,
+                siteId: input.siteId,
+                filename: input.filename,
+                format: input.format,
+                characters: input.characters,
+                chunkCount: 0,
+                status: 'pending',
+                errorMessage: null,
+                warnings: input.warnings,
+                uploadedAt,
+                uploadedBy: input.uploadedBy,
+                indexedAt: null,
+            };
+        },
+        async markIndexed(siteId, id, chunkCount, at) {
+            await db.query(sql `
+        update ${table}
+        set status = ${'indexed'}, chunk_count = ${chunkCount}, error_message = ${null}, indexed_at = ${at}
+        where site_id = ${siteId} and id = ${id}`);
+        },
+        async markError(siteId, id, message) {
+            await db.query(sql `
+        update ${table}
+        set status = ${'error'}, error_message = ${message}
+        where site_id = ${siteId} and id = ${id}`);
+        },
+        async remove(siteId, id) {
+            const existing = await db.query(sql `
+        select id from ${table} where site_id = ${siteId} and id = ${id}`);
+            if (existing.rows.length === 0)
+                throw notFound(id);
+            await db.query(sql `delete from ${table} where site_id = ${siteId} and id = ${id}`);
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/rag/reference-documents/store.js.map

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

package/dist/rag/reference-documents/types.d.ts

@@ -0,0 +1,52 @@
+import type { DocumentFormat } from '../../documents/extract-text.js';
+/**
+ * L22 task 4 — "un flux d'upload de documents additionnels", wired onto the
+ * existing extraction → chunking → vectorisation pipeline (L19/L18) rather
+ * than a second one.
+ *
+ * A reference document is not content: it has no collection, no locale
+ * variants, no draft/published lifecycle. It still needs a home in the
+ * vector index so `assist.chat` can retrieve it — `VectorRecord` requires a
+ * `collection`/`entryId`/`locale`/`status` (task 5's `VectorScope`), so this
+ * pseudo-collection name is the answer to "what collection is a reference
+ * document in?".
+ *
+ * `^_` can never collide with a real collection name:
+ * `defineCollection`'s own `COLLECTION_NAME_PATTERN` is
+ * `/^[a-z][a-z0-9_]*$/`, which requires a *letter* first. Starting with an
+ * underscore is therefore a name no `defineCollection` call can ever
+ * produce, on any site, without needing a registry or a reserved-word list
+ * kept in sync by hand.
+ */
+export declare const REFERENCE_DOCUMENT_COLLECTION = "_reference_documents";
+/** `locale` a reference document's chunks are stored under — it has no translations, so one sentinel value stands in for "not localised". */
+export declare const REFERENCE_DOCUMENT_LOCALE = "und";
+/**
+ * `status` a reference document's chunks are stored under. Reusing the
+ * content lifecycle's own `'published'` value (rather than inventing a new
+ * one) is what lets `assist.chat`'s hard-coded `status: 'published'` filter
+ * retrieve it with no change to that tool — a reference document is exactly
+ * as quotable as a published entry, the moment it finishes indexing.
+ */
+export declare const REFERENCE_DOCUMENT_STATUS = "published";
+export declare const REFERENCE_DOCUMENT_STATUSES: readonly ['pending', 'indexed', 'error'];
+export type ReferenceDocumentStatus = (typeof REFERENCE_DOCUMENT_STATUSES)[number];
+export interface ReferenceDocumentRecord {
+    readonly id: string;
+    readonly siteId: string;
+    readonly filename: string;
+    readonly format: DocumentFormat;
+    readonly characters: number;
+    /** Chunks actually embedded and stored. `0` until indexing finishes. */
+    readonly chunkCount: number;
+    readonly status: ReferenceDocumentStatus;
+    /** Set only when `status === 'error'`. */
+    readonly errorMessage: string | null;
+    /** `extractDocumentText`'s own warnings (e.g. "PDF page 4 has no text layer") — shown, never hidden. */
+    readonly warnings: readonly string[];
+    readonly uploadedAt: string;
+    readonly uploadedBy: string | null;
+    /** Set once indexing finishes successfully. */
+    readonly indexedAt: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/reference-documents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rag/reference-documents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,yBAAyB,CAAA;AAEnE,6IAA6I;AAC7I,eAAO,MAAM,yBAAyB,QAAQ,CAAA;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,cAAc,CAAA;AAEpD,eAAO,MAAM,2BAA2B,YAAI,SAAS,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AACnF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAA;AAElF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAA;IACxC,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,wGAAwG;IACxG,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC"}

package/dist/rag/reference-documents/types.js

@@ -0,0 +1,32 @@
+/**
+ * L22 task 4 — "un flux d'upload de documents additionnels", wired onto the
+ * existing extraction → chunking → vectorisation pipeline (L19/L18) rather
+ * than a second one.
+ *
+ * A reference document is not content: it has no collection, no locale
+ * variants, no draft/published lifecycle. It still needs a home in the
+ * vector index so `assist.chat` can retrieve it — `VectorRecord` requires a
+ * `collection`/`entryId`/`locale`/`status` (task 5's `VectorScope`), so this
+ * pseudo-collection name is the answer to "what collection is a reference
+ * document in?".
+ *
+ * `^_` can never collide with a real collection name:
+ * `defineCollection`'s own `COLLECTION_NAME_PATTERN` is
+ * `/^[a-z][a-z0-9_]*$/`, which requires a *letter* first. Starting with an
+ * underscore is therefore a name no `defineCollection` call can ever
+ * produce, on any site, without needing a registry or a reserved-word list
+ * kept in sync by hand.
+ */
+export const REFERENCE_DOCUMENT_COLLECTION = '_reference_documents';
+/** `locale` a reference document's chunks are stored under — it has no translations, so one sentinel value stands in for "not localised". */
+export const REFERENCE_DOCUMENT_LOCALE = 'und';
+/**
+ * `status` a reference document's chunks are stored under. Reusing the
+ * content lifecycle's own `'published'` value (rather than inventing a new
+ * one) is what lets `assist.chat`'s hard-coded `status: 'published'` filter
+ * retrieve it with no change to that tool — a reference document is exactly
+ * as quotable as a published entry, the moment it finishes indexing.
+ */
+export const REFERENCE_DOCUMENT_STATUS = 'published';
+export const REFERENCE_DOCUMENT_STATUSES = ['pending', 'indexed', 'error'];
+//# sourceMappingURL=types.js.map

package/dist/rag/reference-documents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rag/reference-documents/types.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,sBAAsB,CAAA;AAEnE,6IAA6I;AAC7I,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAA;AAEpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA"}

package/dist/runtime/loop.d.ts

@@ -1,11 +1,33 @@
-import type { RunAgentLoopInput, RunResult } from './types.js';
+import type { ProviderToolCall } from '../providers/types.js';
+import type { ExecutableTool, RunAgentLoopInput, RunResult, ToolCallOutcome } from './types.js';
 /**
- * L4 task 2: one model call, tool dispatch, repeat — with the three guards
- * the lot's own "pièges connus" call out by name: a step ceiling, repetition
- * detection, and per-call cost (usage) measured from the first line rather
- * than discovered later. Permission checking (task 4) and budgets (task 8)
- * wrap this from the outside; this loop only knows how to hold a
- * conversation with a model and the tools it was handed.
+ * L24 task 1's whole point, made concrete: this function knows nothing about
+ * autonomy, approval, or audit. It is handed whatever `ExecutableTool` its
+ * caller built, and calls `.execute()` on it — nothing more. Contract C's R4
+ * ("un outil déclare ses permissions ; le runtime les vérifie — jamais un
+ * contrôle d'accès à l'intérieur d'un outil") extends unchanged to the graph
+ * era this way: the *tools* node below (the graph's own "inside a node" —
+ * see the task's own wording) is exactly this function wired to LangGraph,
+ * so it inherits the same "zero permission logic" property by construction.
+ * `packages/agents/test/runtime/loop.test.ts`'s "the graph node has no gate
+ * of its own" test calls this directly, once with a tool `withAutonomy`
+ * never touched (to show it *would* run unguarded) and once with the same
+ * tool wrapped (to show the run this package actually produces never can) —
+ * proving the gate lives in the tool object handed in, not in this function.
+ */
+export declare function runTool(tool: ExecutableTool | undefined, call: ProviderToolCall, signal: AbortSignal): Promise<ToolCallOutcome>;
+/**
+ * L4 task 2, migrated to LangGraph.js (L24 task 1): one model call, tool
+ * dispatch, repeat — with the same three guards as before (a step ceiling,
+ * repetition detection, per-call cost measured from the first line), now run
+ * as a two-node `StateGraph` (`buildAgentGraph` above) instead of a `for`
+ * loop. The public contract — `RunAgentLoopInput` in, `RunResult` out — is
+ * unchanged, so every existing caller (`agents/orchestrator.ts`,
+ * `subagents/run-subagent.ts`, `tools/core/agent-delegate.ts`,
+ * `assist/runtime.ts`, `eval/run-suite.ts`) needed no change at all.
+ * Permission checking (task 4, now `withAutonomy`) and budgets (task 8)
+ * still wrap this from the outside; this module still only knows how to
+ * hold a conversation with a model and the tools it was handed.
  */
 export declare function runAgentLoop(input: RunAgentLoopInput): Promise<RunResult>;
 //# sourceMappingURL=loop.d.ts.map

package/dist/runtime/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/runtime/loop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,iBAAiB,EACjB,SAAS,EAGV,MAAM,YAAY,CAAA;AAkCnB;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoG/E"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/runtime/loop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,gBAAgB,EAAc,MAAM,uBAAuB,CAAA;AAGtF,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,SAAS,EAGT,eAAe,EAChB,MAAM,YAAY,CAAA;AAqBnB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CAU1B;AA0MD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAyC/E"}