veryfront 0.1.1122 → 0.1.1123

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1122",
+    "version": "0.1.1123",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/extensions/ext-llm-openai/src/openai-responses-request-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-responses-request-builder.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-llm-openai/src/openai-responses-request-builder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,kCAAkC,CAAC;AAO1C,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,OAAO,EAAE;QACZ,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,KAAK,IAAI,KAAK,CAAC;QACb,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ,CAAC;AA6IF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,+BAA+B,EACxC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,gBAAgB,GACzB,sBAAsB,CAsGxB"}
+{"version":3,"file":"openai-responses-request-builder.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-llm-openai/src/openai-responses-request-builder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,kCAAkC,CAAC;AAO1C,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,OAAO,EAAE;QACZ,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,KAAK,IAAI,KAAK,CAAC;QACb,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ,CAAC;AAkJF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,+BAA+B,EACxC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,gBAAgB,GACzB,sBAAsB,CAsGxB"}

package/esm/extensions/ext-llm-openai/src/openai-responses-request-builder.js

@@ -108,6 +108,11 @@ function toOpenAIResponsesTools(tools) {
                 type: "function",
                 name: tool.name,
                 ...(typeof tool.description === "string" ? { description: tool.description } : {}),
+                // Responses otherwise attempts to normalize omitted strictness into
+                // strict mode, which turns every declared property into a required
+                // argument. Runtime and remote tool schemas use normal JSON Schema
+                // optional properties, so preserve that contract explicitly.
+                strict: false,
                 parameters: unwrapToolInputSchema(tool.inputSchema),
             });
             continue;

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

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

@@ -1,5 +1,5 @@
 import { buildChildRunExecutionSnapshot, getChildRunSnapshotUsage, } from "../child-run/execution-snapshot.js";
-import { parseProviderError } from "../../chat/provider-errors.js";
+import { resolveKnownProviderTerminalError } from "../streaming/stream-outcome.js";
 import { isChildRunAbortError } from "../child-run/execution-support.js";
 import { HostedChildTerminalStateError, isHostedChildTerminalErrorCode, resolveHostedChildTerminalErrorCode, } from "./child-status.js";
 /** Should skip hosted child terminal persistence helper. */
@@ -14,17 +14,6 @@ class HostedChildExecutionFailure extends Error {
         this.name = "HostedChildExecutionFailure";
     }
 }
