@astralyn/pi 1.0.5 → 1.2.0

package/dist/modes/interactive/theme/theme-schema.json

@@ -1,361 +0,0 @@
-{
-	"$schema": "http://json-schema.org/draft-07/schema#",
-	"title": "Pi Coding Agent Theme",
-	"description": "Theme schema for Pi coding agent",
-	"type": "object",
-	"required": ["name", "colors"],
-	"properties": {
-		"$schema": {
-			"type": "string",
-			"description": "JSON schema reference"
-		},
-		"name": {
-			"type": "string",
-			"pattern": "^[^/]+$",
-			"description": "Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings."
-		},
-		"appearance": {
-			"type": "string",
-			"enum": ["dark", "light"],
-			"description": "Background the theme is designed for. Detected from the theme colors when omitted."
-		},
-		"vars": {
-			"type": "object",
-			"description": "Reusable color variables",
-			"additionalProperties": {
-				"oneOf": [
-					{
-						"type": "string",
-						"description": "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default"
-					},
-					{
-						"type": "integer",
-						"minimum": 0,
-						"maximum": 255,
-						"description": "256-color palette index (0-255)"
-					}
-				]
-			}
-		},
-		"colors": {
-			"type": "object",
-			"description": "Theme color definitions (scrollbar, thinkingMax, and search highlight colors are optional and use compatible fallbacks)",
-			"required": [
-				"accent",
-				"border",
-				"borderAccent",
-				"borderMuted",
-				"success",
-				"error",
-				"warning",
-				"muted",
-				"dim",
-				"text",
-				"thinkingText",
-				"selectedBg",
-				"userMessageBg",
-				"userMessageText",
-				"customMessageBg",
-				"customMessageText",
-				"customMessageLabel",
-				"toolPendingBg",
-				"toolSuccessBg",
-				"toolErrorBg",
-				"toolTitle",
-				"toolOutput",
-				"mdHeading",
-				"mdLink",
-				"mdLinkUrl",
-				"mdCode",
-				"mdCodeBlock",
-				"mdCodeBlockBorder",
-				"mdQuote",
-				"mdQuoteBorder",
-				"mdHr",
-				"mdListBullet",
-				"toolDiffAdded",
-				"toolDiffRemoved",
-				"toolDiffContext",
-				"syntaxComment",
-				"syntaxKeyword",
-				"syntaxFunction",
-				"syntaxVariable",
-				"syntaxString",
-				"syntaxNumber",
-				"syntaxType",
-				"syntaxOperator",
-				"syntaxPunctuation",
-				"thinkingOff",
-				"thinkingMinimal",
-				"thinkingLow",
-				"thinkingMedium",
-				"thinkingHigh",
-				"thinkingXhigh",
-				"bashMode"
-			],
-			"properties": {
-				"accent": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Primary accent color (logo, selected items, cursor)"
-				},
-				"border": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Normal borders"
-				},
-				"borderAccent": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Highlighted borders"
-				},
-				"borderMuted": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Subtle borders"
-				},
-				"success": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Success states"
-				},
-				"error": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Error states"
-				},
-				"warning": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Warning states"
-				},
-				"muted": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Secondary/dimmed text"
-				},
-				"dim": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Very dimmed text (more subtle than muted)"
-				},
-				"text": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Default text color (usually empty string)"
-				},
-				"thinkingText": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking block text color"
-				},
-				"selectedBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Selected item background"
-				},
-				"scrollbarTrack": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Fullscreen scrollbar track foreground (falls back to muted when omitted)"
-				},
-				"scrollbarThumb": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Fullscreen scrollbar thumb foreground (falls back to text when omitted)"
-				},
-				"searchMatchBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Transcript search match background and current-match text (falls back to selectedBg when omitted)"
-				},
-				"searchMatchText": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Transcript search match text and current-match background (falls back to text when omitted)"
-				},
-				"userMessageBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "User message background"
-				},
-				"userMessageText": {
-					"$ref": "#/$defs/colorValue",
-					"description": "User message text color"
-				},
-				"customMessageBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Custom message background (hook-injected messages)"
-				},
-				"customMessageText": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Custom message text color"
-				},
-				"customMessageLabel": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Custom message type label color"
-				},
-				"toolPendingBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Tool execution box (pending state)"
-				},
-				"toolSuccessBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Tool execution box (success state)"
-				},
-				"toolErrorBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Tool execution box (error state)"
-				},
-				"toolTitle": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Tool execution box title color"
-				},
-				"toolOutput": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Tool execution box output text color"
-				},
-				"mdHeading": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown heading text"
-				},
-				"mdLink": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown link text"
-				},
-				"mdLinkUrl": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown link URL"
-				},
-				"mdCode": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown inline code"
-				},
-				"mdCodeBlock": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown code block content"
-				},
-				"mdCodeBlockBorder": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown code block fences"
-				},
-				"mdQuote": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown blockquote text"
-				},
-				"mdQuoteBorder": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown blockquote border"
-				},
-				"mdHr": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown horizontal rule"
-				},
-				"mdListBullet": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Markdown list bullets/numbers"
-				},
-				"toolDiffAdded": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Added lines in tool diffs"
-				},
-				"toolDiffRemoved": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Removed lines in tool diffs"
-				},
-				"toolDiffContext": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Context lines in tool diffs"
-				},
-				"syntaxComment": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: comments"
-				},
-				"syntaxKeyword": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: keywords"
-				},
-				"syntaxFunction": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: function names"
-				},
-				"syntaxVariable": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: variable names"
-				},
-				"syntaxString": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: string literals"
-				},
-				"syntaxNumber": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: number literals"
-				},
-				"syntaxType": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: type names"
-				},
-				"syntaxOperator": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: operators"
-				},
-				"syntaxPunctuation": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Syntax highlighting: punctuation"
-				},
-				"thinkingOff": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: off"
-				},
-				"thinkingMinimal": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: minimal"
-				},
-				"thinkingLow": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: low"
-				},
-				"thinkingMedium": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: medium"
-				},
-				"thinkingHigh": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: high"
-				},
-				"thinkingXhigh": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: xhigh"
-				},
-				"thinkingMax": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Thinking level border: max (falls back to thinkingXhigh when omitted)"
-				},
-				"bashMode": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Editor border color in bash mode"
-				}
-			},
-			"additionalProperties": false
-		},
-		"export": {
-			"type": "object",
-			"description": "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
-			"properties": {
-				"pageBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Page background color"
-				},
-				"cardBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Card/container background color"
-				},
-				"infoBg": {
-					"$ref": "#/$defs/colorValue",
-					"description": "Info sections background (system prompt, notices)"
-				}
-			},
-			"additionalProperties": false
-		}
-	},
-	"additionalProperties": false,
-	"$defs": {
-		"colorValue": {
-			"oneOf": [
-				{
-					"type": "string",
-					"description": "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default"
-				},
-				{
-					"type": "integer",
-					"minimum": 0,
-					"maximum": 255,
-					"description": "256-color palette index (0-255)"
-				}
-			]
-		}
-	}
-}

