@code-yeongyu/senpi 2026.10.11 → 2026.10.12

package/dist/core/model-config-schema.d.ts

@@ -78,6 +78,7 @@ declare const ModelDefinitionSchema: Type.TObject<{
     extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
     compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+        supportsWebSearch: Type.TOptional<Type.TBoolean>;
         supportsStore: Type.TOptional<Type.TBoolean>;
         supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
         supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -142,6 +143,7 @@ declare const ModelDefinitionSchema: Type.TObject<{
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
         supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
     }>, Type.TObject<{
+        webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
         supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
         sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -234,6 +236,7 @@ declare const ModelOverrideSchema: Type.TObject<{
     extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
     compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+        supportsWebSearch: Type.TOptional<Type.TBoolean>;
         supportsStore: Type.TOptional<Type.TBoolean>;
         supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
         supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -298,6 +301,7 @@ declare const ModelOverrideSchema: Type.TObject<{
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
         supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
     }>, Type.TObject<{
+        webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
         supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
         sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -348,6 +352,7 @@ declare const ProviderConfigSchema: Type.TObject<{
     extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
     compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+        supportsWebSearch: Type.TOptional<Type.TBoolean>;
         supportsStore: Type.TOptional<Type.TBoolean>;
         supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
         supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -412,6 +417,7 @@ declare const ProviderConfigSchema: Type.TObject<{
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
         supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
     }>, Type.TObject<{
+        webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
         supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
         sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
         supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -512,6 +518,7 @@ declare const ProviderConfigSchema: Type.TObject<{
         extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
         cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
         compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+            supportsWebSearch: Type.TOptional<Type.TBoolean>;
             supportsStore: Type.TOptional<Type.TBoolean>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -576,6 +583,7 @@ declare const ProviderConfigSchema: Type.TObject<{
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
             supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
         }>, Type.TObject<{
+            webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -668,6 +676,7 @@ declare const ProviderConfigSchema: Type.TObject<{
         extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
         cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
         compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+            supportsWebSearch: Type.TOptional<Type.TBoolean>;
             supportsStore: Type.TOptional<Type.TBoolean>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -732,6 +741,7 @@ declare const ProviderConfigSchema: Type.TObject<{
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
             supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
         }>, Type.TObject<{
+            webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -795,6 +805,7 @@ declare const ModelsConfigSchema: Type.TObject<{
         extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
         cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
         compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+            supportsWebSearch: Type.TOptional<Type.TBoolean>;
             supportsStore: Type.TOptional<Type.TBoolean>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -859,6 +870,7 @@ declare const ModelsConfigSchema: Type.TObject<{
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
             supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
         }>, Type.TObject<{
+            webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -959,6 +971,7 @@ declare const ModelsConfigSchema: Type.TObject<{
             extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
             cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
             compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+                supportsWebSearch: Type.TOptional<Type.TBoolean>;
                 supportsStore: Type.TOptional<Type.TBoolean>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -1023,6 +1036,7 @@ declare const ModelsConfigSchema: Type.TObject<{
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
                 supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
             }>, Type.TObject<{
+                webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -1115,6 +1129,7 @@ declare const ModelsConfigSchema: Type.TObject<{
             extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
             cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
             compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+                supportsWebSearch: Type.TOptional<Type.TBoolean>;
                 supportsStore: Type.TOptional<Type.TBoolean>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -1179,6 +1194,7 @@ declare const ModelsConfigSchema: Type.TObject<{
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
                 supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
             }>, Type.TObject<{
+                webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -1243,6 +1259,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
         extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
         cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
         compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+            supportsWebSearch: Type.TOptional<Type.TBoolean>;
             supportsStore: Type.TOptional<Type.TBoolean>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -1307,6 +1324,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
             supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
         }>, Type.TObject<{
+            webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
             supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
             sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
             supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -1407,6 +1425,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
             cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
             compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+                supportsWebSearch: Type.TOptional<Type.TBoolean>;
                 supportsStore: Type.TOptional<Type.TBoolean>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -1471,6 +1490,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
                 supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
             }>, Type.TObject<{
+                webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -1563,6 +1583,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             extraBody: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
             cacheRetention: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"short">, Type.TLiteral<"long">]>>;
             compat: Type.TOptional<Type.TUnion<[Type.TObject<{
+                supportsWebSearch: Type.TOptional<Type.TBoolean>;
                 supportsStore: Type.TOptional<Type.TBoolean>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 supportsReasoningEffort: Type.TOptional<Type.TBoolean>;
@@ -1627,6 +1648,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
                 supportsForcedToolChoice: Type.TOptional<Type.TBoolean>;
             }>, Type.TObject<{
+                webSearchToolType: Type.TOptional<Type.TUnion<[Type.TLiteral<"web_search">, Type.TLiteral<"web_search_preview">]>>;
                 supportsDeveloperRole: Type.TOptional<Type.TBoolean>;
                 sessionAffinityFormat: Type.TOptional<Type.TUnion<[Type.TLiteral<"openai">, Type.TLiteral<"openai-nosession">, Type.TLiteral<"openrouter">]>>;
                 supportsLongCacheRetention: Type.TOptional<Type.TBoolean>;
@@ -1690,6 +1712,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
         extraBody?: Record<string, unknown> | undefined;
         cacheRetention?: "long" | "none" | "short" | undefined;
         compat?: {
+            supportsWebSearch?: boolean | undefined;
             supportsStore?: boolean | undefined;
             supportsDeveloperRole?: boolean | undefined;
             supportsReasoningEffort?: boolean | undefined;
@@ -1754,6 +1777,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             supportsLongCacheRetention?: boolean | undefined;
             supportsForcedToolChoice?: boolean | undefined;
         } | {
+            webSearchToolType?: "web_search" | "web_search_preview" | undefined;
             supportsDeveloperRole?: boolean | undefined;
             sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter" | undefined;
             supportsLongCacheRetention?: boolean | undefined;
@@ -1854,6 +1878,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             extraBody?: Record<string, unknown> | undefined;
             cacheRetention?: "long" | "none" | "short" | undefined;
             compat?: {
+                supportsWebSearch?: boolean | undefined;
                 supportsStore?: boolean | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
@@ -1918,6 +1943,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
                 supportsLongCacheRetention?: boolean | undefined;
                 supportsForcedToolChoice?: boolean | undefined;
             } | {
+                webSearchToolType?: "web_search" | "web_search_preview" | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter" | undefined;
                 supportsLongCacheRetention?: boolean | undefined;
@@ -2010,6 +2036,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             extraBody?: Record<string, unknown> | undefined;
             cacheRetention?: "long" | "none" | "short" | undefined;
             compat?: {
+                supportsWebSearch?: boolean | undefined;
                 supportsStore?: boolean | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
@@ -2074,6 +2101,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
                 supportsLongCacheRetention?: boolean | undefined;
                 supportsForcedToolChoice?: boolean | undefined;
             } | {
+                webSearchToolType?: "web_search" | "web_search_preview" | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter" | undefined;
                 supportsLongCacheRetention?: boolean | undefined;
@@ -2137,6 +2165,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
         extraBody?: Record<string, unknown> | undefined;
         cacheRetention?: "long" | "none" | "short" | undefined;
         compat?: {
+            supportsWebSearch?: boolean | undefined;
             supportsStore?: boolean | undefined;
             supportsDeveloperRole?: boolean | undefined;
             supportsReasoningEffort?: boolean | undefined;
@@ -2201,6 +2230,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             supportsLongCacheRetention?: boolean | undefined;
             supportsForcedToolChoice?: boolean | undefined;
         } | {
+            webSearchToolType?: "web_search" | "web_search_preview" | undefined;
             supportsDeveloperRole?: boolean | undefined;
             sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter" | undefined;
             supportsLongCacheRetention?: boolean | undefined;
@@ -2301,6 +2331,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             extraBody?: Record<string, unknown> | undefined;
             cacheRetention?: "long" | "none" | "short" | undefined;
             compat?: {
+                supportsWebSearch?: boolean | undefined;
                 supportsStore?: boolean | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
@@ -2365,6 +2396,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
                 supportsLongCacheRetention?: boolean | undefined;
                 supportsForcedToolChoice?: boolean | undefined;
             } | {
+                webSearchToolType?: "web_search" | "web_search_preview" | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter" | undefined;
                 supportsLongCacheRetention?: boolean | undefined;
@@ -2457,6 +2489,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
             extraBody?: Record<string, unknown> | undefined;
             cacheRetention?: "long" | "none" | "short" | undefined;
             compat?: {
+                supportsWebSearch?: boolean | undefined;
                 supportsStore?: boolean | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
@@ -2521,6 +2554,7 @@ export declare const validateModelsConfig: import("typebox/compile").Validator<{
                 supportsLongCacheRetention?: boolean | undefined;
                 supportsForcedToolChoice?: boolean | undefined;
             } | {
+                webSearchToolType?: "web_search" | "web_search_preview" | undefined;
                 supportsDeveloperRole?: boolean | undefined;
                 sessionAffinityFormat?: "openai" | "openai-nosession" | "openrouter" | undefined;
                 supportsLongCacheRetention?: boolean | undefined;

package/dist/core/model-config-schema.js

@@ -101,6 +101,7 @@ const ModelInputLimitsSchema = Type.Object({
     })),
 });
 const OpenAICompletionsCompatSchema = Type.Object({
+    supportsWebSearch: Type.Optional(Type.Boolean()),
     supportsStore: Type.Optional(Type.Boolean()),
     supportsDeveloperRole: Type.Optional(Type.Boolean()),
     supportsReasoningEffort: Type.Optional(Type.Boolean()),
@@ -138,6 +139,7 @@ const OpenAICompletionsCompatSchema = Type.Object({
     supportsForcedToolChoice: Type.Optional(Type.Boolean()),
 });
 const OpenAIResponsesCompatSchema = Type.Object({
+    webSearchToolType: Type.Optional(Type.Union([Type.Literal("web_search"), Type.Literal("web_search_preview")])),
     supportsDeveloperRole: Type.Optional(Type.Boolean()),
     sessionAffinityFormat: Type.Optional(Type.Union([Type.Literal("openai"), Type.Literal("openai-nosession"), Type.Literal("openrouter")])),
     supportsLongCacheRetention: Type.Optional(Type.Boolean()),

package/dist/core/model-config.js

@@ -109,6 +109,7 @@ const OpenAICompletionsCompatSchema = Type.Object({
 });
 
 const OpenAIResponsesCompatSchema = Type.Object({
+    webSearchToolType: Type.Optional(Type.Union([Type.Literal("web_search"), Type.Literal("web_search_preview")])),
     supportsDeveloperRole: Type.Optional(Type.Boolean()),
     sessionAffinityFormat: Type.Optional(
         Type.Union([Type.Literal("openai"), Type.Literal("openai-nosession"), Type.Literal("openrouter")]),

package/dist/core/reserved-keywords.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OmO's reserved prompt keywords (`ulw`, `mass ulw`, `ulw plan`, `ulw loop`, `ulw research`).
+ *
+ * Mirrors the omo-senpi engine's arming rules (omo `packages/omo-senpi/src/components/
+ * {ultrawork/index.ts, skill-pointers/index.ts, skill-pointers/strip-quoted-regions.ts}`),
+ * so the editor paints a keyword only where the engine would arm it: case-insensitive,
+ * spaces or hyphens between words, the mass aliases (`mulw`, `meth`, `ulw mass`), and
+ * each name only as a word of its own (not inside an identifier, path, file name or URL).
+ * Overlapping mentions all match ("ulw research" is both `ultrawork` and `ulw-research`).
+ * Injected blocks, fenced/inline code, relay headers, block quotes, double quotes, URLs
+ * and negated invocations ("do not load mass-ulw") are quoted material, never a request.
+ */
+export type ReservedKeyword = "ultrawork" | "mass-ulw" | "ulw-plan" | "ulw-loop" | "ulw-research";
+export interface ReservedKeywordSpan {
+    readonly keyword: ReservedKeyword;
+    /** UTF-16 offsets into the searched text, end exclusive. */
+    readonly start: number;
+    readonly end: number;
+}
+export interface ReservedKeywordRun {
+    readonly start: number;
+    readonly end: number;
+}
+/** Every reserved-keyword mention outside quoted regions, in text order. */
+export declare function findReservedKeywordSpans(text: string): ReservedKeywordSpan[];
+/** Overlapping mentions ("mass ulw research" is three) merge into one painted run, as on the desktop. */
+export declare function findReservedKeywordRuns(text: string): ReservedKeywordRun[];
+//# sourceMappingURL=reserved-keywords.d.ts.map

package/dist/core/reserved-keywords.js

@@ -0,0 +1,81 @@
+const MASS_ULW_ALIAS = String.raw `(?:mass[\s-]*ulw|ulw[\s-]*mass|mulw|meth)`;
+// A keyword glued to a preceding identifier segment (`mass-ulw`, `senpi-ulw-loop`, `.omo/ulw/`, `v1.ulw`)
+// names something else; so does one that opens a path (`ulw-execute/ledger.jsonl`).
+const NOT_AFTER_IDENTIFIER = String.raw `(?<![A-Za-z0-9][-_.]|[/\\])`;
+const NOT_BEFORE_PATH = String.raw `(?![-_.]?[A-Za-z0-9]*[/\\])`;
+// The name must end its own word (`ulw-plan-refactor`, `ulw-plan.md` do not count); a chained
+// skill word may follow if it, too, ends there (`mass ulw-loop`).
+const SEGMENT_END = String.raw `(?![-_.]?[A-Za-z0-9])`;
+const NOT_INTO_IDENTIFIER = String.raw `(?![-_](?!(?:loop|plan|research|execute|mass)${SEGMENT_END})[A-Za-z0-9]|\.[A-Za-z0-9])`;
+const keywordPattern = (body) => new RegExp(String.raw `${NOT_AFTER_IDENTIFIER}\b${body}\b${NOT_INTO_IDENTIFIER}${NOT_BEFORE_PATH}`, "gi");
+const RESERVED_KEYWORD_PATTERNS = [
+    ["ultrawork", keywordPattern("(?:ultrawork|ulw)")],
+    ["mass-ulw", keywordPattern(MASS_ULW_ALIAS)],
+    ["ulw-plan", keywordPattern(String.raw `ulw[\s-]*plan`)],
+    ["ulw-loop", keywordPattern(String.raw `ulw[\s-]*loop`)],
+    ["ulw-research", keywordPattern(String.raw `(?:ulw|${MASS_ULW_ALIAS})[\s-]*research`)],
+];
+/** Cheap pre-check: every reserved keyword contains one of these stems. */
+const RESERVED_KEYWORD_STEM = /ulw|ultrawork|mulw|meth/i;
+const INJECTED_BLOCK = /<(omo-[a-z0-9-]+-pointer|ultrawork-mode|omo-ultrawork-reminder)>[\s\S]*?<\/\1>/gi;
+const INLINE_CODE = /(?<!`)(`+)(?!`)[\s\S]*?(?<!`)\1(?!`)/g;
+// A relayed message opens with a sender header (`[REPORT]`, `[a -> b]`, `Name (id), recipient:`): all of it is someone else's text.
+const RELAY_HEADER = /^\s*(?:\[(?:[A-Z][A-Z0-9_-]{2,}|[\w.-]+ -> [\w.-]+)\]|[A-Z][\w.-]{0,30} \([^()\s]{1,40}\)(?:, | to )[\w.-]{1,40}:)/;
+const BLOCK_QUOTE_LINE = /^ {0,3}>[^\n]*/gm;
+const DOUBLE_QUOTED = /"[^"\n]*"|\u201C[^\u201D\n]*\u201D/g;
+const URL_SPAN = /(?<![a-z0-9+.-])[a-z][a-z0-9+.-]*:\/\/[^\s<>"'`]+/gi;
+// A keyword named only to forbid it ("Do not load mass-ulw or ulw-research") is masked up to the next clause break.
+const NEGATED_INVOCATION = /\b(?:do\s+not|don['\u2019]t|dont|never)\s+(?:load|use|run|invoke|start|trigger|arm|enable)\b[^.;:!?\n]*?(?=[.;:!?\n]|\s(?:but|then|instead|however)\b|\s[\u2014\u2013-]\s|$)/gi;
+function maskRegion(region) {
+    return region.replace(/[^\r\n]/g, "\0");
+}
+/** Quoted, injected, relayed and negated regions are masked (offsets kept) before matching. */
+function maskQuotedRegions(text) {
+    if (RELAY_HEADER.test(text))
+        return maskRegion(text);
+    let visible = text.replace(INJECTED_BLOCK, maskRegion);
+    const fenceStart = /^ {0,3}(`{3,}|~{3,})[^\n]*(?:\n|$)/gm;
+    for (let opening = fenceStart.exec(visible); opening !== null; opening = fenceStart.exec(visible)) {
+        const fence = opening[1] ?? "```";
+        const fenceEnd = new RegExp(`^ {0,3}${fence[0]}{${fence.length},}[ \\t]*\\r?$`, "gm");
+        fenceEnd.lastIndex = fenceStart.lastIndex;
+        const closing = fenceEnd.exec(visible);
+        const end = closing === null ? visible.length : fenceEnd.lastIndex;
+        visible = visible.slice(0, opening.index) + maskRegion(visible.slice(opening.index, end)) + visible.slice(end);
+        fenceStart.lastIndex = end;
+    }
+    return visible
+        .replace(INLINE_CODE, maskRegion)
+        .replace(BLOCK_QUOTE_LINE, maskRegion)
+        .replace(DOUBLE_QUOTED, maskRegion)
+        .replace(URL_SPAN, maskRegion)
+        .replace(NEGATED_INVOCATION, maskRegion);
+}
+/** Every reserved-keyword mention outside quoted regions, in text order. */
+export function findReservedKeywordSpans(text) {
+    if (!RESERVED_KEYWORD_STEM.test(text))
+        return [];
+    const visible = maskQuotedRegions(text);
+    const spans = [];
+    for (const [keyword, pattern] of RESERVED_KEYWORD_PATTERNS) {
+        for (const match of visible.matchAll(pattern)) {
+            spans.push({ keyword, start: match.index, end: match.index + match[0].length });
+        }
+    }
+    return spans.sort((left, right) => left.start - right.start || right.end - left.end);
+}
+/** Overlapping mentions ("mass ulw research" is three) merge into one painted run, as on the desktop. */
+export function findReservedKeywordRuns(text) {
+    const runs = [];
+    for (const span of findReservedKeywordSpans(text)) {
+        const previous = runs.at(-1);
+        if (previous !== undefined && span.start <= previous.end) {
+            previous.end = Math.max(previous.end, span.end);
+        }
+        else {
+            runs.push({ start: span.start, end: span.end });
+        }
+    }
+    return runs;
+}
+//# sourceMappingURL=reserved-keywords.js.map

package/dist/core/retry-fallback/candidates.d.ts

@@ -11,7 +11,7 @@ export interface CandidateFilters {
     isSuppressed(base: string): boolean;
     isAuthAvailable(provider: string): boolean;
     isCircuitOpen(base: string): boolean;
-    /** Providers whose account-wide usage limit or billing failure this session saw: their entries are tried last. */
+    /** Providers whose account-wide usage limit or billing failure this session saw: their entries are skipped. */
     isProviderSpent?(provider: string): boolean;
     skip(candidate: string, skipReason: string): void;
 }

package/dist/core/retry-fallback/candidates.js

@@ -1,17 +1,6 @@
 import { baseSelector, candidatesAfter, formatSelector, parseFallbackSelector, } from "./chains.js";
 export function firstUsableCandidate(entries, current, filters) {
-    const isSpent = filters.isProviderSpent;
-    if (!isSpent)
-        return scanCandidates(entries, current, filters, () => false);
-    let avoided = false;
-    const elsewhere = scanCandidates(entries, current, filters, (provider) => {
-        const spent = isSpent(provider);
-        avoided ||= spent;
-        return spent;
-    });
-    if (elsewhere || !avoided)
-        return elsewhere;
-    return scanCandidates(entries, current, filters, () => false);
+    return scanCandidates(entries, current, filters, (provider) => filters.isProviderSpent?.(provider) ?? false);
 }
 function scanCandidates(entries, current, filters, avoidProvider) {
     let probe;

package/dist/core/retry-fallback/controller.d.ts

@@ -14,6 +14,8 @@ export declare class RetryFallbackController {
     constructor(deps: RetryFallbackControllerDeps);
     get activeState(): Readonly<ActiveFallbackState> | undefined;
     get exhaustedChainKey(): string | undefined;
+    isProviderSpent(provider: string): boolean;
+    accountError(provider: string): string | undefined;
     resetTurn(): void;
     clear(): void;
     private canonicalChains;
@@ -68,7 +70,7 @@ export declare class RetryFallbackController {
     tryFallback(reason: FallbackReason, failure: {
         errorMessage?: string;
         retryAfterMs?: number;
-    }): Promise<boolean>;
+    }, failureObserved?: boolean): Promise<boolean>;
     private applyCandidate;
     /** The chain governing `current`, when fallback is enabled; a model's own chain wins over an active one. */
     private managedChainKey;

package/dist/core/retry-fallback/controller.js

@@ -18,6 +18,12 @@ export class RetryFallbackController {
     get exhaustedChainKey() {
         return this.lastExhaustedChainKey;
     }
+    isProviderSpent(provider) {
+        return this.unusable.isProviderSpent(provider);
+    }
+    accountError(provider) {
+        return this.unusable.accountError(provider);
+    }
     resetTurn() {
         this.triedSelectors.clear();
         this.lastExhaustedChainKey = undefined;
@@ -149,9 +155,9 @@ export class RetryFallbackController {
      * half-open probe - independent of whether a fallback candidate remains.
      */
     noteHealthFailure(model, thinkingLevel, failure) {
+        this.unusable.note(model, failure);
         if (!this.managedChainKey({ model, thinkingLevel }))
             return;
-        this.unusable.note(model, failure);
         this.probes.noteFailure(formatSelector(model), failure);
     }
     /**
@@ -174,21 +180,21 @@ export class RetryFallbackController {
         await this.applyCandidate(current, candidate, "transient");
         return true;
     }
-    async tryFallback(reason, failure) {
+    async tryFallback(reason, failure, failureObserved = true) {
         const current = this.deps.getCurrentSelector();
         // Only a transient failure that spent its budget opens the shared circuit
         // here; billing/quota exhaustion is recorded at the failure itself (see
         // noteHealthFailure) so the final chain entry opens too.
-        if (current && reason === "transient")
+        if (failureObserved && current && reason === "transient")
             this.noteHealthFailure(current.model, current.thinkingLevel, failure);
         const limit = usageLimitScope(failure.errorMessage);
-        if (current)
+        if (failureObserved && current)
             this.unusable.note(current.model, failure);
         let candidate = this.nextCandidate(false, true);
         if (!current || !candidate)
             return false;
         const currentBase = formatSelector(current.model);
-        if (reason === "transient" || reason === "hard-error" || reason === "billing") {
+        if (failureObserved && (reason === "transient" || reason === "hard-error" || reason === "billing")) {
             this.deps.cooldowns.note(currentBase, failure);
             this.deps.logger.info("cooldown_noted", { selector: currentBase, errorMessage: failure.errorMessage });
         }

package/dist/core/retry-fallback/cooldown.d.ts

@@ -7,7 +7,8 @@ export declare class SelectorCooldowns {
     private readonly expiresAtBySelector;
     private readonly now;
     private readonly random;
-    constructor(now: () => number, random?: () => number);
+    private readonly wallNow;
+    constructor(now: () => number, random?: () => number, wallNow?: () => number);
     note(baseSelector: string, failure: {
         retryAfterMs?: number;
         errorMessage?: string;

package/dist/core/retry-fallback/cooldown.js

@@ -1,14 +1,17 @@
+import { MAX_SLOT_BLOCK_MS } from "@earendil-works/pi-ai/auth/pool/failover";
 import { stripProviderRequestIds } from "@earendil-works/pi-ai/utils/retry";
+import { usageLimitResetMs } from "../credential-pool/reset-time.js";
 /**
  * Runtime-only selector suppression. A SelectorCooldowns instance belongs to one
  * AgentSession and is deliberately never persisted to settings or session files.
  * Callers provide canonical base selectors without a thinking suffix.
  */
 export class SelectorCooldowns {
-    constructor(now, random = Math.random) {
+    constructor(now, random = Math.random, wallNow = now) {
         this.expiresAtBySelector = new Map();
         this.now = now;
         this.random = random;
+        this.wallNow = wallNow;
     }
     note(baseSelector, failure) {
         this.expiresAtBySelector.set(baseSelector, this.now() + this.durationFor(failure));
@@ -29,18 +32,24 @@ export class SelectorCooldowns {
         this.expiresAtBySelector.clear();
     }
     durationFor({ retryAfterMs, errorMessage }) {
-        if (retryAfterMs !== undefined && Number.isFinite(retryAfterMs) && retryAfterMs > 0) {
-            return retryAfterMs;
-        }
+        // Reset hints are wall-clock times; the stored deadline remains monotonic.
+        const resetMs = errorMessage === undefined ? undefined : usageLimitResetMs(errorMessage, this.wallNow());
         const message = stripProviderRequestIds(errorMessage ?? "").toLowerCase();
-        if (/usage[- ]limit|quota|insufficient_quota|billing|credits[-_ ]required|credits are required/.test(message))
-            return 30 * 60_000;
-        if (/rate[ -]?limit|429|too many requests/.test(message))
-            return 30_000;
-        if (/overloaded|capacity/.test(message))
-            return 45_000 + this.capacityJitterMs();
-        if (/5xx|\b5\d\d\b|server|internal error/.test(message))
-            return 20_000;
+        const defaultMs = /usage[- ]limit|quota|insufficient_quota|billing|credits[-_ ]required|credits are required/.test(message)
+            ? 30 * 60_000
+            : /rate[ -]?limit|429|too many requests/.test(message)
+                ? 30_000
+                : /overloaded|capacity/.test(message)
+                    ? 45_000 + this.capacityJitterMs()
+                    : /5xx|\b5\d\d\b|server|internal error/.test(message)
+                        ? 20_000
+                        : undefined;
+        const retryMs = retryAfterMs !== undefined && Number.isFinite(retryAfterMs) && retryAfterMs > 0 ? retryAfterMs : undefined;
+        const hintedMs = Math.max(resetMs ?? 0, retryMs ?? 0);
+        if (hintedMs > 0)
+            return Math.min(MAX_SLOT_BLOCK_MS, hintedMs);
+        if (defaultMs !== undefined)
+            return defaultMs;
         // A reason-less forbidden rejection is a per-request blip on a healthy credential (senpi#2376).
         if (/"type"\s*:\s*"forbidden"[^}]*request not allowed|request not allowed[^}]*"type"\s*:\s*"forbidden"/.test(message)) {
             return 60_000;

package/dist/core/retry-fallback/unusable.d.ts

@@ -10,9 +10,11 @@ import type { SelectorCooldowns } from "./cooldown.ts";
  */
 export declare class UnusableEntries {
     private readonly cooldowns;
+    private readonly accountErrors;
     constructor(cooldowns: SelectorCooldowns);
     note(model: Model<Api>, failure: CircuitFailure): void;
     isProviderSpent(provider: string): boolean;
+    accountError(provider: string): string | undefined;
     isUnusable(model: Model<Api>): boolean;
     clear(model: Model<Api>): void;
 }

package/dist/core/retry-fallback/unusable.js

@@ -10,12 +10,16 @@ import { usageLimitScope } from "./usage-limit.js";
  */
 export class UnusableEntries {
     constructor(cooldowns) {
+        this.accountErrors = new Map();
         this.cooldowns = cooldowns;
     }
     note(model, failure) {
         const scope = usageLimitScope(failure.errorMessage);
-        if (scope === "account")
+        if (scope === "account") {
             this.cooldowns.note(accountKey(model.provider), failure);
+            if (failure.errorMessage)
+                this.accountErrors.set(model.provider, failure.errorMessage);
+        }
         else if (scope === "model" || isHealthExhaustionFailure(failure.errorMessage)) {
             this.cooldowns.note(entryKey(model), failure);
         }
@@ -23,15 +27,23 @@ export class UnusableEntries {
     isProviderSpent(provider) {
         return this.cooldowns.isSuppressed(accountKey(provider));
     }
+    accountError(provider) {
+        return this.isProviderSpent(provider) ? this.accountErrors.get(provider) : undefined;
+    }
     isUnusable(model) {
         return this.isProviderSpent(model.provider) || this.cooldowns.isSuppressed(entryKey(model));
     }
     clear(model) {
-        this.cooldowns.clear(accountKey(model.provider));
+        // A deliberate model selection allows the user to probe after reauth/reset.
         this.cooldowns.clear(entryKey(model));
+        this.cooldowns.clear(accountKey(model.provider));
+        this.accountErrors.delete(model.provider);
     }
 }
 function accountKey(provider) {
+    // This is a provider-name approximation, not resolved credential/account identity.
+    // Gateways with distinct model accounts share a key; pooled slots can reset earlier
+    // than the last surfaced account error. Explicit /model selection permits a probe.
     return `account:${provider}`;
 }
 function entryKey(model) {