@openrouter/agent 0.3.2 → 0.5.0

package/esm/openrouter.d.ts

@@ -1,5 +1,6 @@
 import { OpenRouterCore } from '@openrouter/sdk/core';
-import type { SDKHooks } from '@openrouter/sdk/hooks/hooks';
+import { SDKHooks } from '@openrouter/sdk/hooks/hooks';
+import type { AfterErrorHook, AfterSuccessHook, BeforeCreateRequestHook, BeforeRequestHook, SDKInitHook } from '@openrouter/sdk/hooks/types';
 import type { SDKOptions } from '@openrouter/sdk/lib/config';
 import type { RequestOptions } from '@openrouter/sdk/lib/sdks';
 import type { $ZodObject, $ZodShape, infer as zodInfer } from 'zod/v4/core';
@@ -7,15 +8,20 @@ import type { CallModelInput } from './lib/async-params.js';
 import type { ModelResult } from './lib/model-result.js';
 import type { Tool } from './lib/tool-types.js';
 export type { SDKOptions } from '@openrouter/sdk/lib/config';
+/** Any single hook interface supported by the underlying SDK. */
+export type Hook = SDKInitHook | BeforeCreateRequestHook | BeforeRequestHook | AfterSuccessHook | AfterErrorHook;
 /**
  * SDK options extended with optional hooks for request/response interception.
- * The underlying `ClientSDK` accepts hooks at runtime but its constructor type
- * (`SDKOptions`) does not include them. This type bridges that gap.
+ * `hooks` accepts an `SDKHooks` instance, a single hook object, or an array of
+ * hook objects; the constructor normalizes shorthand input into an `SDKHooks`
+ * instance before passing it to the underlying SDK, which only recognizes
+ * `hooks` when it is an `SDKHooks` instance.
  */
 export type OpenRouterOptions = SDKOptions & {
-    hooks?: SDKHooks;
+    hooks?: SDKHooks | Hook | readonly Hook[];
 };
 export declare class OpenRouter extends OpenRouterCore {
+    constructor(options?: OpenRouterOptions);
     callModel: <TTools extends readonly Tool[], TSharedSchema extends $ZodObject<$ZodShape> | undefined = undefined, TShared extends Record<string, unknown> = TSharedSchema extends $ZodObject<$ZodShape> ? zodInfer<TSharedSchema> : Record<string, never>>(request: CallModelInput<TTools, TShared> & {
         sharedContextSchema?: TSharedSchema;
     }, options?: RequestOptions) => ModelResult<TTools, TShared>;

package/esm/openrouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../src/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG;IAC3C,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,qBAAa,UAAW,SAAQ,cAAc;IAC5C,SAAS,GACP,MAAM,SAAS,SAAS,IAAI,EAAE,EAC9B,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,EACnE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GACjF,QAAQ,CAAC,aAAa,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzB,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACzC,mBAAmB,CAAC,EAAE,aAAa,CAAC;KACrC,EACD,UAAU,cAAc,KACvB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7B;CACH"}
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../src/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,iEAAiE;AACjE,MAAM,MAAM,IAAI,GACZ,WAAW,GACX,uBAAuB,GACvB,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG;IAC3C,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,IAAI,EAAE,CAAC;CAC3C,CAAC;AAmCF,qBAAa,UAAW,SAAQ,cAAc;gBAChC,OAAO,CAAC,EAAE,iBAAiB;IAYvC,SAAS,GACP,MAAM,SAAS,SAAS,IAAI,EAAE,EAC9B,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,EACnE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GACjF,QAAQ,CAAC,aAAa,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzB,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACzC,mBAAmB,CAAC,EAAE,aAAa,CAAC;KACrC,EACD,UAAU,cAAc,KACvB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7B;CACH"}

package/esm/openrouter.js

@@ -1,8 +1,47 @@
 import { OpenRouterCore } from '@openrouter/sdk/core';
+import { SDKHooks } from '@openrouter/sdk/hooks/hooks';
 import { callModel } from './inner-loop/call-model.js';
+function buildSDKHooks(input) {
+    if (input === undefined) {
+        return undefined;
+    }
+    if (input instanceof SDKHooks) {
+        return input;
+    }
+    const hooks = new SDKHooks();
+    const list = Array.isArray(input)
+        ? input
+        : [
+            input,
+        ];
+    for (const hook of list) {
+        if ('sdkInit' in hook) {
+            hooks.registerSDKInitHook(hook);
+        }
+        if ('beforeCreateRequest' in hook) {
+            hooks.registerBeforeCreateRequestHook(hook);
+        }
+        if ('beforeRequest' in hook) {
+            hooks.registerBeforeRequestHook(hook);
+        }
+        if ('afterSuccess' in hook) {
+            hooks.registerAfterSuccessHook(hook);
+        }
+        if ('afterError' in hook) {
+            hooks.registerAfterErrorHook(hook);
+        }
+    }
+    return hooks;
+}
 export class OpenRouter extends OpenRouterCore {
-    constructor() {
-        super(...arguments);
+    constructor(options) {
+        const { hooks: hooksInput, ...rest } = options ?? {};
+        const hooks = buildSDKHooks(hooksInput);
+        super(hooks === undefined
+            ? rest
+            : Object.assign({}, rest, {
+                hooks,
+            }));
         this.callModel = (request, options) => {
             return callModel(this, request, options);
         };

package/esm/openrouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../src/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAgBvD,MAAM,OAAO,UAAW,SAAQ,cAAc;IAA9C;;QACE,cAAS,GAAG,CAOV,OAEC,EACD,OAAwB,EACM,EAAE;YAChC,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC;CAAA"}
+{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../src/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAYvD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AA0BvD,SAAS,aAAa,CAAC,KAAoD;IACzE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAoB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC;YACE,KAAK;SACN,CAAC;IACN,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,qBAAqB,IAAI,IAAI,EAAE,CAAC;YAClC,KAAK,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;YAC5B,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YACzB,KAAK,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C,YAAY,OAA2B;QACrC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QACxC,KAAK,CACH,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE;gBACtB,KAAK;aACN,CAAC,CACP,CAAC;QAGJ,cAAS,GAAG,CAOV,OAEC,EACD,OAAwB,EACM,EAAE;YAChC,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC;IAfF,CAAC;CAgBF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/agent",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "author": "OpenRouter",
   "description": "Agent toolkit for building AI applications with OpenRouter — tool orchestration, streaming, multi-turn conversations, and format compatibility.",
   "keywords": [
@@ -93,28 +93,22 @@
   "sideEffects": false,
   "repository": {
     "type": "git",
-    "url": "https://github.com/OpenRouterTeam/typescript-agent.git"
+    "url": "https://github.com/OpenRouterTeam/typescript-agent.git",
+    "directory": "packages/agent"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
   "files": [
     "esm",
     "package.json",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "dependencies": {
-    "@openrouter/sdk": "*",
+    "@openrouter/sdk": "^0.12.12",
     "zod": "^4.0.0"
   },
-  "devDependencies": {
-    "@biomejs/biome": "^2.4.10",
-    "@changesets/changelog-github": "^0.6.0",
-    "@changesets/cli": "^2.30.0",
-    "@types/node": "^22.13.12",
-    "dotenv": "^16.4.7",
-    "husky": "^9.1.7",
-    "typescript": "~5.8.3",
-    "vitest": "^3.2.4"
-  },
   "scripts": {
     "lint": "biome check src tests",
     "lint:fix": "biome check --write src tests",