@fugood/buttress-server 2.25.11 → 2.25.12

package/lib/routes/openai-decisions.d.ts

@@ -0,0 +1,97 @@
+/**
+ * OpenAI Decisions API (`POST /v1/decisions`) <-> native decision requests.
+ *
+ * Spec: https://developers.openai.com/api/docs/guides/decisions
+ *
+ * The native request follows the TypeSafe `/v1/systemone` contract, so the
+ * question types map one to one: `predicate` -> `noul`, `choice` -> `choice`,
+ * `score` -> `score`. What differs is the shape: OpenAI sends an ordered array
+ * of optionally named questions with typed choice values and returns an
+ * ordered array of answers; native keys questions and options by string.
+ * The local models never refuse, so no `refusal` answer is produced.
+ */
+import type { DecisionRequest, DecisionResult } from '../types';
+type ChoiceValue = string | boolean;
+type QuestionPlan = {
+    id: string;
+    name: string | null;
+    type: 'predicate';
+} | {
+    id: string;
+    name: string | null;
+    type: 'choice';
+    options: {
+        key: string;
+        value: ChoiceValue;
+    }[];
+} | {
+    id: string;
+    name: string | null;
+    type: 'score';
+    labels: string[];
+};
+export type DecisionPlan = {
+    questions: QuestionPlan[];
+};
+export declare class DecisionRequestError extends Error {
+    param: string | null;
+    constructor(param: string | null, message: string);
+}
+/**
+ * Validate an OpenAI decision request and convert it to the native one.
+ * Throws a DecisionRequestError naming the offending field.
+ */
+export declare const toNativeDecisionRequest: (body: unknown) => {
+    model: string;
+    request: DecisionRequest;
+    plan: DecisionPlan;
+};
+/** Convert a native result to an OpenAI `Decision` object, answers in request order. */
+export declare const toOpenAIDecision: (result: DecisionResult, plan: DecisionPlan, model: string) => {
+    model: string;
+    answers: ({
+        type: string;
+        name: string | null;
+        probability: number;
+        choice?: undefined;
+        score?: undefined;
+        probabilities?: undefined;
+        confidence?: undefined;
+    } | {
+        probability?: undefined;
+        type: string;
+        name: string | null;
+        choice: any;
+        probabilities: {
+            value: ChoiceValue;
+            probability: number;
+        }[];
+        confidence: number;
+        score?: undefined;
+    } | {
+        probability?: undefined;
+        choice?: undefined;
+        type: string;
+        name: string | null;
+        score: number;
+        probabilities: {
+            value: number;
+            label: string;
+            probability: number;
+        }[];
+        confidence: number;
+    })[];
+    usage: {
+        input_tokens: number;
+        input_tokens_details: {
+            cached_tokens: number;
+            cache_write_tokens: number;
+        };
+        output_tokens: number;
+        output_tokens_details: {
+            reasoning_tokens: number;
+        };
+        total_tokens: number;
+    };
+};
+export {};

package/lib/routes/tts-shared.d.ts

@@ -25,6 +25,11 @@ export type SynthesizeBackendResult = {
      * — callers that need the audio beyond the immediate request must copy it.
      */
     cachedFile: string;
+    /**
+     * The cache did not keep this output: `cachedFile` is a per-synthesis temporary
+     * file that the caller owns and must delete.
+     */
+    temporary?: boolean;
     sampling_rate: number;
     channels: number;
 };

