@marifold/core 0.60.0

package/dist/agent/ScopedProcess.js.map

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

package/dist/agent/ToolRegistry.d.ts

@@ -0,0 +1,80 @@
+import { ImageInput, JSONValue, ToolDefinition } from '@priest-ai/core';
+import { ToolKind } from './ApprovalPolicy';
+import type { RunWorkspace } from './RunWorkspace';
+import type { UserInputRequest, UserInputResponse, UserInputSubmission } from './UserInput';
+export type AgentToolKind = ToolKind | 'interaction';
+export interface ToolExecutionContext {
+    /** Working directory the run was started from. Filesystem tools resolve
+     * relative paths against it and treat it as the workspace boundary. */
+    cwd: string;
+    /** Extra absolute folders trusted for file writes (outside the workspace).
+     * In-home entries auto-approve writes; external entries still prompt. */
+    trustedFolders?: string[];
+    /** Per-run filesystem/process capability set. Shell execution fails closed
+     * when this is absent instead of falling back to unrestricted host access. */
+    workspace?: RunWorkspace;
+    signal?: AbortSignal;
+    /** Cap applied to tool output before it is returned to the model. */
+    outputLimit: number;
+}
+export interface ToolExecutionResult {
+    /** Output returned to the model. */
+    content: string;
+    /** Images made visible to the next model iteration by an attachment tool.
+     * They remain turn-local and are not embedded in the textual tool result. */
+    images?: ImageInput[];
+    /** Short human-readable outcome for event rendering, e.g. "1.2KB read". */
+    summary?: string;
+    isError?: boolean;
+}
+export interface ToolRiskAssessment {
+    /** Hard policy denial. Unlike escalation, the user cannot approve this call. */
+    blocked?: boolean;
+    /** True forces interactive approval even when policy says allow. */
+    escalate: boolean;
+    reason?: string;
+    /** True when the call targets a narrowly pre-authorized capability (for
+     * example an uploaded attachment or eligible in-home trusted folder) and is
+     * auto-approved regardless of the tool kind's approval mode. */
+    trusted?: boolean;
+    /** Absolute target path of an escalated file call, so a client can offer to
+     * trust its folder. */
+    targetPath?: string;
+    /** False hides/rejects persistent "always"/"trust" actions. Used for host
+     * paths outside $HOME and other capabilities that must be approved afresh. */
+    persistable?: boolean;
+}
+export interface AgentTool {
+    definition: ToolDefinition;
+    kind: ToolKind;
+    /** One-line human description of a specific call, shown in events and
+     * approval prompts, e.g. "write 2.1KB to ./notes.md". */
+    summarizeCall(input: Record<string, JSONValue>): string;
+    /** Flag calls that exceed the tool kind's normal risk (e.g. writes outside
+     * the workspace). Escalated calls always require interactive approval. */
+    assessRisk?(input: Record<string, JSONValue>, ctx: ToolExecutionContext): ToolRiskAssessment;
+    execute(input: Record<string, JSONValue>, ctx: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+export type EffectfulAgentTool = AgentTool;
+export interface UserInputAgentTool {
+    definition: ToolDefinition;
+    kind: 'interaction';
+    summarizeCall(input: Record<string, JSONValue>): string;
+    createRequest(callId: string, input: Record<string, JSONValue>): UserInputRequest;
+    resolveResponse(request: UserInputRequest, submission: UserInputSubmission): UserInputResponse;
+    formatResponse(response: UserInputResponse): string;
+}
+export type RegisteredAgentTool = AgentTool | UserInputAgentTool;
+export declare class ToolRegistry {
+    private readonly tools;
+    register(tool: RegisteredAgentTool): void;
+    get(name: string): RegisteredAgentTool | undefined;
+    list(): RegisteredAgentTool[];
+    definitions(): ToolDefinition[];
+}
+/** Truncate tool output to the configured limit, keeping head AND tail so the
+ * end of an output (often where the result/error lives) survives — more useful
+ * to the agent than head-only when a large read/shell output is capped. */
+export declare function capToolOutput(content: string, limit: number): string;
+export declare function requireStringInput(input: Record<string, JSONValue>, key: string, tool: string): string;
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/agent/ToolRegistry.d.ts.map

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

package/dist/agent/ToolRegistry.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+exports.capToolOutput = capToolOutput;
+exports.requireStringInput = requireStringInput;
+const MarifoldError_1 = require("../errors/MarifoldError");
+class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.definition.name)) {
+            throw MarifoldError_1.MarifoldError.agentToolInvalid(`Agent tool '${tool.definition.name}' is already registered.`, tool.definition.name);
+        }
+        this.tools.set(tool.definition.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return [...this.tools.values()];
+    }
+    definitions() {
+        return this.list().map(tool => tool.definition);
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+/** Truncate tool output to the configured limit, keeping head AND tail so the
+ * end of an output (often where the result/error lives) survives — more useful
+ * to the agent than head-only when a large read/shell output is capped. */
+function capToolOutput(content, limit) {
+    if (limit <= 0 || content.length <= limit)
+        return content;
+    const head = Math.ceil(limit * 0.7);
+    const tail = limit - head;
+    const omitted = content.length - limit;
+    const tailPart = tail > 0 ? `\n${content.slice(content.length - tail)}` : '';
+    return `${content.slice(0, head)}\n[output truncated — ${omitted} of ${content.length} characters omitted]${tailPart}`;
+}
+function requireStringInput(input, key, tool) {
+    const value = input[key];
+    if (typeof value !== 'string' || !value.trim()) {
+        throw MarifoldError_1.MarifoldError.agentToolInvalid(`Tool '${tool}' requires a non-empty string '${key}' argument.`, tool);
+    }
+    return value;
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/agent/ToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../src/agent/ToolRegistry.ts"],"names":[],"mappings":";;;;;AACA,2DAAwD;AAgFxD;IACmB,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEhE,QAAQ,CAAC,IAAyB;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,6BAAa,CAAC,gBAAgB,CAAC,eAAe,IAAI,CAAC,UAAU,CAAC,IAAI,0BAA0B,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC5H,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;CACF;;AAED;;2EAE2E;AAC3E,uBAA8B,OAAe,EAAE,KAAa;IAC1D,IAAI,KAAK,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,yBAAyB,OAAO,OAAO,OAAO,CAAC,MAAM,uBAAuB,QAAQ,EAAE,CAAC;AACzH,CAAC;AAED,4BAAmC,KAAgC,EAAE,GAAW,EAAE,IAAY;IAC5F,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,MAAM,6BAAa,CAAC,gBAAgB,CAAC,SAAS,IAAI,kCAAkC,GAAG,aAAa,EAAE,IAAI,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/agent/UserInput.d.ts

@@ -0,0 +1,59 @@
+import type { JSONValue } from '@priest-ai/core';
+export declare const MAX_USER_INPUT_QUESTIONS = 3;
+export declare const MAX_USER_INPUT_OPTIONS = 4;
+export declare const MAX_USER_INPUT_CUSTOM_TEXT = 2000;
+export interface UserInputOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+export interface UserInputQuestion {
+    id: string;
+    question: string;
+    header?: string;
+    /** When true, clients may select more than one option. Defaults to false. */
+    multiple?: boolean;
+    options: UserInputOption[];
+}
+export interface UserInputRequest {
+    id: string;
+    questions: UserInputQuestion[];
+}
+export type UserInputSubmissionAnswer = {
+    questionId: string;
+    optionId: string;
+    optionIds?: never;
+    customText?: never;
+} | {
+    questionId: string;
+    optionId?: never;
+    optionIds: string[];
+    customText?: string;
+} | {
+    questionId: string;
+    optionId?: never;
+    optionIds?: never;
+    customText: string;
+};
+export interface UserInputSubmission {
+    answers: UserInputSubmissionAnswer[];
+}
+export interface UserInputAnswer {
+    questionId: string;
+    value: string;
+    optionId?: string;
+    optionIds?: string[];
+    customText?: string;
+}
+export interface UserInputResponse {
+    requestId: string;
+    answers: UserInputAnswer[];
+}
+export type UserInputHandler = (request: UserInputRequest) => Promise<UserInputSubmission | undefined>;
+/** Validate the model-authored question payload before any renderer sees it. */
+export declare function parseUserInputRequest(requestId: string, input: Record<string, JSONValue>): UserInputRequest;
+/** Validate client answers against the exact pending request. */
+export declare function normalizeUserInputSubmission(request: UserInputRequest, value: unknown): UserInputSubmission;
+export declare function resolveUserInputResponse(request: UserInputRequest, submission: UserInputSubmission): UserInputResponse;
+export declare function formatUserInputResponse(response: UserInputResponse): string;
+//# sourceMappingURL=UserInput.d.ts.map

package/dist/agent/UserInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserInput.d.ts","sourceRoot":"","sources":["../../src/agent/UserInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/E;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;AAI9C,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC/B,gBAAgB,CAkDlB;AAED,iEAAiE;AACjE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,GACb,mBAAmB,CAoFrB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,mBAAmB,GAC9B,iBAAiB,CA6BnB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAK3E"}

package/dist/agent/UserInput.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_USER_INPUT_CUSTOM_TEXT = exports.MAX_USER_INPUT_OPTIONS = exports.MAX_USER_INPUT_QUESTIONS = void 0;
+exports.parseUserInputRequest = parseUserInputRequest;
+exports.normalizeUserInputSubmission = normalizeUserInputSubmission;
+exports.resolveUserInputResponse = resolveUserInputResponse;
+exports.formatUserInputResponse = formatUserInputResponse;
+const MarifoldError_1 = require("../errors/MarifoldError");
+exports.MAX_USER_INPUT_QUESTIONS = 3;
+exports.MAX_USER_INPUT_OPTIONS = 4;
+exports.MAX_USER_INPUT_CUSTOM_TEXT = 2000;
+const ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+/** Validate the model-authored question payload before any renderer sees it. */
+function parseUserInputRequest(requestId, input) {
+    const rawQuestions = input.questions;
+    if (!Array.isArray(rawQuestions)
+        || rawQuestions.length < 1
+        || rawQuestions.length > exports.MAX_USER_INPUT_QUESTIONS) {
+        throw invalid(`ask_user requires between 1 and ${exports.MAX_USER_INPUT_QUESTIONS} questions.`);
+    }
+    const seenQuestionIds = new Set();
+    const questions = rawQuestions.map((raw, index) => {
+        const item = record(raw, `questions[${index}]`);
+        const id = identifier(item.id, `questions[${index}].id`);
+        if (seenQuestionIds.has(id))
+            throw invalid(`Duplicate question id '${id}'.`);
+        seenQuestionIds.add(id);
+        const optionsValue = item.options;
+        if (!Array.isArray(optionsValue)
+            || optionsValue.length < 2
+            || optionsValue.length > exports.MAX_USER_INPUT_OPTIONS) {
+            throw invalid(`questions[${index}].options must contain between 2 and ${exports.MAX_USER_INPUT_OPTIONS} choices.`);
+        }
+        const seenOptionIds = new Set();
+        const options = optionsValue.map((rawOption, optionIndex) => {
+            const option = record(rawOption, `questions[${index}].options[${optionIndex}]`);
+            const optionId = identifier(option.id, `questions[${index}].options[${optionIndex}].id`);
+            if (seenOptionIds.has(optionId)) {
+                throw invalid(`Duplicate option id '${optionId}' in question '${id}'.`);
+            }
+            seenOptionIds.add(optionId);
+            return {
+                id: optionId,
+                label: boundedString(option.label, `questions[${index}].options[${optionIndex}].label`, 80),
+                ...optionalBoundedString(option.description, `questions[${index}].options[${optionIndex}].description`, 240),
+            };
+        });
+        return {
+            id,
+            question: boundedString(item.question, `questions[${index}].question`, 500),
+            ...optionalBoundedString(item.header, `questions[${index}].header`, 40, 'header'),
+            ...optionalTrue(item.multiple, `questions[${index}].multiple`, 'multiple'),
+            options,
+        };
+    });
+    return { id: requestId, questions };
+}
+/** Validate client answers against the exact pending request. */
+function normalizeUserInputSubmission(request, value) {
+    const body = record(value, 'submission');
+    if (!Array.isArray(body.answers))
+        throw invalid('answers must be an array.');
+    if (body.answers.length !== request.questions.length) {
+        throw invalid('Every question requires an answer before submission.');
+    }
+    const questions = new Map(request.questions.map(question => [question.id, question]));
+    const seen = new Set();
+    const answers = body.answers.map((raw, index) => {
+        const answer = record(raw, `answers[${index}]`);
+        const questionId = identifier(answer.questionId, `answers[${index}].questionId`);
+        const question = questions.get(questionId);
+        if (!question)
+            throw invalid(`Unknown question id '${questionId}'.`);
+        if (seen.has(questionId))
+            throw invalid(`Question '${questionId}' was answered more than once.`);
+        seen.add(questionId);
+        if (question.multiple) {
+            const hasOptionId = answer.optionId !== undefined;
+            const hasOptionIds = answer.optionIds !== undefined;
+            if (hasOptionId && hasOptionIds) {
+                throw invalid(`Answer '${questionId}' cannot provide both optionId and optionIds.`);
+            }
+            if (hasOptionIds && !Array.isArray(answer.optionIds)) {
+                throw invalid(`Answer '${questionId}'.optionIds must be an array.`);
+            }
+            const optionIds = hasOptionIds
+                ? answer.optionIds.map((optionId, optionIndex) => identifier(optionId, `answers[${index}].optionIds[${optionIndex}]`))
+                : hasOptionId
+                    ? [identifier(answer.optionId, `answers[${index}].optionId`)]
+                    : [];
+            if (new Set(optionIds).size !== optionIds.length) {
+                throw invalid(`Answer '${questionId}' contains the same option more than once.`);
+            }
+            for (const optionId of optionIds) {
+                if (!question.options.some(option => option.id === optionId)) {
+                    throw invalid(`Unknown option '${optionId}' for question '${questionId}'.`);
+                }
+            }
+            const customText = answer.customText === undefined
+                ? undefined
+                : boundedString(answer.customText, `answers[${index}].customText`, exports.MAX_USER_INPUT_CUSTOM_TEXT);
+            if (optionIds.length === 0 && customText === undefined) {
+                throw invalid(`Answer '${questionId}' must choose at least one option or provide custom text.`);
+            }
+            return {
+                questionId,
+                optionIds,
+                ...(customText !== undefined ? { customText } : {}),
+            };
+        }
+        if (answer.optionIds !== undefined) {
+            throw invalid(`Answer '${questionId}' does not allow multiple options.`);
+        }
+        const hasOption = typeof answer.optionId === 'string' && answer.optionId.trim().length > 0;
+        const hasCustom = typeof answer.customText === 'string' && answer.customText.trim().length > 0;
+        if (hasOption === hasCustom) {
+            throw invalid(`Answer '${questionId}' must choose one option or provide custom text.`);
+        }
+        if (hasOption) {
+            const optionId = identifier(answer.optionId, `answers[${index}].optionId`);
+            if (!question.options.some(option => option.id === optionId)) {
+                throw invalid(`Unknown option '${optionId}' for question '${questionId}'.`);
+            }
+            return { questionId, optionId };
+        }
+        return {
+            questionId,
+            customText: boundedString(answer.customText, `answers[${index}].customText`, exports.MAX_USER_INPUT_CUSTOM_TEXT),
+        };
+    });
+    return { answers };
+}
+function resolveUserInputResponse(request, submission) {
+    const normalized = normalizeUserInputSubmission(request, submission);
+    return {
+        requestId: request.id,
+        answers: normalized.answers.map(answer => {
+            const question = request.questions.find(item => item.id === answer.questionId);
+            if (answer.optionIds) {
+                const labels = answer.optionIds.map(optionId => question.options.find(item => item.id === optionId).label);
+                const values = answer.customText ? [...labels, answer.customText] : labels;
+                return {
+                    questionId: question.id,
+                    optionIds: answer.optionIds,
+                    ...(answer.customText ? { customText: answer.customText } : {}),
+                    value: values.join(', '),
+                };
+            }
+            if (answer.optionId) {
+                const option = question.options.find(item => item.id === answer.optionId);
+                return { questionId: question.id, optionId: option.id, value: option.label };
+            }
+            const customText = answer.customText;
+            return {
+                questionId: question.id,
+                customText,
+                value: customText,
+            };
+        }),
+    };
+}
+function formatUserInputResponse(response) {
+    return [
+        'The user answered the clarification questions:',
+        ...response.answers.map(answer => `- ${answer.questionId}: ${answer.value}`),
+    ].join('\n');
+}
+function invalid(message) {
+    return MarifoldError_1.MarifoldError.agentToolInvalid(message, 'ask_user');
+}
+function record(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw invalid(`${label} must be an object.`);
+    }
+    return value;
+}
+function identifier(value, label) {
+    if (typeof value !== 'string' || !ID_PATTERN.test(value)) {
+        throw invalid(`${label} must be a stable id using letters, numbers, underscores, or hyphens.`);
+    }
+    return value;
+}
+function boundedString(value, label, maxLength) {
+    if (typeof value !== 'string' || !value.trim())
+        throw invalid(`${label} must be a non-empty string.`);
+    const normalized = value.trim();
+    if (normalized.length > maxLength)
+        throw invalid(`${label} must be at most ${maxLength} characters.`);
+    return normalized;
+}
+function optionalBoundedString(value, label, maxLength, key = 'description') {
+    if (value === undefined)
+        return {};
+    return { [key]: boundedString(value, label, maxLength) };
+}
+function optionalTrue(value, label, key) {
+    if (value === undefined || value === false)
+        return {};
+    if (value !== true)
+        throw invalid(`${label} must be a boolean.`);
+    return { [key]: true };
+}
+//# sourceMappingURL=UserInput.js.map

package/dist/agent/UserInput.js.map

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

package/dist/agent/tools/AskUserTool.d.ts

@@ -0,0 +1,71 @@
+import type { JSONValue } from '@priest-ai/core';
+import type { UserInputAgentTool } from '../ToolRegistry';
+import { type UserInputRequest, type UserInputResponse, type UserInputSubmission } from '../UserInput';
+export declare class AskUserTool implements UserInputAgentTool {
+    readonly kind: 'interaction';
+    readonly definition: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                questions: {
+                    type: string;
+                    minItems: number;
+                    maxItems: number;
+                    items: {
+                        type: string;
+                        properties: {
+                            id: {
+                                type: string;
+                                description: string;
+                            };
+                            header: {
+                                type: string;
+                                description: string;
+                            };
+                            question: {
+                                type: string;
+                                description: string;
+                            };
+                            multiple: {
+                                type: string;
+                                description: string;
+                            };
+                            options: {
+                                type: string;
+                                minItems: number;
+                                maxItems: number;
+                                items: {
+                                    type: string;
+                                    properties: {
+                                        id: {
+                                            type: string;
+                                            description: string;
+                                        };
+                                        label: {
+                                            type: string;
+                                            description: string;
+                                        };
+                                        description: {
+                                            type: string;
+                                            description: string;
+                                        };
+                                    };
+                                    required: string[];
+                                };
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+            };
+            required: string[];
+        };
+    };
+    summarizeCall(input: Record<string, JSONValue>): string;
+    createRequest(callId: string, input: Record<string, JSONValue>): UserInputRequest;
+    resolveResponse(request: UserInputRequest, submission: UserInputSubmission): UserInputResponse;
+    formatResponse(response: UserInputResponse): string;
+}
+//# sourceMappingURL=AskUserTool.d.ts.map

package/dist/agent/tools/AskUserTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskUserTool.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/AskUserTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAEtB,qBAAa,WAAY,YAAW,kBAAkB;IACpD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,UAAU;QACjB,IAAI;QACJ,WAAW;QAOX,UAAU;YACR,IAAI;YACJ,UAAU;gBACR,SAAS;oBACP,IAAI;oBACJ,QAAQ;oBACR,QAAQ;oBACR,KAAK;wBACH,IAAI;wBACJ,UAAU;4BACR,EAAE;gCAAI,IAAI;gCAAY,WAAW;;4BACjC,MAAM;gCAAI,IAAI;gCAAY,WAAW;;4BACrC,QAAQ;gCAAI,IAAI;gCAAY,WAAW;;4BACvC,QAAQ;gCACN,IAAI;gCACJ,WAAW;;4BAEb,OAAO;gCACL,IAAI;gCACJ,QAAQ;gCACR,QAAQ;gCACR,KAAK;oCACH,IAAI;oCACJ,UAAU;wCACR,EAAE;4CAAI,IAAI;4CAAY,WAAW;;wCACjC,KAAK;4CAAI,IAAI;4CAAY,WAAW;;wCACpC,WAAW;4CAAI,IAAI;4CAAY,WAAW;;;oCAE5C,QAAQ;;;;wBAId,QAAQ;;;;YAId,QAAQ;;MAEV;IAEF,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAGtD;IAED,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,gBAAgB,CAEhF;IAED,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,GAAG,iBAAiB,CAE7F;IAED,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAElD;CACF"}

package/dist/agent/tools/AskUserTool.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskUserTool = void 0;
+const UserInput_1 = require("../UserInput");
+class AskUserTool {
+    kind = 'interaction';
+    definition = {
+        name: 'ask_user',
+        description: [
+            'Pause and ask the user for essential missing information using one compact set of choices.',
+            'When to use: a concrete decision blocks safe or correct progress and cannot be discovered from local context or tools.',
+            'When NOT to use: discoverable facts, minor preferences, confirmation of a reasonable assumption, or any question that does not block progress.',
+            'Batch all currently known questions into one call. Set multiple to true only when choices may be combined. Do not add an Other option because the UI provides free-text automatically.',
+            'Call this tool by itself, without other tool calls in the same response.',
+        ].join(' '),
+        parameters: {
+            type: 'object',
+            properties: {
+                questions: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 3,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'string', description: 'Stable short id, such as style or output_format.' },
+                            header: { type: 'string', description: 'Optional short category label.' },
+                            question: { type: 'string', description: 'The specific decision the user must make.' },
+                            multiple: {
+                                type: 'boolean',
+                                description: 'True when the user may select more than one option; defaults to false.',
+                            },
+                            options: {
+                                type: 'array',
+                                minItems: 2,
+                                maxItems: 4,
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        id: { type: 'string', description: 'Stable short option id.' },
+                                        label: { type: 'string', description: 'Concise user-facing option.' },
+                                        description: { type: 'string', description: 'Optional one-sentence tradeoff.' },
+                                    },
+                                    required: ['id', 'label'],
+                                },
+                            },
+                        },
+                        required: ['id', 'question', 'options'],
+                    },
+                },
+            },
+            required: ['questions'],
+        },
+    };
+    summarizeCall(input) {
+        const count = Array.isArray(input.questions) ? input.questions.length : 0;
+        return `ask the user ${count || '?'} clarification ${count === 1 ? 'question' : 'questions'}`;
+    }
+    createRequest(callId, input) {
+        return (0, UserInput_1.parseUserInputRequest)(callId, input);
+    }
+    resolveResponse(request, submission) {
+        return (0, UserInput_1.resolveUserInputResponse)(request, submission);
+    }
+    formatResponse(response) {
+        return (0, UserInput_1.formatUserInputResponse)(response);
+    }
+}
+exports.AskUserTool = AskUserTool;
+//# sourceMappingURL=AskUserTool.js.map

