thoth-agents 0.5.1 → 0.6.0

package/dist/{chunk-V7HSGRMB.js → chunk-U7FNFTM5.js}

@@ -460,24 +460,6 @@ function scalarString(node, name, source) {
     );
   return node.value;
 }
-function sourceRange(node, source) {
-  if (!node || typeof node !== "object" || !("range" in node))
-    throw new Error(
-      "Cannot safely edit this Pi specialist YAML value without source ranges."
-    );
-  const range = node.range;
-  const sourceTokens = "srcToken" in node ? node.srcToken : void 0;
-  if (!Array.isArray(range) || !sourceTokens || range.length < 3 || !range.every(Number.isInteger) || range[0] < 0 || range[1] < range[0] || range[2] < range[1] || range[2] > source.length)
-    throw new Error(
-      "Cannot safely edit this Pi specialist YAML value using its source range."
-    );
-  let end = range[1];
-  if (isSeq(node) && !node.flow) {
-    const trailingNewline = source.slice(range[0], end).match(/\r?\n$/)?.[0];
-    if (trailingNewline) end -= trailingNewline.length;
-  }
-  return [range[0], end];
-}
 function validatePiSpecialistTools(tools) {
   if (!Array.isArray(tools) || tools.length === 0)
     throw new Error("Select at least one Pi tool name or glob.");
@@ -549,126 +531,41 @@ function readPiSpecialistToolOverrides(content) {
     ...subagentMode ? { subagentMode } : {}
   };
 }
