veryfront 0.1.558 → 0.1.560

package/esm/src/agent/conversation/bootstrap.d.ts

@@ -2,46 +2,60 @@ import "../../../_dnt.polyfills.js";
 import type { InferSchema, Schema } from "../../extensions/schema/index.js";
 import type { ChatUiMessage } from "../../chat/types.js";
 import { type ConversationRunProjection } from "./durable.js";
+/** Record shape for conversation. */
 export interface ConversationRecord {
     id: string;
     projectId: string | null;
 }
+/** Zod schema for get conversation record. */
 export declare const getConversationRecordSchema: () => Schema<ConversationRecord>;
-/** @deprecated Use getConversationRecordSchema() */
+/** Schema for conversation record.
+ * @deprecated Use getConversationRecordSchema()
+ */
 export declare const ConversationRecordSchema: Schema<ConversationRecord>;
+/** Zod schema for get conversation message record. */
 export declare const getConversationMessageRecordSchema: () => Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
     id: Schema<string>;
 }>>;
-/** @deprecated Use getConversationMessageRecordSchema() */
+/** Schema for conversation message record.
+ * @deprecated Use getConversationMessageRecordSchema()
+ */
 export declare const ConversationMessageRecordSchema: Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
     id: Schema<string>;
 }>>;
+/** Record shape for conversation message. */
 export type ConversationMessageRecord = InferSchema<ReturnType<typeof getConversationMessageRecordSchema>>;
+/** Error shape for conversation control plane response. */
 export interface ConversationControlPlaneResponseError {
     status: number;
     statusText: string;
     body: string;
 }
+/** Public API contract for persist conversation user message failure. */
 export interface PersistConversationUserMessageFailure extends ConversationControlPlaneResponseError {
     conversationId: string;
     messageId: string;
 }
+/** Record shape for fetch conversation. */
 export declare function fetchConversationRecord(input: {
     authToken: string;
     apiUrl: string;
     conversationId: string;
 }): Promise<ConversationRecord>;
+/** Ensure conversation project link helper. */
 export declare function ensureConversationProjectLink(input: {
     authToken: string;
     apiUrl: string;
     conversationId: string;
     projectId: string;
 }): Promise<void>;
+/** Record shape for create conversation. */
 export declare function createConversationRecord(input: {
     authToken: string;
     apiUrl: string;
     body: unknown;
 }): Promise<ConversationRecord>;