package/lib/routes/typesafe-compat.check.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/routes/typesafe-compat.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TypeSafe-compatible System One API (EXPERIMENTAL)
+ *
+ * Serves `/typesafe-compat/v1/systemone` and `/typesafe-compat/v1/models` in
+ * the shape of the hosted TypeSafe API (https://docs.typesafe.ai/api), so the
+ * TypeSafe SDKs reach this server's decision generators with
+ * `TYPESAFE_BASE_URL=http://<host>:<port>/typesafe-compat` — the same way
+ * they reach OpenRouter's System One API under its own path.
+ *
+ * Enable via TOML config: [typesafe_compat] enabled = true
+ *
+ * `model` selects a configured decision generator by its published id. An
+ * unknown model is rejected, never substituted: another model answers with
+ * different calibration, which the caller cannot detect.
+ */
+type ValidationIssue = {
+    loc: (string | number)[];
+    msg: string;
+    type: string;
+};
+/**
+ * Structural checks with the hosted API's limits. llama.node validates the
+ * questions again and has the final word; these catch what it reports less
+ * precisely, with the field location the SDKs print.
+ */
+export declare const validateSystemOneRequest: (body: any) => ValidationIssue[];
+/** Published ids of the configured decision generators, in config order. */
+export declare const decisionModelIds: (config: any) => string[];
+export default function factory(): import("../types").ButtressApp;
+export {};

package/lib/services/ggml-decision.d.ts

@@ -1,33 +1,70 @@
 import { z } from 'zod';
 import type { ReadableStream } from 'node:stream/web';
 import type { DecisionResult, ServiceContext, EventStream, Expand } from '../types';
+export declare const decideProperty: z.ZodObject<{
+    request: z.ZodObject<{
+        state: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnknown, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+        questions: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        state?: string | unknown[] | Record<string, unknown> | null | undefined;
+        questions: Record<string, Record<string, unknown>>;
+        images?: string[] | undefined;
+        files?: string[] | undefined;
+    }, {
+        state?: string | unknown[] | Record<string, unknown> | null | undefined;
+        questions: Record<string, Record<string, unknown>>;
+        images?: string[] | undefined;
+        files?: string[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    request: {
+        state?: string | unknown[] | Record<string, unknown> | null | undefined;
+        questions: Record<string, Record<string, unknown>>;
+        images?: string[] | undefined;
+        files?: string[] | undefined;
+    };
+}, {
+    request: {
+        state?: string | unknown[] | Record<string, unknown> | null | undefined;
+        questions: Record<string, Record<string, unknown>>;
+        images?: string[] | undefined;
+        files?: string[] | undefined;
+    };
+}>;
 export declare const schemas: {
     initContext: z.ZodTuple<[z.ZodString, z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>], null>;
     decide: z.ZodTuple<[z.ZodString, z.ZodObject<{
         request: z.ZodObject<{
-            state: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnknown, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+            state: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnknown, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
             questions: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
-            state: string | unknown[] | Record<string, unknown>;
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
             questions: Record<string, Record<string, unknown>>;
             images?: string[] | undefined;
+            files?: string[] | undefined;
         }, {
-            state: string | unknown[] | Record<string, unknown>;
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
             questions: Record<string, Record<string, unknown>>;
             images?: string[] | undefined;
+            files?: string[] | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         request: {
-            state: string | unknown[] | Record<string, unknown>;
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
             questions: Record<string, Record<string, unknown>>;
             images?: string[] | undefined;
+            files?: string[] | undefined;
         };
     }, {
         request: {
-            state: string | unknown[] | Record<string, unknown>;
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
             questions: Record<string, Record<string, unknown>>;
             images?: string[] | undefined;
+            files?: string[] | undefined;
         };
     }>], null>;
     releaseContext: z.ZodTuple<[z.ZodString], null>;
@@ -40,5 +77,15 @@ export interface Service {
         alreadyReleased?: boolean;
     }>;
 }
+/**
+ * Clients upload local media (images, audio clips) first, like STT audio,
+ * and send their names; data URLs pass through.
+ */
+export declare const resolveDecisionMedia: (session: ServiceContext['session'], request: z.infer<typeof decideProperty>['request']) => {
+    state?: string | unknown[] | Record<string, unknown> | null | undefined;
+    questions: Record<string, Record<string, unknown>>;
+    images: string[] | undefined;
+    files: string[] | undefined;
+};
 declare const _default: Service;
 export default _default;

package/lib/services/ggml-llm.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { type Service as LlmService } from './create-llm-service';
-import type { ServiceContext } from '../types';
+import type { DecisionResult, ServiceContext } from '../types';
 export declare const schemas: {
     initContext: z.ZodTuple<[z.ZodString, z.ZodOptional<z.ZodAny>], null>;
     completion: z.ZodTuple<[z.ZodString, z.ZodOptional<z.ZodAny>], null>;
@@ -9,9 +9,42 @@ export declare const schemas: {
     applyChatTemplate: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
     releaseContext: z.ZodTuple<[z.ZodString], null>;
     embedding: z.ZodTuple<[z.ZodString, z.ZodAny], null>;
+    decide: z.ZodTuple<[z.ZodString, z.ZodObject<{
+        request: z.ZodObject<{
+            state: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnknown, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+            questions: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
+            questions: Record<string, Record<string, unknown>>;
+            images?: string[] | undefined;
+            files?: string[] | undefined;
+        }, {
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
+            questions: Record<string, Record<string, unknown>>;
+            images?: string[] | undefined;
+            files?: string[] | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        request: {
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
+            questions: Record<string, Record<string, unknown>>;
+            images?: string[] | undefined;
+            files?: string[] | undefined;
+        };
+    }, {
+        request: {
+            state?: string | unknown[] | Record<string, unknown> | null | undefined;
+            questions: Record<string, Record<string, unknown>>;
+            images?: string[] | undefined;
+            files?: string[] | undefined;
+        };
+    }>], null>;
 };
 export interface Service extends LlmService {
     embedding: (ctx: ServiceContext, ...args: z.infer<typeof schemas.embedding>) => Promise<any>;
+    decide: (ctx: ServiceContext, ...args: z.infer<typeof schemas.decide>) => Promise<DecisionResult>;
 }
 declare const _default: Service;
 export default _default;

package/lib/services/register-tts-result.d.ts

@@ -0,0 +1,4 @@
+import type { SessionFileManager } from '../utils/SessionFileManager';
+import type { SynthesizeBackendResult } from '../routes/tts-shared';
+/** Register a backend synthesis result with the session and return its filename. */
+export default function registerTtsResult(fileManager: SessionFileManager, result: SynthesizeBackendResult): string;

package/lib/{tui-Bl2ADqOw.mjs → tui-Bxeb1d7E.mjs}

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{a as e,t}from"./client-DEUSDK5d.mjs";import{Container as n,Editor as r,Loader as i,Markdown as a,ProcessTerminal as o,Text as s,TuiMainScreen as c}from"@earendil-works/pi-tui";const l=e=>t=>`\x1b[${e}m${t}\x1b[0m`,u=l(`2`),d=l(`1`),f=l(`36`),p=l(`33`),m=l(`31`),h=l(`32`),g=l(`35`),_={heading:e=>d(f(e)),link:f,linkUrl:e=>u(f(e)),code:p,codeBlock:p,codeBlockBorder:u,quote:u,quoteBorder:u,hr:u,listBullet:f,bold:d,italic:l(`3`),strikethrough:l(`9`),underline:l(`4`)},v={borderColor:u,selectList:{selectedPrefix:f,selectedText:d,description:u,scrollInfo:u,noMatch:u}},y=(e,t)=>e.length>t?`${e.slice(0,t)}…`:e;var b=class{tui;chat;thinking=null;thinkingBuffer=``;answer=null;answerBuffer=``;constructor(e,t){this.tui=e,this.chat=t}touch(){this.tui.requestRender()}appendThinking(e){this.thinking||(this.thinking=new s(``,0,0),this.chat.addChild(this.thinking)),this.thinkingBuffer+=e,this.thinking.setText(u(this.thinkingBuffer.trimEnd())),this.touch()}appendAnswer(e){this.answer||(this.answer=new a(``,0,0,_),this.chat.addChild(this.answer)),this.answerBuffer+=e,this.answer.setText(this.answerBuffer),this.touch()}addLine(e){this.answer=null,this.answerBuffer=``,this.chat.addChild(new s(e,0,0)),this.touch()}};const x=async({connection:a,agentName:l,sessionId:_,fork:x})=>{let S=new o,C=new c(S);S.setTitle(`buttress agent · ${l}`);let w=new n,T=new s(``,0,0),E=new r(C,v);C.addChild(w),C.addChild(T),C.addChild(E),C.setFocus(E);let D=_,O=x,k=null,A=null,j=e=>{T.setText(e),C.requestRender()},M=()=>{A||(A=new i(C,f,u,`thinking…`),w.addChild(A),C.requestRender())},N=()=>{A&&(w.removeChild(A),A=null,C.requestRender())},P=`${d(l)} ${u(`@ ${a.baseUrl}`)}`+(D?` ${u(`(${O?`forking`:`continuing`} ${D})`)}`:``);w.addChild(new s(P,0,0)),j(u(`Enter to send · /new fresh session · /exit or Ctrl+C to quit`));let F=async()=>{C.stop(),await S.drainInput().catch(()=>{}),process.exit(0)};C.addInputListener(e=>{if(e===``)return k?(k.abort(),k=null,{consume:!0}):(F(),{consume:!0})});let I=async n=>{w.addChild(new s(`${f(`>`)} ${n}`,0,0));let r=new b(C,w),i=D;k=new AbortController,M(),j(u(`running · Ctrl+C aborts this turn`));let o;try{o=await e(a,l,{prompt:n,sessionId:D??void 0,fork:O},{signal:k.signal,onFrame:({event:e,payload:t})=>{if(e===`session`&&t?.sessionId){t.sessionId!==D&&(D=t.sessionId,w.addChild(new s(u(`session ${D}`),0,0)));return}if(e!==`agent`)return;N();let n=t?.event;if(t?.type===`message_update`&&n)n.type===`thinking_delta`?r.appendThinking(n.delta??``):n.type===`text_delta`&&r.appendAnswer(n.delta??``);else if(t?.type===`tool_execution_start`){let e=JSON.stringify(t.args??{});r.addLine(`${p(`⚙ ${t.toolName}`)}${u(`(${y(e,120)})`)}`)}else t?.type===`tool_execution_end`?r.addLine(t.isError?m(`✗ ${t.toolName} failed`):u(`✓ ${t.toolName}`)):t?.type===`tool_emit`&&r.addLine(u(`  ${t.toolName} → ${t.event}`))}})}catch(e){o={kind:`error`,message:e?.message||String(e),sessionId:D}}if(N(),k=null,o.kind===`result`){let{result:e}=o;D=e.sessionId??D;let t=e.usage||{};w.addChild(new s(u(`— ${e.stopReason} · ${t.totalTurns??`?`} turn(s) · ${t.input??0} in / ${t.output??0} out · session ${D}`),0,0))}else o.kind===`aborted`?(D=o.sessionId??D,w.addChild(new s(p(`(aborted — session is continuable)`),0,0))):o.kind===`error`?(D=o.sessionId??D,w.addChild(new s(m(`Run failed: ${o.message}`),0,0))):w.addChild(new s(m(`Connection lost mid-run.`),0,0));t(i,D)&&(O=!1),j(u(`Enter to send · /new fresh session · /exit or Ctrl+C to quit`)),C.requestRender()};E.onSubmit=e=>{let t=e.trim();if(E.setText(``),t){if(k){j(p(`A turn is still running — Ctrl+C aborts it.`));return}if(t===`/exit`||t===`/quit`){F();return}if(t===`/new`){D=null,O=!1,w.addChild(new s(`${h(`•`)} ${u(`started a fresh session`)}`,0,0)),C.requestRender();return}if(t===`/session`){w.addChild(new s(u(D?`session ${D}`:`no session yet`),0,0)),C.requestRender();return}I(t)}},w.addChild(new s(u(g(`ready`)),0,0)),C.start(),await new Promise(()=>{})};export{x as runAgentTui};
+import{a as e,t}from"./client-BVyIuSyr.mjs";import{Container as n,Editor as r,Loader as i,Markdown as a,ProcessTerminal as o,Text as s,TuiMainScreen as c}from"@earendil-works/pi-tui";const l=e=>t=>`\x1b[${e}m${t}\x1b[0m`,u=l(`2`),d=l(`1`),f=l(`36`),p=l(`33`),m=l(`31`),h=l(`32`),g=l(`35`),_={heading:e=>d(f(e)),link:f,linkUrl:e=>u(f(e)),code:p,codeBlock:p,codeBlockBorder:u,quote:u,quoteBorder:u,hr:u,listBullet:f,bold:d,italic:l(`3`),strikethrough:l(`9`),underline:l(`4`)},v={borderColor:u,selectList:{selectedPrefix:f,selectedText:d,description:u,scrollInfo:u,noMatch:u}},y=(e,t)=>e.length>t?`${e.slice(0,t)}…`:e;var b=class{tui;chat;thinking=null;thinkingBuffer=``;answer=null;answerBuffer=``;constructor(e,t){this.tui=e,this.chat=t}touch(){this.tui.requestRender()}appendThinking(e){this.thinking||(this.thinking=new s(``,0,0),this.chat.addChild(this.thinking)),this.thinkingBuffer+=e,this.thinking.setText(u(this.thinkingBuffer.trimEnd())),this.touch()}appendAnswer(e){this.answer||(this.answer=new a(``,0,0,_),this.chat.addChild(this.answer)),this.answerBuffer+=e,this.answer.setText(this.answerBuffer),this.touch()}addLine(e){this.answer=null,this.answerBuffer=``,this.chat.addChild(new s(e,0,0)),this.touch()}};const x=async({connection:a,agentName:l,sessionId:_,fork:x})=>{let S=new o,C=new c(S);S.setTitle(`buttress agent · ${l}`);let w=new n,T=new s(``,0,0),E=new r(C,v);C.addChild(w),C.addChild(T),C.addChild(E),C.setFocus(E);let D=_,O=x,k=null,A=null,j=e=>{T.setText(e),C.requestRender()},M=()=>{A||(A=new i(C,f,u,`thinking…`),w.addChild(A),C.requestRender())},N=()=>{A&&(w.removeChild(A),A=null,C.requestRender())},P=`${d(l)} ${u(`@ ${a.baseUrl}`)}`+(D?` ${u(`(${O?`forking`:`continuing`} ${D})`)}`:``);w.addChild(new s(P,0,0)),j(u(`Enter to send · /new fresh session · /exit or Ctrl+C to quit`));let F=async()=>{C.stop(),await S.drainInput().catch(()=>{}),process.exit(0)};C.addInputListener(e=>{if(e===``)return k?(k.abort(),k=null,{consume:!0}):(F(),{consume:!0})});let I=async n=>{w.addChild(new s(`${f(`>`)} ${n}`,0,0));let r=new b(C,w),i=D;k=new AbortController,M(),j(u(`running · Ctrl+C aborts this turn`));let o;try{o=await e(a,l,{prompt:n,sessionId:D??void 0,fork:O},{signal:k.signal,onFrame:({event:e,payload:t})=>{if(e===`session`&&t?.sessionId){t.sessionId!==D&&(D=t.sessionId,w.addChild(new s(u(`session ${D}`),0,0)));return}if(e!==`agent`)return;N();let n=t?.event;if(t?.type===`message_update`&&n)n.type===`thinking_delta`?r.appendThinking(n.delta??``):n.type===`text_delta`&&r.appendAnswer(n.delta??``);else if(t?.type===`tool_execution_start`){let e=JSON.stringify(t.args??{});r.addLine(`${p(`⚙ ${t.toolName}`)}${u(`(${y(e,120)})`)}`)}else t?.type===`tool_execution_end`?r.addLine(t.isError?m(`✗ ${t.toolName} failed`):u(`✓ ${t.toolName}`)):t?.type===`tool_emit`&&r.addLine(u(`  ${t.toolName} → ${t.event}`))}})}catch(e){o={kind:`error`,message:e?.message||String(e),sessionId:D}}if(N(),k=null,o.kind===`result`){let{result:e}=o;D=e.sessionId??D;let t=e.usage||{};w.addChild(new s(u(`— ${e.stopReason} · ${t.totalTurns??`?`} turn(s) · ${t.input??0} in / ${t.output??0} out · session ${D}`),0,0))}else o.kind===`aborted`?(D=o.sessionId??D,w.addChild(new s(p(`(aborted — session is continuable)`),0,0))):o.kind===`error`?(D=o.sessionId??D,w.addChild(new s(m(`Run failed: ${o.message}`),0,0))):w.addChild(new s(m(`Connection lost mid-run.`),0,0));t(i,D)&&(O=!1),j(u(`Enter to send · /new fresh session · /exit or Ctrl+C to quit`)),C.requestRender()};E.onSubmit=e=>{let t=e.trim();if(E.setText(``),t){if(k){j(p(`A turn is still running — Ctrl+C aborts it.`));return}if(t===`/exit`||t===`/quit`){F();return}if(t===`/new`){D=null,O=!1,w.addChild(new s(`${h(`•`)} ${u(`started a fresh session`)}`,0,0)),C.requestRender();return}if(t===`/session`){w.addChild(new s(u(D?`session ${D}`:`no session yet`),0,0)),C.requestRender();return}I(t)}},w.addChild(new s(u(g(`ready`)),0,0)),C.start(),await new Promise(()=>{})};export{x as runAgentTui};

package/lib/types.d.ts

@@ -29,12 +29,20 @@ export type RuntimeConfig = {
 export type GeneratorType = 'ggml-llm' | 'ggml-stt' | 'ggml-tts' | 'ggml-decision' | 'mlx-llm' | 'onnx-stt' | 'onnx-tts';
 /** A TypeSafe `/v1/systemone` request, answered by a `ggml-decision` generator. */
 export type DecisionRequest = {
-    /** A string, or any JSON object/array (given to the model as JSON text). */
+    /**
+     * A string, or any JSON object/array (given to the model as JSON text).
+     * `null` asks about the media only (`lfm2-d1`, `lfm2-d1-omni`); it needs media.
+     */
     state: unknown;
     /** Question id → `{ type: 'choice' | 'score' | 'noul', instructions, criteria }`. */
     questions: Record<string, Record<string, any>>;
-    /** Local file paths or data URLs; needs a model with an mmproj configured. */
+    /**
+     * Images, or audio clips for a model that takes audio, as local file paths
+     * or data URLs; needs a model with an mmproj configured.
+     */
     images?: string[];
+    /** Alias of `images`; both lists are used. */
+    files?: string[];
 };
 export type DecisionResult = {
     model: string;
@@ -58,6 +66,10 @@ export type GlobalConfig = {
         enabled?: boolean;
         cors_allowed_origins?: string | string[];
     };
+    typesafe_compat?: {
+        enabled?: boolean;
+        cors_allowed_origins?: string | string[];
+    };
     functions?: {
         enabled?: boolean;
         /** Directory holding local function files, relative to the config file. */

package/lib/utils/SessionFileManager.d.ts

@@ -1,16 +1,24 @@
 import type { ReadableStream as NodeReadableStream } from 'node:stream/web';
+type RegisterOptions = {
+    owned?: boolean;
+    ttl?: number;
+    group?: {
+        name: string;
+        limit: number;
+    };
+};
 type UploadData = Buffer | ArrayBuffer | ReadableStream | NodeReadableStream;
 export declare class SessionFileManager {
     sessionId: string;
     private sessionDir;
     private registry;
     private uploadSeq;
+    private destroyed;
     constructor(sessionId: string, tempDir: string);
-    register(filename: string, realPath: string, opts?: {
-        owned?: boolean;
-        ttl?: number;
-    }): void;
+    register(filename: string, realPath: string, opts?: RegisterOptions): void;
     resolve(filename: string): string | null;
+    private release;
+    private trimGroup;
     storeUpload(originalName: string, data: UploadData): Promise<string>;
     destroy(): Promise<void>;
 }

package/lib/utils/cors.d.ts

@@ -56,6 +56,7 @@ export type CorsPolicy = {
 export declare const buildCorsPolicies: (config: Config, enabled?: {
     openaiCompat?: boolean;
     anthropicMessages?: boolean;
+    typesafeCompat?: boolean;
     functions?: boolean;
 }) => CorsPolicy[];
 /**

package/lib/utils/decision-sharing.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Decision models that share an LLM generator's context.
+ *
+ * A model that both generates and answers typed decisions (Jevling, for one)
+ * is often configured twice: as a `ggml-llm` and as a `ggml-decision`. With
+ * `[generators.backend] share_llm_context = true` on the decision entry, and
+ * both entries naming the same weights, decisions run on the LLM's context
+ * (`parallel.decide()` on a slot beside its completions) instead of loading
+ * the weights a second time. The LLM config always loads the model, so the
+ * result does not depend on which generator starts first.
+ *
+ * It is opt-in because it trades throughput for memory: a decision takes one
+ * of the LLM's `n_parallel` slots, and its forward passes run in the slot
+ * loop between two shared batches, so concurrent completions stop generating
+ * while it runs (a 128-token completion took 2x as long beside six decisions,
+ * unchanged with a separate decision context). Results are not affected: the
+ * slot's sequence and prompt cache are cleared after each decision.
+ *
+ * Sharing is skipped when the decision needs a context the LLM cannot give:
+ * rank pooling (an embedding context), or a different projector.
+ */
+/**
+ * The configured `ggml-llm` generator whose context serves this configured
+ * decision generator, or null. For a client's request use
+ * `findSharedLlmForClient`: the opt-in must come from the server config.
+ */
+export declare const findSharedLlmGenerator: (config: any, decisionConfig: any) => any | null;
+/**
+ * The shared LLM for a decision generator a client starts over RPC, or null.
+ * Sharing needs a configured `ggml-decision` entry with the same weights that
+ * opted in; the client's own `share_llm_context` is ignored, since it would
+ * let a client put its decisions on the LLM's slots. The client's merged
+ * model (rank pooling, projector) still decides whether the LLM can serve it.
+ */
+export declare const findSharedLlmForClient: (config: any, clientModel: any) => any | null;
+/** Startup report: which decision generators share an LLM, and why others do not. */
+export declare const describeDecisionSharing: (config: any) => string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugood/buttress-server",
-  "version": "2.25.11",
+  "version": "2.25.12",
   "main": "lib/index.mjs",
   "types": "lib/index.d.ts",
   "type": "module",
@@ -37,13 +37,13 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@earendil-works/pi-agent-core": "^1.0.0",
-    "@earendil-works/pi-ai": "1.0.0",
-    "@earendil-works/pi-tui": "^1.0.0",
+    "@earendil-works/pi-agent-core": "^1.1.0",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-tui": "^1.1.0",
     "@elysiajs/cors": "^1.1.1",
     "@elysiajs/node": "^1.4.2",
-    "@fugood/llama.node": "^1.8.0-rc.9",
-    "@fugood/whisper.node": "^1.2.0-rc.0",
+    "@fugood/llama.node": "^1.8.0-rc.10",
+    "@fugood/whisper.node": "^1.2.0-rc.1",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
@@ -70,7 +70,7 @@
   },
   "devDependencies": {
     "@fugood/agent-tool-runtime": "^2.25.10",
-    "@fugood/bricks-cli": "^2.25.11",
+    "@fugood/bricks-cli": "^2.25.12",
     "@fugood/bricks-devtools-core": "^2.25.5",
     "tsdown": "^0.22.4",
     "typescript": "^7.0.2"