-function readPiToolConfig(piRoot, roles = PI_SPECIALIST_ROLES) {
-  const snapshot2 = {
-    piRoot: resolve3(piRoot),
-    roles: [],
-    contents: {}
-  };
-  const seen = /* @__PURE__ */ new Set();
-  for (const role of roles) {
-    if (!isPiSpecialistRole(role))
-      throw new Error(`Unsupported Pi specialist: ${role}`);
-    if (seen.has(role)) throw new Error(`Duplicate Pi specialist: ${role}`);
-    seen.add(role);
-    const content = readOwnedPiSpecialistDefinition(snapshot2.piRoot, role);
-    snapshot2.contents[role] = content;
-    const parsed = readPiSpecialistToolOverrides(content);
-    snapshot2.roles.push({
-      role,
-      tools: parsed.tools ?? getPiSpecialistDefaultTools(role),
-      defaultTools: getPiSpecialistDefaultTools(role),
-      disallowedTools: parsed.disallowedTools ?? []
-    });
-  }
-  return snapshot2;
-}
-function replaceToolsField(content, tools) {
-  const parsed = parseFrontmatter(content);
-  const pair = fieldPair(parsed.mapping, "tools");
-  const rendered = JSON.stringify(tools.join(", "));
-  if (!pair) {
-    if (parsed.mapping.flow)
-      throw new Error(
-        "Cannot safely add tools to a flow-style Pi specialist frontmatter mapping."
-      );
-    const newline = parsed.source.match(/\r?\n/)?.[0] ?? (content.includes("\r\n") ? "\r\n" : "\n");
-    return `${content.slice(0, parsed.blockStart)}tools: ${rendered}${newline}${content.slice(parsed.blockStart)}`;
-  }
-  if (pair.value === null)
-    throw new Error("The tools field must contain an explicit list.");
-  let [start, end] = sourceRange(pair.value, parsed.source);
-  let replacement = rendered;
-  const explicitKey = pair.srcToken && "explicitKey" in pair.srcToken && pair.srcToken.explicitKey === true;
-  if (isSeq(pair.value) && !pair.value.flow && !explicitKey) {
-    const [keyStart, keyEnd] = sourceRange(pair.key, parsed.source);
-    start = keyStart;
-    replacement = `${parsed.source.slice(keyStart, keyEnd)}: ${rendered}`;
-  }
-  const next = content.slice(0, parsed.blockStart + start) + replacement + content.slice(parsed.blockStart + end);
-  const verifiedTools = readPiSpecialistToolOverrides(next).tools;
-  if (JSON.stringify(verifiedTools) !== JSON.stringify(tools))
-    throw new Error(
-      "Cannot safely replace the tools field without changing its parsed value."
+function createPiToolsPanelAdapter(piRoot) {
+  const root = resolve3(piRoot);
+  const managedRole = (target) => {
+    if (target.scope !== "global") return void 0;
+    return PI_SPECIALIST_ROLES.find(
+      (role) => target.role === piSpecialistName(role) && resolve3(target.filePath) === join2(root, "agents", `${piSpecialistName(role)}.md`)
     );
-  return next;
-}
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-function savePiToolConfig(snapshot2, roles) {
-  const changedRoles = [];
-  const nextSnapshot = {
-    ...snapshot2,
-    roles: structuredClone(snapshot2.roles),
-    contents: { ...snapshot2.contents }
   };
-  try {
-    const seen = /* @__PURE__ */ new Set();
-    for (const input of roles) {
-      if (!isPiSpecialistRole(input.role))
-        throw new Error(`Unsupported Pi specialist: ${input.role}`);
-      if (seen.has(input.role))
-        throw new Error(`Duplicate Pi specialist: ${input.role}`);
-      seen.add(input.role);
-      validatePiSpecialistTools(input.tools);
-      const expected = snapshot2.contents[input.role];
-      if (expected === void 0)
-        throw new Error(`Missing specialist snapshot: ${input.role}`);
-      readPiSpecialistToolOverrides(expected);
-      const current = readOwnedPiSpecialistDefinition(
-        snapshot2.piRoot,
-        input.role
+  const validatedRole = (target, content) => {
+    const role = managedRole(target);
+    if (!role)
+      throw new Error(
+        `Not a managed global Thoth specialist: ${target.filePath}`
       );
-      readPiSpecialistToolOverrides(current);
-      if (current !== expected)
-        throw new Error(
-          `Pi specialist changed since opening: ${input.role}. Reopen the editor before saving.`
-        );
-    }
-    for (const input of roles) {
-      const current = snapshot2.contents[input.role];
-      const original = snapshot2.roles.find(({ role }) => role === input.role);
-      if (!current || !original)
-        throw new Error(`Missing specialist snapshot: ${input.role}`);
-      if (JSON.stringify(original.tools) === JSON.stringify(input.tools))
-        continue;
-      const next = replaceToolsField(current, input.tools);
-      if (readOwnedPiSpecialistDefinition(snapshot2.piRoot, input.role) !== current)
-        throw new Error(
-          `Pi specialist changed before saving: ${input.role}. Reopen the editor.`
-        );
-      if (writePiManagedText(
-        join2(snapshot2.piRoot, "agents", `${piSpecialistName(input.role)}.md`),
-        next,
-        current
-      ))
-        changedRoles.push(input.role);
-      nextSnapshot.contents[input.role] = next;
-      const nextRole = nextSnapshot.roles.find(
-        ({ role }) => role === input.role
+    const current = readOwnedPiSpecialistDefinition(root, role);
+    readPiSpecialistToolOverrides(current);
+    if (current !== content)
+      throw new Error(
+        `Thoth specialist changed during validation: ${target.role}. Reopen the editor.`
       );
-      if (nextRole) nextRole.tools = [...input.tools];
+    return role;
+  };
+  return {
+    version: 1,
+    appliesTo(target, content) {
+      if (!managedRole(target)) return false;
+      return parseFrontmatter(content).mapping.get("managed-by") === "thoth-agents";
+    },
+    validate(target, content) {
+      validatedRole(target, content);
+    },
+    defaultTools(target, content) {
+      return getPiSpecialistDefaultTools(validatedRole(target, content));
     }
-    return { success: true, changedRoles, snapshot: nextSnapshot };
-  } catch (error) {
-    return {
-      success: false,
-      changedRoles,
-      snapshot: nextSnapshot,
-      error: errorMessage(error)
-    };
-  }
+  };
 }
 
 // src/cli/pi-resources.ts
@@ -1006,9 +903,7 @@ export {
   resolvePiEffort,
   readPiModelConfig,
   savePiModelConfig,
-  validatePiSpecialistTools,
-  readPiToolConfig,
-  savePiToolConfig,
+  createPiToolsPanelAdapter,
   syncPiSpecialists,
   renderConfiguredRolePrompt,
   renderPiRootInstructions,

package/dist/cli/index.js

@@ -59,11 +59,11 @@ import {
   normalizeEffortSelection,
   recordHarnessInstallCompletion,
   syncOpenCodeOwnedSkills
-} from "../chunk-VUNYH263.js";
+} from "../chunk-7YCSKK2X.js";
 import "../chunk-62L3ORXN.js";
 import {
   piAdapter
-} from "../chunk-V7HSGRMB.js";
+} from "../chunk-U7FNFTM5.js";
 import {
   ALL_AGENT_NAMES,
   detectCurrentConfig,

package/dist/cli/pi-install.d.ts

@@ -1,13 +1,18 @@
+import { type PiExternalPackageEvidence, type PiExternalPackageSpec } from './pi-external-package';
 import { type PiPackageReceipt, type PiPackageReceiptOptions } from './pi-package-receipt';
 import { type PiPathOptions, type PiPaths } from './pi-paths';
 export declare const PI_MINIMUM_VERSION = "0.99.0";
 export declare const PI_NODE_MINIMUM = "22.19.0";
 export declare const PI_COMMAND_TIMEOUT_MS = 120000;
+export interface PiSetupPackageSpec extends PiExternalPackageSpec {
+    id: string;
+    preserveUserCopy?: boolean;
+}
 export declare const PI_PACKAGE_SPECS: readonly [{
     readonly id: "delegation";
-    readonly source: "npm:@thoth-agents/pi-subagents@>=0.1.0";
+    readonly source: "npm:@thoth-agents/pi-subagents@>=0.3.0";
     readonly packageName: "@thoth-agents/pi-subagents";
-    readonly version: "0.1.0";
+    readonly version: "0.3.0";
 }, {
     readonly id: "context7";
     readonly source: "npm:@upstash/context7-pi@>=0.1.2";
@@ -25,14 +30,32 @@ export declare const PI_PACKAGE_SPECS: readonly [{
     readonly version: "2.32.1";
 }, {
     readonly id: "ask-user-question";
-    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.1.0";
+    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.3.0";
     readonly packageName: "@thoth-agents/pi-questions-user";
-    readonly version: "0.1.0";
+    readonly version: "0.3.0";
 }, {
     readonly id: "todo";
-    readonly source: "npm:@thoth-agents/pi-todo@>=0.1.0";
+    readonly source: "npm:@thoth-agents/pi-todo@>=0.3.0";
     readonly packageName: "@thoth-agents/pi-todo";
-    readonly version: "0.1.0";
+    readonly version: "0.3.0";
+}, {
+    readonly id: "theme";
+    readonly source: "npm:@thoth-agents/pi-thoth-theme@>=0.3.0";
+    readonly packageName: "@thoth-agents/pi-thoth-theme";
+    readonly version: "0.3.0";
+    readonly preserveUserCopy: true;
+}, {
+    readonly id: "background-tasks";
+    readonly source: "npm:@thoth-agents/pi-background-tasks@>=0.3.0";
+    readonly packageName: "@thoth-agents/pi-background-tasks";
+    readonly version: "0.3.0";
+    readonly preserveUserCopy: true;
+}, {
+    readonly id: "sidebar";
+    readonly source: "npm:@thoth-agents/pi-sidebar@>=0.3.0";
+    readonly packageName: "@thoth-agents/pi-sidebar";
+    readonly version: "0.3.0";
+    readonly preserveUserCopy: true;
 }];
 export declare const PI_GREP_MCP_ENTRY: {
     readonly url: "https://mcp.grep.app";
@@ -114,68 +137,10 @@ export declare function verifyPiFirstPartyPackage(input: {
     error: string;
 };
 export declare function isPiIncumbentDelegationSource(source: string): boolean;
-export declare function getPiExternalPackageSpecs(options?: Pick<PiSetupOptions, 'runtimePackageRoot'>): readonly [{
-    readonly id: "delegation";
-    readonly source: "npm:@thoth-agents/pi-subagents@>=0.1.0";
-    readonly packageName: "@thoth-agents/pi-subagents";
-    readonly version: "0.1.0";
-}, {
-    readonly id: "context7";
-    readonly source: "npm:@upstash/context7-pi@>=0.1.2";
-    readonly packageName: "@upstash/context7-pi";
-    readonly version: "0.1.2";
-}, {
-    readonly id: "web-access";
-    readonly source: "npm:pi-web-access@>=0.27.0";
-    readonly packageName: "pi-web-access";
-    readonly version: "0.27.0";
-}, {
-    readonly id: "grep-adapter";
-    readonly source: "npm:pi-mcp-adapter@>=2.32.1";
-    readonly packageName: "pi-mcp-adapter";
-    readonly version: "2.32.1";
-}, {
-    readonly id: "ask-user-question";
-    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.1.0";
-    readonly packageName: "@thoth-agents/pi-questions-user";
-    readonly version: "0.1.0";
-}, {
-    readonly id: "todo";
-    readonly source: "npm:@thoth-agents/pi-todo@>=0.1.0";
-    readonly packageName: "@thoth-agents/pi-todo";
-    readonly version: "0.1.0";
-}] | ({
-    readonly id: "context7";
-    readonly source: "npm:@upstash/context7-pi@>=0.1.2";
-    readonly packageName: "@upstash/context7-pi";
-    readonly version: "0.1.2";
-} | {
-    readonly id: "web-access";
-    readonly source: "npm:pi-web-access@>=0.27.0";
-    readonly packageName: "pi-web-access";
-    readonly version: "0.27.0";
-} | {
-    readonly id: "grep-adapter";
-    readonly source: "npm:pi-mcp-adapter@>=2.32.1";
-    readonly packageName: "pi-mcp-adapter";
-    readonly version: "2.32.1";
-} | {
-    readonly id: "ask-user-question";
-    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.1.0";
-    readonly packageName: "@thoth-agents/pi-questions-user";
-    readonly version: "0.1.0";
-} | {
-    readonly id: "todo";
-    readonly source: "npm:@thoth-agents/pi-todo@>=0.1.0";
-    readonly packageName: "@thoth-agents/pi-todo";
-    readonly version: "0.1.0";
-} | {
-    source: string;
-    id: "delegation";
-    packageName: "@thoth-agents/pi-subagents";
-    version: "0.1.0";
-})[];
+export declare function getPiExternalPackageSpecs(options?: Pick<PiSetupOptions, 'runtimePackageRoot'>): readonly PiSetupPackageSpec[];
+export declare function inspectPiSetupPackage(packages: readonly PiConfiguredPackage[], spec: PiSetupPackageSpec, requireManagedSource?: boolean): PiExternalPackageEvidence;
 export declare function piIncumbentTodoRecovery(source: string, scope: PiConfiguredPackage['scope'], identityLimitation?: string, unmappedSource?: boolean): string;
+export declare function resolvePiPreservationPackages(output: string, options: PiSetupOptions): PiConfiguredPackage[];
 export declare function mergePiSubagentsConfig(current: Record<string, unknown>): Record<string, unknown>;
 export declare function mergePiGrepMcpConfig(current: Record<string, unknown>): Record<string, unknown>;
 export declare function mergePiRootBlock(current: string, managedBlock: string): string;
@@ -190,6 +155,8 @@ export interface PiConfiguredPackage {
     packageName?: string;
     packageVersion?: string;
     identityLimitation?: string;
+    /** Scoped settings explicitly disable extensions and select only resources. */
+    resourceOnly?: boolean;
     /** Directory-only evidence; source is a display path, not a removal source. */
     unmappedSource?: boolean;
 }

package/dist/cli/pi-tool-config.d.ts

@@ -30,3 +30,22 @@ export declare function validatePiSpecialistTools(tools: readonly string[]): voi
 export declare function readPiSpecialistToolOverrides(content: string): PiSpecialistToolOverrides;
 export declare function readPiToolConfig(piRoot: string, roles?: readonly PiSpecialistRole[]): PiToolConfigSnapshot;
 export declare function savePiToolConfig(snapshot: PiToolConfigSnapshot, roles: readonly PiToolRoleInput[]): PiToolSaveResult;
+/** Structural pi-subagents v1 adapter; root has no dependency on its runtime. */
+export declare function createPiToolsPanelAdapter(piRoot: string): {
+    version: 1;
+    appliesTo(target: {
+        role: string;
+        filePath: string;
+        scope: "global" | "project";
+    }, content: string): boolean;
+    validate(target: {
+        role: string;
+        filePath: string;
+        scope: "global" | "project";
+    }, content: string): void;
+    defaultTools(target: {
+        role: string;
+        filePath: string;
+        scope: "global" | "project";
+    }, content: string): string[];
+};

package/dist/cli/tui/index.js

@@ -2,9 +2,9 @@ import {
   defaultTuiOperations,
   effortChoicesForModel,
   listOperationHarnesses
-} from "../../chunk-VUNYH263.js";
+} from "../../chunk-7YCSKK2X.js";
 import "../../chunk-62L3ORXN.js";
-import "../../chunk-V7HSGRMB.js";
+import "../../chunk-U7FNFTM5.js";
 import "../../chunk-OW6I7ZUU.js";
 
 // src/cli/tui/index.tsx

package/dist/pi.d.ts

@@ -1,52 +1,23 @@
-import { type OverlayOptions } from '@earendil-works/pi-tui';
-import { readPiToolConfig, savePiToolConfig } from './cli/pi-tool-config';
-import { type ToolsPanelKey } from './pi/tools-panel';
 type PiHandler = (event: Record<string, unknown>, context?: {
-    isIdle(): boolean;
-}) => unknown;
-interface PiCommandContext {
-    mode: string;
-    ui: {
+    isIdle?(): boolean;
+    ui?: {
         notify(message: string, type?: 'info' | 'warning' | 'error'): void;
-        custom<T>(factory: (tui: {
-            requestRender(): void;
-            terminal: {
-                rows: number;
-            };
-        }, theme: unknown, keybindings: unknown, done: (result: T) => void) => {
-            render(width: number): string[];
-            invalidate(): void;
-            handleInput(data: string): void;
-        }, options?: {
-            overlay?: boolean;
-            overlayOptions?: OverlayOptions;
-        }): Promise<T>;
     };
-}
-interface PiNativeModules {
-    matchesKey(data: string, key: string): boolean;
-    truncateToWidth(text: string, width: number): string;
-    visibleWidth(text: string): number;
-    keys: Record<ToolsPanelKey, string>;
-}
+}) => unknown;
 export interface PiExtensionApi {
     on(event: 'input' | 'before_agent_start' | 'session_start', handler: PiHandler): void;
     registerCommand?(name: string, command: {
         description: string;
-        handler(args: string | undefined, context: PiCommandContext): unknown;
+        handler(args: string | undefined, context: unknown): unknown;
     }): void;
-    getAllTools?(): Array<{
+    getCommands?(): Array<{
         name: string;
-        description?: string;
+        source?: string;
     }>;
-    getActiveTools?(): string[];
 }
 export interface PiExtensionOptions {
     packageRoot?: string;
     piRoot?: string;
-    readToolConfig?: typeof readPiToolConfig;
-    saveToolConfig?: typeof savePiToolConfig;
-    loadNativeModules?: () => Promise<PiNativeModules>;
 }
 export declare function injectPiRoot(systemPrompt: string): string;
 export default function thothAgentsPiExtension(pi: PiExtensionApi, options?: PiExtensionOptions): void;