@superdoc-dev/sdk 1.0.0-next.72 → 1.0.0-next.74

package/dist/tools.cjs

@@ -1,11 +1,10 @@
 'use strict';
 
 var promises = require('node:fs/promises');
-var node_fs = require('node:fs');
 var path = require('node:path');
 var node_url = require('node:url');
-var contract = require('./generated/contract.cjs');
 var errors = require('./runtime/errors.cjs');
+var intentDispatch_generated = require('./generated/intent-dispatch.generated.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // Resolve tools directory relative to package root (works from both src/ and dist/)
@@ -16,37 +15,9 @@ const providerFileByName = {
     vercel: 'tools.vercel.json',
     generic: 'tools.generic.json',
 };
-let _policyCache = null;
-function loadPolicy() {
-    if (_policyCache)
-        return _policyCache;
-    const raw = node_fs.readFileSync(path.join(toolsDir, 'tools-policy.json'), 'utf8');
-    _policyCache = JSON.parse(raw);
-    return _policyCache;
-}
 function isRecord(value) {
     return typeof value === 'object' && value != null && !Array.isArray(value);
 }
-function isPresent(value) {
-    if (value == null)
-        return false;
-    if (Array.isArray(value))
-        return value.length > 0;
-    return true;
-}
-function extractProviderToolName(tool) {
-    // Anthropic / Generic: top-level name
-    if (typeof tool.name === 'string')
-        return tool.name;
-    // OpenAI / Vercel: nested under function.name
-    if (isRecord(tool.function) && typeof tool.function.name === 'string') {
-        return tool.function.name;
-    }
-    return null;
-}
-function invalidArgument(message, details) {
-    throw new errors.SuperDocCliError(message, { code: 'INVALID_ARGUMENT', details });
-}
 async function readJson(fileName) {
     const filePath = path.join(toolsDir, fileName);
     let raw = '';
@@ -78,105 +49,47 @@ async function readJson(fileName) {
 async function loadProviderBundle(provider) {
     return readJson(providerFileByName[provider]);
 }
-async function loadToolNameMap() {
-    return readJson('tool-name-map.json');
-}
 async function loadCatalog() {
     return readJson('catalog.json');
 }
-function normalizeFeatures(features) {
-    return {
-        hasTables: Boolean(features?.hasTables),
-        hasLists: Boolean(features?.hasLists),
-        hasComments: Boolean(features?.hasComments),
-        hasTrackedChanges: Boolean(features?.hasTrackedChanges),
-        isEmptyDocument: Boolean(features?.isEmptyDocument),
-    };
-}
-function stableSortByPhasePriority(entries, priorityOrder) {
-    const priority = new Map(priorityOrder.map((category, index) => [category, index]));
-    return [...entries].sort((a, b) => {
-        const aPriority = priority.get(a.category) ?? Number.MAX_SAFE_INTEGER;
-        const bPriority = priority.get(b.category) ?? Number.MAX_SAFE_INTEGER;
-        if (aPriority !== bPriority)
-            return aPriority - bPriority;
-        return a.toolName.localeCompare(b.toolName);
-    });
+async function getToolCatalog() {
+    return loadCatalog();
 }
-const OPERATION_INDEX = Object.fromEntries(Object.entries(contract.CONTRACT.operations).map(([id, op]) => [id, op]));
-function validateDispatchArgs(operationId, args) {
-    const operation = OPERATION_INDEX[operationId];
-    if (!operation) {
-        invalidArgument(`Unknown operation id ${operationId}.`);
-    }
-    // Unknown-param rejection
-    const allowedParams = new Set(operation.params.map((param) => String(param.name)));
-    for (const key of Object.keys(args)) {
-        if (!allowedParams.has(key)) {
-            invalidArgument(`Unexpected parameter ${key} for ${operationId}.`);
-        }
-    }
-    // Required-param enforcement
-    for (const param of operation.params) {
-        if ('required' in param && Boolean(param.required) && args[param.name] == null) {
-            invalidArgument(`Missing required parameter ${param.name} for ${operationId}.`);
-        }
-    }
-    // Constraint validation (CLI handles schema-level type validation authoritatively)
-    const constraints = 'constraints' in operation ? operation.constraints : undefined;
-    if (!constraints || !isRecord(constraints))
-        return;
-    const mutuallyExclusive = Array.isArray(constraints.mutuallyExclusive) ? constraints.mutuallyExclusive : [];
-    const requiresOneOf = Array.isArray(constraints.requiresOneOf) ? constraints.requiresOneOf : [];
-    const requiredWhen = Array.isArray(constraints.requiredWhen) ? constraints.requiredWhen : [];
-    for (const group of mutuallyExclusive) {
-        if (!Array.isArray(group))
-            continue;
-        const present = group.filter((name) => isPresent(args[name]));
-        if (present.length > 1) {
-            invalidArgument(`Arguments are mutually exclusive for ${operationId}: ${group.join(', ')}`, {
-                operationId,
-                group,
-            });
-        }
-    }
-    for (const group of requiresOneOf) {
-        if (!Array.isArray(group))
-            continue;
-        const hasAny = group.some((name) => isPresent(args[name]));
-        if (!hasAny) {
-            invalidArgument(`One of the following arguments is required for ${operationId}: ${group.join(', ')}`, {
-                operationId,
-                group,
-            });
-        }
-    }
-    for (const rule of requiredWhen) {
-        if (!isRecord(rule))
-            continue;
-        const whenValue = args[rule.whenParam];
-        let shouldRequire = false;
-        if (Object.prototype.hasOwnProperty.call(rule, 'equals')) {
-            shouldRequire = whenValue === rule.equals;
-        }
-        else if (Object.prototype.hasOwnProperty.call(rule, 'present')) {
-            const present = rule.present === true;
-            shouldRequire = present ? isPresent(whenValue) : !isPresent(whenValue);
-        }
-        else {
-            shouldRequire = isPresent(whenValue);
-        }
-        if (shouldRequire && !isPresent(args[rule.param])) {
-            invalidArgument(`Argument ${rule.param} is required by constraints for ${operationId}.`, {
-                operationId,
-                rule,
-            });
-        }
+async function listTools(provider) {
+    const bundle = await loadProviderBundle(provider);
+    const tools = bundle.tools;
+    if (!Array.isArray(tools)) {
+        throw new errors.SuperDocCliError('Tool provider bundle is missing tools array.', {
+            code: 'TOOLS_ASSET_INVALID',
+            details: { provider },
+        });
     }
+    return tools;
+}
+/**
+ * Select all intent tools for a specific provider.
+ *
+ * Returns all intent tools in the requested provider format.
+ *
+ * @example
+ * ```ts
+ * const { tools } = await chooseTools({ provider: 'openai' });
+ * ```
+ */
+async function chooseTools(input) {
+    const bundle = await loadProviderBundle(input.provider);
+    const tools = Array.isArray(bundle.tools) ? bundle.tools : [];
+    return {
+        tools,
+        meta: {
+            provider: input.provider,
+            toolCount: tools.length,
+        },
+    };
 }
-function resolveDocApiMethod(client, operationId) {
+function resolveDocApiMethod(documentHandle, operationId) {
     const tokens = operationId.split('.').slice(1);
-    let cursor = client.doc;
+    let cursor = documentHandle;
     for (const token of tokens) {
         if (!isRecord(cursor) || !(token in cursor)) {
             throw new errors.SuperDocCliError(`No SDK doc method found for operation ${operationId}.`, {
@@ -194,185 +107,134 @@ function resolveDocApiMethod(client, operationId) {
     }
     return cursor;
 }
-async function getToolCatalog(options = {}) {
-    const catalog = await loadCatalog();
-    if (!options.profile)
-        return catalog;
-    return {
-        ...catalog,
-        profiles: {
-            intent: options.profile === 'intent' ? catalog.profiles.intent : { name: 'intent', tools: [] },
-            operation: options.profile === 'operation' ? catalog.profiles.operation : { name: 'operation', tools: [] },
-        },
-    };
-}
-async function listTools(provider, options = {}) {
-    const profile = options.profile ?? 'intent';
-    const bundle = await loadProviderBundle(provider);
-    const tools = bundle.profiles[profile];
-    if (!Array.isArray(tools)) {
-        throw new errors.SuperDocCliError('Tool provider bundle is missing profile tools.', {
-            code: 'TOOLS_ASSET_INVALID',
-            details: { provider, profile },
+// Cached catalog instance — loaded once per process.
+let _catalogCache = null;
+async function getCachedCatalog() {
+    if (_catalogCache == null) {
+        _catalogCache = await loadCatalog();
+    }
+    return _catalogCache;
+}
+/**
+ * Validate tool arguments against the catalog schema.
+ *
+ * Checks three things in order:
+ * 1. No unknown keys (additionalProperties: false in merged schema)
+ * 2. All universally-required keys present (merged schema `required`)
+ * 3. All action-specific required keys present (per-operation `required`)
+ */
+function validateToolArgs(toolName, args, tool) {
+    const schema = tool.inputSchema;
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = Array.isArray(schema.required) ? schema.required : [];
+    // 1. Reject unknown keys
+    const knownKeys = new Set(Object.keys(properties));
+    const unknownKeys = Object.keys(args).filter((k) => !knownKeys.has(k));
+    if (unknownKeys.length > 0) {
+        throw new errors.SuperDocCliError(`Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, unknownKeys, knownKeys: [...knownKeys] },
         });
     }
-    return tools;
-}
-async function resolveToolOperation(toolName) {
-    const map = await loadToolNameMap();
-    return typeof map[toolName] === 'string' ? map[toolName] : null;
-}
-function inferDocumentFeatures(infoResult) {
-    if (!isRecord(infoResult)) {
-        return {
-            hasTables: false,
-            hasLists: false,
-            hasComments: false,
-            hasTrackedChanges: false,
-            isEmptyDocument: false,
-        };
+    // 2. Reject missing universally-required keys
+    const missingKeys = required.filter((k) => args[k] == null);
+    if (missingKeys.length > 0) {
+        throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}: ${missingKeys.join(', ')}`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, missingKeys },
+        });
     }
-    const counts = isRecord(infoResult.counts) ? infoResult.counts : {};
-    const words = typeof counts.words === 'number' ? counts.words : 0;
-    const paragraphs = typeof counts.paragraphs === 'number' ? counts.paragraphs : 0;
-    const tables = typeof counts.tables === 'number' ? counts.tables : 0;
-    const comments = typeof counts.comments === 'number' ? counts.comments : 0;
-    const lists = typeof counts.lists === 'number' ? counts.lists : typeof counts.listItems === 'number' ? counts.listItems : 0;
-    const trackedChanges = typeof counts.trackedChanges === 'number'
-        ? counts.trackedChanges
-        : typeof counts.tracked_changes === 'number'
-            ? counts.tracked_changes
-            : 0;
-    return {
-        hasTables: tables > 0,
-        hasLists: lists > 0,
-        hasComments: comments > 0,
-        hasTrackedChanges: trackedChanges > 0,
-        isEmptyDocument: words === 0 && paragraphs <= 1,
-    };
-}
-async function chooseTools(input) {
-    const catalog = await loadCatalog();
-    const policy = loadPolicy();
-    const profile = input.profile ?? 'intent';
-    const phase = input.taskContext?.phase ?? 'read';
-    const phasePolicy = policy.phases[phase];
-    const featureMap = normalizeFeatures(input.documentFeatures);
-    const maxTools = Math.max(1, input.budget?.maxTools ?? policy.defaults.maxToolsByProfile[profile]);
-    const minReadTools = Math.max(0, input.budget?.minReadTools ?? policy.defaults.minReadTools);
-    const includeCategories = new Set(input.policy?.includeCategories ?? phasePolicy.include);
-    const excludeCategories = new Set([...(input.policy?.excludeCategories ?? []), ...phasePolicy.exclude]);
-    const allowMutatingTools = input.policy?.allowMutatingTools ?? phase === 'mutate';
-    const excluded = [];
-    const profileTools = catalog.profiles[profile].tools;
-    const indexByToolName = new Map(profileTools.map((tool) => [tool.toolName, tool]));
-    let candidates = profileTools.filter((tool) => {
-        if (tool.requiredCapabilities.some((capability) => !featureMap[capability])) {
-            excluded.push({ toolName: tool.toolName, reason: 'missing-required-capability' });
-            return false;
-        }
-        if (!allowMutatingTools && tool.mutates) {
-            excluded.push({ toolName: tool.toolName, reason: 'mutations-disabled' });
-            return false;
-        }
-        if (includeCategories.size > 0 && !includeCategories.has(tool.category)) {
-            excluded.push({ toolName: tool.toolName, reason: 'category-not-included' });
-            return false;
-        }
-        if (excludeCategories.has(tool.category)) {
-            excluded.push({ toolName: tool.toolName, reason: 'phase-category-excluded' });
-            return false;
-        }
-        return true;
-    });
-    const forceExclude = new Set(input.policy?.forceExclude ?? []);
-    candidates = candidates.filter((tool) => {
-        if (!forceExclude.has(tool.toolName))
-            return true;
-        excluded.push({ toolName: tool.toolName, reason: 'force-excluded' });
-        return false;
-    });
-    // Resolve forceInclude tools — these are guaranteed slots exempt from budget trimming.
-    const forcedToolNames = new Set(input.policy?.forceInclude ?? []);
-    const forcedTools = [];
-    for (const forcedToolName of forcedToolNames) {
-        const forced = indexByToolName.get(forcedToolName);
-        if (!forced) {
-            excluded.push({ toolName: forcedToolName, reason: 'not-in-profile' });
-            continue;
+    // 3. Reject missing per-operation required keys.
+    //    For multi-action tools, resolve the operation by action; for single-op
+    //    tools, use the sole operation entry.
+    const action = args.action;
+    let op;
+    if (typeof action === 'string' && tool.operations.length > 1) {
+        op = tool.operations.find((o) => o.intentAction === action);
+    }
+    else if (tool.operations.length === 1) {
+        op = tool.operations[0];
+    }
+    if (op) {
+        validateOperationRequired(toolName, action, args, op);
+    }
+}
+/**
+ * Check per-operation required constraints.
+ *
+ * Handles two shapes emitted by the codegen:
+ *   - `required: string[]`        — all listed keys must be present
+ *   - `requiredOneOf: string[][]`  — at least one branch must be fully satisfied
+ *     (mirrors JSON Schema `oneOf` with per-branch `required` arrays)
+ */
+function validateOperationRequired(toolName, action, args, op) {
+    const actionLabel = typeof action === 'string' ? ` action "${action}"` : '';
+    if (op.requiredOneOf && op.requiredOneOf.length > 0) {
+        const satisfied = op.requiredOneOf.some((branch) => branch.every((k) => args[k] != null));
+        if (!satisfied) {
+            const options = op.requiredOneOf.map((b) => b.join(' + ')).join(' | ');
+            throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}${actionLabel}: must provide one of: ${options}`, {
+                code: 'INVALID_ARGUMENT',
+                details: { toolName, action, requiredOneOf: op.requiredOneOf },
+            });
         }
-        candidates.push(forced);
-        forcedTools.push(forced);
     }
-    candidates = [...new Map(candidates.map((tool) => [tool.toolName, tool])).values()];
-    // Start with forceInclude tools — they always occupy a slot.
-    const selected = [...forcedTools];
-    const selectedNames = new Set(selected.map((tool) => tool.toolName));
-    const foundationalIds = new Set(policy.defaults.foundationalOperationIds);
-    const foundational = candidates.filter((tool) => foundationalIds.has(tool.operationId) && !selectedNames.has(tool.toolName));
-    for (const tool of foundational) {
-        if (selected.length >= minReadTools || selected.length >= maxTools)
-            break;
-        selected.push(tool);
-        selectedNames.add(tool.toolName);
-    }
-    const remaining = stableSortByPhasePriority(candidates.filter((tool) => !selectedNames.has(tool.toolName)), phasePolicy.priority);
-    for (const tool of remaining) {
-        if (selected.length >= maxTools) {
-            excluded.push({ toolName: tool.toolName, reason: 'budget-trim' });
-            continue;
+    else if (op.required && op.required.length > 0) {
+        const missingActionKeys = op.required.filter((k) => args[k] == null);
+        if (missingActionKeys.length > 0) {
+            throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}${actionLabel}: ${missingActionKeys.join(', ')}`, {
+                code: 'INVALID_ARGUMENT',
+                details: { toolName, action, missingKeys: missingActionKeys },
+            });
         }
-        selected.push(tool);
     }
-    const bundle = await loadProviderBundle(input.provider);
-    const providerTools = Array.isArray(bundle.profiles[profile]) ? bundle.profiles[profile] : [];
-    const providerIndex = new Map(providerTools
-        .filter((tool) => isRecord(tool))
-        .map((tool) => [extractProviderToolName(tool), tool])
-        .filter((entry) => entry[0] !== null));
-    const selectedProviderTools = selected
-        .map((tool) => providerIndex.get(tool.toolName))
-        .filter((tool) => Boolean(tool));
-    return {
-        tools: selectedProviderTools,
-        selected: selected.map((tool) => ({
-            operationId: tool.operationId,
-            toolName: tool.toolName,
-            category: tool.category,
-            mutates: tool.mutates,
-            profile: tool.profile,
-        })),
-        excluded,
-        selectionMeta: {
-            profile,
-            phase,
-            maxTools,
-            minReadTools,
-            selectedCount: selected.length,
-            decisionVersion: policy.defaults.chooserDecisionVersion,
-            provider: input.provider,
-        },
-    };
 }
-async function dispatchSuperDocTool(client, toolName, args = {}, invokeOptions) {
-    const operationId = await resolveToolOperation(toolName);
-    if (!operationId) {
-        throw new errors.SuperDocCliError(`Unknown SuperDoc tool: ${toolName}`, {
-            code: 'TOOL_NOT_FOUND',
+/**
+ * Dispatch a tool call against a bound document handle.
+ *
+ * The document handle injects session targeting automatically.
+ * Tool arguments should not contain `doc` or `sessionId`.
+ */
+async function dispatchSuperDocTool(documentHandle, toolName, args = {}, invokeOptions) {
+    if (!isRecord(args)) {
+        throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
+            code: 'INVALID_ARGUMENT',
             details: { toolName },
         });
     }
-    if (!isRecord(args)) {
-        invalidArgument(`Tool arguments for ${toolName} must be an object.`);
+    // Validate against the tool schema before dispatch.
+    const catalog = await getCachedCatalog();
+    const tool = catalog.tools.find((t) => t.toolName === toolName);
+    if (tool == null) {
+        throw new errors.SuperDocCliError(`Unknown tool: ${toolName}`, {
+            code: 'TOOL_DISPATCH_NOT_FOUND',
+            details: { toolName },
+        });
+    }
+    validateToolArgs(toolName, args, tool);
+    return intentDispatch_generated.dispatchIntentTool(toolName, args, (operationId, input) => {
+        const method = resolveDocApiMethod(documentHandle, operationId);
+        return method(input, invokeOptions);
+    });
+}
+/**
+ * Read the bundled system prompt for intent tools.
+ */
+async function getSystemPrompt() {
+    const promptPath = path.join(toolsDir, 'system-prompt.md');
+    try {
+        return await promises.readFile(promptPath, 'utf8');
+    }
+    catch {
+        throw new errors.SuperDocCliError('System prompt not found.', {
+            code: 'TOOLS_ASSET_NOT_FOUND',
+            details: { filePath: promptPath },
+        });
     }
-    validateDispatchArgs(operationId, args);
-    const method = resolveDocApiMethod(client, operationId);
-    return method(args, invokeOptions);
 }
 
 exports.chooseTools = chooseTools;
 exports.dispatchSuperDocTool = dispatchSuperDocTool;
+exports.getSystemPrompt = getSystemPrompt;
 exports.getToolCatalog = getToolCatalog;
-exports.inferDocumentFeatures = inferDocumentFeatures;
 exports.listTools = listTools;
-exports.resolveToolOperation = resolveToolOperation;

package/dist/tools.d.ts

@@ -1,113 +1,57 @@
+import type { BoundDocApi } from './generated/client.js';
 import type { InvokeOptions } from './runtime/process.js';
 export type ToolProvider = 'openai' | 'anthropic' | 'vercel' | 'generic';
-export type ToolProfile = 'intent' | 'operation';
-export type ToolPhase = 'read' | 'locate' | 'mutate' | 'review';
-export type DocumentFeatures = {
-    hasTables: boolean;
-    hasLists: boolean;
-    hasComments: boolean;
-    hasTrackedChanges: boolean;
-    isEmptyDocument: boolean;
-};
-export type ToolChooserInput = {
-    provider: ToolProvider;
-    profile?: ToolProfile;
-    documentFeatures?: Partial<DocumentFeatures>;
-    taskContext?: {
-        phase?: ToolPhase;
-        previousToolCalls?: Array<{
-            toolName: string;
-            ok: boolean;
-        }>;
-    };
-    budget?: {
-        maxTools?: number;
-        minReadTools?: number;
-    };
-    policy?: {
-        includeCategories?: string[];
-        excludeCategories?: string[];
-        allowMutatingTools?: boolean;
-        forceInclude?: string[];
-        forceExclude?: string[];
-    };
-};
 export type ToolCatalog = {
     contractVersion: string;
     generatedAt: string | null;
-    namePolicyVersion: string;
-    exposureVersion: string;
     toolCount: number;
-    profiles: {
-        intent: {
-            name: 'intent';
-            tools: ToolCatalogEntry[];
-        };
-        operation: {
-            name: 'operation';
-            tools: ToolCatalogEntry[];
-        };
-    };
+    tools: ToolCatalogEntry[];
 };
-type ToolCatalogEntry = {
+type OperationEntry = {
     operationId: string;
+    intentAction: string;
+    required?: string[];
+    requiredOneOf?: string[][];
+};
+type ToolCatalogEntry = {
     toolName: string;
-    profile: ToolProfile;
-    source: 'operation' | 'intent';
     description: string;
     inputSchema: Record<string, unknown>;
-    outputSchema: Record<string, unknown>;
     mutates: boolean;
-    category: string;
-    capabilities: string[];
-    constraints?: Record<string, unknown>;
-    errors: string[];
-    examples: Array<{
-        description: string;
-        args: Record<string, unknown>;
-    }>;
-    commandTokens: string[];
-    profileTags: string[];
-    requiredCapabilities: Array<keyof DocumentFeatures>;
-    sessionRequirements: {
-        requiresOpenContext: boolean;
-        supportsSessionTargeting: boolean;
-    };
-    intentId?: string;
+    operations: OperationEntry[];
+};
+export declare function getToolCatalog(): Promise<ToolCatalog>;
+export declare function listTools(provider: ToolProvider): Promise<unknown[]>;
+export type ToolChooserInput = {
+    provider: ToolProvider;
 };
-export declare function getToolCatalog(options?: {
-    profile?: ToolProfile;
-}): Promise<ToolCatalog>;
-export declare function listTools(provider: ToolProvider, options?: {
-    profile?: ToolProfile;
-}): Promise<unknown[]>;
-export declare function resolveToolOperation(toolName: string): Promise<string | null>;
-export declare function inferDocumentFeatures(infoResult: Record<string, unknown> | null | undefined): DocumentFeatures;
+/**
+ * Select all intent tools for a specific provider.
+ *
+ * Returns all intent tools in the requested provider format.
+ *
+ * @example
+ * ```ts
+ * const { tools } = await chooseTools({ provider: 'openai' });
+ * ```
+ */
 export declare function chooseTools(input: ToolChooserInput): Promise<{
     tools: unknown[];
-    selected: Array<{
-        operationId: string;
-        toolName: string;
-        category: string;
-        mutates: boolean;
-        profile: ToolProfile;
-    }>;
-    excluded: Array<{
-        toolName: string;
-        reason: string;
-    }>;
-    selectionMeta: {
-        profile: ToolProfile;
-        phase: ToolPhase;
-        maxTools: number;
-        minReadTools: number;
-        selectedCount: number;
-        decisionVersion: string;
+    meta: {
         provider: ToolProvider;
+        toolCount: number;
     };
 }>;
-export declare function dispatchSuperDocTool(client: {
-    doc: Record<string, unknown>;
-}, toolName: string, args?: Record<string, unknown>, invokeOptions?: InvokeOptions): Promise<unknown>;
+/**
+ * Dispatch a tool call against a bound document handle.
+ *
+ * The document handle injects session targeting automatically.
+ * Tool arguments should not contain `doc` or `sessionId`.
+ */
+export declare function dispatchSuperDocTool(documentHandle: BoundDocApi, toolName: string, args?: Record<string, unknown>, invokeOptions?: InvokeOptions): Promise<unknown>;
+/**
+ * Read the bundled system prompt for intent tools.
+ */
+export declare function getSystemPrompt(): Promise<string>;
 export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAWzE,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC;AA6CF,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAE3D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAU1E;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,YAAY,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC,CAWD;AAiID;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,WAAW,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAUvD"}