@codenotch/process 0.1.4 → 0.1.5

package/dist/types/lib/connectors.d.ts

@@ -234,9 +234,31 @@ export interface PaymentHandle {
      */
     chargeSavedMethod(request: ChargeRequest, opts?: ActivityOptions): Promise<ChargeResult>;
 }
+/**
+ * A file the model reads: by reference ({ renderingId } — a ctx.render.pdf result works
+ * as-is), the server resolves the bytes at call time and they never travel through the
+ * process; inline bytes ride the journal base64-encoded — keep them small, big documents
+ * belong in renderings. Accepted media types: image/* and application/pdf, each gated on
+ * the bound provider's input capabilities.
+ */
+export type LlmFile = {
+    renderingId: string;
+} | {
+    mediaType: string;
+    bytes: Uint8Array;
+    fileName?: string;
+};
+/** One piece of a message: text, or a file the model reads alongside it. */
+export type LlmContentPart = {
+    type: 'text';
+    text: string;
+} | ({
+    type: 'file';
+} & LlmFile);
 export interface LlmMessage {
     role: 'user' | 'assistant';
-    content: string;
+    /** Plain text, or an ordered part array. File parts belong in user messages. */
+    content: string | LlmContentPart[];
 }
 export interface LlmUsage {
     inputTokens: number;
@@ -246,6 +268,11 @@ export type LlmStopReason = 'end' | 'maxTokens' | 'refusal';
 export interface LlmRequest {
     /** One user message — the simple form. Exactly one of prompt and messages. */
     prompt?: string;
+    /**
+     * Files the model reads with the prompt (they precede it) — prompt-form only; the
+     * messages form places files as content parts.
+     */
+    files?: LlmFile[];
     /** The full conversation, for multi-turn flows the process assembles itself. */
     messages?: LlmMessage[];
     system?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codenotch/process",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Types and standard library for Codenotch script processes. Processes execute on the server only: the engine embeds the compiled runtime (dist/prelude.js); this package distributes the type declarations.",
   "repository": {
     "type": "git",