package/dist/agent/tools/AskUserTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskUserTool.js","sourceRoot":"","sources":["../../../src/agent/tools/AskUserTool.ts"],"names":[],"mappings":";;;AAEA,4CAOsB;AAEtB;IACW,IAAI,GAAG,aAAsB,CAAC;IAC9B,UAAU,GAAG;QACpB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;YACX,4FAA4F;YAC5F,wHAAwH;YACxH,gJAAgJ;YAChJ,wLAAwL;YACxL,0EAA0E;SAC3E,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;4BACvF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;4BACzE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;4BACtF,QAAQ,EAAE;gCACR,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,wEAAwE;6BACtF;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,OAAO;gCACb,QAAQ,EAAE,CAAC;gCACX,QAAQ,EAAE,CAAC;gCACX,KAAK,EAAE;oCACL,IAAI,EAAE,QAAQ;oCACd,UAAU,EAAE;wCACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;wCAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;wCACrE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;qCAChF;oCACD,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;iCAC1B;6BACF;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC;qBACxC;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF,CAAC;IAEF,aAAa,CAAC,KAAgC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,gBAAgB,KAAK,IAAI,GAAG,kBAAkB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChG,CAAC;IAED,aAAa,CAAC,MAAc,EAAE,KAAgC;QAC5D,OAAO,IAAA,iCAAqB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,eAAe,CAAC,OAAyB,EAAE,UAA+B;QACxE,OAAO,IAAA,oCAAwB,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,cAAc,CAAC,QAA2B;QACxC,OAAO,IAAA,mCAAuB,EAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/agent/tools/DelegateTool.d.ts

@@ -0,0 +1,49 @@
+import { JSONValue } from '@priest-ai/core';
+import { AgentTool, ToolExecutionContext, ToolExecutionResult } from '../ToolRegistry';
+export interface DelegateAskRequest {
+    prompt: string;
+    profile: string;
+}
+export interface DelegateAskResult {
+    ok: boolean;
+    text: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface DelegateToolDeps {
+    ask: (request: DelegateAskRequest) => Promise<DelegateAskResult>;
+    listProfileNames: () => string[];
+}
+/**
+ * Minimal multi-model orchestration: run a one-shot request through another
+ * profile (and therefore that profile's provider/model). Delegated requests
+ * are plain asks — no tools — so delegation depth is structurally 1.
+ */
+export declare class DelegateTool implements AgentTool {
+    private readonly deps;
+    readonly kind: 'delegate';
+    readonly definition: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                profile: {
+                    type: string;
+                    description: string;
+                };
+                prompt: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    constructor(deps: DelegateToolDeps);
+    summarizeCall(input: Record<string, JSONValue>): string;
+    execute(input: Record<string, JSONValue>, ctx: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=DelegateTool.d.ts.map