@noetic-tools/types 1.1.0 → 1.2.0

package/dist/types/common.d.ts

@@ -13,6 +13,28 @@ export interface RetryPolicy {
     /** Upper bound in ms for the computed delay (caps exponential/linear growth). */
     maxDelay?: number;
 }
+/**
+ * Declares an OpenRouter server-executed tool on an LLM step. OpenRouter runs
+ * the tool (web search, web fetch) provider-side and returns the result item in
+ * the response — no client-side execute function is involved.
+ *
+ * `parameters` keys are camelCase (e.g. `maxResults`, `searchContextSize`); the
+ * SDK re-serialises them to the wire format and silently drops unknown keys.
+ * @public
+ */
+export interface ServerToolSpec {
+    /** Server tool discriminator. */
+    type: 'openrouter:web_search' | 'openrouter:web_fetch';
+    /** Optional provider config forwarded to the tool (camelCase keys). */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * Distinguishes an inline `ServerToolSpec` from a client `Tool` in a
+ * heterogeneous `tools` list. A server-tool spec carries a server-tool `type`
+ * discriminator and, unlike a `Tool`, has no `execute` method.
+ * @public
+ */
+export declare function isServerToolSpec(value: unknown): value is ServerToolSpec;
 /**
  * Optional parameters forwarded to the model provider during an LLM step.
  * @public

package/dist/types/common.js

@@ -1 +1,19 @@
-export {};
+/**
+ * Distinguishes an inline `ServerToolSpec` from a client `Tool` in a
+ * heterogeneous `tools` list. A server-tool spec carries a server-tool `type`
+ * discriminator and, unlike a `Tool`, has no `execute` method.
+ * @public
+ */
+export function isServerToolSpec(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    if ('execute' in value) {
+        return false;
+    }
+    if (!('type' in value)) {
+        return false;
+    }
+    const { type } = value;
+    return type === 'openrouter:web_search' || type === 'openrouter:web_fetch';
+}

package/dist/types/runtime.d.ts

@@ -1,6 +1,6 @@
 import type { ZodType } from 'zod';
 import type { Channel, ChannelHandle, ExternalChannel } from './channel.js';
-import type { LLMResponse, ModelParams } from './common.js';
+import type { LLMResponse, ModelParams, ServerToolSpec } from './common.js';
 import type { Context, CwdState } from './context.js';
 import type { DetachedHandle } from './detached.js';
 import type { FsAdapter } from './fs-adapter.js';
@@ -54,6 +54,16 @@ interface CallModelRequestBase {
     outputSchema?: ZodType;
     /** Controls framework event emission. Defaults to `true`. Passed through from `StepLLM.emit`. */
     emit?: boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
+    /**
+     * @internal
+     * Framework-internal carrier for OpenRouter server tools (web search/fetch).
+     * Server tools are an authoring concept inside `StepLLM.tools` — the
+     * interpreter partitions those entries out of the client `tools` list and
+     * stamps the specs here so the model caller can wrap them via the SDK's
+     * `serverTool()` and append them to the SDK tools array. NOT an authored
+     * field: public callers declare server tools as `tools` entries, never here.
+     */
+    _serverTools?: ServerToolSpec[];
     /** Optional signal for cancelling the in-flight call (used by session abort). */
     signal?: AbortSignal;
     /**

package/dist/types/step.d.ts

@@ -1,6 +1,6 @@
 import type { ZodType } from 'zod';
 import type { Channel } from './channel.js';
-import type { ModelParams, RetryPolicy, StepMeta } from './common.js';
+import type { ModelParams, RetryPolicy, ServerToolSpec, StepMeta } from './common.js';
 import type { Context } from './context.js';
 import type { NoeticError } from './error.js';
 import type { ContextMemory, MemoryConfig, MemoryLayer, ProjectionPolicy } from './memory.js';
@@ -94,8 +94,14 @@ export interface StepLLM<TMemory = ContextMemory, _I = unknown, O = unknown> {
     model: Lazy<string, TMemory>;
     /** System instructions. Eager string or `(ctx) => string | undefined` getter. */
     instructions?: Lazy<string | undefined, TMemory>;
-    /** Tools exposed to the LLM. Eager array or `(ctx) => Tool[] | undefined` getter. Function-form tools do not contribute to the pre-computed `ctx.unifiedTools`; they are resolved per execution. */
-    tools?: Lazy<Tool[] | undefined, TMemory>;
+    /**
+     * Tools exposed to the LLM. Eager array or `(ctx) => (...)[] | undefined` getter.
+     * Entries are either a client `Tool` or an inline `ServerToolSpec` (an
+     * OpenRouter server tool the provider executes, e.g. web search/fetch).
+     * Function-form tools do not contribute to the pre-computed `ctx.unifiedTools`;
+     * they are resolved per execution.
+     */
+    tools?: Lazy<(Tool | ServerToolSpec)[] | undefined, TMemory>;
     output?: ZodType<O>;
     params?: ModelParams;
     /** Controls framework event emission for this step. Defaults to `true`. Set `false` to suppress all framework events. A filter function receives `(eventType, data)` and returns `boolean`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/types",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "Foundational type contracts and primitives shared across the Noetic framework (items, LLM config, adapters, steering, errors).",
   "license": "Apache-2.0",