@oh-my-pi/pi-ai 18.12.0 → 18.12.2

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [Unreleased]
 
+## [18.12.2] - 2026-10-18
+
+### Added
+
+- Added `nativeJudgmentImageBounds()`: the image bounds a native judge enforces, its wire's transport limits tightened by the catalog's model bounds
+- Added Box judgment questions (`BoxQuestion`/`BoxAnswer`, TypeSafe Jev 1.14+ direct or through OpenRouter): each names the request image it searches by `image` index, and comes back as that image's edges as 0–1 fractions; text, OpenAI Decisions, and Workers AI judges reject them
+
+### Fixed
+
+- Fixed Muse Code usage going stale whenever its 5-hour window sits idle: the idle window now reports as unused, and weekly usage carries over from the last active window until its reset ([#16193](https://github.com/can1357/oh-my-pi/pull/16193) by [@eggpeat](https://github.com/eggpeat))
+- Fixed DeepSeek tool calls never running when the model writes them as chat-template tokens with `_` in place of `▁`, a missing `｜`, or no per-call close (e.g. `<｜tool_calls_begin｜>…<｜tool_calls_end｜>`): they now run as tool calls, and any that still cannot be parsed are removed from history and reported to the model as a failed call ([#16216](https://github.com/can1357/oh-my-pi/pull/16216) by [@H4vC](https://github.com/H4vC))
+
+## [18.12.1] - 2026-10-17
+
+### Fixed
+
+- Fixed every request failing behind a TLS-inspecting proxy that refuses compressed uploads: a 400/403/415 whose body is not JSON, or the Anthropic API's "request body is not valid JSON" after a proxy drops `Content-Encoding`, now resends the body uncompressed and stops compressing for that host ([#16108](https://github.com/can1357/oh-my-pi/pull/16108) by [@alphastorm](https://github.com/alphastorm))
+
 ## [18.12.0] - 2026-10-17
 
 ### Breaking Changes
@@ -2336,25 +2354,4 @@
 
 - Removed the `partial-json` dependency; streaming JSON parsing now uses the in-house `RelaxedJson` parser.
 
-## [16.1.9] - 2026-06-21
-
-### Added
-
-- Added `llama.cpp` to the interactive `/login` provider list, accepting an optional API key while defaulting to local no-auth mode.
-
-### Changed
-
-- Optimized generated AI tool schemas by collapsing verbose `anyOf` unions into standard `enum` types
-
-### Fixed
-
-- Fixed tool-call argument validation dropping nested keys that were accidentally double-encoded
-- Fixed the `moonshot` provider being locked to the international Kimi host (`api.moonshot.ai`): OpenAI-completions requests now honor a `MOONSHOT_BASE_URL` override so users can reach the Kimi China platform (`api.moonshot.cn`), which rejects keys issued for the international endpoint. ([#2883](https://github.com/can1357/oh-my-pi/issues/2883))
-- Fixed tool-call argument validation dropping fields whose object keys were accidentally JSON-encoded a second time (e.g. `{ "\"op\"": "done" }`), which surfaced as spurious missing-required errors. A schema-agnostic pre-validation pass now recursively unwraps such double-encoded keys — through arrays and nested objects, and again after a JSON-string container is parsed — before the unrecognized-key repair can delete them.
-
-### Removed
-
-- Removed the `setNextRequestDebugPath`, `clearNextRequestDebugPath`, and `getNextRequestDebugPath` utility functions for request debugging, as request/response recording now relies exclusively on the `PI_REQ_DEBUG` environment variable.
-- Removed Wafer Pass (`wafer-pass`) login support; Wafer Serverless remains available as `wafer-serverless`.
-
-Older entries are archived in [packages/ai/CHANGELOG.md@50ec66f75d57](https://github.com/can1357/oh-my-pi/blob/50ec66f75d57ad55838a9fe4da5e66f29af4d73c/packages/ai/CHANGELOG.md).
+Older entries are archived in [packages/ai/CHANGELOG.md@bb602d67c9b6](https://github.com/can1357/oh-my-pi/blob/bb602d67c9b685535bbf8ef1a1cc9de3c944ede4/packages/ai/CHANGELOG.md).

package/dist/types/dialect/deepseek.d.ts

@@ -4,6 +4,19 @@ export declare const DEEPSEEK_TOOL_CALLS_END = "<\uFF5Ctool\u2581calls\u2581end\
 export declare const DEEPSEEK_TOOL_CALL_BEGIN = "<\uFF5Ctool\u2581call\u2581begin\uFF5C>";
 export declare const DEEPSEEK_TOOL_CALL_END = "<\uFF5Ctool\u2581call\u2581end\uFF5C>";
 export declare const DEEPSEEK_TOOL_SEPARATOR = "<\uFF5Ctool\u2581sep\uFF5C>";
+/** DeepSeek template tokens that structure a tool call. */
+export declare const DEEPSEEK_TOOL_CALL_TOKENS: Readonly<Record<string, true>>;
+/** A token found in text: its canonical spelling and the text actually written. */
+export interface DeepSeekTokenMatch {
+    readonly token: string;
+    readonly raw: string;
+    readonly index: number;
+}
+/**
+ * Find the earliest of `tokens` in `text` at or after `from`, in its canonical
+ * spelling or any re-spelling described at {@link TEMPLATE_TOKEN_SPELLING}.
+ */
+export declare function findDeepSeekTemplateToken(text: string, tokens: Readonly<Record<string, true>>, from?: number): DeepSeekTokenMatch | undefined;
 export declare class DeepSeekInbandScanner implements InbandScanner {
     #private;
     constructor(options?: InbandScannerOptions);

package/dist/types/judgment/native.d.ts

@@ -41,10 +41,15 @@ export type JudgmentApi = keyof typeof JUDGMENT_WIRES;
 export declare function isJudgmentApi(api: Api): api is JudgmentApi;
 /** Whether both the native protocol and catalog model support image input. */
 export declare function nativeJudgmentSupportsImages(model: Model): boolean;
+/** Whether `model`'s native judgment takes images and its wire forwards box questions. The model itself may still refuse them (Box needs Jev 1.14+). */
+export declare function nativeJudgmentSupportsBoxes(model: Model): boolean;
 /**
- * Whether `model`'s native judgment API takes these exact images: image support plus every documented
- * transport and catalog bound. A judge chain skips a candidate that would refuse them instead of failing on it.
+ * Every image bound `model`'s native judgment enforces: its wire's transport limits tightened by the
+ * catalog's model bounds. `undefined` when it takes no images. Native APIs reject images outside these
+ * rather than resizing them, so callers size images to them first.
  */
+export declare function nativeJudgmentImageBounds(model: Model): JudgmentImageInput | undefined;
+/** Whether `model`'s native judgment API takes these exact images: image support within every {@link nativeJudgmentImageBounds}. */
 export declare function nativeJudgmentAcceptsImages(model: Model, images: readonly ImageContent[]): boolean;
 /**
  * Reject images that `model`'s native judgment API cannot take — no image support, an unsupported or
@@ -52,6 +57,12 @@ export declare function nativeJudgmentAcceptsImages(model: Model, images: readon
  * @throws {AIError.ValidationError} naming the reason.
  */
 export declare function checkNativeJudgmentImages(model: Model, request: JudgmentRequest, imageAssets?: JudgmentImageAssets): void;
+/**
+ * Reject box questions whose `image` is not an index into `request.images`: nothing would say which
+ * image their edges measure.
+ * @throws {AIError.ValidationError} naming the question.
+ */
+export declare function checkBoxQuestions(request: JudgmentRequest): void;
 /** `TYPESAFE_BASE_URL` when set, else the public API root; trailing slashes stripped. */
 export declare function typesafeBaseUrl(): string;
 /** `TYPESAFE_DEFAULT_MODEL` when set, else {@link TYPESAFE_DEFAULT_MODEL}. */

package/dist/types/judgment/types.d.ts

@@ -3,8 +3,9 @@
  *
  * A {@link Judge} answers a map of named questions — {@link ChoiceQuestion}
  * (one option from a fixed set), {@link NoulQuestion} (probability that a
- * yes/no condition holds), {@link ScoreQuestion} (position on ordered levels)
- * — about one {@link JudgmentState}. Every question in a request sees the same
+ * yes/no condition holds), {@link ScoreQuestion} (position on ordered levels),
+ * {@link BoxQuestion} (where a target is in one of the request's images, native
+ * judges only) — about one {@link JudgmentState}. Every question in a request sees the same
  * state and is answered independently, so callers batch independent questions
  * into one call. The shape mirrors TypeSafe's System One API so the native
  * backend ({@link NativeJudge}) forwards requests verbatim, while the text
@@ -41,7 +42,19 @@ export interface ScoreQuestion {
     instructions: string;
     criteria: readonly [string, string, ...string[]];
 }
-export type Question = ChoiceQuestion | NoulQuestion | ScoreQuestion;
+/**
+ * Where one target is in an image (TypeSafe Box, Jev 1.14+): https://docs.typesafe.ai/primitives/box.
+ * Only native judges answer it. `instructions` must name the target and, among several images, which
+ * one to search; `image` stays local and says which entry of {@link JudgmentRequest.images} the
+ * answer's edges measure, so a judge that resizes or pads that image can map them back.
+ */
+export interface BoxQuestion {
+    type: "box";
+    instructions: string;
+    /** Index into the request's `images` of the image searched. */
+    image: number;
+}
+export type Question = ChoiceQuestion | NoulQuestion | ScoreQuestion | BoxQuestion;
 /** Questions keyed by caller-chosen ids; answers come back under the same ids. */
 export type Questions = Record<string, Question>;
 export interface ChoiceAnswer<L extends string = string> {
@@ -67,9 +80,23 @@ export interface ScoreAnswer {
     /** Concentration of the distribution, 0–1. */
     confidence: number;
 }
-export type Answer = ChoiceAnswer | NoulAnswer | ScoreAnswer;
+/** A rectangle's edges as 0–1 fractions of an image's width (`left` < `right`) and height (`top` < `bottom`), from its top-left corner. */
+export interface BoxEdges {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export interface BoxAnswer {
+    type: "box";
+    /** Smallest rectangle containing the target, on the image the question's `image` names. Always present: absence is a separate yes/no question. */
+    box: BoxEdges;
+    /** How sure the model is of the box, 0–1. */
+    confidence: number;
+}
+export type Answer = ChoiceAnswer | NoulAnswer | ScoreAnswer | BoxAnswer;
 /** The answer type for a question, preserving choice labels. */
-export type AnswerFor<Q extends Question> = Q extends ChoiceQuestion<infer L> ? ChoiceAnswer<L> : Q extends NoulQuestion ? NoulAnswer : ScoreAnswer;
+export type AnswerFor<Q extends Question> = Q extends ChoiceQuestion<infer L> ? ChoiceAnswer<L> : Q extends NoulQuestion ? NoulAnswer : Q extends BoxQuestion ? BoxAnswer : ScoreAnswer;
 export interface JudgmentRequest<Q extends Questions = Questions> {
     state: JudgmentState;
     questions: Q;

package/dist/types/judgment/wire.d.ts

@@ -42,6 +42,8 @@ export interface JudgmentWire {
     imagesRequireOptIn?: boolean;
     /** Whether this wire drops per-image detail metadata. */
     ignoresImageDetail?: boolean;
+    /** Whether this dialect forwards `box` questions; others reject them before sending. */
+    boxes?: boolean;
     /** The response's answers and usage; `undefined` when the payload is not this API's response shape. */
     decode(payload: unknown): DecodedJudgment | undefined;
 }

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

@@ -1,8 +1,13 @@
-import type { StreamFunction, StreamOptions, ToolChoice } from "../types.js";
+import type { Model, StreamFunction, StreamOptions, ToolChoice } from "../types.js";
 export interface OllamaChatOptions extends StreamOptions {
     reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
     disableReasoning?: boolean;
     toolChoice?: ToolChoice;
 }
+/** Whether Ollama chat removes assistant thinking from replayed history. */
+export declare function ollamaChatDropsOwnThinking(model: {
+    api?: string;
+    compat?: Model["compat"];
+} | null | undefined): boolean;
 /** Retry EOS-only Ollama completions before the agent loop sees an empty stop. */
 export declare const streamOllama: StreamFunction<"ollama-chat">;

package/dist/types/providers/transform-messages.d.ts

@@ -52,6 +52,8 @@ export declare function shouldDropTruncatedThinkingOnlyAssistant(msg: AssistantM
  */
 export declare function isSurvivingAssistant(msg: AssistantMessage, model?: Model): boolean;
 export declare function isAnthropicMessagesModel(model: Model): model is Model<"anthropic-messages">;
+/** Whether `turn` came from `model` itself: its own turns replay their native reasoning unchanged. */
+export declare function isSameModelTurn(turn: Pick<AssistantMessage, "provider" | "api" | "model">, model: Pick<Model, "provider" | "api" | "id">): boolean;
 /**
  * Normalize tool call ID for cross-provider compatibility.
  * OpenAI Responses API generates IDs that are 450+ chars with special characters like `|`.

package/dist/types/usage/muse-code.d.ts

@@ -1,2 +1,2 @@
-import type { UsageProvider } from "../usage.js";
+import { type UsageProvider } from "../usage.js";
 export declare const museCodeUsageProvider: UsageProvider;

package/dist/types/utils/dsml-leak.d.ts

@@ -1,25 +1,27 @@
 /**
- * Removal of DeepSeek DSML tool-call markup left in visible assistant text.
+ * Removal of DeepSeek tool-call markup left in visible assistant text.
  *
  * DeepSeek models on OpenAI-compatible hosts sometimes emit their tool calls as
- * raw `<｜DSML｜…>` markup in `content`. A well-formed envelope is healed into a
- * structured call by `StreamMarkupHealing`, but a degraded model can drop the
- * opening `<｜DSML｜tool_calls>` / `<｜DSML｜invoke name="…">` tags (or the host
- * runs no healer at all). That markup must not stay in history: replaying it
- * teaches the model to keep writing tool calls as text (issue #10556). Callers
- * strip it before the message is committed and tell the model its call failed.
+ * text in `content`: the V4 `<｜DSML｜…>` envelope or the V3 chat-template
+ * tokens (`<｜tool▁calls▁begin｜>` …). A well-formed call is healed into a
+ * structured call by `StreamMarkupHealing`, but a degraded model can drop
+ * required tags (or the host runs no healer at all). That markup must not stay
+ * in history: replaying it teaches the model to keep writing tool calls as text
+ * (issue #10556). Callers strip it before the message is committed and tell the
+ * model its call failed.
  */
 import type { AssistantMessage, Model } from "../types.js";
 /**
  * Whether DSML leak recovery applies to `model`: a DeepSeek-class model, or one
  * explicitly configured with the `dsml` stream healer (e.g. a `models.yml` entry
- * whose id the classifier cannot place). Other models never write DSML tool
- * calls, so DSML text from them is prose and is left alone.
+ * whose id the classifier cannot place). Other models never write DeepSeek tool
+ * calls, so such markup from them is prose and is left alone.
  */
 export declare function isDsmlLeakRecoveryTarget(model: Model): boolean;
 /**
- * Strip leaked DSML tool-call markup from `text`, leaving quoted code intact.
- * Returns `undefined` when `text` carries no such markup.
+ * Strip leaked DeepSeek tool-call markup (DSML or chat-template tokens) from
+ * `text`, leaving quoted code intact. Returns `undefined` when `text` carries
+ * no such markup.
  */
 export declare function stripDsmlToolMarkup(text: string): string | undefined;
 /**

package/dist/types/utils/request-compression.d.ts

@@ -9,10 +9,13 @@ import type { FetchImpl, Model } from "../types.js";
  * Install it beneath any body rewriter or signer (e.g. the cch attestation
  * patch): those must see the uncompressed bytes. Other hosts, small bodies,
  * bodies that already carry `Content-Encoding`, and `PI_REQUEST_COMPRESSION=0`
- * pass through untouched. A possible rejection is resent uncompressed once;
- * only when that resend succeeds is the encoding latched off for the host, so
- * a genuine 400 never disables compression.
+ * pass through untouched. A possible rejection — the host's decode error, or a
+ * non-JSON 400/403/415 from a proxy in front of it — is resent uncompressed
+ * once; only when that resend succeeds is the encoding latched off for the
+ * host, so a genuine 400 never disables compression. When a non-JSON refusal
+ * recurs uncompressed with the same status and a non-JSON body, that status
+ * stops being re-checked for the host.
  */
 export declare function wrapFetchForRequestCompression(base: FetchImpl, model: Model): FetchImpl;
-/** Test hook: clears every per-host rejection latch. */
+/** Test hook: clears every per-host latch. */
 export declare function resetRequestCompressionForTesting(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-ai",
-	"version": "18.12.0",
+	"version": "18.12.2",
 	"description": "Unified LLM API with automatic model discovery and provider configuration",
 	"keywords": [
 		"ai",
@@ -155,11 +155,11 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.12.0",
-		"@oh-my-pi/pi-catalog": "18.12.0",
-		"@oh-my-pi/pi-natives": "18.12.0",
-		"@oh-my-pi/pi-utils": "18.12.0",
-		"@oh-my-pi/pi-wire": "18.12.0"
+		"@oh-my-pi/omptype": "18.12.2",
+		"@oh-my-pi/pi-catalog": "18.12.2",
+		"@oh-my-pi/pi-natives": "18.12.2",
+		"@oh-my-pi/pi-utils": "18.12.2",
+		"@oh-my-pi/pi-wire": "18.12.2"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"