@oh-my-pi/pi-coding-agent 17.1.1 → 17.1.3

package/dist/types/cli/bench-cli.d.ts

@@ -21,6 +21,7 @@ export interface BenchCommandArgs {
 }
 export interface BenchModelRegistry {
     getAll(): Model<Api>[];
+    getAvailable(): Model<Api>[];
     getApiKey(model: Model<Api>, sessionId?: string): Promise<string | undefined>;
     resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
     hasConfiguredAuth?(model: Model<Api>): boolean;

package/dist/types/config/model-resolver.d.ts

@@ -78,7 +78,7 @@ export interface ModelMatchPreferences {
     deprioritizeProviders?: string[];
 }
 export type ModelLookupRegistry = Pick<ModelRegistry, "getAvailable">;
-type CliModelRegistry = Pick<ModelRegistry, "getAll">;
+type CliModelRegistry = Pick<ModelRegistry, "getAll" | "getAvailable">;
 type InitialModelRegistry = Pick<ModelRegistry, "getAvailable" | "find">;
 type RestorableModelRegistry = Pick<ModelRegistry, "getAvailable" | "find" | "getApiKey">;
 export declare function getModelMatchPreferences(settings?: Partial<Pick<Settings, "get" | "getStorage">>): ModelMatchPreferences;
@@ -279,13 +279,16 @@ export interface ResolveCliModelResult {
 /**
  * Resolve a single model from CLI flags.
  *
- * Exact model names take precedence over configured role names.
+ * Explicit `provider/id` references and authenticated bare ids take precedence
+ * over configured role names, which in turn take precedence over an
+ * unauthenticated catalog-only id (so a bundled `cursor/default` never shadows a
+ * configured `modelRoles.default`).
  */
 export declare function resolveCliModel(options: {
     cliProvider?: string;
     cliModel?: string;
     modelRegistry: CliModelRegistry;
-    /** Authenticated models to prefer for unqualified selectors; omit to preserve catalog-order behavior. */
+    /** Authenticated models to prefer for unqualified selectors; defaults to the registry's authenticated set. */
     availableModels?: Model<Api>[];
     settings?: Settings;
     preferences?: ModelMatchPreferences;

package/dist/types/config/settings-schema.d.ts

@@ -5811,6 +5811,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "searxng.engines": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
     readonly "searxng.language": {
         readonly type: "string";
         readonly default: undefined;

package/dist/types/launch/broker-list-order.test.d.ts

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

package/dist/types/modes/interactive-mode.d.ts

@@ -36,7 +36,7 @@ import { type LoopLimitRuntime } from "./loop-limit.js";
 import { OAuthManualInputManager } from "./oauth-manual-input.js";
 import { type ObservableSession } from "./session-observer-registry.js";
 import type { Theme } from "./theme/theme.js";
-import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types.js";
+import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, RenderSessionContextOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types.js";
 /**
  * Editor max-height cap for a terminal of `terminalRows` rows.
  *
@@ -309,11 +309,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
         imageLinks?: readonly (string | undefined)[];
         reuseSettledComponent?: boolean;
     }): Component[];
-    renderSessionContext(sessionContext: SessionContext, options?: {
-        updateFooter?: boolean;
-        populateHistory?: boolean;
-        reuseSettledComponents?: boolean;
-    }): void;
+    renderSessionContext(sessionContext: SessionContext, options?: RenderSessionContextOptions): void;
     renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;

package/dist/types/modes/types.d.ts

@@ -77,6 +77,13 @@ export interface InteractiveModeInitOptions {
     clearInitialTerminalHistory?: boolean;
 }
 export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
+export interface RenderSessionContextOptions {
+    updateFooter?: boolean;
+    populateHistory?: boolean;
+    reuseSettledComponents?: boolean;
+    /** Tool calls whose existing live component remains the sole render owner across a rebuild. */
+    preservedLiveToolCallIds?: ReadonlySet<string>;
+}
 export interface InteractiveModeContext {
     ui: TUI;
     chatContainer: TranscriptContainer;
@@ -284,11 +291,7 @@ export interface InteractiveModeContext {
         imageLinks?: readonly (string | undefined)[];
         reuseSettledComponent?: boolean;
     }): Component[];
-    renderSessionContext(sessionContext: SessionContext, options?: {
-        updateFooter?: boolean;
-        populateHistory?: boolean;
-        reuseSettledComponents?: boolean;
-    }): void;
+    renderSessionContext(sessionContext: SessionContext, options?: RenderSessionContextOptions): void;
     renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -1,7 +1,7 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { AssistantMessage, ImageContent, Message } from "@oh-my-pi/pi-ai";
 import { type Component } from "@oh-my-pi/pi-tui";
-import type { InteractiveModeContext } from "../../modes/types.js";
+import type { InteractiveModeContext, RenderSessionContextOptions } from "../../modes/types.js";
 import type { SessionContext } from "../../session/session-context.js";
 interface RenderInitialMessagesOptions {
     preserveExistingChat?: boolean;
@@ -12,11 +12,6 @@ type AddMessageOptions = {
     imageLinks?: readonly (string | undefined)[];
     reuseSettledComponent?: boolean;
 };
-type RenderSessionContextOptions = {
-    updateFooter?: boolean;
-    populateHistory?: boolean;
-    reuseSettledComponents?: boolean;
-};
 export declare class UiHelpers {
     #private;
     private ctx;

package/dist/types/task/executor.d.ts

@@ -21,7 +21,7 @@ import { type AgentReviver } from "../registry/agent-lifecycle.js";
 import type { AgentSession } from "../session/agent-session.js";
 import type { ArtifactManager } from "../session/artifacts.js";
 import type { AuthStorage } from "../session/auth-storage.js";
-import type { ConfiguredThinkingLevel } from "../thinking.js";
+import { type ConfiguredThinkingLevel, type TaskEffort } from "../thinking.js";
 import type { ContextFileEntry } from "../tools/index.js";
 import type { EventBus } from "../utils/event-bus.js";
 import type { WorkspaceTree } from "../workspace-tree.js";
@@ -81,6 +81,8 @@ export interface ExecutorOptions {
      */
     parentActiveModelPattern?: string;
     thinkingLevel?: ConfiguredThinkingLevel;
+    /** Caller-requested coarse effort (`lo`/`med`/`hi`); maps onto the resolved model's supported thinking range and wins over {@link thinkingLevel}. */
+    effort?: TaskEffort;
     /** Schema used to validate the final structured completion. */
     outputSchema?: unknown;
     /** Enforcement policy for {@link outputSchema}; defaults to legacy permissive behavior. */

package/dist/types/task/structured-subagent.d.ts

@@ -1,3 +1,4 @@
+import type { TaskEffort } from "../thinking.js";
 import type { ToolSession } from "../tools/index.js";
 import { type DiscoveryResult } from "./discovery.js";
 import { type AgentDefinition, type AgentProgress, type SingleResult, type StructuredSubagentOutput } from "./types.js";
@@ -40,6 +41,8 @@ export interface StructuredSubagentRequest {
     /** Presence, rather than truthiness, makes this the highest-priority schema. */
     outputSchema?: unknown;
     schemaMode?: StructuredSubagentSchemaMode;
+    /** Per-spawn thinking effort mapped onto the resolved model's supported range; overrides the agent's default selector. */
+    effort?: TaskEffort;
     identity?: StructuredSubagentIdentity;
     index?: number;
     parentToolCallId?: string;

package/dist/types/task/types.d.ts

@@ -1,7 +1,7 @@
 import type { Usage } from "@oh-my-pi/pi-ai";
 import { type BaseType } from "arktype";
 import type { AgentSessionEvent } from "../session/agent-session.js";
-import type { ConfiguredThinkingLevel } from "../thinking.js";
+import type { ConfiguredThinkingLevel, TaskEffort } from "../thinking.js";
 import type { NestedRepoPatch } from "./worktree.js";
 /** Source of an agent definition */
 export type AgentSource = "bundled" | "user" | "project";
@@ -83,7 +83,7 @@ export declare const taskItemSchema: import("arktype/internal/variants/object.ts
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    model?: string | string[] | undefined;
+    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
 }, {}>;
@@ -95,8 +95,8 @@ export interface TaskItem {
     agent?: string;
     /** The work; required by the schema. */
     task?: string;
-    /** Explicit model selector or fallback chain for this spawn, including optional reasoning suffixes. */
-    model?: string | string[];
+    /** Per-spawn thinking effort: lowest/middle/highest level the resolved model supports. Overrides the agent's default selector (e.g. `auto`). */
+    effort?: TaskEffort;
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */
@@ -108,7 +108,7 @@ export declare const taskSchema: import("arktype/internal/variants/object.ts").O
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    model?: string | string[] | undefined;
+    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
     isolated?: boolean | undefined;
@@ -117,7 +117,7 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    model?: string | string[] | undefined;
+    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
     isolated?: boolean | undefined;
@@ -125,7 +125,7 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    model?: string | string[] | undefined;
+    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
 }, {}>, import("arktype/internal/variants/object.ts").ObjectType<{
@@ -134,7 +134,7 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
         name?: string | undefined;
         agent: import("arktype/internal/attributes.ts").Default<string, "task">;
         task: string;
-        model?: string | string[] | undefined;
+        effort?: "hi" | "lo" | "med" | undefined;
         outputSchema?: string | boolean | object | null | undefined;
         schemaMode?: "permissive" | "strict" | undefined;
         isolated?: boolean | undefined;
@@ -145,7 +145,7 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
         name?: string | undefined;
         agent: import("arktype/internal/attributes.ts").Default<string, "task">;
         task: string;
-        model?: string | string[] | undefined;
+        effort?: "hi" | "lo" | "med" | undefined;
         outputSchema?: string | boolean | object | null | undefined;
         schemaMode?: "permissive" | "strict" | undefined;
     }[];
@@ -176,8 +176,8 @@ export interface TaskParams {
     agent?: string;
     /** The work (flat form). */
     task?: string;
-    /** Explicit model selector or fallback chain for the spawn, including optional reasoning suffixes. */
-    model?: string | string[];
+    /** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */
+    effort?: TaskEffort;
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */

package/dist/types/thinking.d.ts

@@ -88,6 +88,19 @@ export declare function parseCliThinkingLevel(value: string | null | undefined):
  * downstream.
  */
 export declare function clampAutoThinkingEffort(model: Model | undefined, effort: Effort): Effort | undefined;
+/** Coarse per-spawn effort selectors accepted by the task tool. */
+export declare const TASK_EFFORTS: readonly ["lo", "med", "hi"];
+/** Coarse task-spawn effort: the lowest, middle, or highest thinking level the target model supports. */
+export type TaskEffort = (typeof TASK_EFFORTS)[number];
+/**
+ * Maps a coarse task effort onto the model's supported thinking range:
+ * `lo` = lowest supported level, `hi` = highest (whatever the model tops out
+ * at — high, xhigh, or max), `med` = the middle (lower of the two middles for
+ * an even-sized range). Without a model, maps over the full canonical range.
+ * Returns `undefined` when the model has no controllable effort surface, so
+ * callers fall back to their default selector (e.g. `auto`).
+ */
+export declare function resolveTaskEffortLevel(model: Model | undefined, effort: TaskEffort): Effort | undefined;
 /**
  * The provisional concrete level shown while `auto` is configured but before a
  * turn has been classified. Prefers the model's `defaultLevel`, otherwise High,

package/dist/types/tools/auto-generated-guard.d.ts

@@ -1,11 +1,13 @@
+import { type Settings } from "../config/settings.js";
 /**
  * Check if a file is auto-generated by examining its content.
  * Throws ToolError if the file appears to be auto-generated.
  *
  * @param absolutePath - Absolute path to the file
  * @param displayPath - Path to show in error messages (relative or as provided)
+ * @param activeSettings - Session settings; falls back to global settings or the schema default
  */
-export declare function assertEditableFile(absolutePath: string, displayPath?: string): Promise<void>;
+export declare function assertEditableFile(absolutePath: string, displayPath?: string, activeSettings?: Settings): Promise<void>;
 /**
  * Check if file content is auto-generated.
  * Uses only the first CHECK_BYTE_COUNT characters of the content.
@@ -13,5 +15,6 @@ export declare function assertEditableFile(absolutePath: string, displayPath?: s
  *
  * @param content - File content to check (can be full content or prefix)
  * @param displayPath - Path to show in error messages
+ * @param activeSettings - Session settings; falls back to global settings or the schema default
  */
-export declare function assertEditableFileContent(content: string, displayPath: string): void;
+export declare function assertEditableFileContent(content: string, displayPath: string, activeSettings?: Settings): void;

package/dist/types/tools/eval-format/index.d.ts

@@ -0,0 +1,7 @@
+import type { EvalLanguage } from "../../eval/types.js";
+export * from "./javascript.js";
+export * from "./julia.js";
+export * from "./python.js";
+export * from "./ruby.js";
+/** Formats an arbitrary eval-code prefix for display without changing the executed source. */
+export declare function formatEvalCodeForDisplay(source: string, language: EvalLanguage): string;

package/dist/types/tools/eval-format/javascript.d.ts

@@ -0,0 +1,2 @@
+/** Formats JavaScript/TypeScript-like eval source for safe, stable display without requiring valid syntax. */
+export declare function formatJavaScriptForDisplay(source: string): string;

package/dist/types/tools/eval-format/julia.d.ts

@@ -0,0 +1,2 @@
+/** Formats an arbitrary Julia source prefix for stable, readable display. */
+export declare function formatJuliaForDisplay(source: string): string;

package/dist/types/tools/eval-format/python.d.ts

@@ -0,0 +1,2 @@
+/** Formats an arbitrary Python source prefix for stable, readable display. */
+export declare function formatPythonForDisplay(source: string): string;

package/dist/types/tools/eval-format/ruby.d.ts

@@ -0,0 +1,2 @@
+/** Formats an arbitrary Ruby source prefix for display without requiring valid syntax. */
+export declare function formatRubyForDisplay(source: string): string;

package/dist/types/tools/memory-render.d.ts

@@ -13,10 +13,7 @@ import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types.js";
 import type { Theme } from "../modes/theme/theme.js";
 interface RetainRenderArgs {
-    items?: Array<{
-        content?: string;
-        context?: string;
-    }>;
+    items?: unknown;
 }
 interface QueryRenderArgs {
     query?: string;

package/dist/types/tools/resolve.d.ts

@@ -27,6 +27,13 @@ export declare const PROPOSE_DEVICE_NAME = "propose";
 export declare const RESOLVE_DEVICE_PATH = "xd://resolve";
 export declare const REJECT_DEVICE_PATH = "xd://reject";
 export declare const PROPOSE_DEVICE_PATH = "xd://propose";
+/**
+ * Model-visible banner prepended to a staged preview's tool result text. The
+ * TUI badge (`⟨proposed⟩`) never reaches the model, and preview diffs are
+ * byte-identical to applied-edit output — without this line the model reads
+ * the result as an already-applied change.
+ */
+export declare const PREVIEW_PENDING_NOTICE = "Staged as a proposal \u2014 files NOT modified yet. To apply: write a one-sentence reason to xd://resolve. To discard: write to xd://reject.";
 export type ResolutionDeviceName = typeof RESOLVE_DEVICE_NAME | typeof REJECT_DEVICE_NAME | typeof PROPOSE_DEVICE_NAME;
 /** Whether an xd:// device name is one of the plain-text resolution devices. */
 export declare function isResolutionDeviceName(name: string): name is ResolutionDeviceName;

package/dist/types/tools/todo.d.ts

@@ -44,6 +44,8 @@ declare const todoSchema: import("arktype/internal/variants/object.ts").ObjectTy
 }, {}>;
 type TodoParams = TodoSchema;
 type TodoSchema = typeof todoSchema.infer;
+/** A single todo op entry (the params object itself). */
+type TodoOpEntryValue = TodoParams;
 /** Return the active todo task, preferring an in-progress item over the first pending item. */
 export declare function nextActionableTask(phases: readonly TodoPhase[]): TodoItem | undefined;
 export declare const USER_TODO_EDIT_CUSTOM_TYPE = "user_todo_edit";
@@ -92,7 +94,7 @@ export declare function selectCollapsedTodos<T extends {
     status: TodoStatus;
 }>(tasks: T[], isMatched: (task: T) => boolean, cap: number): CollapsedTodoSelection<T>;
 /** Apply an array of `todo`-style ops to existing phases. Used by /todo slash command. */
-export declare function applyOpsToPhases(currentPhases: TodoPhase[], ops: TodoParams[]): {
+export declare function applyOpsToPhases(currentPhases: TodoPhase[], ops: TodoOpEntryValue[]): {
     phases: TodoPhase[];
     errors: string[];
 };
@@ -124,6 +126,7 @@ export declare class TodoTool implements AgentTool<typeof todoSchema, TodoToolDe
     }, {}>;
     readonly concurrency = "exclusive";
     readonly strict = true;
+    readonly lenientArgValidation = true;
     readonly examples: readonly ToolExample<typeof todoSchema.infer>[];
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);

package/dist/types/web/search/providers/base.d.ts

@@ -1,5 +1,6 @@
 import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
 import type { ModelRegistry } from "../../../config/model-registry.js";
+import type { StructuredQuery } from "../query.js";
 import type { SearchProviderId, SearchResponse } from "../types.js";
 /**
  * Shared web search parameters passed to providers.
@@ -13,6 +14,21 @@ import type { SearchProviderId, SearchResponse } from "../types.js";
  */
 export interface SearchParams {
     query: string;
+    /**
+     * Structured view of `query`, parsed once by the search pipeline:
+     * Google-style directives (`site:`, `before:`/`after:`, `inurl:`,
+     * `intitle:`, `filetype:`, quoted phrases, `OR` groups, `-exclusions`)
+     * extracted into fields.
+     *
+     * Providers SHOULD map constraints onto native API parameters
+     * (domain/date filters) or engine query syntax (`formatQuery`) where the
+     * upstream supports them, and lean lenient otherwise: the pipeline
+     * post-filters every response with `applyQueryConstraints`, which
+     * relaxes any constraint that would eliminate all results — so a
+     * best-effort search always beats an empty one. When absent (direct
+     * provider calls), parse with `parseSearchQuery(params.query)`.
+     */
+    parsedQuery?: StructuredQuery;
     limit?: number;
     /**
      * Temporal filter narrowing results to the specified time window.

package/dist/types/web/search/providers/brave.d.ts

@@ -6,12 +6,14 @@
  */
 import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import type { StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 export interface BraveSearchParams {
     query: string;
     num_results?: number;
     recency?: "day" | "week" | "month" | "year";
+    parsedQuery?: StructuredQuery;
     signal?: AbortSignal;
     fetch?: FetchImpl;
 }

package/dist/types/web/search/providers/firecrawl.d.ts

@@ -12,6 +12,8 @@ export interface FirecrawlSearchParams {
     query: string;
     num_results?: number;
     recency?: SearchParams["recency"];
+    /** Explicit `tbs` (custom date range); takes precedence over `recency`. */
+    tbs?: string;
     signal?: AbortSignal;
     fetch?: FetchImpl;
 }

package/dist/types/web/search/providers/gemini.d.ts

@@ -10,6 +10,7 @@
  */
 import { type AuthStorage, type FetchImpl, type OAuthAccess } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import { type StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 declare const GEMINI_PROVIDERS: readonly ["google-gemini-cli", "google-antigravity"];
@@ -21,6 +22,8 @@ interface GeminiToolParams {
 }
 export interface GeminiSearchParams extends GeminiToolParams {
     query: string;
+    /** Pre-parsed structured query; falls back to parsing `query` when omitted. */
+    parsedQuery?: StructuredQuery;
     system_prompt?: string;
     num_results?: number;
     /** Maximum output tokens. */

package/dist/types/web/search/providers/jina.d.ts

@@ -14,6 +14,8 @@ type SearchParamsWithFetch = SearchParams & {
 export interface JinaSearchParams {
     query: string;
     num_results?: number;
+    /** Single bare host for Jina's `X-Site` in-site search header. */
+    site?: string;
     signal?: AbortSignal;
     fetch?: FetchImpl;
 }

package/dist/types/web/search/providers/kagi.d.ts

@@ -5,6 +5,7 @@
  */
 import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import type { StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 type SearchParamsWithFetch = SearchParams & {
@@ -15,6 +16,7 @@ export declare function searchKagi(params: {
     query: string;
     num_results?: number;
     recency?: SearchParams["recency"];
+    parsedQuery?: StructuredQuery;
     signal?: AbortSignal;
     authStorage: AuthStorage;
     sessionId?: string;

package/dist/types/web/search/providers/kimi.d.ts

@@ -9,6 +9,7 @@
  */
 import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import { type StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 type SearchParamsWithFetch = SearchParams & {
@@ -16,6 +17,7 @@ type SearchParamsWithFetch = SearchParams & {
 };
 export interface KimiSearchParams {
     query: string;
+    parsedQuery?: StructuredQuery;
     num_results?: number;
     include_content?: boolean;
     signal?: AbortSignal;

package/dist/types/web/search/providers/parallel.d.ts

@@ -1,5 +1,6 @@
 import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import { type StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 export declare function searchParallel(params: {
@@ -7,6 +8,7 @@ export declare function searchParallel(params: {
     num_results?: number;
     signal?: AbortSignal;
     fetch?: FetchImpl;
+    parsedQuery?: StructuredQuery;
 }, authStorage: AuthStorage, sessionId?: string): Promise<SearchResponse>;
 export declare class ParallelProvider extends SearchProvider {
     readonly id = "parallel";

package/dist/types/web/search/providers/perplexity.d.ts

@@ -9,12 +9,15 @@
  */
 import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import { type StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 export interface PerplexitySearchParams {
     signal?: AbortSignal;
     query: string;
     system_prompt?: string;
+    /** Pre-parsed view of `query` from the search pipeline; parsed locally when absent. */
+    parsedQuery?: StructuredQuery;
     search_recency_filter?: "hour" | "day" | "week" | "month" | "year";
     num_results?: number;
     /** Maximum output tokens. Defaults to 8192. */

package/dist/types/web/search/providers/searxng.d.ts

@@ -14,6 +14,9 @@
  *   searxng.basicUsername - Optional RFC 7617 Basic auth username
  *   searxng.basicPassword - Optional RFC 7617 Basic auth password
  *   searxng.categories    - Optional comma-separated categories filter
+ *   searxng.engines       - Optional comma-separated engine names or shortcuts
+ *                           (e.g. "duckduckgo, br, sp"); shortcuts resolve via
+ *                           the instance's /config endpoint
  *   searxng.language      - Optional language code (e.g. en, zh-CN)
  *
  * Environment variable fallbacks:
@@ -22,15 +25,22 @@
  *   SEARXNG_BASIC_USERNAME - Optional RFC 7617 Basic auth username
  *   SEARXNG_BASIC_PASSWORD - Optional RFC 7617 Basic auth password
  *
+ * Bang syntax in queries is passed through: `!ddg foo` selects an engine or
+ * category server-side and the bang token is stripped from the upstream query.
+ * External bangs (`!!g`) are removed client-side because SearXNG answers them
+ * with an HTTP redirect even for JSON requests.
+ *
  * Reference: https://docs.searxng.org/dev/search_api.html
  */
 import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types.js";
+import type { StructuredQuery } from "../query.js";
 import type { SearchParams } from "./base.js";
 import { SearchProvider } from "./base.js";
 /** Execute SearXNG web search. */
 export declare function searchSearXNG(params: {
     query: string;
+    parsedQuery?: StructuredQuery;
     num_results?: number;
     recency?: "day" | "week" | "month" | "year";
     signal?: AbortSignal;

package/dist/types/web/search/providers/tavily.d.ts

@@ -12,6 +12,14 @@ export interface TavilySearchParams {
     query: string;
     num_results?: number;
     recency?: "day" | "week" | "month" | "year";
+    /** `site:` hosts mapped to Tavily's `include_domains`. */
+    include_domains?: string[];
+    /** `-site:` hosts mapped to Tavily's `exclude_domains`. */
+    exclude_domains?: string[];
+    /** `after:` inclusive lower bound, ISO `YYYY-MM-DD`, mapped to `start_date`. */
+    start_date?: string;
+    /** `before:` upper bound, ISO `YYYY-MM-DD`, mapped to `end_date`. */
+    end_date?: string;
     signal?: AbortSignal;
     fetch?: FetchImpl;
 }