+/** Message shape for create conversation. */
 export declare function createConversationMessage(input: {
     authToken: string;
     apiUrl: string;
@@ -50,6 +64,7 @@ export declare function createConversationMessage(input: {
     operation?: string;
     onResponseError?: (error: ConversationControlPlaneResponseError) => void;
 }): Promise<ConversationMessageRecord>;
+/** Message shape for persist conversation user. */
 export declare function persistConversationUserMessage(input: {
     authToken: string;
     apiUrl: string;
@@ -59,10 +74,12 @@ export declare function persistConversationUserMessage(input: {
     operation?: string;
     onFailure?: (failure: PersistConversationUserMessageFailure) => void;
 }): Promise<ConversationMessageRecord>;
+/** Context for find latest user conversation message. */
 export declare function findLatestUserConversationMessageContext(messages: ChatUiMessage[]): {
     latestUserMessage: ChatUiMessage | undefined;
     visibleParentMessageId?: string;
 };
+/** Message shape for persist latest conversation user. */
 export declare function persistLatestConversationUserMessage(input: {
     authToken: string;
     apiUrl: string;
@@ -73,11 +90,13 @@ export declare function persistLatestConversationUserMessage(input: {
     missingUserMessageErrorMessage?: string;
     onFailure?: (failure: PersistConversationUserMessageFailure) => void;
 }): Promise<void>;
+/** Result returned from bootstrap conversation agent run. */
 export interface BootstrapConversationAgentRunResult {
     conversation: ConversationRecord;
     message: ConversationMessageRecord;
     run: ConversationRunProjection;
 }
+/** Bootstrap conversation agent run helper. */
 export declare function bootstrapConversationAgentRun(input: {
     authToken: string;
     apiUrl: string;

package/esm/src/agent/conversation/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,yBAAyB,EAA8B,MAAM,cAAc,CAAC;AAK1F,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,eAAO,MAAM,2BAA2B,kCAevC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,4BAA0C,CAAC;AAEhF,eAAO,MAAM,kCAAkC;;GAI9C,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,+BAA+B;;GAAiD,CAAC;AAE9F,MAAM,MAAM,yBAAyB,GAAG,WAAW,CACjD,UAAU,CAAC,OAAO,kCAAkC,CAAC,CACtD,CAAC;AAEF,MAAM,WAAW,qCAAqC;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qCACf,SAAQ,qCAAqC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAyDD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAO9B;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS9B;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,IAAI,CAAC;CAC1E,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAUrC;AAED,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,qCAAqC,KAAK,IAAI,CAAC;CACtE,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA0BrC;AAED,wBAAgB,wCAAwC,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG;IACnF,iBAAiB,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAqBA;AAED,wBAAsB,oCAAoC,CAAC,KAAK,EAAE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,qCAAqC,KAAK,IAAI,CAAC;CACtE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB;AAED,MAAM,WAAW,mCAAmC;IAClD,YAAY,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,yBAAyB,CAAC;IACnC,GAAG,EAAE,yBAAyB,CAAC;CAChC;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAkC/C"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/bootstrap.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/conversation/bootstrap.js

@@ -4,6 +4,7 @@ import { defineSchema, lazySchema } from "../../schemas/index.js";
 import { isUuid, toConversationPartsFromUiMessage } from "../../chat/conversation.js";
 import { createConversationAgentRun } from "./durable.js";
 const CONVERSATION_API_TIMEOUT_MS = 15_000;
+/** Zod schema for get conversation record. */
 export const getConversationRecordSchema = defineSchema((v) => v.object({
     id: v.string(),
     projectId: v.string().nullable().optional(),
@@ -18,12 +19,17 @@ export const getConversationRecordSchema = defineSchema((v) => v.object({
             d.project_id ?? null,
     };
 }));
-/** @deprecated Use getConversationRecordSchema() */
+/** Schema for conversation record.
+ * @deprecated Use getConversationRecordSchema()
+ */
 export const ConversationRecordSchema = lazySchema(getConversationRecordSchema);
+/** Zod schema for get conversation message record. */
 export const getConversationMessageRecordSchema = defineSchema((v) => v.object({
     id: v.string().uuid(),
 }));
-/** @deprecated Use getConversationMessageRecordSchema() */
+/** Schema for conversation message record.
+ * @deprecated Use getConversationMessageRecordSchema()
+ */
 export const ConversationMessageRecordSchema = lazySchema(getConversationMessageRecordSchema);
 async function controlPlaneJson(input) {
     const controller = new AbortController();
@@ -66,6 +72,7 @@ function buildConversationPath(apiUrl, conversationId) {
 function buildConversationMessagesPath(apiUrl, conversationId) {
     return `${buildConversationPath(apiUrl, conversationId)}/messages`;
 }
+/** Record shape for fetch conversation. */
 export async function fetchConversationRecord(input) {
     return controlPlaneJson({
         authToken: input.authToken,
@@ -74,6 +81,7 @@ export async function fetchConversationRecord(input) {
         operation: "Fetch conversation",
     });
 }
+/** Ensure conversation project link helper. */
 export async function ensureConversationProjectLink(input) {
     const conversation = await fetchConversationRecord(input);
     if (conversation.projectId === input.projectId)
@@ -90,6 +98,7 @@ export async function ensureConversationProjectLink(input) {
         operation: "Link conversation to project",
     });
 }
+/** Record shape for create conversation. */
 export async function createConversationRecord(input) {
     return controlPlaneJson({
         authToken: input.authToken,
@@ -100,6 +109,7 @@ export async function createConversationRecord(input) {
         operation: "Create conversation",
     });
 }
+/** Message shape for create conversation. */
 export async function createConversationMessage(input) {
     return controlPlaneJson({
         authToken: input.authToken,
@@ -111,6 +121,7 @@ export async function createConversationMessage(input) {
         onResponseError: input.onResponseError,
     });
 }
+/** Message shape for persist conversation user. */
 export async function persistConversationUserMessage(input) {
     const parts = toConversationPartsFromUiMessage(input.message);
     if (parts.length === 0) {
@@ -137,6 +148,7 @@ export async function persistConversationUserMessage(input) {
         },
     });
 }
+/** Context for find latest user conversation message. */
 export function findLatestUserConversationMessageContext(messages) {
     const latestUserMessageIndex = messages.findLastIndex((message) => message.role === "user");
     const latestUserMessage = latestUserMessageIndex >= 0
@@ -157,6 +169,7 @@ export function findLatestUserConversationMessageContext(messages) {
         latestUserMessage,
     };
 }
+/** Message shape for persist latest conversation user. */
 export async function persistLatestConversationUserMessage(input) {
     if (!input.enabled || !input.conversationId) {
         return;
@@ -175,6 +188,7 @@ export async function persistLatestConversationUserMessage(input) {
         ...(input.onFailure ? { onFailure: input.onFailure } : {}),
     });
 }
+/** Bootstrap conversation agent run helper. */
 export async function bootstrapConversationAgentRun(input) {
     if (input.parentConversationId && input.ensureProjectId) {
         await ensureConversationProjectLink({

package/esm/src/agent/conversation/delegation-policy.d.ts

@@ -1,36 +1,61 @@
 import type { ChatSystemMessage } from "../../chat/types.js";
+/** Shared keep root assistant visible owner value. */
 export declare const KEEP_ROOT_ASSISTANT_VISIBLE_OWNER = "Keep the root assistant visibly owning the work.";
+/** Shared delegate only when materially helpful value. */
 export declare const DELEGATE_ONLY_WHEN_MATERIALLY_HELPFUL = "Delegate only when isolation, parallelism, or a different tool/model budget materially helps.";
+/** Shared no delegation narration unless asked value. */
 export declare const NO_DELEGATION_NARRATION_UNLESS_ASKED = "Do not mention child agents, delegation, or tool/process narration unless the user explicitly asks about them.";
+/** Shared synthesize delegated findings in root voice value. */
 export declare const SYNTHESIZE_DELEGATED_FINDINGS_IN_ROOT_VOICE = "After delegated work returns, synthesize the findings in the root assistant voice.";
+/** Shared load skill continue same turn value. */
 export declare const LOAD_SKILL_CONTINUE_SAME_TURN = "Continue the same turn after calling it.";
+/** Shared load skill continue same turn now value. */
 export declare const LOAD_SKILL_CONTINUE_SAME_TURN_NOW = "Continue the same turn now.";
+/** Shared load skill root ownership value. */
 export declare const LOAD_SKILL_ROOT_OWNERSHIP = "Keep the root assistant visibly owning the work.";
+/** Shared load skill use allowed tools value. */
 export declare const LOAD_SKILL_USE_ALLOWED_TOOLS = "For multi-step or isolated work, call invoke_agent; otherwise keep working directly with the allowed tools.";
+/** Shared load skill delegation threshold value. */
 export declare const LOAD_SKILL_DELEGATION_THRESHOLD = "Delegate only when isolation, parallelism, or a different tool/model budget materially helps.";
+/** Shared load skill override forwarding value. */
 export declare const LOAD_SKILL_OVERRIDE_FORWARDING = "Pass through any returned model, thinking, or maxSteps overrides to invoke_agent when delegating.";
+/** Shared load skill tool intersection value. */
 export declare const LOAD_SKILL_TOOL_INTERSECTION = "If the current run exposes fewer tools than the loaded skill metadata, use only the tools that are actually available right now.";
+/** Builds root owned delegated findings instruction. */
 export declare function buildRootOwnedDelegatedFindingsInstruction(): string;
+/** Shared root owned child result instruction value. */
 export declare const ROOT_OWNED_CHILD_RESULT_INSTRUCTION: string;
+/** Builds root owned child result hint. */
 export declare function buildRootOwnedChildResultHint(text: string): {
     instruction: string;
     suggestedText: string;
 };
+/** Public API contract for root owned child result hint. */
 export interface RootOwnedChildResultHint {
     instruction: string;
     suggestedText: string;
 }
+/** Public API contract for root owned child result hinted. */
 export interface RootOwnedChildResultHinted {
     rootResponseHint?: RootOwnedChildResultHint;
 }
+/** Applies root owned child result hint. */
 export declare function withRootOwnedChildResultHint<T extends object>(result: T): T & RootOwnedChildResultHinted;
+/** Builds invoke agent followup instruction. */
 export declare function buildInvokeAgentFollowupInstruction(): string;
+/** Builds starter intent root ownership reminder. */
 export declare function buildStarterIntentRootOwnershipReminder(): string;
+/** Message shape for build starter intent root ownership block. */
 export declare function buildStarterIntentRootOwnershipBlockMessage(): string;
+/** Shared load skill continuation reminder value. */
 export declare const LOAD_SKILL_CONTINUATION_REMINDER = "CRITICAL: load_skill only loaded instructions. Continue the same turn now. Keep the root assistant visibly owning the work. Use the loaded skill guidance to proceed. Delegate only when isolation, parallelism, or a different tool/model budget materially helps. Do not stop immediately after load_skill.";
+/** Shared slash command artifact reminder value. */
 export declare const SLASH_COMMAND_ARTIFACT_REMINDER = "CRITICAL: This slash-command task names an exact artifact path. Keep the root assistant visibly owning the work. Treat that path as a required deliverable, and continue in the same turn. Delegate only when isolation materially helps.";
+/** Shared first turn starter intent root ownership reminder value. */
 export declare const FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_REMINDER: string;
+/** Shared first turn starter intent root ownership context key value. */
 export declare const FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_CONTEXT_KEY = "__vfStarterIntentRootOwnership";
+/** Shared first turn starter intent root ownership block message value. */
 export declare const FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_BLOCK_MESSAGE: string;
 type StarterIntentTurnPolicyInput = {
     messages: readonly unknown[];
@@ -42,12 +67,19 @@ type StarterIntentTurnPolicy = {
     shouldAddRootOwnershipReminder: boolean;
     shouldBlockImmediateDelegation: boolean;
 };
+/** Extract starter intent ID. */
 export declare function extractStarterIntentId(messages: readonly unknown[]): string | null;
+/** Evaluate starter intent turn policy helper. */
 export declare function evaluateStarterIntentTurnPolicy(input: StarterIntentTurnPolicyInput): StarterIntentTurnPolicy;
+/** Add first turn starter intent root ownership reminder helper. */
 export declare function addFirstTurnStarterIntentRootOwnershipReminder(system: string): string;
+/** Check whether starter intent root ownership is required. */
 export declare function isStarterIntentRootOwnershipRequired(value: unknown): boolean;
+/** Should reinforce load skill continuation helper. */
 export declare function shouldReinforceLoadSkillContinuation(messages: readonly unknown[]): boolean;
+/** Add load skill continuation reminder helper. */
 export declare function addLoadSkillContinuationReminder(instructions: string | ChatSystemMessage[]): string | ChatSystemMessage[];
+/** Add slash command artifact reminder helper. */
 export declare function addSlashCommandArtifactReminder(instructions: string | ChatSystemMessage[]): string | ChatSystemMessage[];
 export {};
 //# sourceMappingURL=delegation-policy.d.ts.map

package/esm/src/agent/conversation/delegation-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegation-policy.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/delegation-policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,eAAO,MAAM,iCAAiC,qDAAqD,CAAC;AACpG,eAAO,MAAM,qCAAqC,kGAC+C,CAAC;AAClG,eAAO,MAAM,oCAAoC,mHACiE,CAAC;AACnH,eAAO,MAAM,2CAA2C,uFAC8B,CAAC;AAEvF,eAAO,MAAM,6BAA6B,6CAA6C,CAAC;AACxF,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,qDAAoC,CAAC;AAC3E,eAAO,MAAM,4BAA4B,gHACsE,CAAC;AAChH,eAAO,MAAM,+BAA+B,kGAAwC,CAAC;AACrF,eAAO,MAAM,8BAA8B,sGAC0D,CAAC;AACtG,eAAO,MAAM,4BAA4B,qIAC2F,CAAC;AAErI,wBAAgB,0CAA0C,IAAI,MAAM,CAEnE;AAED,eAAO,MAAM,mCAAmC,QAA+C,CAAC;AAEhG,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,GACX;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAKhD;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAwBD,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,EAC3D,MAAM,EAAE,CAAC,GACR,CAAC,GAAG,0BAA0B,CAUhC;AAED,wBAAgB,mCAAmC,IAAI,MAAM,CAE5D;AAED,wBAAgB,uCAAuC,IAAI,MAAM,CAEhE;AAED,wBAAgB,2CAA2C,IAAI,MAAM,CAEpE;AAED,eAAO,MAAM,gCAAgC,kTAC8L,CAAC;AAC5O,eAAO,MAAM,+BAA+B,8OAC6K,CAAC;AAI1N,eAAO,MAAM,iDAAiD,QACnB,CAAC;AAC5C,eAAO,MAAM,oDAAoD,mCAC/B,CAAC;AACnC,eAAO,MAAM,sDAAsD,QACpB,CAAC;AAEhD,KAAK,4BAA4B,GAAG;IAClC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,8BAA8B,EAAE,OAAO,CAAC;IACxC,8BAA8B,EAAE,OAAO,CAAC;CACzC,CAAC;AA6CF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAelF;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,4BAA4B,GAClC,uBAAuB,CAazB;AAED,wBAAgB,8CAA8C,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrF;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5E;AAED,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CA+C1F;AAED,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,GACzC,MAAM,GAAG,iBAAiB,EAAE,CAgB9B;AAED,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,GACzC,MAAM,GAAG,iBAAiB,EAAE,CAgB9B"}
+{"version":3,"file":"delegation-policy.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/conversation/delegation-policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,sDAAsD;AACtD,eAAO,MAAM,iCAAiC,qDAAqD,CAAC;AACpG,0DAA0D;AAC1D,eAAO,MAAM,qCAAqC,kGAC+C,CAAC;AAClG,yDAAyD;AACzD,eAAO,MAAM,oCAAoC,mHACiE,CAAC;AACnH,gEAAgE;AAChE,eAAO,MAAM,2CAA2C,uFAC8B,CAAC;AAEvF,kDAAkD;AAClD,eAAO,MAAM,6BAA6B,6CAA6C,CAAC;AACxF,sDAAsD;AACtD,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAC/E,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,qDAAoC,CAAC;AAC3E,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,gHACsE,CAAC;AAChH,oDAAoD;AACpD,eAAO,MAAM,+BAA+B,kGAAwC,CAAC;AACrF,mDAAmD;AACnD,eAAO,MAAM,8BAA8B,sGAC0D,CAAC;AACtG,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,qIAC2F,CAAC;AAErI,wDAAwD;AACxD,wBAAgB,0CAA0C,IAAI,MAAM,CAEnE;AAED,wDAAwD;AACxD,eAAO,MAAM,mCAAmC,QAA+C,CAAC;AAEhG,2CAA2C;AAC3C,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,GACX;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAKhD;AAED,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAwBD,4CAA4C;AAC5C,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,EAC3D,MAAM,EAAE,CAAC,GACR,CAAC,GAAG,0BAA0B,CAUhC;AAED,gDAAgD;AAChD,wBAAgB,mCAAmC,IAAI,MAAM,CAE5D;AAED,qDAAqD;AACrD,wBAAgB,uCAAuC,IAAI,MAAM,CAEhE;AAED,mEAAmE;AACnE,wBAAgB,2CAA2C,IAAI,MAAM,CAEpE;AAED,qDAAqD;AACrD,eAAO,MAAM,gCAAgC,kTAC8L,CAAC;AAC5O,oDAAoD;AACpD,eAAO,MAAM,+BAA+B,8OAC6K,CAAC;AAI1N,sEAAsE;AACtE,eAAO,MAAM,iDAAiD,QACnB,CAAC;AAC5C,yEAAyE;AACzE,eAAO,MAAM,oDAAoD,mCAC/B,CAAC;AACnC,2EAA2E;AAC3E,eAAO,MAAM,sDAAsD,QACpB,CAAC;AAEhD,KAAK,4BAA4B,GAAG;IAClC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,8BAA8B,EAAE,OAAO,CAAC;IACxC,8BAA8B,EAAE,OAAO,CAAC;CACzC,CAAC;AA6CF,iCAAiC;AACjC,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAelF;AAED,kDAAkD;AAClD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,4BAA4B,GAClC,uBAAuB,CAazB;AAED,oEAAoE;AACpE,wBAAgB,8CAA8C,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrF;AAED,+DAA+D;AAC/D,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5E;AAED,uDAAuD;AACvD,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CA+C1F;AAED,mDAAmD;AACnD,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,GACzC,MAAM,GAAG,iBAAiB,EAAE,CAgB9B;AAED,kDAAkD;AAClD,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,GACzC,MAAM,GAAG,iBAAiB,EAAE,CAgB9B"}

package/esm/src/agent/conversation/delegation-policy.js

@@ -1,21 +1,35 @@
 import { extractLatestUserText } from "../artifacts/default-research-artifact-support.js";
 import { buildRootOwnedChildRunResultHint } from "../child-run/result-summary.js";
 import { isRecord } from "../../chat/conversation.js";
+/** Shared keep root assistant visible owner value. */
 export const KEEP_ROOT_ASSISTANT_VISIBLE_OWNER = "Keep the root assistant visibly owning the work.";
+/** Shared delegate only when materially helpful value. */
 export const DELEGATE_ONLY_WHEN_MATERIALLY_HELPFUL = "Delegate only when isolation, parallelism, or a different tool/model budget materially helps.";
+/** Shared no delegation narration unless asked value. */
 export const NO_DELEGATION_NARRATION_UNLESS_ASKED = "Do not mention child agents, delegation, or tool/process narration unless the user explicitly asks about them.";
+/** Shared synthesize delegated findings in root voice value. */
 export const SYNTHESIZE_DELEGATED_FINDINGS_IN_ROOT_VOICE = "After delegated work returns, synthesize the findings in the root assistant voice.";
+/** Shared load skill continue same turn value. */
 export const LOAD_SKILL_CONTINUE_SAME_TURN = "Continue the same turn after calling it.";
+/** Shared load skill continue same turn now value. */
 export const LOAD_SKILL_CONTINUE_SAME_TURN_NOW = "Continue the same turn now.";
+/** Shared load skill root ownership value. */
 export const LOAD_SKILL_ROOT_OWNERSHIP = KEEP_ROOT_ASSISTANT_VISIBLE_OWNER;
+/** Shared load skill use allowed tools value. */
 export const LOAD_SKILL_USE_ALLOWED_TOOLS = "For multi-step or isolated work, call invoke_agent; otherwise keep working directly with the allowed tools.";
+/** Shared load skill delegation threshold value. */
 export const LOAD_SKILL_DELEGATION_THRESHOLD = DELEGATE_ONLY_WHEN_MATERIALLY_HELPFUL;
+/** Shared load skill override forwarding value. */
 export const LOAD_SKILL_OVERRIDE_FORWARDING = "Pass through any returned model, thinking, or maxSteps overrides to invoke_agent when delegating.";
+/** Shared load skill tool intersection value. */
 export const LOAD_SKILL_TOOL_INTERSECTION = "If the current run exposes fewer tools than the loaded skill metadata, use only the tools that are actually available right now.";
+/** Builds root owned delegated findings instruction. */
 export function buildRootOwnedDelegatedFindingsInstruction() {
     return `Use these delegated findings directly in your next assistant response. ${KEEP_ROOT_ASSISTANT_VISIBLE_OWNER} ${NO_DELEGATION_NARRATION_UNLESS_ASKED}`;
 }
+/** Shared root owned child result instruction value. */
 export const ROOT_OWNED_CHILD_RESULT_INSTRUCTION = buildRootOwnedDelegatedFindingsInstruction();
+/** Builds root owned child result hint. */
 export function buildRootOwnedChildResultHint(text) {
     return buildRootOwnedChildRunResultHint({
         text,
@@ -38,6 +52,7 @@ function getRootOwnedChildResultText(result) {
         ? result.summary.text
         : null;
 }
+/** Applies root owned child result hint. */
 export function withRootOwnedChildResultHint(result) {
     const text = getRootOwnedChildResultText(result);
     if (!text) {
@@ -48,22 +63,30 @@ export function withRootOwnedChildResultHint(result) {
         rootResponseHint: buildRootOwnedChildResultHint(text),
     };
 }
+/** Builds invoke agent followup instruction. */
 export function buildInvokeAgentFollowupInstruction() {
     return `${SYNTHESIZE_DELEGATED_FINDINGS_IN_ROOT_VOICE} ${NO_DELEGATION_NARRATION_UNLESS_ASKED}`;
 }
+/** Builds starter intent root ownership reminder. */
 export function buildStarterIntentRootOwnershipReminder() {
     return `CRITICAL: For first-turn /plan and /research starter requests, keep the root assistant visibly owning the work, continue in the same turn after load_skill, and delegate only when isolation, parallelism, or a different tool/model budget materially helps.`;
 }
+/** Message shape for build starter intent root ownership block. */
 export function buildStarterIntentRootOwnershipBlockMessage() {
     return `Keep the first /plan or /research turn root-owned. Continue in the main thread after load_skill, explain the approach first, and delegate only when isolation, parallelism, or a different tool/model budget materially helps.`;
 }
+/** Shared load skill continuation reminder value. */
 export const LOAD_SKILL_CONTINUATION_REMINDER = `CRITICAL: load_skill only loaded instructions. ${LOAD_SKILL_CONTINUE_SAME_TURN_NOW} ${LOAD_SKILL_ROOT_OWNERSHIP} Use the loaded skill guidance to proceed. ${LOAD_SKILL_DELEGATION_THRESHOLD} Do not stop immediately after load_skill.`;
+/** Shared slash command artifact reminder value. */
 export const SLASH_COMMAND_ARTIFACT_REMINDER = `CRITICAL: This slash-command task names an exact artifact path. ${LOAD_SKILL_ROOT_OWNERSHIP} Treat that path as a required deliverable, and continue in the same turn. Delegate only when isolation materially helps.`;
 const RICH_TEXT_COMMAND_PATTERN = /<span\s+data-command="([^"]+)">\s*\/([a-z0-9_-]+)\s*<\/span>/gi;
 const STARTER_INTENT_PATTERN = /^\s*\/([a-z0-9_-]+)\b/i;
 const CONVERSATION_FIRST_STARTER_INTENT_IDS = new Set(["plan", "research"]);
+/** Shared first turn starter intent root ownership reminder value. */
 export const FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_REMINDER = buildStarterIntentRootOwnershipReminder();
+/** Shared first turn starter intent root ownership context key value. */
 export const FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_CONTEXT_KEY = "__vfStarterIntentRootOwnership";
+/** Shared first turn starter intent root ownership block message value. */
 export const FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_BLOCK_MESSAGE = buildStarterIntentRootOwnershipBlockMessage();
 function isToolCallPart(part) {
     return (isRecord(part) &&
@@ -92,6 +115,7 @@ function hasToolCallOrResult(messages, toolName) {
         });
     });
 }
+/** Extract starter intent ID. */
 export function extractStarterIntentId(messages) {
     const latestUserText = extractLatestUserText(messages);
     if (!latestUserText) {
@@ -103,6 +127,7 @@ export function extractStarterIntentId(messages) {
     const commandId = STARTER_INTENT_PATTERN.exec(normalizedText)?.[1] ?? null;
     return commandId ? commandId.toLowerCase() : null;
 }
+/** Evaluate starter intent turn policy helper. */
 export function evaluateStarterIntentTurnPolicy(input) {
     const starterIntentId = extractStarterIntentId(input.messages);
     const keepConversationFirst = input.step === 1 && starterIntentId !== null &&
@@ -116,15 +141,18 @@ export function evaluateStarterIntentTurnPolicy(input) {
         shouldBlockImmediateDelegation: keepConversationFirst,
     };
 }
+/** Add first turn starter intent root ownership reminder helper. */
 export function addFirstTurnStarterIntentRootOwnershipReminder(system) {
     if (system.includes(FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_REMINDER)) {
         return system;
     }
     return `${system}\n\n${FIRST_TURN_STARTER_INTENT_ROOT_OWNERSHIP_REMINDER}`;
 }
+/** Check whether starter intent root ownership is required. */
 export function isStarterIntentRootOwnershipRequired(value) {
     return value === true;
 }
+/** Should reinforce load skill continuation helper. */
 export function shouldReinforceLoadSkillContinuation(messages) {
     const lastMessage = messages.at(-1);
     const previousMessage = messages.at(-2);
@@ -160,6 +188,7 @@ export function shouldReinforceLoadSkillContinuation(messages) {
     }
     return loadSkillCalls.every((part) => completedToolCallIds.has(part.toolCallId));
 }
+/** Add load skill continuation reminder helper. */
 export function addLoadSkillContinuationReminder(instructions) {
     if (typeof instructions === "string") {
         return `${instructions}\n\n${LOAD_SKILL_CONTINUATION_REMINDER}`;
@@ -175,6 +204,7 @@ export function addLoadSkillContinuationReminder(instructions) {
         },
     ];
 }
+/** Add slash command artifact reminder helper. */
 export function addSlashCommandArtifactReminder(instructions) {
     if (typeof instructions === "string") {
         return `${instructions}\n\n${SLASH_COMMAND_ARTIFACT_REMINDER}`;