@selesai/code 0.10.2 → 0.12.0

package/dist/extensions/pi-tool-display/tool-display-api-consumer.d.ts

@@ -0,0 +1,30 @@
+export type RuntimeToolDefinition = Record<string, unknown>;
+
+export interface ToolDisplayAdapter {
+  kind?: "read" | "edit" | "mcp" | "generic";
+  overrideExistingRenderers?: boolean;
+}
+
+export interface ToolDisplayApi {
+  version: 1;
+  decorateTool<T extends RuntimeToolDefinition>(tool: T, adapter?: ToolDisplayAdapter | Record<string, unknown>): T;
+}
+
+export interface DecorateToolForDisplayOptions {
+  suppressDecorateErrors?: boolean;
+}
+
+export declare function getToolDisplayApi(): ToolDisplayApi | undefined;
+
+export declare function queueToolDisplayDecoration<T extends RuntimeToolDefinition>(
+  tool: T,
+  adapter?: ToolDisplayAdapter | Record<string, unknown>,
+): void;
+
+export declare function decorateToolForDisplay<T extends object>(
+  tool: T,
+  adapter?: ToolDisplayAdapter | Record<string, unknown>,
+  options?: DecorateToolForDisplayOptions,
+): T;
+
+export declare function decorateMcpToolForDisplay<T extends RuntimeToolDefinition>(tool: T): T;

package/dist/extensions/pi-tool-display/tool-display-api-consumer.js

@@ -0,0 +1,40 @@
+const TOOL_DISPLAY_API_KEY = Symbol.for("pi-tool-display.api.v1");
+const TOOL_DISPLAY_PENDING_DECORATIONS_KEY = Symbol.for("pi-tool-display.pendingDecorations.v1");
+
+export function getToolDisplayApi() {
+  const api = globalThis[TOOL_DISPLAY_API_KEY];
+  if (api?.version !== 1 || typeof api.decorateTool !== "function") {
+    return undefined;
+  }
+
+  return api;
+}
+
+export function queueToolDisplayDecoration(tool, adapter) {
+  const existing = globalThis[TOOL_DISPLAY_PENDING_DECORATIONS_KEY];
+  const queue = Array.isArray(existing) ? existing : [];
+  queue.push({ tool, adapter });
+  globalThis[TOOL_DISPLAY_PENDING_DECORATIONS_KEY] = queue;
+}
+
+export function decorateToolForDisplay(tool, adapter, options = {}) {
+  const api = getToolDisplayApi();
+  if (!api) {
+    queueToolDisplayDecoration(tool, adapter);
+    return tool;
+  }
+
+  try {
+    return api.decorateTool(tool, adapter);
+  } catch (error) {
+    if (options.suppressDecorateErrors) {
+      return tool;
+    }
+
+    throw error;
+  }
+}
+
+export function decorateMcpToolForDisplay(tool) {
+  return decorateToolForDisplay(tool, { kind: "mcp", overrideExistingRenderers: true });
+}

package/dist/extensions/pi-web-agent/package.json

@@ -1,31 +1,31 @@
-{
-	"name": "@selesai/bundled-pi-web-agent",
-	"version": "1.5.1",
-	"private": true,
-	"description": "Bundled pi-web-agent extension for reliable web access with explicit search, fetch, and headless boundaries. Vendored source-first from @demigodmode/pi-web-agent.",
-	"type": "module",
-	"keywords": [
-		"pi-package",
-		"pi",
-		"extension",
-		"web-search",
-		"web-fetch"
-	],
-	"license": "AGPL-3.0-only",
-	"pi": {
-		"extensions": [
-			"./src/extension.ts"
-		]
-	},
-	"dependencies": {
-		"@mozilla/readability": "^0.6.0",
-		"cheerio": "^1.1.0",
-		"jsdom": "^26.0.0",
-		"playwright": "^1.60.0",
-		"typebox": "^1.1.37"
-	},
-	"peerDependencies": {
-		"@selesai/code": "*",
-		"@earendil-works/pi-tui": "*"
-	}
-}
+{
+	"name": "@selesai/bundled-pi-web-agent",
+	"version": "1.5.1",
+	"private": true,
+	"description": "Bundled pi-web-agent extension for reliable web access with explicit search, fetch, and headless boundaries. Vendored source-first from @demigodmode/pi-web-agent.",
+	"type": "module",
+	"keywords": [
+		"pi-package",
+		"pi",
+		"extension",
+		"web-search",
+		"web-fetch"
+	],
+	"license": "AGPL-3.0-only",
+	"pi": {
+		"extensions": [
+			"./src/extension.ts"
+		]
+	},
+	"dependencies": {
+		"@mozilla/readability": "^0.6.0",
+		"cheerio": "^1.1.0",
+		"jsdom": "^26.0.0",
+		"playwright": "^1.60.0",
+		"typebox": "^1.1.37"
+	},
+	"peerDependencies": {
+		"@selesai/code": "*",
+		"@earendil-works/pi-tui": "*"
+	}
+}