package/docs/bundled/extensions/web-search.md

@@ -1,46 +0,0 @@
-# Web Search
-
-`web_search` is a Pi-native tool for querying live web information through MiniMax and DeepSeek search engines.
-
-When both engines are configured, searches run concurrently and results are fused with reciprocal-rank scoring: URLs are normalized (tracking parameters and fragments stripped), duplicates are merged, and high-ranked results from both engines remain represented.
-
-| Engine mode | Requirement |
-|---|---|
-| `dual` | Both MiniMax and DeepSeek keys configured |
-| `minimax` | Only a MiniMax key configured |
-| `deepseek` | Only a DeepSeek key configured |
-| `none` | No key found — the tool reports itself disabled |
-
-## Credentials
-
-Keys are resolved per provider through the runtime's canonical auth chain (`ModelRuntime.getAuth`: runtime API key → `auth.json` → `models.json` → environment). When no runtime is available (or it does not know the provider), the extension falls back to reading `auth.json` directly (provider IDs `minimax-cn`, `minimax`, `deepseek`, including command-configured keys such as `"!op read ..."`) and then the environment variables `MINIMAX_CN_API_KEY`, `MINIMAX_API_KEY`, `DEEPSEEK_API_KEY`.
-
-The MiniMax CN account (`minimax-cn`) is preferred over the global one (`minimax`) and selects the `api.minimaxi.com` search host; the global account uses `api.minimax.io`, overridable via `MINIMAX_API_HOST`.
-
-Configure with `/login minimax-cn` or `/login deepseek`, or by exporting the environment variables above.
-
-When no key is configured, `web_search` is removed from the model's tool set and system prompt entirely — the model never sees or calls it. This is re-evaluated on every session start (`startup`, `/new`, `/reload`, resume, fork). When credentials are available, the extension leaves the host's active-tool set unchanged: normal registration keeps the tool available by default, while an explicit `/tools` or SDK-host disable remains respected until that host enables it again. The tool always stays registered for `/tools` and historical rendering; force-enabling it without keys returns the disabled message.
-
-## Usage
-
-### Parameters
-
-- `query`: the search query, up to 500 characters — 3–5 keywords work best; include a year when freshness matters.
-
-### Output
-
-The model-facing payload is Markdown containing up to 12 HTTP(S) source results. Titles and snippets are bounded to 200 characters each, source URLs to 2048 characters, DeepSeek synthesis to 6000 characters, and up to 8 related searches to 200 characters each. Results found by both providers are tagged as such; this means the URL appeared in both result sets, not that its claims were independently verified. When structured source URLs are present, the tool result reminds the model to cite the relevant URLs without prescribing a heading or response format.
-
-## Limits
-
-- With no configured key the tool is hidden from the model (see Credentials); the disabled message only appears when the tool was force-enabled via `/tools` without keys.
-- Engine failures are independent: if one engine errors, the other's results are still returned; the tool errors only when every configured engine fails. Error outcomes are marked as protocol-level tool errors; the credential-disabled warning is not.
-- MiniMax search uses the Coding Plan Search endpoint (`POST /v1/coding_plan/search`), which requires a Coding Plan key — a standard MiniMax API key may be rejected upstream.
-- DeepSeek search goes through the Anthropic-compatible endpoint (`/anthropic/v1/messages`, model `claude-sonnet-search`) with the server-side `web_search_20250305` tool; the request uses `max_tokens: 1024`, followed by the local output bound above. A response must contain a structured `web_search_tool_result`: an empty result array is a valid zero-result search, while text-only, malformed, or structured-error responses count as a provider failure and their synthesis is discarded.
-- Requests time out after 60 seconds (MiniMax) or 90 seconds (DeepSeek) and surface as Pi tool errors. Successful upstream response bodies are limited to 2 MiB, error bodies to 200 bytes, and model-facing error messages to 500 characters.
-
-## Implementation notes
-
-The extension keeps presentation Pi-native: the call line shows the query, in-flight renders show the engine label with elapsed time past 2s, the collapsed result shows hit count, engines, duration, and a top-domain preview with the configured expand hint, and expanding renders the result sections from `details` — without the model-facing agent directives — falling back to the raw payload for legacy entries.
-
-Credential resolution never inspects `getProviderAuthStatus` — that probe returns a truthy `AuthStatus` object even when nothing is configured and carries no key. Only `getAuth` returns usable key material.

