veryfront 0.1.558 → 0.1.560

package/esm/src/agent/hosted/child-lifecycle.d.ts

@@ -1,4 +1,5 @@
 import { type ChildRunExecutionResult, type ChildRunExecutionSnapshot } from "../child-run/execution-snapshot.js";
+/** State for hosted child lifecycle terminal. */
 export interface HostedChildLifecycleTerminalState {
     status: "completed" | "failed" | "cancelled";
     usage?: {
@@ -12,6 +13,7 @@ export interface HostedChildLifecycleTerminalState {
 export interface HostedChildLifecycleCompletedState extends Omit<HostedChildLifecycleTerminalState, "status"> {
     status: "completed";
 }
+/** Public API contract for hosted child lifecycle adapter. */
 export interface HostedChildLifecycleAdapter {
     pending?: () => Promise<void> | void;
     running?: () => Promise<void> | void;
@@ -22,6 +24,7 @@ export interface HostedChildLifecycleAdapter {
 export interface HostedChildLifecycleErrorState extends Omit<HostedChildLifecycleTerminalState, "status"> {
     status: "failed" | "cancelled";
 }
+/** Options accepted by hosted child lifecycle runner. */
 export interface HostedChildLifecycleRunnerOptions<TResult> {
     adapter: HostedChildLifecycleAdapter;
     execute: () => Promise<TResult> | TResult;
@@ -29,6 +32,7 @@ export interface HostedChildLifecycleRunnerOptions<TResult> {
     resolveErrorState: (error: unknown) => Promise<HostedChildLifecycleErrorState> | HostedChildLifecycleErrorState;
     onLifecycleError?: (error: unknown) => Promise<void> | void;
 }
+/** Result returned from hosted child lifecycle run. */
 export type HostedChildLifecycleRunResult<TResult> = {
     status: "completed";
     result: TResult;
@@ -38,6 +42,7 @@ export type HostedChildLifecycleRunResult<TResult> = {
     error: unknown;
     terminalState: HostedChildLifecycleTerminalState;
 };
+/** Result returned from hosted child execution lifecycle. */
 export type HostedChildExecutionLifecycleResult<TLocalResult extends ChildRunExecutionResult> = {
     status: "completed";
     result: TLocalResult;
@@ -48,7 +53,9 @@ export type HostedChildExecutionLifecycleResult<TLocalResult extends ChildRunExe
     error: unknown;
     terminalState: HostedChildLifecycleTerminalState;
 };
+/** Should skip hosted child terminal persistence helper. */
 export declare function shouldSkipHostedChildTerminalPersistence(terminalState: Pick<HostedChildLifecycleTerminalState, "terminalErrorCode">): boolean;
+/** Options accepted by hosted child execution lifecycle. */
 export interface HostedChildExecutionLifecycleOptions<TLocalResult extends ChildRunExecutionResult> {
     adapter: HostedChildLifecycleAdapter;
     executionFailedCode: string;
@@ -58,6 +65,8 @@ export interface HostedChildExecutionLifecycleOptions<TLocalResult extends Child
     onLifecycleError?: (error: unknown) => Promise<void> | void;
     skipTerminalPersistence?: (terminalState: HostedChildLifecycleTerminalState) => boolean;
 }
+/** Run hosted child lifecycle. */
 export declare function runHostedChildLifecycle<TResult>(options: HostedChildLifecycleRunnerOptions<TResult>): Promise<HostedChildLifecycleRunResult<TResult>>;
+/** Run hosted child execution lifecycle. */
 export declare function runHostedChildExecutionLifecycle<TLocalResult extends ChildRunExecutionResult>(options: HostedChildExecutionLifecycleOptions<TLocalResult>): Promise<HostedChildExecutionLifecycleResult<TLocalResult>>;
 //# sourceMappingURL=child-lifecycle.d.ts.map

package/esm/src/agent/hosted/child-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAE/B,MAAM,oCAAoC,CAAC;AAQ5C,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,kCACf,SAAQ,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC;IACzD,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,CACV,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,CACP,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,CACV,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC;IACzD,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED,MAAM,WAAW,iCAAiC,CAAC,OAAO;IACxD,OAAO,EAAE,2BAA2B,CAAC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1C,qBAAqB,CAAC,EAAE,CACtB,MAAM,EAAE,OAAO,KAEb,OAAO,CAAC,kCAAkC,CAAC,GAC3C,kCAAkC,CAAC;IACvC,iBAAiB,EAAE,CACjB,KAAK,EAAE,OAAO,KAEZ,OAAO,CAAC,8BAA8B,CAAC,GACvC,8BAA8B,CAAC;IACnC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,MAAM,6BAA6B,CAAC,OAAO,IAC7C;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,iCAAiC,CAAC;CAClD,GACC;IACA,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,iCAAiC,CAAC;CAClD,CAAC;AAEJ,MAAM,MAAM,mCAAmC,CAC7C,YAAY,SAAS,uBAAuB,IAE1C;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,iCAAiC,CAAC;CAClD,GACC;IACA,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,iCAAiC,CAAC;CAClD,CAAC;AAEJ,wBAAgB,wCAAwC,CACtD,aAAa,EAAE,IAAI,CAAC,iCAAiC,EAAE,mBAAmB,CAAC,GAC1E,OAAO,CAET;AAED,MAAM,WAAW,oCAAoC,CACnD,YAAY,SAAS,uBAAuB;IAE5C,OAAO,EAAE,2BAA2B,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IACpD,oBAAoB,EAAE,MAAM,yBAAyB,GAAG,IAAI,CAAC;IAC7D,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,EAAE,CAAC,aAAa,EAAE,iCAAiC,KAAK,OAAO,CAAC;CACzF;AAiCD,wBAAsB,uBAAuB,CAAC,OAAO,EACnD,OAAO,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAsCjD;AA2FD,wBAAsB,gCAAgC,CACpD,YAAY,SAAS,uBAAuB,EAE5C,OAAO,EAAE,oCAAoC,CAAC,YAAY,CAAC,GAC1D,OAAO,CAAC,mCAAmC,CAAC,YAAY,CAAC,CAAC,CA4E5D"}
+{"version":3,"file":"child-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAE/B,MAAM,oCAAoC,CAAC;AAQ5C,iDAAiD;AACjD,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,kCACf,SAAQ,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC;IACzD,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,CACV,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,CACP,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,CACV,aAAa,EAAE,iCAAiC,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC;IACzD,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED,yDAAyD;AACzD,MAAM,WAAW,iCAAiC,CAAC,OAAO;IACxD,OAAO,EAAE,2BAA2B,CAAC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1C,qBAAqB,CAAC,EAAE,CACtB,MAAM,EAAE,OAAO,KAEb,OAAO,CAAC,kCAAkC,CAAC,GAC3C,kCAAkC,CAAC;IACvC,iBAAiB,EAAE,CACjB,KAAK,EAAE,OAAO,KAEZ,OAAO,CAAC,8BAA8B,CAAC,GACvC,8BAA8B,CAAC;IACnC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED,uDAAuD;AACvD,MAAM,MAAM,6BAA6B,CAAC,OAAO,IAC7C;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,iCAAiC,CAAC;CAClD,GACC;IACA,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,iCAAiC,CAAC;CAClD,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,mCAAmC,CAC7C,YAAY,SAAS,uBAAuB,IAE1C;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,iCAAiC,CAAC;CAClD,GACC;IACA,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,iCAAiC,CAAC;CAClD,CAAC;AAEJ,4DAA4D;AAC5D,wBAAgB,wCAAwC,CACtD,aAAa,EAAE,IAAI,CAAC,iCAAiC,EAAE,mBAAmB,CAAC,GAC1E,OAAO,CAET;AAED,4DAA4D;AAC5D,MAAM,WAAW,oCAAoC,CACnD,YAAY,SAAS,uBAAuB;IAE5C,OAAO,EAAE,2BAA2B,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IACpD,oBAAoB,EAAE,MAAM,yBAAyB,GAAG,IAAI,CAAC;IAC7D,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,EAAE,CAAC,aAAa,EAAE,iCAAiC,KAAK,OAAO,CAAC;CACzF;AAiCD,kCAAkC;AAClC,wBAAsB,uBAAuB,CAAC,OAAO,EACnD,OAAO,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAsCjD;AA2FD,4CAA4C;AAC5C,wBAAsB,gCAAgC,CACpD,YAAY,SAAS,uBAAuB,EAE5C,OAAO,EAAE,oCAAoC,CAAC,YAAY,CAAC,GAC1D,OAAO,CAAC,mCAAmC,CAAC,YAAY,CAAC,CAAC,CA4E5D"}

package/esm/src/agent/hosted/child-lifecycle.js

@@ -1,6 +1,7 @@
 import { buildChildRunExecutionSnapshot, getChildRunSnapshotUsage, } from "../child-run/execution-snapshot.js";
 import { isChildRunAbortError } from "../child-run/execution-support.js";
 import { HostedChildTerminalStateError, isHostedChildTerminalErrorCode, resolveHostedChildTerminalErrorCode, } from "./child-status.js";
+/** Should skip hosted child terminal persistence helper. */
 export function shouldSkipHostedChildTerminalPersistence(terminalState) {
     return isHostedChildTerminalErrorCode(terminalState.terminalErrorCode);
 }
@@ -23,6 +24,7 @@ async function dispatchTerminalState(adapter, terminalState) {
     }
     await adapter.completed?.(terminalState);
 }
+/** Run hosted child lifecycle. */
 export async function runHostedChildLifecycle(options) {
     await options.adapter.pending?.();
     await options.adapter.running?.();
@@ -123,6 +125,7 @@ function resolveHostedChildExecutionErrorState(error, input) {
         usage: toHostedChildLifecycleUsage(getChildRunSnapshotUsage(input.getExecutionSnapshot())),
     };
 }
+/** Run hosted child execution lifecycle. */
 export async function runHostedChildExecutionLifecycle(options) {
     const adapter = wrapSkippableTerminalPersistence(options.adapter, options.skipTerminalPersistence);
     try {

package/esm/src/agent/hosted/child-mirror.d.ts

@@ -1,12 +1,15 @@
 import type { ChatMessageMetadata, ChatUiMessageChunk } from "../../chat/protocol.js";
 import type { HostedStreamPartForUiChunkMapping } from "../../chat/hosted-ui-chunk-mapping.js";
+/** Public API contract for hosted child chunk mirror. */
 export interface HostedChildChunkMirror {
     handleChunk(chunk: ChatUiMessageChunk<ChatMessageMetadata>): Promise<void> | void;
 }
+/** State for hosted child mirror. */
 export interface HostedChildMirrorState {
     reasoningStarted: boolean;
     textStarted: boolean;
 }
+/** Context for hosted child mirror. */
 export interface HostedChildMirrorContext {
     mirror: HostedChildChunkMirror | null;
     messageId: string | null;
@@ -22,6 +25,7 @@ export interface HostedChildMirrorContext {
 type CoreMirroredPartType = "reasoning-delta" | "text-delta" | "tool-input-start" | "tool-input-delta" | "tool-call" | "tool-result";
 type MirroredPartType = CoreMirroredPartType | "tool-error" | "error";
 type DurableMirrorChunkType = ChatUiMessageChunk<ChatMessageMetadata>["type"];
+/** Check whether a hosted chunk was already mirrored. */
 export declare function isAlreadyMirroredHostedChunk(partType: MirroredPartType, mirroredChunkType: DurableMirrorChunkType): boolean;
 type MirroredHostedStreamPart = Extract<HostedStreamPartForUiChunkMapping, {
     type: "reasoning-delta";
@@ -80,25 +84,31 @@ type HostedMirrorBasePart = {
 type ExtraMirroredHostedStreamPart = Extract<HostedStreamPartForUiChunkMapping, {
     type: "source";
 }>;
+/** Public API contract for hosted child mirror part. */
 export type HostedChildMirrorPart = HostedMirrorBasePart | ExtraMirroredHostedStreamPart;
+/** Converts a value to mirrored hosted stream part. */
 export declare function toMirroredHostedStreamPart(part: HostedChildMirrorPart, ids: {
     messageId: string | null;
     reasoningMessageId: string | null;
 }): MirroredHostedStreamPart;
+/** Append hosted child mirror chunk. */
 export declare function appendHostedChildMirrorChunk(input: {
     mirror: HostedChildChunkMirror | null;
     chunk: ChatUiMessageChunk<ChatMessageMetadata>;
 }): Promise<boolean>;
+/** Close hosted child reasoning segment helper. */
 export declare function closeHostedChildReasoningSegment(input: {
     mirror: HostedChildChunkMirror | null;
     reasoningMessageId: string | null;
     state: HostedChildMirrorState;
 }): Promise<void>;
+/** Close hosted child text segment helper. */
 export declare function closeHostedChildTextSegment(input: {
     mirror: HostedChildChunkMirror | null;
     messageId: string | null;
     state: HostedChildMirrorState;
 }): Promise<void>;
+/** Context for create hosted child mirror. */
 export declare function createHostedChildMirrorContext(input: {
     mirror: HostedChildChunkMirror | null;
     messageId?: string | null;

package/esm/src/agent/hosted/child-mirror.d.ts.map

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

package/esm/src/agent/hosted/child-mirror.js

@@ -6,9 +6,11 @@ const ALREADY_MIRRORED_CHUNK_TYPES_BY_PART_TYPE = {
     "tool-result": ["tool-output-available"],
     "tool-error": ["tool-input-start", "tool-input-error"],
 };
+/** Check whether a hosted chunk was already mirrored. */
 export function isAlreadyMirroredHostedChunk(partType, mirroredChunkType) {
     return ALREADY_MIRRORED_CHUNK_TYPES_BY_PART_TYPE[partType]?.includes(mirroredChunkType) ?? false;
 }
+/** Converts a value to mirrored hosted stream part. */
 export function toMirroredHostedStreamPart(part, ids) {
     switch (part.type) {
         case "reasoning-delta":
@@ -83,6 +85,7 @@ export function toMirroredHostedStreamPart(part, ids) {
             };
     }
 }
+/** Append hosted child mirror chunk. */
 export async function appendHostedChildMirrorChunk(input) {
     if (!input.mirror) {
         return false;
@@ -90,6 +93,7 @@ export async function appendHostedChildMirrorChunk(input) {
     await input.mirror.handleChunk(input.chunk);
     return true;
 }
+/** Close hosted child reasoning segment helper. */
 export async function closeHostedChildReasoningSegment(input) {
     if (!input.state.reasoningStarted || !input.reasoningMessageId) {
         return;
@@ -103,6 +107,7 @@ export async function closeHostedChildReasoningSegment(input) {
         },
     });
 }
+/** Close hosted child text segment helper. */
 export async function closeHostedChildTextSegment(input) {
     if (!input.state.textStarted || !input.messageId) {
         return;
@@ -116,6 +121,7 @@ export async function closeHostedChildTextSegment(input) {
         },
     });
 }
+/** Context for create hosted child mirror. */
 export function createHostedChildMirrorContext(input) {
     const messageId = input.messageId ?? null;
     const reasoningMessageId = input.reasoningMessageId ??

package/esm/src/agent/hosted/child-pending-tool-lifecycle.d.ts

@@ -1,10 +1,13 @@
 import type { ChatMessageMetadata, ChatUiMessageChunk } from "../../chat/protocol.js";
+/** Public API contract for hosted child pending tool call phase. */
 export type HostedChildPendingToolCallPhase = "input_streaming" | "awaiting_result";
+/** State for hosted child pending tool call. */
 export interface HostedChildPendingToolCallState {
     phase: HostedChildPendingToolCallPhase;
     toolName?: string;
     input?: unknown;
 }
+/** Public API contract for hosted child pending tool lifecycle close reason. */
 export type HostedChildPendingToolLifecycleCloseReason = {
     kind: "ended";
 } | {
@@ -13,34 +16,42 @@ export type HostedChildPendingToolLifecycleCloseReason = {
     kind: "error";
     error: unknown;
 };
+/** Public API contract for hosted child pending tool lifecycle close log. */
 export interface HostedChildPendingToolLifecycleCloseLog {
     reason: HostedChildPendingToolLifecycleCloseReason["kind"];
     toolCallIds: string[];
     errorMessage: string | null;
 }
+/** Public API contract for hosted child pending tool lifecycle unknown tool log. */
 export interface HostedChildPendingToolLifecycleUnknownToolLog {
     toolCallId: string;
     phase: HostedChildPendingToolCallPhase;
     reason: HostedChildPendingToolLifecycleCloseReason["kind"];
     hasInputSnapshot: boolean;
 }
+/** Public API contract for hosted child pending tool lifecycle logger. */
 export interface HostedChildPendingToolLifecycleLogger {
     warnIncompleteToolLifecycles?: (input: HostedChildPendingToolLifecycleCloseLog) => void;
     warnUnknownToolIdentity?: (input: HostedChildPendingToolLifecycleUnknownToolLog) => void;
 }
+/** Context for hosted child pending tool lifecycle log. */
 export interface HostedChildPendingToolLifecycleLogContext {
     conversationId?: string;
     parentRunId?: string;
     description: string;
 }
+/** Public API contract for hosted child pending tool lifecycle log writer. */
 export interface HostedChildPendingToolLifecycleLogWriter {
     warn: (message: string, context: Record<string, unknown>) => void;
 }
+/** Create hosted child pending tool lifecycle logger. */
 export declare function createHostedChildPendingToolLifecycleLogger(context: HostedChildPendingToolLifecycleLogContext, writer: HostedChildPendingToolLifecycleLogWriter): HostedChildPendingToolLifecycleLogger;
+/** Input payload for hosted child pending tool lifecycle. */
 export interface HostedChildPendingToolLifecycleInput {
     appendMirrorChunk: (chunk: ChatUiMessageChunk<ChatMessageMetadata>) => Promise<void> | void;
     logger?: HostedChildPendingToolLifecycleLogger;
 }
+/** Create hosted child pending tool lifecycle. */
 export declare function createHostedChildPendingToolLifecycle(input: HostedChildPendingToolLifecycleInput): {
     upsertPendingToolCall: (toolCallId: string, state: HostedChildPendingToolCallState) => void;
     emitToolInputStartIfNeeded: (toolCallId: string, toolName: string) => Promise<void>;

package/esm/src/agent/hosted/child-pending-tool-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-pending-tool-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-pending-tool-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,MAAM,MAAM,+BAA+B,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEpF,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,0CAA0C,GAClD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,uCAAuC;IACtD,MAAM,EAAE,0CAA0C,CAAC,MAAM,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,6CAA6C;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,+BAA+B,CAAC;IACvC,MAAM,EAAE,0CAA0C,CAAC,MAAM,CAAC,CAAC;IAC3D,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qCAAqC;IACpD,4BAA4B,CAAC,EAAE,CAAC,KAAK,EAAE,uCAAuC,KAAK,IAAI,CAAC;IACxF,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,6CAA6C,KAAK,IAAI,CAAC;CAC1F;AAED,MAAM,WAAW,yCAAyC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnE;AAED,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,yCAAyC,EAClD,MAAM,EAAE,wCAAwC,GAC/C,qCAAqC,CAwBvC;AAED,MAAM,WAAW,oCAAoC;IACnD,iBAAiB,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5F,MAAM,CAAC,EAAE,qCAAqC,CAAC;CAChD;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,oCAAoC;wCAiBpD,MAAM,SAAS,+BAA+B;6CAbnC,MAAM,YAAY,MAAM;wCA2ExC,MAAM;oCArDC,0CAA0C;EA0DxF"}
+{"version":3,"file":"child-pending-tool-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-pending-tool-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,oEAAoE;AACpE,MAAM,MAAM,+BAA+B,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEpF,gDAAgD;AAChD,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,MAAM,0CAA0C,GAClD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,WAAW,uCAAuC;IACtD,MAAM,EAAE,0CAA0C,CAAC,MAAM,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,oFAAoF;AACpF,MAAM,WAAW,6CAA6C;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,+BAA+B,CAAC;IACvC,MAAM,EAAE,0CAA0C,CAAC,MAAM,CAAC,CAAC;IAC3D,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,qCAAqC;IACpD,4BAA4B,CAAC,EAAE,CAAC,KAAK,EAAE,uCAAuC,KAAK,IAAI,CAAC;IACxF,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,6CAA6C,KAAK,IAAI,CAAC;CAC1F;AAED,2DAA2D;AAC3D,MAAM,WAAW,yCAAyC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnE;AAED,yDAAyD;AACzD,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,yCAAyC,EAClD,MAAM,EAAE,wCAAwC,GAC/C,qCAAqC,CAwBvC;AAED,6DAA6D;AAC7D,MAAM,WAAW,oCAAoC;IACnD,iBAAiB,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5F,MAAM,CAAC,EAAE,qCAAqC,CAAC;CAChD;AAED,kDAAkD;AAClD,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,oCAAoC;wCAiBpD,MAAM,SAAS,+BAA+B;6CAbnC,MAAM,YAAY,MAAM;wCA2ExC,MAAM;oCArDC,0CAA0C;EA0DxF"}

package/esm/src/agent/hosted/child-pending-tool-lifecycle.js

@@ -1,4 +1,5 @@
 import { toChildRunToolInputRecord } from "../child-run/execution-support.js";
+/** Create hosted child pending tool lifecycle logger. */
 export function createHostedChildPendingToolLifecycleLogger(context, writer) {
     return {
         warnIncompleteToolLifecycles: (log) => {
@@ -24,6 +25,7 @@ export function createHostedChildPendingToolLifecycleLogger(context, writer) {
         },
     };
 }
+/** Create hosted child pending tool lifecycle. */
 export function createHostedChildPendingToolLifecycle(input) {
     const startedToolCallIds = new Set();
     const pendingToolCalls = new Map();

package/esm/src/agent/hosted/child-requested-tools.d.ts

@@ -2,6 +2,7 @@ import type { HostToolSet } from "../../tool/index.js";
 import { type HostedChildFileWriteFallbackLogger } from "./child-artifact-support.js";
 import { type HostedChildSteeringMutationHandler } from "./child-steering-tools.js";
 import { type ProjectSteeringPaths } from "../project/steering-mutation.js";
+/** Input payload for hosted child requested tools. */
 export interface HostedChildRequestedToolsInput {
     prompt: string;
     requestedTools?: readonly string[];
@@ -12,15 +13,21 @@ export interface HostedChildRequestedToolsInput {
     sandboxRequiredCuePattern?: RegExp;
     isTextArtifactPrompt?: (prompt: string) => boolean;
 }
+/** Default value for hosted child excluded tool names. */
 export declare const DEFAULT_HOSTED_CHILD_EXCLUDED_TOOL_NAMES: ReadonlySet<string>;
+/** Default value for hosted child requested tool companions. */
 export declare const DEFAULT_HOSTED_CHILD_REQUESTED_TOOL_COMPANIONS: Readonly<Record<string, readonly string[]>>;
+/** Default value for hosted child sandbox required cue pattern. */
 export declare const DEFAULT_HOSTED_CHILD_SANDBOX_REQUIRED_CUE_PATTERN: RegExp;
+/** Sanitize hosted child requested tools. */
 export declare function sanitizeHostedChildRequestedTools(input: HostedChildRequestedToolsInput): string[] | undefined;
+/** Expand hosted child requested tools helper. */
 export declare function expandHostedChildRequestedTools(input: {
     requestedTools?: readonly string[];
     excludedTools?: ReadonlySet<string>;
     companionTools?: Readonly<Record<string, readonly string[]>>;
 }): string[] | undefined;
+/** Request payload for should prune sandbox tools from hosted child. */
 export declare function shouldPruneSandboxToolsFromHostedChildRequest(input: {
     prompt: string;
     requestedTools?: readonly string[];
@@ -29,6 +36,7 @@ export declare function shouldPruneSandboxToolsFromHostedChildRequest(input: {
     sandboxRequiredCuePattern?: RegExp;
     isTextArtifactPrompt?: (prompt: string) => boolean;
 }): boolean;
+/** Result returned from hosted child fork runtime tool selection. */
 export type HostedChildForkRuntimeToolSelectionResult = {
     ok: true;
     forkTools: HostToolSet;
@@ -36,6 +44,7 @@ export type HostedChildForkRuntimeToolSelectionResult = {
     ok: false;
     errorMessage: string;
 };
+/** Result returned from default hosted child fork runtime tool preparation. */
 export type DefaultHostedChildForkRuntimeToolPreparationResult = {
     ok: true;
     forkTools: HostToolSet;
@@ -44,6 +53,7 @@ export type DefaultHostedChildForkRuntimeToolPreparationResult = {
     ok: false;
     errorMessage: string;
 };
+/** Result returned from default hosted child fork tool assembly source. */
 export type DefaultHostedChildForkToolAssemblySourceResult = {
     ok: true;
     forkTools: HostToolSet;
@@ -53,6 +63,7 @@ export type DefaultHostedChildForkToolAssemblySourceResult = {
     ok: false;
     errorMessage: string;
 };
+/** Result returned from default hosted child fork tool assembly. */
 export type DefaultHostedChildForkToolAssemblyResult = {
     ok: true;
     forkTools: HostToolSet;
@@ -63,16 +74,19 @@ export type DefaultHostedChildForkToolAssemblyResult = {
     ok: false;
     errorMessage: string;
 };
+/** Select hosted child fork runtime tools helper. */
 export declare function selectHostedChildForkRuntimeTools(input: {
     provider: string;
     forkModel?: string;
     forkTools: HostToolSet;
     requestedTools?: readonly string[];
 }): HostedChildForkRuntimeToolSelectionResult;
+/** Sanitize default hosted child requested tools. */
 export declare function sanitizeDefaultHostedChildRequestedTools(input: {
     prompt: string;
     requestedTools?: readonly string[];
 }): string[] | undefined;
+/** Select default hosted child fork runtime tools helper. */
 export declare function selectDefaultHostedChildForkRuntimeTools(input: {
     provider: string;
     forkModel?: string;
@@ -80,6 +94,7 @@ export declare function selectDefaultHostedChildForkRuntimeTools(input: {
     effectivePrompt: string;
     requestedTools?: readonly string[];
 }): HostedChildForkRuntimeToolSelectionResult;
+/** Prepare default hosted child fork runtime tools. */
 export declare function prepareDefaultHostedChildForkRuntimeTools(input: {
     provider: string;
     forkModel?: string;
@@ -92,6 +107,7 @@ export declare function prepareDefaultHostedChildForkRuntimeTools(input: {
     onSteeringMutation?: HostedChildSteeringMutationHandler;
     logger?: HostedChildFileWriteFallbackLogger;
 }): DefaultHostedChildForkRuntimeToolPreparationResult;
+/** Prepare default hosted child fork tool assembly. */
 export declare function prepareDefaultHostedChildForkToolAssembly(input: {
     prepareToolSources: () => Promise<DefaultHostedChildForkToolAssemblySourceResult>;
     provider: string;
@@ -104,6 +120,8 @@ export declare function prepareDefaultHostedChildForkToolAssembly(input: {
     onSteeringMutation?: HostedChildSteeringMutationHandler;
     logger?: HostedChildFileWriteFallbackLogger;
 }): Promise<DefaultHostedChildForkToolAssemblyResult>;
+/** Builds default hosted child fork tool set. */
 export declare function buildDefaultHostedChildForkToolSet(...toolSets: readonly HostToolSet[]): HostToolSet;
+/** Builds hosted child tool description. */
 export declare function buildHostedChildToolDescription(): string;
 //# sourceMappingURL=child-requested-tools.d.ts.map

package/esm/src/agent/hosted/child-requested-tools.d.ts.map

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

package/esm/src/agent/hosted/child-requested-tools.js

@@ -4,16 +4,20 @@ import { getForkRuntimeAllowedToolNames } from "../runtime/provider-native-tool-
 import { PROJECT_STEERING_FILE_MUTATION_TOOL_NAMES, } from "../project/steering-mutation.js";
 const DEFAULT_SANDBOX_TOOL_NAMES = ["bash", "readFile", "writeFile"];
 const DEFAULT_ARTIFACT_TOOL_NAMES = ["create_file", "update_file"];
+/** Default value for hosted child excluded tool names. */
 export const DEFAULT_HOSTED_CHILD_EXCLUDED_TOOL_NAMES = new Set([
     "studio_panel_control",
     "studio_suggestions",
     "form_input",
 ]);
+/** Default value for hosted child requested tool companions. */
 export const DEFAULT_HOSTED_CHILD_REQUESTED_TOOL_COMPANIONS = {
     create_file: ["update_file"],
     update_file: ["create_file"],
 };
+/** Default value for hosted child sandbox required cue pattern. */
 export const DEFAULT_HOSTED_CHILD_SANDBOX_REQUIRED_CUE_PATTERN = /\b(bash|shell|terminal|command line|cli|\/workspace|workspace\/|python|node|npm|pnpm|yarn|curl|jq|csv|json|pdf|zip|unzip|archive|repo|git|test|build|script)\b/i;
+/** Sanitize hosted child requested tools. */
 export function sanitizeHostedChildRequestedTools(input) {
     const expandedTools = expandHostedChildRequestedTools({
         requestedTools: input.requestedTools,
@@ -36,6 +40,7 @@ export function sanitizeHostedChildRequestedTools(input) {
     const sandboxToolNames = new Set(input.sandboxToolNames ?? DEFAULT_SANDBOX_TOOL_NAMES);
     return expandedTools.filter((toolName) => !sandboxToolNames.has(toolName));
 }
+/** Expand hosted child requested tools helper. */
 export function expandHostedChildRequestedTools(input) {
     if (!input.requestedTools) {
         return undefined;
@@ -58,6 +63,7 @@ export function expandHostedChildRequestedTools(input) {
     }
     return [...expandedTools];
 }
+/** Request payload for should prune sandbox tools from hosted child. */
 export function shouldPruneSandboxToolsFromHostedChildRequest(input) {
     const requestedTools = input.requestedTools;
     if (!requestedTools?.length) {
@@ -79,6 +85,7 @@ export function shouldPruneSandboxToolsFromHostedChildRequest(input) {
     }
     return !matchesSandboxRequiredCue(input.sandboxRequiredCuePattern, input.prompt);
 }
+/** Select hosted child fork runtime tools helper. */
 export function selectHostedChildForkRuntimeTools(input) {
     if (!input.requestedTools?.length) {
         return {
@@ -110,6 +117,7 @@ export function selectHostedChildForkRuntimeTools(input) {
         forkTools,
     };
 }
+/** Sanitize default hosted child requested tools. */
 export function sanitizeDefaultHostedChildRequestedTools(input) {
     return sanitizeHostedChildRequestedTools({
         prompt: input.prompt,
@@ -120,6 +128,7 @@ export function sanitizeDefaultHostedChildRequestedTools(input) {
         isTextArtifactPrompt: isHostedChildTextProjectArtifactPrompt,
     });
 }
+/** Select default hosted child fork runtime tools helper. */
 export function selectDefaultHostedChildForkRuntimeTools(input) {
     const effectiveRequestedTools = sanitizeDefaultHostedChildRequestedTools({
         prompt: input.effectivePrompt,
@@ -132,6 +141,7 @@ export function selectDefaultHostedChildForkRuntimeTools(input) {
         requestedTools: effectiveRequestedTools,
     });
 }
+/** Prepare default hosted child fork runtime tools. */
 export function prepareDefaultHostedChildForkRuntimeTools(input) {
     const selectedTools = selectDefaultHostedChildForkRuntimeTools({
         provider: input.provider,
@@ -169,6 +179,7 @@ export function prepareDefaultHostedChildForkRuntimeTools(input) {
         availableToolNames,
     };
 }
+/** Prepare default hosted child fork tool assembly. */
 export async function prepareDefaultHostedChildForkToolAssembly(input) {
     const toolSources = await input.prepareToolSources();
     if (!toolSources.ok) {
@@ -199,6 +210,7 @@ export async function prepareDefaultHostedChildForkToolAssembly(input) {
         closeRuntime: toolSources.closeRuntime,
     };
 }
+/** Builds default hosted child fork tool set. */
 export function buildDefaultHostedChildForkToolSet(...toolSets) {
     const allTools = {};
     for (const toolSet of toolSets) {
@@ -213,6 +225,7 @@ export function buildDefaultHostedChildForkToolSet(...toolSets) {
     }
     return forkTools;
 }
+/** Builds hosted child tool description. */
 export function buildHostedChildToolDescription() {
     return `Invoke a focused child agent on an isolated subtask.
 Call multiple times in one response to run child agents in parallel.

package/esm/src/agent/hosted/child-status.d.ts

@@ -1,4 +1,5 @@
 import { type ConversationRunProjection } from "../conversation/durable.js";
+/** Public API contract for hosted child run identifiers. */
 export interface HostedChildRunIdentifiers {
     childConversationId: string;
     childRunId: string;
@@ -7,25 +8,34 @@ export interface HostedChildRunIdentifiers {
     latestExternalEventSequence: number;
 }
 type HostedConversationRunStatus = ConversationRunProjection["status"];
+/** Shared hosted child terminal error codes value. */
 export declare const hostedChildTerminalErrorCodes: Readonly<{
     cancelled: "DURABLE_CHILD_CANCELLED";
     failed: "DURABLE_CHILD_FAILED";
     completedExternally: "DURABLE_CHILD_COMPLETED_EXTERNALLY";
 }>;
+/** Public API contract for a code is a hosted child terminal error. */
 export type HostedChildTerminalErrorCode = (typeof hostedChildTerminalErrorCodes)[keyof typeof hostedChildTerminalErrorCodes];
+/** Check whether a code is a hosted child terminal error. */
 export declare function isHostedChildTerminalErrorCode(value: unknown): value is HostedChildTerminalErrorCode;
+/** Public API contract for hosted child same turn retry block signal. */
 export interface HostedChildSameTurnRetryBlockSignal {
     terminalErrorCode?: string | null;
     terminalErrorMessage?: string | null;
 }
+/** Should block hosted child same turn retry helper. */
 export declare function shouldBlockHostedChildSameTurnRetry(result: unknown): result is HostedChildSameTurnRetryBlockSignal;
+/** Public API contract for hosted child terminal status. */
 export type HostedChildTerminalStatus = Extract<HostedConversationRunStatus, "completed" | "failed" | "cancelled">;
+/** Error shape for hosted child terminal state. */
 export declare class HostedChildTerminalStateError extends Error {
     readonly status: HostedChildTerminalStatus;
     readonly identifiers: HostedChildRunIdentifiers;
     constructor(status: HostedChildTerminalStatus, identifiers: HostedChildRunIdentifiers);
 }
+/** Resolves a code is a hosted child terminal error. */
 export declare function resolveHostedChildTerminalErrorCode(status: HostedChildTerminalStatus): HostedChildTerminalErrorCode;
+/** Input payload for monitor hosted child run status. */
 export interface MonitorHostedChildRunStatusInput {
     authToken: string;
     apiUrl: string;
@@ -34,6 +44,7 @@ export interface MonitorHostedChildRunStatusInput {
     pollIntervalMs: number;
     onTerminal: (error: HostedChildTerminalStateError) => void;
 }
+/** Monitor hosted child run status helper. */
 export declare function monitorHostedChildRunStatus(input: MonitorHostedChildRunStatusInput): Promise<void>;
 export {};
 //# sourceMappingURL=child-status.d.ts.map

package/esm/src/agent/hosted/child-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-status.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,4BAA4B,CAAC;AAEhG,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,KAAK,2BAA2B,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAEvE,eAAO,MAAM,6BAA6B;;;;EAIxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAMvC;AAED,MAAM,WAAW,mCAAmC;IAClD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAOD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,mCAAmC,CAa/C;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,2BAA2B,EAC3B,WAAW,GAAG,QAAQ,GAAG,WAAW,CACrC,CAAC;AAEF,qBAAa,6BAA8B,SAAQ,KAAK;IAEpD,QAAQ,CAAC,MAAM,EAAE,yBAAyB;IAC1C,QAAQ,CAAC,WAAW,EAAE,yBAAyB;gBADtC,MAAM,EAAE,yBAAyB,EACjC,WAAW,EAAE,yBAAyB;CAOlD;AAQD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,yBAAyB,GAChC,4BAA4B,CAW9B;AA2BD,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,yBAAyB,CAAC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAC5D;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAiCf"}
+{"version":3,"file":"child-status.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,4BAA4B,CAAC;AAEhG,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,KAAK,2BAA2B,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAEvE,sDAAsD;AACtD,eAAO,MAAM,6BAA6B;;;;EAIxC,CAAC;AAEH,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF,6DAA6D;AAC7D,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAMvC;AAED,yEAAyE;AACzE,MAAM,WAAW,mCAAmC;IAClD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAOD,wDAAwD;AACxD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,mCAAmC,CAa/C;AAED,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,2BAA2B,EAC3B,WAAW,GAAG,QAAQ,GAAG,WAAW,CACrC,CAAC;AAEF,mDAAmD;AACnD,qBAAa,6BAA8B,SAAQ,KAAK;IAEpD,QAAQ,CAAC,MAAM,EAAE,yBAAyB;IAC1C,QAAQ,CAAC,WAAW,EAAE,yBAAyB;gBADtC,MAAM,EAAE,yBAAyB,EACjC,WAAW,EAAE,yBAAyB;CAOlD;AAQD,wDAAwD;AACxD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,yBAAyB,GAChC,4BAA4B,CAW9B;AA2BD,yDAAyD;AACzD,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,yBAAyB,CAAC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAC5D;AAED,8CAA8C;AAC9C,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/esm/src/agent/hosted/child-status.js

@@ -1,10 +1,12 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { getConversationRun } from "../conversation/durable.js";
+/** Shared hosted child terminal error codes value. */
 export const hostedChildTerminalErrorCodes = Object.freeze({
     cancelled: "DURABLE_CHILD_CANCELLED",
     failed: "DURABLE_CHILD_FAILED",
     completedExternally: "DURABLE_CHILD_COMPLETED_EXTERNALLY",
 });
+/** Check whether a code is a hosted child terminal error. */
 export function isHostedChildTerminalErrorCode(value) {
     return (value === hostedChildTerminalErrorCodes.cancelled ||
         value === hostedChildTerminalErrorCodes.failed ||
@@ -14,6 +16,7 @@ function getOptionalStringProperty(value, property) {
     const descriptor = Object.getOwnPropertyDescriptor(value, property);
     return typeof descriptor?.value === "string" ? descriptor.value : null;
 }
+/** Should block hosted child same turn retry helper. */
 export function shouldBlockHostedChildSameTurnRetry(result) {
     if (typeof result !== "object" || result === null) {
         return false;
@@ -24,6 +27,7 @@ export function shouldBlockHostedChildSameTurnRetry(result) {
         terminalErrorCode === hostedChildTerminalErrorCodes.cancelled ||
         terminalErrorMessage === "Child run cancelled");
 }
+/** Error shape for hosted child terminal state. */
 export class HostedChildTerminalStateError extends Error {
     status;
     identifiers;
@@ -37,6 +41,7 @@ export class HostedChildTerminalStateError extends Error {
 function isActiveHostedChildStatus(status) {
     return status === "pending" || status === "running" || status === "waiting_for_tool";
 }
+/** Resolves a code is a hosted child terminal error. */
 export function resolveHostedChildTerminalErrorCode(status) {
     switch (status) {
         case "cancelled":
@@ -69,6 +74,7 @@ async function waitForHostedChildStatusPoll(ms, abortSignal) {
 function isAbortError(error) {
     return error instanceof DOMException && error.name === "AbortError";
 }
+/** Monitor hosted child run status helper. */
 export async function monitorHostedChildRunStatus(input) {
     while (!input.abortSignal?.aborted) {
         await waitForHostedChildStatusPoll(input.pollIntervalMs, input.abortSignal);

package/esm/src/agent/hosted/child-steering-tools.d.ts

@@ -1,7 +1,10 @@
 import type { HostToolDefinition, HostToolSet } from "../../tool/index.js";
 import { type ProjectSteeringMutationResult, type ProjectSteeringPaths } from "../project/steering-mutation.js";
+/** Handler for hosted child steering mutation. */
 export type HostedChildSteeringMutationHandler = (mutation: ProjectSteeringMutationResult) => Promise<void> | void;
+/** Handler for hosted child project switch. */
 export type HostedChildProjectSwitchHandler = (projectId: string) => Promise<void> | void;
+/** Input payload for wrap hosted child steering mutation tool. */
 export type WrapHostedChildSteeringMutationToolInput = {
     toolName: string;
     toolDefinition: HostToolDefinition;
@@ -10,11 +13,14 @@ export type WrapHostedChildSteeringMutationToolInput = {
     steeringPaths?: ProjectSteeringPaths;
     onMutation?: HostedChildSteeringMutationHandler;
 };
+/** Input payload for wrap hosted child project switch tool. */
 export type WrapHostedChildProjectSwitchToolInput = {
     tools: HostToolSet;
     toolName?: string;
     onConfirmedProjectSwitch: HostedChildProjectSwitchHandler;
 };
+/** Wrap hosted child steering mutation tool helper. */
 export declare function wrapHostedChildSteeringMutationTool(input: WrapHostedChildSteeringMutationToolInput): HostToolDefinition;
+/** Wrap hosted child project switch tool helper. */
 export declare function wrapHostedChildProjectSwitchTool(input: WrapHostedChildProjectSwitchToolInput): void;
 //# sourceMappingURL=child-steering-tools.d.ts.map