package/dist/extensions/pi-web-agent/src/backends/config.ts

@@ -1,205 +1,205 @@
-export type SearxngOptions = {
-  categories?: string[];
-  language?: string;
-  safesearch?: 0 | 1 | 2;
-};
-
-export type FirecrawlOptions = {
-  formats?: string[];
-  onlyMainContent?: boolean;
-};
-
-export type SearchBackendConfig = {
-  provider: 'duckduckgo' | 'searxng' | 'brave';
-  baseUrl?: string;
-  fallback?: 'duckduckgo';
-  options?: SearxngOptions;
-};
-
-export type FetchBackendConfig = {
-  provider: 'http' | 'firecrawl';
-  baseUrl?: string;
-  apiKey?: string;
-  fallback?: 'http';
-  options?: FirecrawlOptions;
-};
-export type HeadlessBackendConfig = { provider: 'local-browser' };
-
-export type BackendConfig = {
-  search: SearchBackendConfig;
-  fetch: FetchBackendConfig;
-  headless: HeadlessBackendConfig;
-};
-
-export type BackendConfigOverride = {
-  search?: Partial<SearchBackendConfig>;
-  fetch?: Partial<FetchBackendConfig>;
-  headless?: Partial<HeadlessBackendConfig>;
-};
-
-export type BackendConfigFile = {
-  backends?: {
-    search?: { provider?: unknown; baseUrl?: unknown; fallback?: unknown; options?: unknown };
-    fetch?: { provider?: unknown; baseUrl?: unknown; apiKey?: unknown; fallback?: unknown; options?: unknown };
-    headless?: { provider?: unknown };
-  };
-};
-
-export const DEFAULT_BACKEND_CONFIG: BackendConfig = {
-  search: { provider: 'duckduckgo' },
-  fetch: { provider: 'http' },
-  headless: { provider: 'local-browser' }
-};
-
-function extractStringArray(value: unknown): string[] | undefined {
-  if (!Array.isArray(value)) return undefined;
-  const strings = value.filter((item): item is string => typeof item === 'string');
-  return strings.length === value.length ? strings : undefined;
-}
-
-function extractSearxngOptions(value: unknown): SearxngOptions | undefined {
-  if (!value || typeof value !== 'object') return undefined;
-  const raw = value as { categories?: unknown; language?: unknown; safesearch?: unknown };
-  const options: SearxngOptions = {};
-  const categories = extractStringArray(raw.categories);
-  if (categories) options.categories = categories;
-  if (typeof raw.language === 'string') options.language = raw.language;
-  if (raw.safesearch === 0 || raw.safesearch === 1 || raw.safesearch === 2) options.safesearch = raw.safesearch;
-  return Object.keys(options).length > 0 ? options : undefined;
-}
-
-function extractFirecrawlOptions(value: unknown): FirecrawlOptions | undefined {
-  if (!value || typeof value !== 'object') return undefined;
-  const raw = value as { formats?: unknown; onlyMainContent?: unknown };
-  const options: FirecrawlOptions = {};
-  const formats = extractStringArray(raw.formats);
-  if (formats) options.formats = formats;
-  if (typeof raw.onlyMainContent === 'boolean') options.onlyMainContent = raw.onlyMainContent;
-  return Object.keys(options).length > 0 ? options : undefined;
-}
-
-export function extractBackendConfigOverride(
-  file: BackendConfigFile | null | undefined
-): BackendConfigOverride {
-  const backends = file?.backends;
-  const override: BackendConfigOverride = {};
-
-  if (
-    backends?.search?.provider === 'duckduckgo' ||
-    backends?.search?.provider === 'searxng' ||
-    backends?.search?.provider === 'brave'
-  ) {
-    override.search = { provider: backends.search.provider };
-    if (backends.search.provider === 'searxng' && typeof backends.search.baseUrl === 'string') {
-      override.search.baseUrl = backends.search.baseUrl;
-    }
-    if (backends.search.fallback === 'duckduckgo') {
-      override.search.fallback = 'duckduckgo';
-    }
-    if (backends.search.provider === 'searxng') {
-      const options = extractSearxngOptions(backends.search.options);
-      if (options) {
-        override.search.options = options;
-      }
-    }
-  }
-
-  if (backends?.fetch?.provider === 'http' || backends?.fetch?.provider === 'firecrawl') {
-    override.fetch = { provider: backends.fetch.provider };
-    if (typeof backends.fetch.baseUrl === 'string') {
-      override.fetch.baseUrl = backends.fetch.baseUrl;
-    }
-    if (typeof backends.fetch.apiKey === 'string') {
-      override.fetch.apiKey = backends.fetch.apiKey;
-    }
-    if (backends.fetch.fallback === 'http') {
-      override.fetch.fallback = 'http';
-    }
-    const options = extractFirecrawlOptions(backends.fetch.options);
-    if (options) {
-      override.fetch.options = options;
-    }
-  }
-
-  if (backends?.headless?.provider === 'local-browser') {
-    override.headless = { provider: 'local-browser' };
-  }
-
-  return override;
-}
-
-export function validateBackendConfig(config: BackendConfig): string[] {
-  const issues: string[] = [];
-
-  if (config.search.provider === 'searxng' && !config.search.baseUrl) {
-    issues.push('search provider searxng requires backends.search.baseUrl');
-  }
-
-  if (config.fetch.provider === 'firecrawl' && !config.fetch.baseUrl) {
-    issues.push('fetch provider firecrawl requires backends.fetch.baseUrl');
-  }
-
-  if (config.search.fallback === 'duckduckgo' && config.search.provider !== 'searxng' && config.search.provider !== 'brave') {
-    issues.push('search fallback duckduckgo is only supported when search provider is searxng or brave');
-  }
-
-  if (config.fetch.fallback === 'http' && config.fetch.provider !== 'firecrawl') {
-    issues.push('fetch fallback http is only supported when fetch provider is firecrawl');
-  }
-
-  if (config.search.options?.categories && config.search.options.categories.length === 0) {
-    issues.push('search options.categories must contain at least one category when provided');
-  }
-
-  if (config.search.options?.language !== undefined && !config.search.options.language.trim()) {
-    issues.push('search options.language must not be empty when provided');
-  }
-
-  if (
-    config.search.options?.safesearch !== undefined &&
-    ![0, 1, 2].includes(config.search.options.safesearch)
-  ) {
-    issues.push('search options.safesearch must be 0, 1, or 2 when provided');
-  }
-
-  if (config.fetch.options?.formats && config.fetch.options.formats.length === 0) {
-    issues.push('fetch options.formats must contain at least one format when provided');
-  }
-
-  return issues;
-}
-
-function mergeSearchConfig(
-  current: SearchBackendConfig,
-  override: Partial<SearchBackendConfig> | undefined
-): SearchBackendConfig {
-  if (!override) return current;
-  if (override.provider && override.provider !== current.provider) {
-    return { ...override, provider: override.provider };
-  }
-  return { ...current, ...override };
-}
-
-function mergeFetchConfig(
-  current: FetchBackendConfig,
-  override: Partial<FetchBackendConfig> | undefined
-): FetchBackendConfig {
-  if (!override) return current;
-  if (override.provider && override.provider !== current.provider) {
-    return { ...override, provider: override.provider };
-  }
-  return { ...current, ...override };
-}
-
-export function mergeBackendConfigLayers(
-  ...layers: Array<BackendConfig | BackendConfigOverride | undefined>
-): BackendConfig {
-  return layers.reduce<BackendConfig>(
-    (merged, layer) => ({
-      search: mergeSearchConfig(merged.search, layer?.search),
-      fetch: mergeFetchConfig(merged.fetch, layer?.fetch),
-      headless: { ...merged.headless, ...layer?.headless }
-    }),
-    DEFAULT_BACKEND_CONFIG
-  );
-}
+export type SearxngOptions = {
+  categories?: string[];
+  language?: string;
+  safesearch?: 0 | 1 | 2;
+};
+
+export type FirecrawlOptions = {
+  formats?: string[];
+  onlyMainContent?: boolean;
+};
+
+export type SearchBackendConfig = {
+  provider: 'duckduckgo' | 'searxng' | 'brave';
+  baseUrl?: string;
+  fallback?: 'duckduckgo';
+  options?: SearxngOptions;
+};
+
+export type FetchBackendConfig = {
+  provider: 'http' | 'firecrawl';
+  baseUrl?: string;
+  apiKey?: string;
+  fallback?: 'http';
+  options?: FirecrawlOptions;
+};
+export type HeadlessBackendConfig = { provider: 'local-browser' };
+
+export type BackendConfig = {
+  search: SearchBackendConfig;
+  fetch: FetchBackendConfig;
+  headless: HeadlessBackendConfig;
+};
+
+export type BackendConfigOverride = {
+  search?: Partial<SearchBackendConfig>;
+  fetch?: Partial<FetchBackendConfig>;
+  headless?: Partial<HeadlessBackendConfig>;
+};
+
+export type BackendConfigFile = {
+  backends?: {
+    search?: { provider?: unknown; baseUrl?: unknown; fallback?: unknown; options?: unknown };
+    fetch?: { provider?: unknown; baseUrl?: unknown; apiKey?: unknown; fallback?: unknown; options?: unknown };
+    headless?: { provider?: unknown };
+  };
+};
+
+export const DEFAULT_BACKEND_CONFIG: BackendConfig = {
+  search: { provider: 'duckduckgo' },
+  fetch: { provider: 'http' },
+  headless: { provider: 'local-browser' }
+};
+
+function extractStringArray(value: unknown): string[] | undefined {
+  if (!Array.isArray(value)) return undefined;
+  const strings = value.filter((item): item is string => typeof item === 'string');
+  return strings.length === value.length ? strings : undefined;
+}
+
+function extractSearxngOptions(value: unknown): SearxngOptions | undefined {
+  if (!value || typeof value !== 'object') return undefined;
+  const raw = value as { categories?: unknown; language?: unknown; safesearch?: unknown };
+  const options: SearxngOptions = {};
+  const categories = extractStringArray(raw.categories);
+  if (categories) options.categories = categories;
+  if (typeof raw.language === 'string') options.language = raw.language;
+  if (raw.safesearch === 0 || raw.safesearch === 1 || raw.safesearch === 2) options.safesearch = raw.safesearch;
+  return Object.keys(options).length > 0 ? options : undefined;
+}
+
+function extractFirecrawlOptions(value: unknown): FirecrawlOptions | undefined {
+  if (!value || typeof value !== 'object') return undefined;
+  const raw = value as { formats?: unknown; onlyMainContent?: unknown };
+  const options: FirecrawlOptions = {};
+  const formats = extractStringArray(raw.formats);
+  if (formats) options.formats = formats;
+  if (typeof raw.onlyMainContent === 'boolean') options.onlyMainContent = raw.onlyMainContent;
+  return Object.keys(options).length > 0 ? options : undefined;
+}
+
+export function extractBackendConfigOverride(
+  file: BackendConfigFile | null | undefined
+): BackendConfigOverride {
+  const backends = file?.backends;
+  const override: BackendConfigOverride = {};
+
+  if (
+    backends?.search?.provider === 'duckduckgo' ||
+    backends?.search?.provider === 'searxng' ||
+    backends?.search?.provider === 'brave'
+  ) {
+    override.search = { provider: backends.search.provider };
+    if (backends.search.provider === 'searxng' && typeof backends.search.baseUrl === 'string') {
+      override.search.baseUrl = backends.search.baseUrl;
+    }
+    if (backends.search.fallback === 'duckduckgo') {
+      override.search.fallback = 'duckduckgo';
+    }
+    if (backends.search.provider === 'searxng') {
+      const options = extractSearxngOptions(backends.search.options);
+      if (options) {
+        override.search.options = options;
+      }
+    }
+  }
+
+  if (backends?.fetch?.provider === 'http' || backends?.fetch?.provider === 'firecrawl') {
+    override.fetch = { provider: backends.fetch.provider };
+    if (typeof backends.fetch.baseUrl === 'string') {
+      override.fetch.baseUrl = backends.fetch.baseUrl;
+    }
+    if (typeof backends.fetch.apiKey === 'string') {
+      override.fetch.apiKey = backends.fetch.apiKey;
+    }
+    if (backends.fetch.fallback === 'http') {
+      override.fetch.fallback = 'http';
+    }
+    const options = extractFirecrawlOptions(backends.fetch.options);
+    if (options) {
+      override.fetch.options = options;
+    }
+  }
+
+  if (backends?.headless?.provider === 'local-browser') {
+    override.headless = { provider: 'local-browser' };
+  }
+
+  return override;
+}
+
+export function validateBackendConfig(config: BackendConfig): string[] {
+  const issues: string[] = [];
+
+  if (config.search.provider === 'searxng' && !config.search.baseUrl) {
+    issues.push('search provider searxng requires backends.search.baseUrl');
+  }
+
+  if (config.fetch.provider === 'firecrawl' && !config.fetch.baseUrl) {
+    issues.push('fetch provider firecrawl requires backends.fetch.baseUrl');
+  }
+
+  if (config.search.fallback === 'duckduckgo' && config.search.provider !== 'searxng' && config.search.provider !== 'brave') {
+    issues.push('search fallback duckduckgo is only supported when search provider is searxng or brave');
+  }
+
+  if (config.fetch.fallback === 'http' && config.fetch.provider !== 'firecrawl') {
+    issues.push('fetch fallback http is only supported when fetch provider is firecrawl');
+  }
+
+  if (config.search.options?.categories && config.search.options.categories.length === 0) {
+    issues.push('search options.categories must contain at least one category when provided');
+  }
+
+  if (config.search.options?.language !== undefined && !config.search.options.language.trim()) {
+    issues.push('search options.language must not be empty when provided');
+  }
+
+  if (
+    config.search.options?.safesearch !== undefined &&
+    ![0, 1, 2].includes(config.search.options.safesearch)
+  ) {
+    issues.push('search options.safesearch must be 0, 1, or 2 when provided');
+  }
+
+  if (config.fetch.options?.formats && config.fetch.options.formats.length === 0) {
+    issues.push('fetch options.formats must contain at least one format when provided');
+  }
+
+  return issues;
+}
+
+function mergeSearchConfig(
+  current: SearchBackendConfig,
+  override: Partial<SearchBackendConfig> | undefined
+): SearchBackendConfig {
+  if (!override) return current;
+  if (override.provider && override.provider !== current.provider) {
+    return { ...override, provider: override.provider };
+  }
+  return { ...current, ...override };
+}
+
+function mergeFetchConfig(
+  current: FetchBackendConfig,
+  override: Partial<FetchBackendConfig> | undefined
+): FetchBackendConfig {
+  if (!override) return current;
+  if (override.provider && override.provider !== current.provider) {
+    return { ...override, provider: override.provider };
+  }
+  return { ...current, ...override };
+}
+
+export function mergeBackendConfigLayers(
+  ...layers: Array<BackendConfig | BackendConfigOverride | undefined>
+): BackendConfig {
+  return layers.reduce<BackendConfig>(
+    (merged, layer) => ({
+      search: mergeSearchConfig(merged.search, layer?.search),
+      fetch: mergeFetchConfig(merged.fetch, layer?.fetch),
+      headless: { ...merged.headless, ...layer?.headless }
+    }),
+    DEFAULT_BACKEND_CONFIG
+  );
+}