package/examples/plugins/pi-example-plugin/README.md

@@ -1,38 +0,0 @@
-# `@earendil-works/pi-example-plugin`
-
-This package provides conventional `session` and `tui` Chord facets. The Session-worker facet provides a remote greeting service. The TUI facet contributes `/hello` and calls that service.
-
-The package needs no build script. Pi asks Chord to discover `src/session.ts` and `src/tui.ts`, builds both entries into its server-owned plugin cache, and sends the TUI artifact to clients.
-
-From this directory's parent of parents (the repository root):
-
-```bash
-PI_EXPERIMENTAL=1 pi experimental server \
-  -e "$PWD/examples/plugins/pi-example-plugin"
-```
-
-Alternatively, a client can select the plugin for the Session it creates or resumes on one local server:
-
-```bash
-PI_EXPERIMENTAL=1 pi experimental client \
-  -e "$PWD/examples/plugins/pi-example-plugin"
-```
-
-Repeat `-e` to select multiple plugin packages. Client paths are resolved locally and sent only to a Unix server; Radius clients cannot select server filesystem paths. The Session and matching TUI facets are stored with that Session, so later server generations and clients can resume it without plugin arguments. Other Sessions and their workers are unaffected. An active Session rejects a different package selection instead of being restarted.
-
-`server -e` establishes the server profile's default Session and TUI facets. Starting an explicit foreground server without `-e` clears that default. Client selection never changes the server's root facet generation.
-
-Run `/hello Armin` in the TUI. After editing a facet, run `/reload`. The server atomically rebuilds the package, reloads the attached Session-worker generation, updates the current TUI generation, and serves the new artifact to future clients.
-
-Package metadata can override or disable conventional entries:
-
-```json
-{
-  "chord": {
-    "facets": {
-      "session": "./src/worker.ts",
-      "tui": false
-    }
-  }
-}
-```

