@ogygie/core 0.21.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygie/core",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Ogygie framework core: manifest/spec/error schemas, generic tenancy and gate tooling. Ships TypeScript sources — Ogygie products run tsx/vitest by construction (D1).",
   "license": "MIT",
   "repository": {

package/src/model.test.ts

@@ -21,6 +21,17 @@ function fakeApi(answer: { status?: number; body: unknown }) {
 const OK = { content: [{ type: "text", text: "hello" }, { type: "thinking", thinking: "" }], stop_reason: "end_turn", model: "claude-opus-5-5", usage: { input_tokens: 12, output_tokens: 3 } };
 
 describe("createMessagesClient", () => {
+  it("ÉTANT DONNÉ un message en blocs (texte puis document PDF) ALORS il part tel quel : le modèle lit le document nativement", async () => {
+    const api = fakeApi({ body: OK });
+    const client = createMessagesClient({ apiKey: "k", fetchImpl: api.fetchImpl });
+    const content = [
+      { type: "text" as const, text: "lis la pièce" },
+      { type: "document" as const, source: { type: "base64" as const, media_type: "application/pdf" as const, data: "JVBERi0=" }, title: "cahier.pdf" },
+    ];
+    await client.complete({ model: "m", system: "s", messages: [{ role: "user", content }] });
+    expect(api.calls[0]?.body["messages"]).toEqual([{ role: "user", content }]);
+  });
+
   it("ÉTANT DONNÉ une complétion ALORS la requête porte clé, version, modèle, bloc system mis en cache, messages, effort ; le texte, le stop et l'usage reviennent", async () => {
     const api = fakeApi({ body: OK });
     const client = createMessagesClient({ apiKey: "sk-test", fetchImpl: api.fetchImpl });

package/src/model.ts

@@ -15,9 +15,25 @@
  */
 import { throwOgygieError } from "./error.schema.js";
 
+/** A text part of a message. */
+export interface ModelTextBlock {
+  type: "text";
+  text: string;
+}
+
+/** A document the model reads natively — a PDF, passed as it was received, never written anywhere. */
+export interface ModelDocumentBlock {
+  type: "document";
+  source: { type: "base64"; media_type: "application/pdf"; data: string };
+  title?: string;
+}
+
+export type ModelContentBlock = ModelTextBlock | ModelDocumentBlock;
+
 export interface ModelMessage {
   role: "user" | "assistant";
-  content: string;
+  /** Plain text, or blocks when a message carries documents; passed to the API as is. */
+  content: string | ModelContentBlock[];
 }
 
 export interface ModelCompletionInput {