-function resolveKnownProviderTerminalError(error) {
-    const parsedError = parseProviderError(error);
-    if (parsedError.code === "EXTERNAL_SERVICE_ERROR" &&
-        parsedError.message === "LLM provider service error") {
-        return null;
-    }
-    return {
-        code: parsedError.code,
-        message: parsedError.message,
-    };
-}
 async function dispatchTerminalState(adapter, terminalState) {
     if (terminalState.status === "cancelled") {
         await adapter.cancelled?.(terminalState);

package/esm/src/agent/hosted/cloud-agent-chat-execution.d.ts

@@ -0,0 +1,38 @@
+import { type HostToolSet } from "../../tool/index.js";
+import { type HostedChatRuntimeCreationResult } from "./chat-runtime-contract.js";
+import type { HostedConversationRootRunContext } from "../conversation/root-run-lifecycle.js";
+import { type AgentRuntimeMessage } from "../runtime/message-adapter.js";
+import { type DefaultHostedChatRuntimeCreationOptions, type DefaultHostedChatRuntimeTaskContext } from "./default-chat-runtime.js";
+import { type AgentServiceRuntimeConfig, type CreateAgentServiceRuntimeOptions } from "../service/runtime.js";
+import type { AgentServiceServerLifecycle } from "../service/server.js";
+import type { ParsedHostedChatRequest } from "./chat-request-parser.js";
+import type { PreparedHostedChatExecution } from "./prepared-chat-execution.js";
+import { type NodeVeryfrontCloudAgentServiceContext } from "./cloud-agent-config.js";
+/** Full type of a prepared cloud agent chat execution, ready to stream or detach. */
+export type NodeVeryfrontCloudAgentServicePreparedExecution = PreparedHostedChatExecution & {
+    config: AgentServiceRuntimeConfig;
+    agent: HostedChatRuntimeCreationResult["agent"];
+    runtimeKind: "framework";
+    finalMessages: AgentRuntimeMessage[];
+    messages: PreparedHostedChatExecution["messages"];
+    rootRunContext: HostedConversationRootRunContext;
+};
+/** Builds the local tool set for a root chat runtime task context. */
+export declare function buildLocalTools(context: NodeVeryfrontCloudAgentServiceContext, options: DefaultHostedChatRuntimeCreationOptions, taskContext: DefaultHostedChatRuntimeTaskContext): HostToolSet;
+/** Creates the project steering refresh object for the chat runtime. */
+export declare function createProjectSteeringRefresh(context: NodeVeryfrontCloudAgentServiceContext): (input: import("./default-chat-runtime.js").DefaultHostedChatRuntimeSystemRefreshInput) => Promise<string>;
+/** Creates the hosted chat runtime for the given options. */
+export declare function createAgentRuntime(context: NodeVeryfrontCloudAgentServiceContext, options: DefaultHostedChatRuntimeCreationOptions): Promise<HostedChatRuntimeCreationResult>;
+/** Prepares the chat execution within the project agent runtime scope. */
+export declare function prepareChatExecutionWithinProjectRuntime(context: NodeVeryfrontCloudAgentServiceContext, req: ParsedHostedChatRequest): Promise<NodeVeryfrontCloudAgentServicePreparedExecution>;
+/** Prepares the chat execution, running within the project agent runtime. */
+export declare function prepareChatExecution(context: NodeVeryfrontCloudAgentServiceContext, req: ParsedHostedChatRequest): Promise<NodeVeryfrontCloudAgentServicePreparedExecution>;
+/** Creates the prepared execution runtime options for streaming and detached runs. */
+export declare function createPreparedExecutionRuntimeOptions(context: NodeVeryfrontCloudAgentServiceContext, config: AgentServiceRuntimeConfig): import("./prepared-chat-execution.js").PreparedHostedChatExecutionRuntimeOptions;
+/** Creates and starts the control plane registration lifecycle if enabled. */
+export declare function createControlPlaneRegistrationLifecycle(context: NodeVeryfrontCloudAgentServiceContext): Promise<AgentServiceServerLifecycle | undefined>;
+/** Builds the full CreateAgentServiceRuntimeOptions for the cloud agent service. */
+export declare function createNodeVeryfrontCloudAgentServiceRuntimeOptions(context: NodeVeryfrontCloudAgentServiceContext): CreateAgentServiceRuntimeOptions<NodeVeryfrontCloudAgentServicePreparedExecution>;
+/** Public type alias for the prepared execution type. */
+export type { NodeVeryfrontCloudAgentServicePreparedExecution as PreparedExecution };
+//# sourceMappingURL=cloud-agent-chat-execution.d.ts.map

package/esm/src/agent/hosted/cloud-agent-chat-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-agent-chat-execution.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/cloud-agent-chat-execution.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,KAAK,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAU7F,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAEL,KAAK,uCAAuC,EAC5C,KAAK,mCAAmC,EACzC,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACtC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAKxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAShF,OAAO,EAIL,KAAK,qCAAqC,EAE3C,MAAM,yBAAyB,CAAC;AAkBjC,qFAAqF;AACrF,MAAM,MAAM,+CAA+C,GAAG,2BAA2B,GAAG;IAC1F,MAAM,EAAE,yBAAyB,CAAC;IAClC,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,CAAC;IAChD,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAClD,cAAc,EAAE,gCAAgC,CAAC;CAClD,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,qCAAqC,EAC9C,OAAO,EAAE,uCAAuC,EAChD,WAAW,EAAE,mCAAmC,GAC/C,WAAW,CAiCb;AAED,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,qCAAqC,8GAU1F;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,qCAAqC,EAC9C,OAAO,EAAE,uCAAuC,GAC/C,OAAO,CAAC,+BAA+B,CAAC,CAyD1C;AA8FD,0EAA0E;AAC1E,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,qCAAqC,EAC9C,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,+CAA+C,CAAC,CAgG1D;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qCAAqC,EAC9C,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,+CAA+C,CAAC,CAK1D;AAED,sFAAsF;AACtF,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,qCAAqC,EAC9C,MAAM,EAAE,yBAAyB,oFAUlC;AAkBD,8EAA8E;AAC9E,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAsClD;AAED,oFAAoF;AACpF,wBAAgB,kDAAkD,CAChE,OAAO,EAAE,qCAAqC,GAC7C,gCAAgC,CAAC,+CAA+C,CAAC,CAwCnF;AAED,yDAAyD;AACzD,YAAY,EAAE,+CAA+C,IAAI,iBAAiB,EAAE,CAAC"}

package/esm/src/agent/hosted/cloud-agent-chat-execution.js

@@ -0,0 +1,349 @@
+/** Chat execution preparation and runtime wiring for the cloud agent service. */
+import * as dntShim from "../../../_dnt.shims.js";
+import { createRemoteMCPToolSource, sleepTool } from "../../tool/index.js";
+import { getEnv } from "../../platform/compat/process.js";
+import { buildAgentRunTraceAttributes, buildExecuteToolTraceAttributes, buildProjectServiceTraceAttributes, buildScheduleTraceAttributes, } from "./trace-attributes.js";
+import { createHostedFormInputTool } from "./form-input-tool.js";
+import { createHostedWebFetchTool } from "./web-fetch-tool.js";
+import { createDefaultHostedChatRuntime, } from "./default-chat-runtime.js";
+import { createHostedRootLocalToolRuntime } from "./root-sandbox-tool-source.js";
+import { createVeryfrontCloudContextSummaryGenerator } from "./context-summary-generator.js";
+import { createDefaultHostedProjectSteeringRefresh } from "./default-project-steering-refresh.js";
+import { applyAgentProjectContextChange } from "../project/context.js";
+import { runWithProjectAgentRuntime } from "../project/agent-runtime.js";
+import { buildVeryfrontCloudRuntimeInstructions } from "./cloud-runtime-system-messages.js";
+import { createAgentServiceRegistrationLifecycle, resolveAgentServiceRegistrationInput, } from "../service/registration.js";
+import { runPreparedHostedChatExecutionDetached, streamPreparedHostedChatExecutionToAgUiResponse, } from "./prepared-chat-execution.js";
+import { createVeryfrontCloudPreparedHostedChatExecutionRuntimeOptions, } from "./cloud-prepared-chat-execution-runtime.js";
+import { prepareVeryfrontCloudHostedChatExecution } from "./cloud-chat-execution-preparation.js";
+import { getDefaultAgentId, getProjectAgentRuntime, getResolvedAgentConfig, resolveAgentConfig, } from "./cloud-agent-config.js";
+import { buildHostedDelegateTools, createInvokeAgentTool, createLoadSkillTool, fetchProjectSteering, getDiscoveredHostTools, getProjectInstructions, getSkillsConfig, refreshProjectSkillIds, resolveHostedDelegationBinding, resolveMcpServers, setFilteredTraceAttributes, } from "./cloud-agent-child-tools.js";
+const DEFAULT_FORWARDED_CONFIG_NAMESPACE = "veryfront";
+const DEFAULT_PROJECT_NAVIGATION_TOOL_NAMES = ["studio_open_project"];
+/** Builds the local tool set for a root chat runtime task context. */
+export function buildLocalTools(context, options, taskContext) {
+    const config = context.infrastructure.getConfig();
+    const tools = {
+        ...getDiscoveredHostTools({ agentId: taskContext.agentId }),
+        form_input: createHostedFormInputTool(taskContext, config.VERYFRONT_API_URL),
+        load_skill: createLoadSkillTool(context, taskContext),
+        sleep: sleepTool,
+        web_fetch: createHostedWebFetchTool(),
+    };
+    if (options.allowDelegation !== false) {
+        const agentConfig = options.liveProjectSteering?.agent;
+        const binding = resolveHostedDelegationBinding(agentConfig);
+        if (binding.kind === "scoped") {
+            Object.assign(tools, buildHostedDelegateTools(context, {
+                delegates: binding.delegateIds,
+                selfId: agentConfig?.id ?? taskContext.agentId ?? "veryfront",
+                taskContext,
+            }));
+        }
+        else {
+            // Agents authored before declarative delegates retain the legacy hosted
+            // child-fork tool. Explicit scoped delegate bindings opt out.
+            tools.invoke_agent = createInvokeAgentTool(context, taskContext);
+        }
+    }
+    return tools;
+}
+/** Creates the project steering refresh object for the chat runtime. */
+export function createProjectSteeringRefresh(context) {
+    return createDefaultHostedProjectSteeringRefresh({
+        fetchProjectInstructions: (lookup) => getProjectInstructions(context, lookup),
+        fetchSkills: (lookup) => getSkillsConfig(context, lookup),
+        buildInstructions: buildVeryfrontCloudRuntimeInstructions,
+        projectScopedRemoteToolOptions: {
+            projectNavigationToolNames: DEFAULT_PROJECT_NAVIGATION_TOOL_NAMES,
+        },
+        logger: context.infrastructure.logger,
+    });
+}
+/** Creates the hosted chat runtime for the given options. */
+export function createAgentRuntime(context, options) {
+    const config = context.infrastructure.getConfig();
+    const projectRuntime = getProjectAgentRuntime(context);
+    const refreshSystem = createProjectSteeringRefresh(context);
+    const localToolRuntime = createHostedRootLocalToolRuntime({
+        allowedToolNames: options.allowedTools,
+        apiUrl: config.VERYFRONT_API_URL,
+        authToken: options.authToken,
+        createBashTool: context.options.createBashTool,
+        buildBaseTools: (taskContext) => buildLocalTools(context, options, taskContext),
+    });
+    return createDefaultHostedChatRuntime({
+        options,
+        sourceIntegrationPolicy: projectRuntime.sourceIntegrationPolicy,
+        config: {
+            apiUrl: config.VERYFRONT_API_URL,
+            apiMcpUrl: config.VERYFRONT_MCP_URL,
+            studioMcpUrl: config.VERYFRONT_STUDIO_MCP_URL,
+            mcpServers: resolveMcpServers(context.options, options.liveProjectSteering?.agent),
+        },
+        buildLocalTools: localToolRuntime.buildLocalTools,
+        cleanup: localToolRuntime.cleanup,
+        refreshSystem,
+        onSteeringMutation: async ({ mutation, taskContext }) => {
+            if (mutation.skillsChanged) {
+                // Pass the live task context (not a spread copy) so the refreshed
+                // owner-scoped skill ids and source paths actually land on the run.
+                await refreshProjectSkillIds(context, taskContext);
+            }
+        },
+        onStudioProjectSwitch: async ({ projectId, taskContext }) => {
+            if (!applyAgentProjectContextChange(taskContext, projectId)) {
+                return false;
+            }
+            await refreshProjectSkillIds(context, taskContext);
+            return true;
+        },
+        projectScopedRemoteToolOptions: {
+            projectNavigationToolNames: DEFAULT_PROJECT_NAVIGATION_TOOL_NAMES,
+        },
+        createRemoteToolSource: createRemoteMCPToolSource,
+        traceLocalTools: {
+            trace: (spanName, operation) => context.infrastructure.tracer.trace(spanName, operation),
+            buildAttributes: ({ toolName, toolCallId }) => buildExecuteToolTraceAttributes({
+                toolName,
+                toolCallId,
+            }),
+            setAttributes: (attributes) => setFilteredTraceAttributes(context, attributes),
+        },
+        logger: context.infrastructure.logger,
+    });
+}
+function setPrepareChatExecutionStartAttributes(context, input) {
+    const span = context.infrastructure.tracer.scope().active();
+    span?.setAttributes({
+        "chat.projectId": input.projectId ?? "none",
+        "chat.userId": input.userId,
+    });
+}
+function setPrepareChatExecutionResultAttributes(context, input) {
+    const scheduleTraceAttributes = buildScheduleTraceAttributes(input.forwardedProps);
+    const span = context.infrastructure.tracer.scope().active();
+    span?.setAttributes(buildAgentRunTraceAttributes({
+        operationName: "invoke_agent",
+        conversationId: input.conversationId,
+        projectId: input.projectId,
+        userId: input.userId,
+        agentId: input.agentId,
+        agentName: input.agentName,
+        modelId: input.modelId,
+        runId: input.runId,
+        parentConversationId: input.upstreamParentConversationId,
+        parentRunId: input.upstreamParentRunId,
+        toolCallId: input.spawnedFromToolCallId,
+        scheduleId: typeof scheduleTraceAttributes["schedule.id"] === "string"
+            ? scheduleTraceAttributes["schedule.id"]
+            : null,
+        scheduleName: typeof scheduleTraceAttributes["schedule.name"] === "string"
+            ? scheduleTraceAttributes["schedule.name"]
+            : null,
+    }));
+    span?.setAttributes({
+        "agent.runtime.kind": input.runtimeKind,
+        ...input.projectServiceTraceAttributes,
+        ...scheduleTraceAttributes,
+    });
+}
+function createHostedChatContextBudgetOptions(context, req, agentConfig, abortSignal) {
+    const config = context.infrastructure.getConfig();
+    if (!config.VERYFRONT_CONTEXT_COMPACTION_ENABLED || !req.durableRootRun) {
+        return undefined;
+    }
+    return {
+        tokenBudget: config.VERYFRONT_CONTEXT_COMPACTION_TOKEN_BUDGET,
+        reserveTokens: config.VERYFRONT_CONTEXT_COMPACTION_RESERVE_TOKENS,
+        recentTailTokens: config.VERYFRONT_CONTEXT_COMPACTION_RECENT_TAIL_TOKENS,
+        minimumRecentTurns: config.VERYFRONT_CONTEXT_COMPACTION_MINIMUM_RECENT_TURNS,
+        maxSummaryTokens: config.VERYFRONT_CONTEXT_COMPACTION_MAX_SUMMARY_TOKENS,
+        summaryGenerator: createVeryfrontCloudContextSummaryGenerator({
+            apiUrl: config.VERYFRONT_API_URL,
+            authToken: req.authToken,
+            projectSlug: req.projectSlug,
+            model: config.VERYFRONT_CONTEXT_COMPACTION_SUMMARY_MODEL ?? agentConfig.model,
+            maxOutputTokens: config.VERYFRONT_CONTEXT_COMPACTION_MAX_SUMMARY_TOKENS,
+            maxInputTokens: config.VERYFRONT_CONTEXT_COMPACTION_SUMMARY_INPUT_TOKENS,
+            abortSignal,
+        }),
+        logger: {
+            debug: (message, metadata) => context.infrastructure.logger.debug(message, metadata),
+            error: (message, metadata) => context.infrastructure.logger.error(message, metadata),
+        },
+    };
+}
+/** Prepares the chat execution within the project agent runtime scope. */
+export async function prepareChatExecutionWithinProjectRuntime(context, req) {
+    const { userId, authToken, projectId, conversationId, upstreamParentConversationId, upstreamParentRunId, spawnedFromToolCallId, } = req;
+    const config = context.infrastructure.getConfig();
+    const projectServiceTraceAttributes = buildProjectServiceTraceAttributes({
+        projectSlug: req.projectSlug,
+        readEnv: getEnv,
+    });
+    setPrepareChatExecutionStartAttributes(context, { projectId, userId });
+    const requestedAgentId = req.agentId ?? getDefaultAgentId(context);
+    // veryfront-api is the trusted caller for request-scoped project-agent config.
+    const agentConfig = req.agentConfig ?? await resolveAgentConfig(context, requestedAgentId);
+    const abortController = new AbortController();
+    const { effectiveMessages, rootRunContext, runtime: { agent, runtimeKind, modelId, cleanup }, finalMessages, } = await prepareVeryfrontCloudHostedChatExecution({
+        request: req,
+        agentConfig,
+        apiUrl: config.VERYFRONT_API_URL,
+        abortSignal: abortController.signal,
+        logger: context.infrastructure.logger,
+        rootRun: {
+            instrumentation: {
+                trace: context.trace,
+                setTraceAttributes: context.infrastructure.setActiveSpanAttributes,
+                debug: (message, metadata) => context.infrastructure.logger.debug(message, metadata),
+                warn: (message, metadata) => context.infrastructure.logger.warn(message, metadata),
+                error: (message, metadata) => context.infrastructure.logger.error(message, metadata),
+            },
+        },
+        fetchSteering: (steeringInput) => fetchProjectSteering(context, steeringInput),
+        buildInstructions: buildVeryfrontCloudRuntimeInstructions,
+        contextBudget: createHostedChatContextBudgetOptions(context, req, agentConfig, abortController.signal),
+        createRuntime: (creationOptions) => context.trace("chat.createRuntime", () => createAgentRuntime(context, {
+            ...creationOptions,
+            userId: req.userId,
+        })),
+    });
+    setPrepareChatExecutionResultAttributes(context, {
+        conversationId,
+        projectId,
+        userId,
+        agentId: agentConfig.id,
+        agentName: agentConfig.name,
+        modelId,
+        runId: rootRunContext.durableRootRun?.runId,
+        upstreamParentConversationId,
+        upstreamParentRunId,
+        spawnedFromToolCallId,
+        runtimeKind,
+        forwardedProps: req.forwardedProps,
+        projectServiceTraceAttributes,
+    });
+    return {
+        config,
+        agent,
+        agentId: agentConfig.id,
+        runtimeKind,
+        modelId,
+        cleanup,
+        messages: effectiveMessages,
+        finalMessages,
+        conversationId,
+        authToken,
+        projectId,
+        userId,
+        rootRunContext,
+        upstreamParentConversationId,
+        upstreamParentRunId,
+        spawnedFromToolCallId,
+        traceAttributes: {
+            ...projectServiceTraceAttributes,
+            ...buildScheduleTraceAttributes(req.forwardedProps),
+        },
+    };
+}
+/** Prepares the chat execution, running within the project agent runtime. */
+export async function prepareChatExecution(context, req) {
+    return await runWithProjectAgentRuntime(getProjectAgentRuntime(context), () => prepareChatExecutionWithinProjectRuntime(context, req));
+}
+/** Creates the prepared execution runtime options for streaming and detached runs. */
+export function createPreparedExecutionRuntimeOptions(context, config) {
+    return createVeryfrontCloudPreparedHostedChatExecutionRuntimeOptions({
+        apiUrl: config.VERYFRONT_API_URL,
+        tracer: context.infrastructure.tracer,
+        trace: context.trace,
+        traceStream: (operation) => context.infrastructure.tracer.trace("chat.stream", operation),
+        logger: context.infrastructure.logger,
+        setActiveSpanAttributes: context.infrastructure.setActiveSpanAttributes,
+    });
+}
+function resolveAgentServiceRuntimeName() {
+    if (Reflect.get(dntShim.dntGlobalThis, "Bun")) {
+        return "bun";
+    }
+    if (Reflect.get(dntShim.dntGlobalThis, "Deno")) {
+        return "deno";
+    }
+    return "node";
+}
+function getAgentServiceVersion(context) {
+    return context.options.env?.npm_package_version;
+}
+/** Creates and starts the control plane registration lifecycle if enabled. */
+export async function createControlPlaneRegistrationLifecycle(context) {
+    const config = context.infrastructure.getConfig();
+    const registrationInput = await resolveAgentServiceRegistrationInput({
+        config,
+        serviceName: context.options.serviceName,
+        agentId: getDefaultAgentId(context),
+        version: getAgentServiceVersion(context),
+        runtime: resolveAgentServiceRuntimeName(),
+    });
+    if (!registrationInput) {
+        return undefined;
+    }
+    if (!context.options.runtimeSource) {
+        throw new Error("runtimeSource is required when agent service control-plane registration is enabled.");
+    }
+    try {
+        const lifecycle = await createAgentServiceRegistrationLifecycle({
+            ...registrationInput,
+            logger: context.infrastructure.logger,
+        });
+        return {
+            stop: () => lifecycle.stop(),
+        };
+    }
+    catch (error) {
+        if (config.VERYFRONT_AGENT_SERVICE_REGISTRATION === "enabled") {
+            throw error;
+        }
+        context.infrastructure.logger.warn("Agent service registration skipped", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+}
+/** Builds the full CreateAgentServiceRuntimeOptions for the cloud agent service. */
+export function createNodeVeryfrontCloudAgentServiceRuntimeOptions(context) {
+    return {
+        serviceName: context.options.serviceName,
+        runtimeSource: context.options.runtimeSource,
+        forwardedConfigNamespace: context.options.forwardedConfigNamespace ??
+            DEFAULT_FORWARDED_CONFIG_NAMESPACE,
+        getConfig: context.infrastructure.getConfig,
+        getAgentConfig: () => getResolvedAgentConfig(context),
+        tracker: context.tracker,
+        prepareExecution: (request) => prepareChatExecution(context, request),
+        streamExecutionToAgUiResponse: (execution) => streamPreparedHostedChatExecutionToAgUiResponse({
+            execution,
+            runtime: createPreparedExecutionRuntimeOptions(context, execution.config),
+        }),
+        startDetachedExecution: ({ execution, abortSignal }) => runPreparedHostedChatExecutionDetached({
+            execution: {
+                ...execution,
+                abortSignal,
+            },
+            runtime: createPreparedExecutionRuntimeOptions(context, execution.config),
+        }),
+        cleanupExecution: async ({ execution, runId, conversationId }) => {
+            await execution.cleanup().catch((error) => {
+                context.infrastructure.logger.error("Detached durable run cleanup failed after duplicate start", {
+                    runId,
+                    conversationId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            });
+        },
+        setActiveSpanAttributes: context.infrastructure.setActiveSpanAttributes,
+        trace: context.trace,
+        logger: context.infrastructure.logger,
+        drainTimeoutMs: context.options.drainTimeoutMs ?? 15_000,
+    };
+}

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

@@ -0,0 +1,80 @@
+import { type HostToolSet } from "../../tool/index.js";
+import { type AgentServiceMcpServerConfig } from "../service/mcp-server-config.js";
+import type { RuntimeLoadSkillToolContext } from "../runtime/load-skill-tool.js";
+import type { RuntimeProjectSteeringLookup } from "../runtime/project-skill-catalog.js";
+import { type RuntimeSkillDefinition } from "../runtime/skill-metadata.js";
+import type { RuntimeAgentMarkdownDefinition } from "../runtime/agent-definition.js";
+import type { RuntimeClientProfile } from "../runtime/client-profile.js";
+import type { DefaultHostedChildAgentExecutionConfig, DefaultHostedInvokeAgentContext } from "./default-invoke-agent-tool.js";
+import type { HostedChildRunIdentifiers } from "./child-status.js";
+import type { HostedProjectSkillIdsContext } from "./project-steering-adapter.js";
+import { type NodeVeryfrontCloudAgentServiceContext } from "./cloud-agent-config.js";
+/**
+ * Task context carried through a hosted child agent run. Combines the invoke-agent
+ * base context with skill/tool availability fields.
+ */
+export type ChildRunContext = DefaultHostedInvokeAgentContext & Pick<RuntimeLoadSkillToolContext, "agentId" | "availableSkillIds" | "skillSourcePaths" | "loadedSkillResponses" | "loadedSkillReferenceResponses"> & {
+    clientProfile?: RuntimeClientProfile | null;
+};
+/**
+ * Resolves the effective MCP server list by intersecting service-level options
+ * with optional per-agent overrides.
+ */
+export declare function resolveMcpServers(options: {
+    mcpServers?: readonly AgentServiceMcpServerConfig[];
+}, agentConfig?: Pick<RuntimeAgentMarkdownDefinition, "mcpServers">): readonly AgentServiceMcpServerConfig[];
+/**
+ * Returns the set of host tools visible to the given agent scope, excluding
+ * shared skill infrastructure tools (load_skill_reference, execute_skill_script).
+ */
+export declare function getDiscoveredHostTools(scope?: {
+    agentId?: string;
+}): HostToolSet;
+/** Fetches the project instructions for the given agent id and lookup context. */
+export declare function getProjectInstructions(context: NodeVeryfrontCloudAgentServiceContext, lookup: RuntimeProjectSteeringLookup, agentId?: string): Promise<string>;
+/** Fetches the resolved skill definitions for the given agent id and lookup context. */
+export declare function getSkillsConfig(context: NodeVeryfrontCloudAgentServiceContext, lookup: RuntimeProjectSteeringLookup, agentId?: string): Promise<RuntimeSkillDefinition[]>;
+/** Creates the load_skill tool scoped to the given tool context. */
+export declare function createLoadSkillTool(context: NodeVeryfrontCloudAgentServiceContext, toolContext: RuntimeLoadSkillToolContext): import("../../tool/types.js").Tool<import("../../extensions/schema/schema-validator.js").InferShape<{
+    skillId: import("../../internal-agents/schema.js").Schema<string>;
+    file: import("../../internal-agents/schema.js").Schema<string | undefined>;
+}>, import("../index.js").RuntimeLoadSkillToolOutput>;
+/** Refreshes the project skill ids for the given skill context. */
+export declare function refreshProjectSkillIds(context: NodeVeryfrontCloudAgentServiceContext, skillContext: HostedProjectSkillIdsContext): Promise<void>;
+/** Sets filtered trace attributes on the active span. */
+export declare function setFilteredTraceAttributes(context: NodeVeryfrontCloudAgentServiceContext, attributes: Record<string, unknown>): void;
+/** Resolves the effective tool name allowlist for a hosted child agent run. */
+export declare function resolveHostedChildToolNames(agentConfig: RuntimeAgentMarkdownDefinition): string[] | undefined;
+/** Builds the child run context for a nested hosted agent invocation. */
+export declare function buildHostedChildToolContext(globalToolContext: ChildRunContext, childAgentId: string, childConfig: DefaultHostedChildAgentExecutionConfig | undefined, durableChildRun?: HostedChildRunIdentifiers): ChildRunContext;
+/** Fetches project steering for a given project / auth / branch combination. */
+export declare function fetchProjectSteering(context: NodeVeryfrontCloudAgentServiceContext, input: {
+    projectId: string | null;
+    authToken: string;
+    branchId?: string | null;
+}, agentId?: string): Promise<import("./chat-preparation.js").HostedChatRuntimePreparationSteering>;
+/** Resolves the execution config for a hosted child agent invocation. */
+export declare function resolveHostedChildAgentExecutionConfig(context: NodeVeryfrontCloudAgentServiceContext, taskContext: ChildRunContext, childAgentId: string, projectId: string): Promise<DefaultHostedChildAgentExecutionConfig | undefined>;
+/** Creates the invoke_agent tool for the given child context. */
+export declare function createInvokeAgentTool(context: NodeVeryfrontCloudAgentServiceContext, childContext: ChildRunContext, options?: {
+    requireDurable?: boolean;
+}): import("../../tool/types.js").Tool<import("./default-invoke-agent-tool.js").DefaultHostedInvokeAgentInput, import("./default-invoke-agent-tool.js").DefaultHostedInvokeAgentToolResult>;
+/** Builds the set of delegate agent tools for the given delegate ids. */
+export declare function buildHostedDelegateTools(context: NodeVeryfrontCloudAgentServiceContext, input: {
+    delegates: readonly string[];
+    selfId: string;
+    taskContext: ChildRunContext;
+}): HostToolSet;
+/** The shape of a hosted delegation binding (scoped vs. legacy). */
+export type HostedDelegationBinding = {
+    kind: "scoped";
+    delegateIds: string[];
+} | {
+    kind: "legacy";
+};
+/**
+ * Resolves the delegation binding from an agent config. Agents with an explicit
+ * `delegates` list use scoped delegation; all others fall back to legacy invoke_agent.
+ */
+export declare function resolveHostedDelegationBinding(agentConfig: RuntimeAgentMarkdownDefinition | undefined): HostedDelegationBinding;
+//# sourceMappingURL=cloud-agent-child-tools.d.ts.map

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

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