pi-adaptive-thinking 0.0.0

package/README.md

@@ -0,0 +1,85 @@
+<div align="center">
+
+# pi-adaptive-thinking
+
+Bring adaptive reasoning-effort control to Pi agents.
+
+</div>
+
+`pi-adaptive-thinking` is a Pi extension that lets the agent change Pi's thinking level through a tool named `set_reasoning_effort`.
+
+It mirrors the user-facing behavior of `opencode-adaptive-thinking` while using Pi-native APIs: `pi.getThinkingLevel()`, `pi.setThinkingLevel()`, and `thinking_level_select`.
+
+## Installation
+
+```bash
+pi install npm:pi-adaptive-thinking
+```
+
+For local development:
+
+```bash
+pnpm install
+pnpm build
+pi -e ./dist/index.js
+```
+
+## Behavior
+
+The extension registers a tool with these parameters:
+
+- `level`: one of the valid Pi thinking levels for the current model.
+- `persist`: optional boolean, default `false`.
+
+Temporary changes:
+
+```json
+{ "level": "high", "persist": false }
+```
+
+This changes reasoning effort for the current agent turn and restores the prior/baseline level when the turn ends.
+
+Persistent changes:
+
+```json
+{ "level": "low", "persist": true }
+```
+
+This changes the session baseline until another persistent change is made or the user changes thinking level manually.
+
+## Configuration
+
+Configuration files are loaded in this order:
+
+1. Project: `.pi/adaptive-thinking.json`
+2. Global: `~/.pi/agent/adaptive-thinking.json`
+3. Built-in defaults
+
+Project configuration takes precedence over global configuration.
+
+```json
+{
+  "enabled": true,
+  "quiet": false,
+  "toolName": "set_reasoning_effort",
+  "toolDescription": "Set your reasoning effort",
+  "systemPrompt": "You MUST manage reasoning effort actively. Lower it before trivial or routine turns; raise it for ambiguity, debugging, risky changes, or multi-step synthesis. Reassess at turn start, after meaningful new evidence, and when the task shifts. NEVER leave the current level unchanged by inertia, and NEVER reply to a trivial turn before considering a downshift."
+}
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm format:check
+pnpm lint
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+Run all checks:
+
+```bash
+pnpm verify
+```

package/dist/config-loader.d.ts

@@ -0,0 +1,16 @@
+import { type AdaptiveThinkingConfig } from "./config.js";
+export type { AdaptiveThinkingConfig } from "./config.js";
+export type LoadConfigOptions = {
+    cwd: string;
+    homeDir?: string;
+};
+export type LoadConfigResult = {
+    success: true;
+    config: AdaptiveThinkingConfig;
+    source?: string;
+} | {
+    success: false;
+    source: string;
+    error: Error;
+};
+export declare const loadConfig: ({ cwd, homeDir, }: LoadConfigOptions) => Promise<LoadConfigResult>;

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+import { Type, type Static } from "typebox";
+export declare const defaultSystemPrompt: string;
+export declare const configDefaults: {
+    enabled: boolean;
+    quiet: boolean;
+    toolName: string;
+    toolDescription: string;
+    systemPrompt: string;
+};
+export declare const ConfigSchema: Type.TObject<{
+    enabled: Type.TBoolean;
+    quiet: Type.TBoolean;
+    toolName: Type.TString;
+    toolDescription: Type.TString;
+    systemPrompt: Type.TString;
+}>;
+export type AdaptiveThinkingConfig = Static<typeof ConfigSchema>;
+export declare const parseConfig: (input: unknown) => AdaptiveThinkingConfig;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function adaptiveThinking(pi: ExtensionAPI): void;