@project-ava-supernova/core 0.2.71

package/dist/tools/tool-registry.d.ts

@@ -0,0 +1,84 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolConfirmationHandler, PermissionMode, ToolCategory, CategoryPermission, AuditCallback } from './types.js';
+import type { ToolSchema } from '../providers/types.js';
+export declare const TOOL_CATEGORY_MAP: Record<string, ToolCategory>;
+export declare const PRESET_CATEGORY_DEFAULTS: Record<Exclude<PermissionMode, 'custom'>, Record<ToolCategory, CategoryPermission>>;
+export declare class ToolRegistry {
+    private tools;
+    private confirmationHandler?;
+    private permissionMode;
+    private categoryOverrides;
+    private sessionFirstTimeApproved;
+    private auditCallback?;
+    private argsPreprocessor?;
+    setConfirmationHandler(handler: ToolConfirmationHandler): void;
+    /**
+     * Register a hook that rewrites tool args after user approval but before
+     * the tool runs. Used to substitute secret handles with values from the
+     * host's working set without exposing values in the confirmation UI or
+     * conversation history.
+     */
+    setArgsPreprocessor(fn: (toolName: string, args: Record<string, unknown>) => Promise<Record<string, unknown>> | Record<string, unknown>): void;
+    setPermissionMode(mode: PermissionMode): void;
+    getPermissionMode(): PermissionMode;
+    setAuditCallback(cb: AuditCallback): void;
+    getCategoryForTool(toolName: string): ToolCategory;
+    getCategoryPermission(category: ToolCategory): CategoryPermission;
+    getCategoryPermissions(): Record<ToolCategory, CategoryPermission>;
+    setCategoryPermission(category: ToolCategory, permission: CategoryPermission): void;
+    setCategoryPermissions(overrides: Partial<Record<ToolCategory, CategoryPermission>>): void;
+    /** Mark a category as approved for first_time mode (lasts until session reset). */
+    approveCategory(category: ToolCategory): void;
+    /** Clear first-time approvals (call on new session / clear chat). */
+    resetSessionFirstTime(): void;
+    /** Check if current overrides match a preset and auto-switch mode. */
+    private detectPresetMatch;
+    /**
+     * Construct and register the builtin tools.
+     *
+     * @param options.exclude Tool names to NOT construct at all. The VS Code
+     *   extension passes DESKTOP_TOOL_NAMES here: Microsoft blocked the
+     *   extension over the desktop/browser tools and required their removal to
+     *   reinstate it (v0.48.1, 2026-04-21). Excluding at construction means
+     *   they never reach a schema, a confirmation prompt, or the model.
+     * @param options.allowDesktopMode Whether switch_mode offers 'desktop' as a
+     *   transition target. Defaults true (IDE + CLI ship the full agent — they
+     *   are distributed outside the marketplace and are not subject to the ban).
+     */
+    registerBuiltins(options?: {
+        exclude?: string[];
+        allowDesktopMode?: boolean;
+    }): void;
+    register(tool: Tool): void;
+    /**
+     * Model-facing aliases for tool names. The model's training data
+     * overwhelmingly uses short convention names (`write`, `read`, `edit`)
+     * rather than our internal prefixed names (`file_write`, `file_read`,
+     * `file_edit`). When the coordinator hallucinates `write` it's actually
+     * right — our schema was wrong. We now expose the short names to the
+     * model and keep the prefixed names internally so memory patterns and
+     * procedural learning don't need to be rewritten.
+     *
+     * NOT mode allowlists or persona definitions, despite what this comment
+     * said until 2026-08-19. Both are compared against `s.function.name` from
+     * getSchemas() — the MODEL-facing name — at agent.ts:1422 (schema filter),
+     * agent.ts:2248 (call blocking) and conductor.ts:704 (persona scoping). So a
+     * list holding `file_read` matched nothing, and every mode that filters lost
+     * the file tools: the schema was withheld AND the call would have been
+     * blocked. 20 of 24 personas could not read, `builder` could not write.
+     *
+     * Those lists use the MODEL-facing names. If that ever changes, the guard in
+     * tests/mode-allowlists.test.ts is what will tell you.
+     *
+     * Direction: model-side → internal.
+     */
+    private static readonly MODEL_NAME_ALIASES;
+    /** Inverse of MODEL_NAME_ALIASES — internal → model-facing. */
+    private static readonly INTERNAL_TO_MODEL_NAME;
+    private resolveToolName;
+    getTool(name: string): Tool | undefined;
+    getSchemas(): ToolSchema[];
+    needsConfirmation(tool: Tool, args?: Record<string, unknown>): boolean;
+    execute(name: string, args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private emitAudit;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"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"}