@d3ara1n/pi-model-roles 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d3ara1n/pi-model-roles",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Model role configuration library for pi extensions — defines named model roles and resolves them to Model instances",
   "main": "src/index.ts",

package/src/api.ts

@@ -168,6 +168,10 @@ export function initModelRolesAPI(
       const { model: _omitModel, ...streamOptions } = options ?? {};
       if (auth.apiKey) streamOptions.apiKey = auth.apiKey;
       if (auth.headers) streamOptions.headers = auth.headers;
+      // Apply the role's thinking level unless the caller explicitly overrides it.
+      if (roleConfig.thinking && streamOptions.reasoningEffort === undefined) {
+        streamOptions.reasoningEffort = roleConfig.thinking;
+      }
       return piAiComplete(model, context, streamOptions);
     },
 
@@ -188,6 +192,10 @@ export function initModelRolesAPI(
       const { model: _omitModel, ...streamOptions } = options ?? {};
       if (auth.apiKey) streamOptions.apiKey = auth.apiKey;
       if (auth.headers) streamOptions.headers = auth.headers;
+      // Apply the role's thinking level unless the caller explicitly overrides it.
+      if (roleConfig.thinking && streamOptions.reasoning === undefined) {
+        streamOptions.reasoning = roleConfig.thinking;
+      }
       return piAiStreamSimple(model, context, streamOptions);
     },
   };

package/src/types.ts

@@ -112,15 +112,17 @@ export interface ModelRolesAPI {
    * Call pi-ai's complete() with auth resolved internally from the role's model.
    *
    * Auth (including OAuth token refresh) is resolved for the model actually
-   * used, so callers never handle API keys or headers. The underlying call is
-   * pi-ai's complete() verbatim — no fallback, no retry, no error swallowing;
+   * used, so callers never handle API keys or headers. The role's
+   * {@link RoleConfig.thinking} level is applied as `reasoningEffort` unless
+   * the caller sets it explicitly. No fallback, no retry, no error swallowing;
    * throws if the role has no available model or auth resolution fails.
    *
-   * @param roleName - Role whose model + auth to use
+   * @param roleName - Role whose model + auth + thinking to use
    * @param context - Conversation context (systemPrompt + messages)
    * @param options - Stream options forwarded to pi-ai's complete(). Pass
    *   `model` to override the role's model (auth is then resolved for that
-   *   model); all other fields pass through unchanged.
+   *   model); pass `reasoningEffort` to override the role's thinking level;
+   *   all other fields pass through unchanged.
    */
   complete<TApi extends Api = Api>(
     roleName: string,
@@ -132,17 +134,20 @@ export interface ModelRolesAPI {
    * Call pi-ai's streamSimple() with auth resolved internally from the role's model.
    *
    * Streaming counterpart to {@link complete}. Same auth resolution (including
-   * OAuth token refresh) and same error semantics (throws on no model / auth
-   * failure). Returns the pi-ai event stream verbatim — iterate it for events,
-   * call `.result()` for the final AssistantMessage.
+   * OAuth token refresh), same thinking-level application (role's
+   * {@link RoleConfig.thinking} → `reasoning` unless overridden), and same
+   * error semantics (throws on no model / auth failure). Returns the pi-ai
+   * event stream — iterate it for events, call `.result()` for the final
+   * AssistantMessage.
    *
    * Note: unlike pi-ai's synchronous `streamSimple`, this is async because auth
    * resolution (OAuth token refresh) must complete before the stream starts.
    *
-   * @param roleName - Role whose model + auth to use
+   * @param roleName - Role whose model + auth + thinking to use
    * @param context - Conversation context (systemPrompt + messages)
    * @param options - Stream options forwarded to pi-ai's streamSimple(). Pass
-   *   `model` to override the role's model; all other fields pass through.
+   *   `model` to override the role's model; pass `reasoning` to override the
+   *   role's thinking level; all other fields pass through.
    */
   streamWithRole<TApi extends Api = Api>(
     roleName: string,