package/examples/plugins/pi-example-plugin/package.json

@@ -1,10 +0,0 @@
-{
-	"name": "@earendil-works/pi-example-plugin",
-	"version": "1.0.0",
-	"private": true,
-	"type": "module",
-	"peerDependencies": {
-		"@astralyn/pi": "^0.85.0",
-		"@earendil-works/chord": "^0.85.0"
-	}
-}

package/examples/plugins/pi-example-plugin/src/contract.ts

@@ -1,13 +0,0 @@
-import { type Context, defineService, type ReplicatedState } from "@earendil-works/chord";
-
-export interface ExampleFacetReply {
-	readonly message: string;
-	readonly workerActivations: number;
-}
-
-export interface ExampleFacetService {
-	readonly workerActivations: ReplicatedState<{ count: number }>;
-	greet(input: { readonly name: string }, context: Context): Promise<ExampleFacetReply>;
-}
-
-export const ExampleFacetService = defineService<ExampleFacetService>("pi.example-plugin.greeting");

package/examples/plugins/pi-example-plugin/src/session.ts

@@ -1,24 +0,0 @@
-import { defineFacet } from "@earendil-works/chord";
-import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
-import { ExampleFacetService } from "./contract.ts";
-
-export default defineFacet({
-	id: "@earendil-works/pi-example-plugin/session",
-	setup(env) {
-		const workerActivations = env.replicatedState({ count: 0 });
-		env.provide(ExampleFacetService, {
-			workerActivations,
-			async greet({ name }) {
-				return {
-					message: `Hello ${name} from the bundled Session worker facet!!!`,
-					workerActivations: workerActivations.value.count,
-				};
-			},
-		});
-		env.onActivate(() => {
-			workerActivations.change(BACKGROUND_CONTEXT, (draft) => {
-				draft.count += 1;
-			});
-		});
-	},
-});

package/examples/plugins/pi-example-plugin/src/tui.ts

@@ -1,31 +0,0 @@
-import { AgentController, PresentationUI, SlashCommands } from "@astralyn/pi/experimental/plugin";
-import { defineFacet } from "@earendil-works/chord";
-import { ExampleFacetService } from "./contract.ts";
-
-export default defineFacet({
-	id: "@earendil-works/pi-example-plugin/tui",
-	setup(env) {
-		const example = env.use(ExampleFacetService);
-		const commands = env.use(SlashCommands);
-		const controller = env.use(AgentController);
-		const ui = env.use(PresentationUI);
-		env.onActivate(() => {
-			env.own(
-				commands.replace({
-					name: "hello",
-					description: "Call the bundled Session worker facet",
-					argumentHint: "<name>",
-					async run(args, context) {
-						const message = args.length === 0 ? "from the TUI" : args;
-						const reply = await example.greet({ name: message }, context);
-						ui.showStatus(
-							`We got this: ${reply.message} Worker activations: ${reply.workerActivations}.`,
-							context,
-						);
-						return controller.prompt({ message: `pong: ${message}`, images: null }, context);
-					},
-				}),
-			);
-		});
-	},
-});