eve 0.83.2 → 0.84.0

package/dist/src/compiler/normalize-agent-config.js

@@ -1 +1 @@
-import{isAbsolute,relative,resolve}from"node:path";import{normalizeLogicalPath}from"#discover/filesystem.js";import{toErrorMessage}from"#shared/errors.js";import{parseJsonObject}from"#shared/json.js";import{isDynamicModelDefinition}from"#shared/agent-definition.js";import{createCompiledBindingNamespaceLoader}from"#compiler/load-binding-namespace.js";import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{formatLanguageModelGatewayId}from"#internal/runtime-model.js";import{classifyModelRouting}from"#internal/classify-model-routing.js";import{isMockModel}from"#internal/mock-model-identity.js";import{isChatGptModelRouting}from"#shared/chatgpt-model.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileAgentConfig(e,t,n){let r=n.source,i=formatAgentConfigModulePath(e,r,n.binding),a=normalizeAgentDefinition(Object.hasOwn(n,`definition`)?n.definition:await loadModuleBackedDefinition({binding:n.binding,displayPath:i,kind:`agent config`,loadNamespace:createCompiledBindingNamespaceLoader({appRoot:e.appRoot,bindings:{[r.sourceId]:n.binding},registries:t.registries}),source:r}),`Expected the agent config export "${r.exportName??`default`}" from "${i}" to match the public eve shape.`),o=isDynamicModelDefinition(a.model)?a.model:void 0,s=o===void 0?await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the primary compaction trigger model`,contextWindowTokens:a.modelContextWindowTokens,promptCache:a.modelOptions?.promptCache,providerOptions:a.modelOptions?.providerOptions,source:r,sourcePath:i,value:a.model}):void 0,c={},l={compaction:c,name:e.agentId,source:{...r}};a.defaultTools!==void 0&&(l.defaultTools=a.defaultTools),a.description!==void 0&&(l.description=a.description);let u;o!==void 0&&(u={eventNames:Object.keys(o.events),exportName:r.exportName,sourceKind:`module`,logicalPath:r.logicalPath,sourceId:r.sourceId});let d=normalizeExperimentalDefinition(a.experimental);if(d!==void 0&&(l.experimental=d),a.build!==void 0&&(l.build={externalDependencies:a.build.externalDependencies===void 0?void 0:[...a.build.externalDependencies]}),a.reasoning!==void 0&&(l.reasoning=a.reasoning),a.tool!==void 0&&(l.tool=a.tool),a.limits!==void 0&&(l.limits={sessionTimeoutMs:a.limits.sessionTimeoutMs,sessionUsage:a.limits.sessionUsage!==void 0||void 0}),a.compaction?.model!==void 0&&(c.model=await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the compaction summary model`,contextWindowTokens:a.compaction.modelContextWindowTokens,providerOptions:a.modelOptions?.providerOptions,source:r,sourceField:`compaction.model`,sourcePath:i,value:a.compaction.model})),a.compaction?.thresholdPercent!==void 0&&(c.thresholdPercent=a.compaction.thresholdPercent),u!==void 0)return{...l,dynamicModel:u};if(s===void 0)throw Error(`Expected a static agent model to compile to a concrete model reference.`);return{...l,model:s}}function normalizeExperimentalDefinition(e){if(e===void 0)return;let t={};return e.workflow!==void 0&&(t.workflow={modelCallsPerStep:e.workflow.modelCallsPerStep,retention:e.workflow.retention,world:e.workflow.world}),t}async function normalizeAuthoredModelReference(e){if(typeof e.value==`string`){let t=classifyModelRouting(e.value,e.providerOptions);return rejectGatewayPromptCache(e,t),await withCompiledRuntimeModelLimits({id:formatLanguageModelGatewayId(e.value),providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:t},e)}let t=e.source;if(t===void 0)throw Error(`Expected ${e.purpose} to provide a valid AI SDK language model reference.`);let n=e.value,r=n.specificationVersion;if(r!==`v2`&&r!==`v3`&&r!==`v4`||typeof n.provider!=`string`||typeof n.modelId!=`string`||typeof n.doGenerate!=`function`||typeof n.doStream!=`function`)throw Error(`Expected the authored agent config export "${t.exportName??`default`}" from "${e.sourcePath??t.logicalPath}" to provide a valid AI SDK language model.`);let i=classifyModelRouting(n,e.providerOptions);rejectGatewayPromptCache(e,i);let a={id:formatLanguageModelGatewayId(n),source:{exportName:t.exportName,sourceKind:`module`,logicalPath:t.logicalPath,sourceId:t.sourceId},providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:i};if(e.sourceField!==void 0&&(a.sourceField=e.sourceField),e.promptCache!==void 0&&(a.promptCache=e.promptCache),e.contextWindowTokens===void 0){if(isChatGptModelRouting(a.routing))return{...a,contextWindowTokens:2e5};if(isMockModel(n))return{...a,contextWindowTokens:1e6};try{let t=await e.modelCatalog.getByProviderModelId(n.provider,n.modelId);if(t)return{...a,id:t.slug,contextWindowTokens:t.limits.contextWindowTokens,maxOutputTokens:t.limits.maxOutputTokens}}catch{}}return await withCompiledRuntimeModelLimits(a,e)}function rejectGatewayPromptCache(e,t){if(e.promptCache!==void 0&&t.kind===`gateway`)throw Error(`${e.sourcePath??`agent.ts`}: modelOptions.promptCache applies only to models eve calls directly, but "${formatLanguageModelGatewayId(e.value)}" routes through AI Gateway, which manages its own prompt caching. Remove promptCache, or configure Gateway caching with providerOptions.gateway.caching.`)}function formatAgentConfigModulePath(e,t,n){return n.backing.kind===`programmatic`?t.logicalPath:normalizeLogicalPath(relative(resolveTopLevelAgentRoot(e),n.backing.sourcePath))}function resolveTopLevelAgentRoot(e){let t=resolve(e.appRoot),n=resolve(t,`agent`);return isPathInsideOrEqual(n,resolve(e.agentRoot))?n:t}function isPathInsideOrEqual(e,t){let n=relative(e,t);return n===``||!n.startsWith(`..`)&&!isAbsolute(n)}async function withCompiledRuntimeModelLimits(e,t){if(t.contextWindowTokens!==void 0)return{...e,contextWindowTokens:t.contextWindowTokens};let n;try{n=await t.modelCatalog.getModelLimits(e.id)}catch(n){throw Error(`Failed to load AI Gateway model metadata for ${t.purpose} "${e.id}". ${toErrorMessage(n)}`)}if(n===null)throw Error(`Cannot compile agent compaction because ${t.purpose} "${e.id}" does not have known AI Gateway context window metadata.`);return{...e,contextWindowTokens:n.contextWindowTokens,maxOutputTokens:n.maxOutputTokens}}function parseProviderOptionsRecord(e){if(e===void 0)return;let t={};for(let[n,r]of Object.entries(e))t[n]=parseJsonObject(r);return t}export{compileAgentConfig};
+import{isAbsolute,relative,resolve}from"node:path";import{normalizeLogicalPath}from"#discover/filesystem.js";import{toErrorMessage}from"#shared/errors.js";import{parseJsonObject}from"#shared/json.js";import{isDynamicModelDefinition}from"#shared/agent-definition.js";import{createCompiledBindingNamespaceLoader}from"#compiler/load-binding-namespace.js";import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{formatLanguageModelGatewayId}from"#internal/runtime-model.js";import{classifyModelRouting}from"#internal/classify-model-routing.js";import{isMockModel}from"#internal/mock-model-identity.js";import{isChatGptModelRouting}from"#shared/chatgpt-model.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileAgentConfig(e,t,n){let r=n.source,i=formatAgentConfigModulePath(e,r,n.binding),a=normalizeAgentDefinition(Object.hasOwn(n,`definition`)?n.definition:await loadModuleBackedDefinition({binding:n.binding,displayPath:i,kind:`agent config`,loadNamespace:createCompiledBindingNamespaceLoader({appRoot:e.appRoot,bindings:{[r.sourceId]:n.binding},registries:t.registries}),source:r}),`Expected the agent config export "${r.exportName??`default`}" from "${i}" to match the public eve shape.`),o=isDynamicModelDefinition(a.model)?a.model:void 0,s=o===void 0?await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the primary compaction trigger model`,contextWindowTokens:a.modelContextWindowTokens,promptCache:a.modelOptions?.promptCache,providerOptions:a.modelOptions?.providerOptions,source:r,sourcePath:i,value:a.model}):void 0,c={},l={compaction:c,name:e.agentId,source:{...r}};a.defaultTools!==void 0&&(l.defaultTools=a.defaultTools),a.description!==void 0&&(l.description=a.description);let u;o!==void 0&&(u={exportName:r.exportName,sourceKind:`module`,logicalPath:r.logicalPath,sourceId:r.sourceId});let d=normalizeExperimentalDefinition(a.experimental);if(d!==void 0&&(l.experimental=d),a.build!==void 0&&(l.build={externalDependencies:a.build.externalDependencies===void 0?void 0:[...a.build.externalDependencies]}),a.reasoning!==void 0&&(l.reasoning=a.reasoning),a.tool!==void 0&&(l.tool=a.tool),a.limits!==void 0&&(l.limits={sessionTimeoutMs:a.limits.sessionTimeoutMs,sessionUsage:a.limits.sessionUsage!==void 0||void 0}),a.compaction?.model!==void 0&&(c.model=await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the compaction summary model`,contextWindowTokens:a.compaction.modelContextWindowTokens,providerOptions:a.modelOptions?.providerOptions,source:r,sourceField:`compaction.model`,sourcePath:i,value:a.compaction.model})),a.compaction?.thresholdPercent!==void 0&&(c.thresholdPercent=a.compaction.thresholdPercent),u!==void 0)return{...l,dynamicModel:u};if(s===void 0)throw Error(`Expected a static agent model to compile to a concrete model reference.`);return{...l,model:s}}function normalizeExperimentalDefinition(e){if(e===void 0)return;let t={};return e.workflow!==void 0&&(t.workflow={modelCallsPerStep:e.workflow.modelCallsPerStep,retention:e.workflow.retention,world:e.workflow.world}),t}async function normalizeAuthoredModelReference(e){if(typeof e.value==`string`){let t=classifyModelRouting(e.value,e.providerOptions);return rejectGatewayPromptCache(e,t),await withCompiledRuntimeModelLimits({id:formatLanguageModelGatewayId(e.value),providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:t},e)}let t=e.source;if(t===void 0)throw Error(`Expected ${e.purpose} to provide a valid AI SDK language model reference.`);let n=e.value,r=n.specificationVersion;if(r!==`v2`&&r!==`v3`&&r!==`v4`||typeof n.provider!=`string`||typeof n.modelId!=`string`||typeof n.doGenerate!=`function`||typeof n.doStream!=`function`)throw Error(`Expected the authored agent config export "${t.exportName??`default`}" from "${e.sourcePath??t.logicalPath}" to provide a valid AI SDK language model.`);let i=classifyModelRouting(n,e.providerOptions);rejectGatewayPromptCache(e,i);let a={id:formatLanguageModelGatewayId(n),source:{exportName:t.exportName,sourceKind:`module`,logicalPath:t.logicalPath,sourceId:t.sourceId},providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:i};if(e.sourceField!==void 0&&(a.sourceField=e.sourceField),e.promptCache!==void 0&&(a.promptCache=e.promptCache),e.contextWindowTokens===void 0){if(isChatGptModelRouting(a.routing))return{...a,contextWindowTokens:2e5};if(isMockModel(n))return{...a,contextWindowTokens:1e6};try{let t=await e.modelCatalog.getByProviderModelId(n.provider,n.modelId);if(t)return{...a,id:t.slug,contextWindowTokens:t.limits.contextWindowTokens,maxOutputTokens:t.limits.maxOutputTokens}}catch{}}return await withCompiledRuntimeModelLimits(a,e)}function rejectGatewayPromptCache(e,t){if(e.promptCache!==void 0&&t.kind===`gateway`)throw Error(`${e.sourcePath??`agent.ts`}: modelOptions.promptCache applies only to models eve calls directly, but "${formatLanguageModelGatewayId(e.value)}" routes through AI Gateway, which manages its own prompt caching. Remove promptCache, or configure Gateway caching with providerOptions.gateway.caching.`)}function formatAgentConfigModulePath(e,t,n){return n.backing.kind===`programmatic`?t.logicalPath:normalizeLogicalPath(relative(resolveTopLevelAgentRoot(e),n.backing.sourcePath))}function resolveTopLevelAgentRoot(e){let t=resolve(e.appRoot),n=resolve(t,`agent`);return isPathInsideOrEqual(n,resolve(e.agentRoot))?n:t}function isPathInsideOrEqual(e,t){let n=relative(e,t);return n===``||!n.startsWith(`..`)&&!isAbsolute(n)}async function withCompiledRuntimeModelLimits(e,t){if(t.contextWindowTokens!==void 0)return{...e,contextWindowTokens:t.contextWindowTokens};let n;try{n=await t.modelCatalog.getModelLimits(e.id)}catch(n){throw Error(`Failed to load AI Gateway model metadata for ${t.purpose} "${e.id}". ${toErrorMessage(n)}`)}if(n===null)throw Error(`Cannot compile agent compaction because ${t.purpose} "${e.id}" does not have known AI Gateway context window metadata.`);return{...e,contextWindowTokens:n.contextWindowTokens,maxOutputTokens:n.maxOutputTokens}}function parseProviderOptionsRecord(e){if(e===void 0)return;let t={};for(let[n,r]of Object.entries(e))t[n]=parseJsonObject(r);return t}export{compileAgentConfig};

package/dist/src/compiler/normalize-connection.js

@@ -1 +1 @@
-import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{extractVercelConnectMetadata}from"#shared/vercel-connect-metadata.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{normalizeMcpClientConnectionDefinition,normalizeOpenApiConnectionDefinition}from"#internal/authored-definition/connection.js";import{readConnectionProtocol}from"#public/definitions/connections/protocol.js";import{ALLOWED_DYNAMIC_CONNECTION_EVENTS,assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#dynamic/definition.js";async function compileConnectionDefinition(e,t,n){let r=await loadModuleBackedDefinition({binding:n.binding,kind:`connection`,loadNamespace:n.loadNamespace,source:t}),i=`Expected the connection export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`;if(isDynamicSentinel(r)){assertResolverOnlyDynamicSentinel(r,i);let e=Object.keys(r.events),n=e.find(e=>!ALLOWED_DYNAMIC_CONNECTION_EVENTS.has(e));if(n!==void 0)throw Error(`${i} Dynamic connections support only "session.started" and "turn.started" handlers. Unsupported event: "${n}".`);return{kind:`dynamic-connection`,definition:{eventNames:e,exportName:t.exportName,logicalPath:t.logicalPath,slug:t.connectionName,sourceId:t.sourceId,sourceKind:`module`}}}let a=eveNamespaceReservation(t.connectionName);if(a!==void 0)throw Error(`Connection "${t.logicalPath}" uses the reserved name "${t.connectionName}". Rename its path; ${a}.`);let o=readConnectionProtocol(r),s={connectionName:t.connectionName,exportName:t.exportName,logicalPath:t.logicalPath,sourceId:t.sourceId,sourceKind:`module`},c,l;if(o===`openapi`){let e=normalizeOpenApiConnectionDefinition(r,i);c={...s,description:e.description,protocol:`openapi`,url:e.baseUrl??``},l=e.auth}else{let e=normalizeMcpClientConnectionDefinition(r,i);c={...s,description:e.description,protocol:`mcp`,...e.experimental_events===void 0?{}:{experimental_events:!0},url:e.url},l=e.auth}let u=extractVercelConnectMetadata(typeof l!=`object`||!l?void 0:l.vercelConnect);return u!==void 0&&(c.vercelConnect=u),{definition:c,kind:`connection`}}export{compileConnectionDefinition};
+import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{extractVercelConnectMetadata}from"#shared/vercel-connect-metadata.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{normalizeMcpClientConnectionDefinition,normalizeOpenApiConnectionDefinition}from"#internal/authored-definition/connection.js";import{readConnectionProtocol}from"#public/definitions/connections/protocol.js";import{assertDynamicSentinelKeys,isDynamicSentinel}from"#dynamic/definition.js";async function compileConnectionDefinition(e,t,n){let r=await loadModuleBackedDefinition({binding:n.binding,kind:`connection`,loadNamespace:n.loadNamespace,source:t}),i=`Expected the connection export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`;if(isDynamicSentinel(r))return assertDynamicSentinelKeys(r,i),{kind:`dynamic-connection`,definition:{exportName:t.exportName,logicalPath:t.logicalPath,slug:t.connectionName,sourceId:t.sourceId,sourceKind:`module`}};let a=eveNamespaceReservation(t.connectionName);if(a!==void 0)throw Error(`Connection "${t.logicalPath}" uses the reserved name "${t.connectionName}". Rename its path; ${a}.`);let o=readConnectionProtocol(r),s={connectionName:t.connectionName,exportName:t.exportName,logicalPath:t.logicalPath,sourceId:t.sourceId,sourceKind:`module`},c,l;if(o===`openapi`){let e=normalizeOpenApiConnectionDefinition(r,i);c={...s,description:e.description,protocol:`openapi`,url:e.baseUrl??``},l=e.auth}else{let e=normalizeMcpClientConnectionDefinition(r,i);c={...s,description:e.description,protocol:`mcp`,...e.experimental?.events===void 0?{}:{experimental_events:!0},url:e.url},l=e.auth}let u=extractVercelConnectMetadata(typeof l!=`object`||!l?void 0:l.vercelConnect);return u!==void 0&&(c.vercelConnect=u),{definition:c,kind:`connection`}}export{compileConnectionDefinition};

package/dist/src/compiler/normalize-hook.js

@@ -1 +1 @@
-import{expectFunction,expectObjectRecord}from"#internal/authored-module.js";import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileHookEntry(e,t){let n=expectObjectRecord(await loadModuleBackedDefinition({binding:t.binding,kind:`hook`,loadNamespace:t.loadNamespace,source:e}),`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" to return an object.`),r=n.events===void 0?{}:expectObjectRecord(n.events,`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" to expose events as an object.`);return{eventNames:Object.entries(r).flatMap(([t,n])=>n===void 0?[]:(expectFunction(n,`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" to provide a function for events.${t}.`),[t])),exportName:e.exportName,logicalPath:e.logicalPath,slug:stripLogicalPathExtension(e.logicalPath).replace(/^hooks\//,``),sourceId:e.sourceId,sourceKind:`module`}}export{compileHookEntry};
+import{expectFunction,expectObjectRecord}from"#internal/authored-module.js";import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{assertHookForm}from"#public/definitions/hook.js";async function compileHookEntry(e,t){let n=expectObjectRecord(await loadModuleBackedDefinition({binding:t.binding,kind:`hook`,loadNamespace:t.loadNamespace,source:e}),`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" to return an object.`);assertHookForm(n,`The hook export "${e.exportName??`default`}" from "${e.logicalPath}"`);let r=n.events===void 0?{}:expectObjectRecord(n.events,`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" to expose events as an object.`);return{eventNames:Object.entries(r).flatMap(([t,n])=>n===void 0?[]:(expectFunction(n,`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" to provide a function for events.${t}.`),[t])),exportName:e.exportName,logicalPath:e.logicalPath,slug:stripLogicalPathExtension(e.logicalPath).replace(/^hooks\//,``),sourceId:e.sourceId,sourceKind:`module`}}export{compileHookEntry};

package/dist/src/compiler/normalize-instructions.js

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeInstructionsDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";import{ALLOWED_DYNAMIC_INSTRUCTION_EVENTS,assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#dynamic/definition.js";async function compileInstructionsEntry(e,t,n){if(t.sourceKind===`markdown`){let e=normalizeInstructionsDefinition(t.definition,`Expected the compiled instructions definition at "${t.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(t.logicalPath),logicalPath:t.logicalPath,owner:n.owner,content:e.content,role:e.role,sourceId:t.sourceId,sourceKind:t.sourceKind}}}let r=requireModuleBackedDefinitionLoadOptions(n,t.logicalPath),i=await loadModuleBackedDefinition({binding:r.binding,kind:`instructions`,loadNamespace:r.loadNamespace,source:t});if(isDynamicSentinel(i)){assertResolverOnlyDynamicSentinel(i,`Expected the instructions export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);let e=Object.keys(i.events),n=e.find(e=>!ALLOWED_DYNAMIC_INSTRUCTION_EVENTS.has(e));if(n!==void 0)throw Error(`Expected the instructions export "${t.exportName??`default`}" from "${t.logicalPath}" to use only "session.started" or "turn.started" events. Unsupported event: "${n}".`);let r=stripLogicalPathExtension(t.logicalPath).replace(/^instructions\//,``);return{kind:`dynamic-instructions`,definition:{eventNames:e,exportName:t.exportName,logicalPath:t.logicalPath,slug:r,sourceId:t.sourceId,sourceKind:`module`}}}let a=normalizeInstructionsDefinition(i,`Expected the instructions export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(t.logicalPath),logicalPath:t.logicalPath,content:a.content,role:a.role,sourceId:t.sourceId,sourceKind:t.sourceKind}}}export{compileInstructionsEntry};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeInstructionsDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";import{assertDynamicSentinelKeys,isDynamicSentinel}from"#dynamic/definition.js";async function compileInstructionsEntry(e,t,n){if(t.sourceKind===`markdown`){let e=normalizeInstructionsDefinition(t.definition,`Expected the compiled instructions definition at "${t.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(t.logicalPath),logicalPath:t.logicalPath,owner:n.owner,content:e.content,role:e.role,sourceId:t.sourceId,sourceKind:t.sourceKind}}}let r=requireModuleBackedDefinitionLoadOptions(n,t.logicalPath),i=await loadModuleBackedDefinition({binding:r.binding,kind:`instructions`,loadNamespace:r.loadNamespace,source:t});if(isDynamicSentinel(i)){let e=`Expected the instructions export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`;assertDynamicSentinelKeys(i,e);let n=stripLogicalPathExtension(t.logicalPath).replace(/^instructions\//,``);return{kind:`dynamic-instructions`,definition:{exportName:t.exportName,logicalPath:t.logicalPath,slug:n,sourceId:t.sourceId,sourceKind:`module`}}}let a=normalizeInstructionsDefinition(i,`Expected the instructions export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(t.logicalPath),logicalPath:t.logicalPath,content:a.content,role:a.role,sourceId:t.sourceId,sourceKind:t.sourceKind}}}export{compileInstructionsEntry};

package/dist/src/compiler/normalize-manifest.js

@@ -1 +1 @@
-import{randomUUID}from"node:crypto";import{noDevelopmentExtensions,prepareDevelopmentExtensions}from"#compiler/development-extensions.js";import{ROOT_COMPILED_AGENT_NODE_ID,createCompiledAgentManifest,createCompiledAgentNodeManifest,createCompiledAgentResources,createCompiledSubagentNodeId}from"#compiler/manifest.js";import{summarizeCompilerDiagnostics}from"#compiler/diagnostics.js";import{composeAgentModuleCandidates,createAgentModuleBinding,createProgrammaticModuleCandidates,disableComposedCandidate,isAgentModuleCandidate}from"#compiler/source-graph.js";import{compileMemoryDefinition}from"#compiler/normalize-memory.js";import{frameworkAgentSourceRegistry}from"#framework/sources/registry.js";import{bindingMountId}from"#compiler/extension-mount-bindings.js";import{assertApplicationOverlayCanApplyToAllNodes,assertNonExtensionSpecialTool,assertRootOnlyConfig,assertUniqueBy,assertUniqueRegistryIds,collectSelectedSourceIds,compileChannelRoutes,compileExtensionMounts,createCompiledRemoteAgent,createExtensionCompileMounts,expectSubagentDescription,loadSelectedNodeConfig,mergeExternalDependencies,withDiagnosticsSummary,withExtensionNamespace}from"#compiler/normalize-manifest-helpers.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{assertRemoteAgentDefinitionHasNoLocalPackageEntries,normalizeSubagentConfig}from"#compiler/normalize-subagent.js";import{NodeModuleEvaluationContext,markConfigRuntimeEntries}from"#compiler/module-lifecycle.js";import{assertStaticConnectionOwnership}from"#compiler/connection-ownership.js";import{createAuthoredModuleGraph}from"#internal/authored-module-graph.js";import{pruneAuthoredModuleCache}from"#internal/authored-module-cache.js";import{createCompiledRuntimeModelCatalogLoader}from"#compiler/model-catalog.js";import{compileAgentConfig}from"#compiler/normalize-agent-config.js";import{compileChannelDefinition}from"#compiler/normalize-channel.js";import{compileConnectionDefinition}from"#compiler/normalize-connection.js";import{applyAgentToolPolicy,applyDefaultToolPolicy,canDisableToolWithoutSelectedSource}from"#compiler/default-tool-policy.js";import{resolveWorkspaceSubagentDefinition}from"#compiler/resolve-workspace-subagent.js";import{workspaceSubagentName}from"#public/definitions/workspace-agent.js";import{compileHookEntry}from"#compiler/normalize-hook.js";import{compileInstructionsEntry}from"#compiler/normalize-instructions.js";import{createMemoryWrapperCandidates}from"#compiler/memory-wrapper-candidates.js";import{compileSandboxDefinition}from"#compiler/normalize-sandbox.js";import{compileScheduleDefinition}from"#compiler/normalize-schedule.js";import{compileScheduleCollectionDefinition}from"#compiler/normalize-schedule-collection.js";import{isScheduleCollectionDefinition}from"#shared/schedule-collection-definition.js";import{createScheduleCollectionWrapperCandidates}from"#compiler/schedule-collection-wrapper-candidates.js";import{assertSkillNameAvailable,compileSkillSource}from"#compiler/normalize-skill.js";import{compileToolEntry}from"#compiler/normalize-tool.js";import{finalizeNodeSourceState}from"#compiler/node-source-state.js";import{listApplicationModulePaths,projectAgentSources,projectSelectedSources}from"#compiler/project-sources.js";async function compileAgentManifest(e,t={}){let n=[frameworkAgentSourceRegistry,...t.sourceRegistries??[]];assertUniqueRegistryIds(n);let r={modelCatalog:createCompiledRuntimeModelCatalogLoader(e.appRoot),registries:n},i=t.diagnostics??[],a=await prepareDevelopmentExtensions({diagnostics:i,manifest:e,nodeId:ROOT_COMPILED_AGENT_NODE_ID,selection:t.developmentExtensions??noDevelopmentExtensions()}),o=await new AgentGraphCompiler(r,n,i,createAuthoredModuleGraph(listApplicationModulePaths(a.manifest),{appRoot:e.appRoot})).compileStaticNode({developmentExtensionCandidates:a.candidates,inheritedExternalDependencies:[],isRoot:!0,layer:`application`,manifest:a.manifest,nodeId:ROOT_COMPILED_AGENT_NODE_ID,nodePath:``,owner:{kind:`application`}}),s=summarizeCompilerDiagnostics(i),c=withDiagnosticsSummary(o.descendants,s),l=createCompiledAgentManifest({...o.manifest,diagnosticsSummary:s,subagents:c});return pruneAuthoredModuleCache(),l}var AgentGraphCompiler=class{context;registries;diagnostics;mounts=new Map;evaluationId=randomUUID();moduleGraph;constructor(e,t,n,r){this.context=e,this.registries=t,this.diagnostics=n,this.moduleGraph=r}async compileStaticNode(e){let t=await this.createPhaseOneNodeSourceState(e,e.inheritedExternalDependencies),n=await compileAgentConfig(e.manifest,this.context,{binding:t.selectedConfig.binding,definition:t.selectedConfig.definition,source:t.selectedConfig.source});assertRootOnlyConfig(n,e.isRoot,e.manifest.agentId),applyAgentToolPolicy(t,n),applyDefaultToolPolicy(t,n);let r=mergeExternalDependencies(e.inheritedExternalDependencies,n.build?.externalDependencies,e.manifest.resolvedExtensions.flatMap(e=>e.externalDependencies));r.length>0&&(n={...n,build:{...n.build,externalDependencies:r}});let i=finalizeNodeSourceState(t,r);markConfigRuntimeEntries(n,i.evaluation);let a=await this.compileResources(e,i),o=await this.compileChildren(e,i,r),s=createCompiledAgentNodeManifest({...a,config:n,remoteAgents:o.remoteAgents});return{descendants:o.nodes,manifest:s}}async compileChildren(e,t,n){let r=[],i=[],a=collectSelectedSourceIds(t.composed),o=t.projected.subagents.filter(e=>a.has(e.candidate.sourceId));for(let t of o){let a=t.source,o=createCompiledSubagentNodeId(e.nodeId,a.sourceId),s={extensionScope:t.extensionScope??e.extensionScope,mountId:t.mountId,inheritedExternalDependencies:n,isRoot:!1,layer:t.candidate.layer,manifest:a.manifest,nodeId:o,nodePath:t.nodePath,owner:t.owner,parentNodeId:e.nodeId},c=await this.createPhaseOneNodeSourceState(s,n),l=normalizeSubagentConfig(c.selectedConfig.definition,`Expected the subagent config export "${c.selectedConfig.source.exportName??`default`}" from "${a.entryPath}" to match the public eve shape.`);if(l.kind===`remote`){let n=workspaceSubagentName(c.selectedConfig.definition),r=n===void 0?l:await resolveWorkspaceSubagentDefinition({definition:l,name:n,registries:this.registries,source:a});assertRemoteAgentDefinitionHasNoLocalPackageEntries(a);let s=c.selectedConfig.source.sourceId;c.evaluation.setBindings({[s]:c.selectedConfig.binding}),c.evaluation.requireRuntimeEntry(s);let u=c.evaluation.finalizeBindings()[s];if(u===void 0)throw Error(`Remote subagent "${o}" has no finalized config binding.`);i.push(createCompiledRemoteAgent({binding:u,definition:r,nodeId:o,owner:t.owner,parentNodeId:e.nodeId,source:a,sourceRef:c.selectedConfig.source}));continue}let u,d;l.kind===`local`?(u=await compileAgentConfig(a.manifest,this.context,{binding:c.selectedConfig.binding,definition:l.definition,source:c.selectedConfig.source}),assertRootOnlyConfig(u,!1,a.manifest.agentId),applyAgentToolPolicy(c,u),applyDefaultToolPolicy(c,u)):d=l.build?.externalDependencies;let f=mergeExternalDependencies(n,u?.build?.externalDependencies,d,a.manifest.resolvedExtensions.flatMap(e=>e.externalDependencies));u!==void 0&&f.length>0&&(u={...u,build:{...u.build,externalDependencies:f}});let p=finalizeNodeSourceState(c,f);u===void 0?p.evaluation.requireRuntimeEntry(c.selectedConfig.source.sourceId):markConfigRuntimeEntries(u,p.evaluation);let m=await this.compileResources(s,p),h=await this.compileChildren(s,p,f),g={backing:t.candidate.backing,entryPath:a.entryPath,logicalPath:a.logicalPath,name:a.subagentId,nodeId:o,owner:t.owner,parentNodeId:e.nodeId,rootPath:a.rootPath,sourceId:a.sourceId,sourceKind:`module`},_;_=u===void 0?{...g,agent:createCompiledAgentResources({...m,remoteAgents:h.remoteAgents}),configResolver:{build:l.kind===`dynamic`?l.build:void 0,eventNames:l.kind===`dynamic`?l.eventNames:[],exportName:c.selectedConfig.source.exportName,logicalPath:c.selectedConfig.source.logicalPath,sourceId:c.selectedConfig.source.sourceId,sourceKind:`module`}}:{...g,agent:createCompiledAgentNodeManifest({...m,config:u,remoteAgents:h.remoteAgents}),description:expectSubagentDescription(u,a)},r.push(_,...h.nodes)}return{nodes:r,remoteAgents:i}}composeNodeSources(e,t){let n=projectAgentSources({externalDependencies:t,extensionScope:e.extensionScope,mountId:e.mountId,layer:e.layer,manifest:e.manifest,nodeId:e.nodeId,nodePath:e.nodePath,owner:e.owner}),r=[],i=[];for(let t of this.registries){let n=t===frameworkAgentSourceRegistry;for(let a of t.registrations){if(a.applyTo===`root`&&!e.isRoot)continue;!n&&a.applyTo===`all-local-nodes`&&assertApplicationOverlayCanApplyToAllNodes(a.source.modules.map(e=>e.logicalPath));let t=createProgrammaticModuleCandidates({layer:n?`framework-default`:`application`,nodeId:e.nodeId,owner:n?{feature:a.source.id,kind:`framework`}:{kind:`application`},registration:a});(n?r:i).push(...t)}}let a=[...r,...e.developmentExtensionCandidates??[],...n.candidates,...createMemoryWrapperCandidates([...n.candidates,...i]),...createScheduleCollectionWrapperCandidates([...n.candidates,...i],e.manifest.agentId),...i],o=composeAgentModuleCandidates(a),s=projectSelectedSources({candidates:o.selected.values(),resources:n.resources});return{composed:o,orderedCandidates:a,projected:n,sourcesBySourceId:new Map(s.map(e=>[e.candidate.sourceId,e])),subagentsBySourceId:new Map(n.subagents.map(e=>[e.candidate.sourceId,e]))}}async createPhaseOneNodeSourceState(e,t){let n=this.composeNodeSources(e,t),{mounts:r,sourceIds:i}=createExtensionCompileMounts(e.manifest,e.nodePath);for(let[e,t]of r)this.mounts.set(e,t);let a=new NodeModuleEvaluationContext(this.registries,e=>i.get(bindingMountId(e)??``),this.mounts,this.evaluationId,e.manifest.appRoot,this.moduleGraph);return a.setBindings(Object.fromEntries([...n.composed.selected.values()].filter(isAgentModuleCandidate).map(e=>[e.sourceId,createAgentModuleBinding(e)]))),{evaluation:a,graph:n,selectedConfig:await loadSelectedNodeConfig(n,a)}}async compileResources(e,t){let n=[],r=[],i=[],a=[],o=[],s=[],c=[],l=[],u=[],d=[],f=[],p=[],m=[],h,g=collectSelectedSourceIds(t.composed),_=t.evaluation.loadNamespace;for(let v of t.orderedCandidates){if(!g.has(v.sourceId))continue;let y=t.sourcesBySourceId.get(v.sourceId);if(y===void 0)continue;let b=t.bindings[v.sourceId],x={binding:b,loadNamespace:_,owner:v.owner};switch(y.kind){case`config`:case`extension`:break;case`channel`:{let n=await compileChannelDefinition(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_});n.kind===`disabled`?(t.composed=disableComposedCandidate({candidate:v,composed:t.composed}),delete t.bindings[v.sourceId],g.delete(v.sourceId)):m.push(...n.definitions);break}case`connection`:{let n=await compileConnectionDefinition(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_});if(n.kind===`connection`){if(n.definition.experimental_events===!0&&e.nodeId!==ROOT_COMPILED_AGENT_NODE_ID)throw Error(`experimental_events currently requires a root-agent connection.`);c.push(n.definition)}else l.push(withExtensionNamespace(n.definition,v.owner));t.evaluation.requireRuntimeEntry(v.sourceId);break}case`hook`:d.push(await compileHookEntry(y.source,{binding:b,loadNamespace:_})),t.evaluation.requireRuntimeEntry(v.sourceId);break;case`instructions`:{let n=await compileInstructionsEntry(e.manifest.agentRoot,y.source,x);n.kind===`instructions`?o.push(n.definition):(s.push(n.definition),t.evaluation.requireRuntimeEntry(v.sourceId));break}case`memory`:u.push(await compileMemoryDefinition(y.source,{binding:b,loadNamespace:_})),t.evaluation.requireRuntimeEntry(v.sourceId);break;case`sandbox`:h=await compileSandboxDefinition(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_}),h.inheritsParent||t.evaluation.requireRuntimeEntry(v.sourceId);break;case`schedule`:{let n=y.source.sourceKind===`module`?await loadModuleBackedDefinition({binding:b,loadNamespace:_,kind:`schedule`,source:y.source}):y.source.definition;if(isScheduleCollectionDefinition(n)){p.push(compileScheduleCollectionDefinition(y.source,n)),t.evaluation.requireRuntimeEntry(v.sourceId);break}let r=compileScheduleDefinition(e.manifest.agentRoot,y.source,n,x.owner);f.push(r),r.sourceKind===`module`&&r.hasRun&&t.evaluation.requireRuntimeEntry(v.sourceId);break}case`skill`:{let n=await compileSkillSource(e.manifest.agentRoot,y.source,x);n.kind===`skill`?(assertSkillNameAvailable(n.definition),i.push(n.definition)):(a.push(withExtensionNamespace(n.definition,v.owner)),t.evaluation.requireRuntimeEntry(v.sourceId));break}case`tool`:{let i=await compileToolEntry(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_});i.kind===`disabled`?(t.composed=disableComposedCandidate({allowUnmatched:canDisableToolWithoutSelectedSource(t,i.name),candidate:v,composed:t.composed}),delete t.bindings[v.sourceId],g.delete(v.sourceId)):i.kind===`tool`?(n.push(i.definition),i.definition.hasExecute&&t.evaluation.requireRuntimeEntry(v.sourceId)):i.kind===`dynamic-tool`?(r.push(withExtensionNamespace(i.definition,v.owner)),t.evaluation.requireRuntimeEntry(v.sourceId)):(assertNonExtensionSpecialTool(v,`Web search`),n.push(i.definition));break}}}if(h===void 0)throw Error(`Agent node "${e.nodeId}" has no selected sandbox source.`);assertUniqueBy(n,e=>e.name,`tool name`),assertUniqueBy(r,e=>e.slug,`dynamic tool slug`),assertUniqueBy(c,e=>e.connectionName,`connection name`),assertUniqueBy(l,e=>e.slug,`dynamic connection slug`),assertUniqueBy(i,e=>e.name,`skill name`),assertStaticConnectionOwnership({connectionNames:c.map(e=>e.connectionName),subagentNames:t.projected.subagents.filter(e=>g.has(e.candidate.sourceId)).map(e=>e.source.subagentId),toolNames:n.map(e=>e.name)});let v=compileChannelRoutes(t,m,this.diagnostics,e.nodeId),y=compileExtensionMounts(e.manifest,t.composed,e.nodePath);for(let e of y)t.evaluation.requireRuntimeEntry(e.mountSourceId);let b=t.evaluation.finalizeBindings();return createCompiledAgentResources({agentRoot:e.manifest.agentRoot,appRoot:e.manifest.appRoot,bindings:b,channelRoutes:v,connections:c,diagnosticsSummary:summarizeCompilerDiagnostics(this.diagnostics),dynamicConnections:l,dynamicInstructions:s,dynamicSkills:a,dynamicTools:r,extensionMounts:y,hooks:d,memories:u,instructions:o,sandbox:h,sandboxWorkspaces:e.manifest.sandboxWorkspaces.map(e=>({logicalPath:e.logicalPath,rootEntries:[...e.rootEntries],sourceId:e.sourceId,sourcePath:e.sourcePath})),schedules:f,scheduleCollections:p,skills:i,sourceComposition:t.composed.composition,tools:n})}};export{compileAgentManifest};
+import{randomUUID}from"node:crypto";import{noDevelopmentExtensions,prepareDevelopmentExtensions}from"#compiler/development-extensions.js";import{ROOT_COMPILED_AGENT_NODE_ID,createCompiledAgentManifest,createCompiledAgentNodeManifest,createCompiledAgentResources,createCompiledSubagentNodeId}from"#compiler/manifest.js";import{summarizeCompilerDiagnostics}from"#compiler/diagnostics.js";import{composeAgentModuleCandidates,createAgentModuleBinding,createProgrammaticModuleCandidates,disableComposedCandidate,isAgentModuleCandidate}from"#compiler/source-graph.js";import{compileMemoryDefinition}from"#compiler/normalize-memory.js";import{frameworkAgentSourceRegistry}from"#framework/sources/registry.js";import{bindingMountId}from"#compiler/extension-mount-bindings.js";import{assertApplicationOverlayCanApplyToAllNodes,assertNonExtensionSpecialTool,assertRootOnlyConfig,assertUniqueBy,assertUniqueRegistryIds,collectSelectedSourceIds,compileChannelRoutes,compileExtensionMounts,createCompiledRemoteAgent,createExtensionCompileMounts,expectSubagentDescription,loadSelectedNodeConfig,mergeExternalDependencies,withDiagnosticsSummary,withExtensionNamespace}from"#compiler/normalize-manifest-helpers.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{assertRemoteAgentDefinitionHasNoLocalPackageEntries,normalizeSubagentConfig}from"#compiler/normalize-subagent.js";import{NodeModuleEvaluationContext,markConfigRuntimeEntries}from"#compiler/module-lifecycle.js";import{assertStaticConnectionOwnership}from"#compiler/connection-ownership.js";import{createAuthoredModuleGraph}from"#internal/authored-module-graph.js";import{pruneAuthoredModuleCache}from"#internal/authored-module-cache.js";import{createCompiledRuntimeModelCatalogLoader}from"#compiler/model-catalog.js";import{compileAgentConfig}from"#compiler/normalize-agent-config.js";import{compileChannelDefinition}from"#compiler/normalize-channel.js";import{compileConnectionDefinition}from"#compiler/normalize-connection.js";import{applyAgentToolPolicy,applyDefaultToolPolicy,canDisableToolWithoutSelectedSource}from"#compiler/default-tool-policy.js";import{resolveWorkspaceSubagentDefinition}from"#compiler/resolve-workspace-subagent.js";import{workspaceSubagentName}from"#public/definitions/workspace-agent.js";import{compileHookEntry}from"#compiler/normalize-hook.js";import{compileInstructionsEntry}from"#compiler/normalize-instructions.js";import{createMemoryWrapperCandidates}from"#compiler/memory-wrapper-candidates.js";import{compileSandboxDefinition}from"#compiler/normalize-sandbox.js";import{compileScheduleDefinition}from"#compiler/normalize-schedule.js";import{compileScheduleCollectionDefinition}from"#compiler/normalize-schedule-collection.js";import{isScheduleCollectionDefinition}from"#shared/schedule-collection-definition.js";import{createScheduleCollectionWrapperCandidates}from"#compiler/schedule-collection-wrapper-candidates.js";import{assertSkillNameAvailable,compileSkillSource}from"#compiler/normalize-skill.js";import{compileToolEntry}from"#compiler/normalize-tool.js";import{finalizeNodeSourceState}from"#compiler/node-source-state.js";import{listApplicationModulePaths,projectAgentSources,projectSelectedSources}from"#compiler/project-sources.js";async function compileAgentManifest(e,t={}){let n=[frameworkAgentSourceRegistry,...t.sourceRegistries??[]];assertUniqueRegistryIds(n);let r={modelCatalog:createCompiledRuntimeModelCatalogLoader(e.appRoot),registries:n},i=t.diagnostics??[],a=await prepareDevelopmentExtensions({diagnostics:i,manifest:e,nodeId:ROOT_COMPILED_AGENT_NODE_ID,selection:t.developmentExtensions??noDevelopmentExtensions()}),o=await new AgentGraphCompiler(r,n,i,createAuthoredModuleGraph(listApplicationModulePaths(a.manifest),{appRoot:e.appRoot})).compileStaticNode({developmentExtensionCandidates:a.candidates,inheritedExternalDependencies:[],isRoot:!0,layer:`application`,manifest:a.manifest,nodeId:ROOT_COMPILED_AGENT_NODE_ID,nodePath:``,owner:{kind:`application`}}),s=summarizeCompilerDiagnostics(i),c=withDiagnosticsSummary(o.descendants,s),l=createCompiledAgentManifest({...o.manifest,diagnosticsSummary:s,subagents:c});return pruneAuthoredModuleCache(),l}var AgentGraphCompiler=class{context;registries;diagnostics;mounts=new Map;evaluationId=randomUUID();moduleGraph;constructor(e,t,n,r){this.context=e,this.registries=t,this.diagnostics=n,this.moduleGraph=r}async compileStaticNode(e){let t=await this.createPhaseOneNodeSourceState(e,e.inheritedExternalDependencies),n=await compileAgentConfig(e.manifest,this.context,{binding:t.selectedConfig.binding,definition:t.selectedConfig.definition,source:t.selectedConfig.source});assertRootOnlyConfig(n,e.isRoot,e.manifest.agentId),applyAgentToolPolicy(t,n),applyDefaultToolPolicy(t,n);let r=mergeExternalDependencies(e.inheritedExternalDependencies,n.build?.externalDependencies,e.manifest.resolvedExtensions.flatMap(e=>e.externalDependencies));r.length>0&&(n={...n,build:{...n.build,externalDependencies:r}});let i=finalizeNodeSourceState(t,r);markConfigRuntimeEntries(n,i.evaluation);let a=await this.compileResources(e,i),o=await this.compileChildren(e,i,r),s=createCompiledAgentNodeManifest({...a,config:n,remoteAgents:o.remoteAgents});return{descendants:o.nodes,manifest:s}}async compileChildren(e,t,n){let r=[],i=[],a=collectSelectedSourceIds(t.composed),o=t.projected.subagents.filter(e=>a.has(e.candidate.sourceId));for(let t of o){let a=t.source,o=createCompiledSubagentNodeId(e.nodeId,a.sourceId),s={extensionScope:t.extensionScope??e.extensionScope,mountId:t.mountId,inheritedExternalDependencies:n,isRoot:!1,layer:t.candidate.layer,manifest:a.manifest,nodeId:o,nodePath:t.nodePath,owner:t.owner,parentNodeId:e.nodeId},c=await this.createPhaseOneNodeSourceState(s,n),l=normalizeSubagentConfig(c.selectedConfig.definition,`Expected the subagent config export "${c.selectedConfig.source.exportName??`default`}" from "${a.entryPath}" to match the public eve shape.`);if(l.kind===`remote`){let n=workspaceSubagentName(c.selectedConfig.definition),r=n===void 0?l:await resolveWorkspaceSubagentDefinition({definition:l,name:n,registries:this.registries,source:a});assertRemoteAgentDefinitionHasNoLocalPackageEntries(a);let s=c.selectedConfig.source.sourceId;c.evaluation.setBindings({[s]:c.selectedConfig.binding}),c.evaluation.requireRuntimeEntry(s);let u=c.evaluation.finalizeBindings()[s];if(u===void 0)throw Error(`Remote subagent "${o}" has no finalized config binding.`);i.push(createCompiledRemoteAgent({binding:u,definition:r,nodeId:o,owner:t.owner,parentNodeId:e.nodeId,source:a,sourceRef:c.selectedConfig.source}));continue}let u;l.kind===`local`&&(u=await compileAgentConfig(a.manifest,this.context,{binding:c.selectedConfig.binding,definition:l.definition,source:c.selectedConfig.source}),assertRootOnlyConfig(u,!1,a.manifest.agentId),applyAgentToolPolicy(c,u),applyDefaultToolPolicy(c,u));let d=mergeExternalDependencies(n,u?.build?.externalDependencies,a.manifest.resolvedExtensions.flatMap(e=>e.externalDependencies));u!==void 0&&d.length>0&&(u={...u,build:{...u.build,externalDependencies:d}});let f=finalizeNodeSourceState(c,d);u===void 0?f.evaluation.requireRuntimeEntry(c.selectedConfig.source.sourceId):markConfigRuntimeEntries(u,f.evaluation);let p=await this.compileResources(s,f),m=await this.compileChildren(s,f,d),h={backing:t.candidate.backing,entryPath:a.entryPath,logicalPath:a.logicalPath,name:a.subagentId,nodeId:o,owner:t.owner,parentNodeId:e.nodeId,rootPath:a.rootPath,sourceId:a.sourceId,sourceKind:`module`},g;g=u===void 0?{...h,agent:createCompiledAgentResources({...p,remoteAgents:m.remoteAgents}),configResolver:{exportName:c.selectedConfig.source.exportName,logicalPath:c.selectedConfig.source.logicalPath,sourceId:c.selectedConfig.source.sourceId,sourceKind:`module`}}:{...h,agent:createCompiledAgentNodeManifest({...p,config:u,remoteAgents:m.remoteAgents}),description:expectSubagentDescription(u,a)},r.push(g,...m.nodes)}return{nodes:r,remoteAgents:i}}composeNodeSources(e,t){let n=projectAgentSources({externalDependencies:t,extensionScope:e.extensionScope,mountId:e.mountId,layer:e.layer,manifest:e.manifest,nodeId:e.nodeId,nodePath:e.nodePath,owner:e.owner}),r=[],i=[];for(let t of this.registries){let n=t===frameworkAgentSourceRegistry;for(let a of t.registrations){if(a.applyTo===`root`&&!e.isRoot)continue;!n&&a.applyTo===`all-local-nodes`&&assertApplicationOverlayCanApplyToAllNodes(a.source.modules.map(e=>e.logicalPath));let t=createProgrammaticModuleCandidates({layer:n?`framework-default`:`application`,nodeId:e.nodeId,owner:n?{feature:a.source.id,kind:`framework`}:{kind:`application`},registration:a});(n?r:i).push(...t)}}let a=[...r,...e.developmentExtensionCandidates??[],...n.candidates,...createMemoryWrapperCandidates([...n.candidates,...i]),...createScheduleCollectionWrapperCandidates([...n.candidates,...i],e.manifest.agentId),...i],o=composeAgentModuleCandidates(a),s=projectSelectedSources({candidates:o.selected.values(),resources:n.resources});return{composed:o,orderedCandidates:a,projected:n,sourcesBySourceId:new Map(s.map(e=>[e.candidate.sourceId,e])),subagentsBySourceId:new Map(n.subagents.map(e=>[e.candidate.sourceId,e]))}}async createPhaseOneNodeSourceState(e,t){let n=this.composeNodeSources(e,t),{mounts:r,sourceIds:i}=createExtensionCompileMounts(e.manifest,e.nodePath);for(let[e,t]of r)this.mounts.set(e,t);let a=new NodeModuleEvaluationContext(this.registries,e=>i.get(bindingMountId(e)??``),this.mounts,this.evaluationId,e.manifest.appRoot,this.moduleGraph);return a.setBindings(Object.fromEntries([...n.composed.selected.values()].filter(isAgentModuleCandidate).map(e=>[e.sourceId,createAgentModuleBinding(e)]))),{evaluation:a,graph:n,selectedConfig:await loadSelectedNodeConfig(n,a)}}async compileResources(e,t){let n=[],r=[],i=[],a=[],o=[],s=[],c=[],l=[],u=[],d=[],f=[],p=[],m=[],h,g=collectSelectedSourceIds(t.composed),_=t.evaluation.loadNamespace;for(let v of t.orderedCandidates){if(!g.has(v.sourceId))continue;let y=t.sourcesBySourceId.get(v.sourceId);if(y===void 0)continue;let b=t.bindings[v.sourceId],x={binding:b,loadNamespace:_,owner:v.owner};switch(y.kind){case`config`:case`extension`:break;case`channel`:{let n=await compileChannelDefinition(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_});n.kind===`disabled`?(t.composed=disableComposedCandidate({candidate:v,composed:t.composed}),delete t.bindings[v.sourceId],g.delete(v.sourceId)):m.push(...n.definitions);break}case`connection`:{let n=await compileConnectionDefinition(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_});if(n.kind===`connection`){if(n.definition.experimental_events===!0&&e.nodeId!==ROOT_COMPILED_AGENT_NODE_ID)throw Error(`experimental_events currently requires a root-agent connection.`);c.push(n.definition)}else l.push(withExtensionNamespace(n.definition,v.owner));t.evaluation.requireRuntimeEntry(v.sourceId);break}case`hook`:d.push(await compileHookEntry(y.source,{binding:b,loadNamespace:_})),t.evaluation.requireRuntimeEntry(v.sourceId);break;case`instructions`:{let n=await compileInstructionsEntry(e.manifest.agentRoot,y.source,x);n.kind===`instructions`?o.push(n.definition):(s.push(n.definition),t.evaluation.requireRuntimeEntry(v.sourceId));break}case`memory`:u.push(await compileMemoryDefinition(y.source,{binding:b,loadNamespace:_})),t.evaluation.requireRuntimeEntry(v.sourceId);break;case`sandbox`:h=await compileSandboxDefinition(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_}),h.inheritsParent||t.evaluation.requireRuntimeEntry(v.sourceId);break;case`schedule`:{let n=y.source.sourceKind===`module`?await loadModuleBackedDefinition({binding:b,loadNamespace:_,kind:`schedule`,source:y.source}):y.source.definition;if(isScheduleCollectionDefinition(n)){p.push(compileScheduleCollectionDefinition(y.source,n)),t.evaluation.requireRuntimeEntry(v.sourceId);break}let r=compileScheduleDefinition(e.manifest.agentRoot,y.source,n,x.owner);f.push(r),r.sourceKind===`module`&&r.hasRun&&t.evaluation.requireRuntimeEntry(v.sourceId);break}case`skill`:{let n=await compileSkillSource(e.manifest.agentRoot,y.source,x);n.kind===`skill`?(assertSkillNameAvailable(n.definition),i.push(n.definition)):(a.push(withExtensionNamespace(n.definition,v.owner)),t.evaluation.requireRuntimeEntry(v.sourceId));break}case`tool`:{let i=await compileToolEntry(e.manifest.agentRoot,y.source,{binding:b,loadNamespace:_});i.kind===`disabled`?(t.composed=disableComposedCandidate({allowUnmatched:canDisableToolWithoutSelectedSource(t,i.name),candidate:v,composed:t.composed}),delete t.bindings[v.sourceId],g.delete(v.sourceId)):i.kind===`tool`?(n.push(i.definition),i.definition.hasExecute&&t.evaluation.requireRuntimeEntry(v.sourceId)):i.kind===`dynamic-tool`?(r.push(withExtensionNamespace(i.definition,v.owner)),t.evaluation.requireRuntimeEntry(v.sourceId)):(assertNonExtensionSpecialTool(v,`Web search`),n.push(i.definition));break}}}if(h===void 0)throw Error(`Agent node "${e.nodeId}" has no selected sandbox source.`);assertUniqueBy(n,e=>e.name,`tool name`),assertUniqueBy(r,e=>e.slug,`dynamic tool slug`),assertUniqueBy(c,e=>e.connectionName,`connection name`),assertUniqueBy(l,e=>e.slug,`dynamic connection slug`),assertUniqueBy(i,e=>e.name,`skill name`),assertStaticConnectionOwnership({connectionNames:c.map(e=>e.connectionName),subagentNames:t.projected.subagents.filter(e=>g.has(e.candidate.sourceId)).map(e=>e.source.subagentId),toolNames:n.map(e=>e.name)});let v=compileChannelRoutes(t,m,this.diagnostics,e.nodeId),y=compileExtensionMounts(e.manifest,t.composed,e.nodePath);for(let e of y)t.evaluation.requireRuntimeEntry(e.mountSourceId);let b=t.evaluation.finalizeBindings();return createCompiledAgentResources({agentRoot:e.manifest.agentRoot,appRoot:e.manifest.appRoot,bindings:b,channelRoutes:v,connections:c,diagnosticsSummary:summarizeCompilerDiagnostics(this.diagnostics),dynamicConnections:l,dynamicInstructions:s,dynamicSkills:a,dynamicTools:r,extensionMounts:y,hooks:d,memories:u,instructions:o,sandbox:h,sandboxWorkspaces:e.manifest.sandboxWorkspaces.map(e=>({logicalPath:e.logicalPath,rootEntries:[...e.rootEntries],sourceId:e.sourceId,sourcePath:e.sourcePath})),schedules:f,scheduleCollections:p,skills:i,sourceComposition:t.composed.composition,tools:n})}};export{compileAgentManifest};

package/dist/src/compiler/normalize-memory.js

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeMemoryDefinition}from"#internal/authored-definition/memory.js";async function compileMemoryDefinition(e,t){let n=normalizeMemoryDefinition(await loadModuleBackedDefinition({binding:t.binding,kind:`memory`,loadNamespace:t.loadNamespace,source:e}),`Expected the memory export "${e.exportName??`default`}" from "${e.logicalPath}" to be created with defineMemory().`);return{description:n.description,exportName:e.exportName,logicalPath:e.logicalPath,slot:deriveMemorySlot(e.logicalPath),sourceId:e.sourceId,sourceKind:`module`,visibility:n.visibility??`scope`}}function deriveMemorySlot(e){let t=stripLogicalPathExtension(e);return t===`memory`?`memory`:t.slice(7)}export{compileMemoryDefinition,deriveMemorySlot};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeMemoryDefinition}from"#internal/authored-definition/memory.js";async function compileMemoryDefinition(e,t){return{description:normalizeMemoryDefinition(await loadModuleBackedDefinition({binding:t.binding,kind:`memory`,loadNamespace:t.loadNamespace,source:e}),`Expected the memory export "${e.exportName??`default`}" from "${e.logicalPath}" to be created with defineMemory().`).description,exportName:e.exportName,logicalPath:e.logicalPath,slot:deriveMemorySlot(e.logicalPath),sourceId:e.sourceId,sourceKind:`module`}}function deriveMemorySlot(e){let t=stripLogicalPathExtension(e);return t===`memory`?`memory`:t.slice(7)}export{compileMemoryDefinition,deriveMemorySlot};

package/dist/src/compiler/normalize-schedule.js

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeScheduleDefinition}from"#internal/authored-definition/core.js";import{readWorkflowFunctionId}from"#internal/workflow/reference.js";import{workflowCallbackErrorMessage}from"#shared/workflow-tool-context.js";function compileScheduleDefinition(e,t,n,r){let i=normalizeScheduleDefinition(n,t.sourceKind===`markdown`?`Expected the compiled schedule definition at "${t.logicalPath}" to match the public eve shape.`:`Expected the schedule export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);if(readWorkflowFunctionId(i.run)!==void 0)throw Error(`${t.logicalPath}: ${workflowCallbackErrorMessage(`schedule`)}`);let a={cron:i.cron,hasRun:i.run!==void 0,logicalPath:t.logicalPath,name:deriveScheduleName(t.logicalPath),sourceId:t.sourceId,sourceKind:t.sourceKind},o=i.markdown===void 0?a:{...a,markdown:i.markdown.trim()};return t.sourceKind===`module`?{...o,sourceKind:`module`}:{...o,owner:r,sourceKind:`markdown`}}function deriveScheduleName(e){return stripLogicalPathExtension(e).replace(/^schedules\//,``)}export{compileScheduleDefinition};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeScheduleDefinition}from"#internal/authored-definition/core.js";import{readWorkflowFunctionId}from"#internal/workflow/reference.js";import{workflowCallbackErrorMessage}from"#shared/workflow-tool-context.js";function compileScheduleDefinition(e,t,n,r){let i=normalizeScheduleDefinition(n,t.sourceKind===`markdown`?`Expected the compiled schedule definition at "${t.logicalPath}" to match the public eve shape.`:`Expected the schedule export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);if(readWorkflowFunctionId(i.run)!==void 0)throw Error(`${t.logicalPath}: ${workflowCallbackErrorMessage(`schedule`)}`);let a={cron:i.cron,hasRun:i.run!==void 0,logicalPath:t.logicalPath,name:deriveScheduleName(t.logicalPath),sourceId:t.sourceId,sourceKind:t.sourceKind},o=i.content===void 0?a:{...a,markdown:i.content.trim()};return t.sourceKind===`module`?{...o,sourceKind:`module`}:{...o,owner:r,sourceKind:`markdown`}}function deriveScheduleName(e){return stripLogicalPathExtension(e).replace(/^schedules\//,``)}export{compileScheduleDefinition};

package/dist/src/compiler/normalize-skill.js

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeSkillDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#dynamic/definition.js";function assertSkillNameAvailable(e){let t=eveNamespaceReservation(e.name);if(t!==void 0)throw Error(`Skill "${e.logicalPath}" uses the reserved name "${e.name}". Rename its path; ${t}.`)}async function compileSkillSource(e,t,n){if(t.sourceKind===`skill-package`)return{kind:`skill`,definition:compileSkillPackageSource(t,n.owner)};if(t.sourceKind===`markdown`){let e=normalizeSkillDefinition(t.definition,`Expected the compiled skill definition at "${t.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{deferred:e.deferred,description:e.description,files:e.files,license:e.license,logicalPath:t.logicalPath,owner:n.owner,markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:stripLogicalPathExtension(t.logicalPath).replace(/^skills\//,``),sourceId:t.sourceId,sourceKind:t.sourceKind}}}let r=requireModuleBackedDefinitionLoadOptions(n,t.logicalPath),i=await loadModuleBackedDefinition({binding:r.binding,kind:`skill`,loadNamespace:r.loadNamespace,source:t});if(isDynamicSentinel(i)){assertResolverOnlyDynamicSentinel(i,`Expected the skill export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);let e=stripLogicalPathExtension(t.logicalPath).replace(/^skills\//,``);return{kind:`dynamic-skill`,definition:{eventNames:Object.keys(i.events),exportName:t.exportName,logicalPath:t.logicalPath,slug:e,sourceId:t.sourceId,sourceKind:`module`}}}let a=normalizeSkillDefinition(i,`Expected the skill export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{deferred:a.deferred,description:a.description,files:a.files,license:a.license,logicalPath:t.logicalPath,markdown:a.markdown,metadata:a.metadata===void 0?void 0:{...a.metadata},name:stripLogicalPathExtension(t.logicalPath).replace(/^skills\//,``),sourceId:t.sourceId,sourceKind:t.sourceKind}}}function compileSkillPackageSource(e,t){return{assetsPath:e.assetsPath,deferred:e.deferred,description:e.description,license:e.license,logicalPath:e.logicalPath,owner:t,markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name,referencesPath:e.referencesPath,rootPath:e.rootPath,scriptsPath:e.scriptsPath,skillId:e.skillId,skillFilePath:e.skillFilePath,sourceId:e.sourceId,sourceKind:`skill-package`}}export{assertSkillNameAvailable,compileSkillSource};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeSkillDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{assertDynamicSentinelKeys,isDynamicSentinel}from"#dynamic/definition.js";function assertSkillNameAvailable(e){let t=eveNamespaceReservation(e.name);if(t!==void 0)throw Error(`Skill "${e.logicalPath}" uses the reserved name "${e.name}". Rename its path; ${t}.`)}async function compileSkillSource(e,t,n){if(t.sourceKind===`skill-package`)return{kind:`skill`,definition:compileSkillPackageSource(t,n.owner)};if(t.sourceKind===`markdown`){let e=normalizeSkillDefinition(t.definition,`Expected the compiled skill definition at "${t.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{deferred:e.deferred,description:e.description,files:e.files,license:e.license,logicalPath:t.logicalPath,owner:n.owner,content:e.content,metadata:e.metadata===void 0?void 0:{...e.metadata},name:stripLogicalPathExtension(t.logicalPath).replace(/^skills\//,``),sourceId:t.sourceId,sourceKind:t.sourceKind}}}let r=requireModuleBackedDefinitionLoadOptions(n,t.logicalPath),i=await loadModuleBackedDefinition({binding:r.binding,kind:`skill`,loadNamespace:r.loadNamespace,source:t});if(isDynamicSentinel(i)){let e=`Expected the skill export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`;assertDynamicSentinelKeys(i,e);let n=stripLogicalPathExtension(t.logicalPath).replace(/^skills\//,``);return{kind:`dynamic-skill`,definition:{exportName:t.exportName,logicalPath:t.logicalPath,slug:n,sourceId:t.sourceId,sourceKind:`module`}}}let a=normalizeSkillDefinition(i,`Expected the skill export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{deferred:a.deferred,description:a.description,files:a.files,license:a.license,logicalPath:t.logicalPath,content:a.content,metadata:a.metadata===void 0?void 0:{...a.metadata},name:stripLogicalPathExtension(t.logicalPath).replace(/^skills\//,``),sourceId:t.sourceId,sourceKind:t.sourceKind}}}function compileSkillPackageSource(e,t){return{assetsPath:e.assetsPath,deferred:e.deferred,description:e.description,license:e.license,logicalPath:e.logicalPath,owner:t,content:e.content,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name,referencesPath:e.referencesPath,rootPath:e.rootPath,scriptsPath:e.scriptsPath,skillId:e.skillId,skillFilePath:e.skillFilePath,sourceId:e.sourceId,sourceKind:`skill-package`}}export{assertSkillNameAvailable,compileSkillSource};

package/dist/src/compiler/normalize-subagent.d.ts

@@ -1,14 +1,9 @@
-import { type DynamicToolEventName } from "#dynamic/definition.js";
 import type { LocalSubagentSourceRef } from "#discover/manifest.js";
 import type { AgentToolExposure } from "#shared/agent-definition.js";
 export type NormalizedSubagentConfig = {
     readonly kind: "local";
     readonly definition: unknown;
 } | {
-    readonly build?: {
-        readonly externalDependencies?: readonly string[];
-    };
-    readonly eventNames: readonly DynamicToolEventName[];
     readonly kind: "dynamic";
 } | {
     readonly description: string;

package/dist/src/compiler/normalize-subagent.js

@@ -1 +1 @@
-import{expectAgentToolExposure,expectBoolean,expectFunction,expectObjectRecord,expectOnlyKnownKeys,expectString}from"#internal/authored-module.js";import{EVE_SESSION_ROUTE_PATH}from"#protocol/routes.js";import{isDynamicSentinel}from"#dynamic/definition.js";const ALLOWED_DYNAMIC_SUBAGENT_EVENTS=new Set([`session.started`,`turn.started`]);function normalizeSubagentConfig(e,t){if(isDynamicSentinel(e)){let n=expectObjectRecord(e,t);expectOnlyKnownKeys(n,[`build`,`events`,`kind`],t);let r=expectObjectRecord(n.events,t),i=[];for(let[e,n]of Object.entries(r)){if(!ALLOWED_DYNAMIC_SUBAGENT_EVENTS.has(e))throw Error(`${t} Dynamic subagents support only "session.started" and "turn.started" handlers.`);expectFunction(n,t),i.push(e)}let a=n.build===void 0?void 0:normalizeDynamicSubagentBuild(n.build,t);return a===void 0?{eventNames:i,kind:`dynamic`}:{build:a,eventNames:i,kind:`dynamic`}}if(typeof e==`object`&&e&&e.kind===`remote`){let n=expectObjectRecord(e,t);return expectOnlyKnownKeys(n,[`auth`,`description`,`forwardPrincipal`,`headers`,`kind`,`path`,`tool`,`url`],t),n.forwardPrincipal!==void 0&&expectBoolean(n.forwardPrincipal,`${t} Expected "forwardPrincipal" to be a boolean.`),{description:expectString(n.description,t),kind:`remote`,path:n.path===void 0?EVE_SESSION_ROUTE_PATH:expectString(n.path,t),tool:n.tool===void 0?void 0:expectAgentToolExposure(n.tool,t),url:typeof n.url==`function`?void 0:expectString(n.url,t)}}return{definition:e,kind:`local`}}function assertRemoteAgentDefinitionHasNoLocalPackageEntries(e){let t=e.manifest,n=[t.connections.length>0?`connections/`:void 0,t.hooks.length>0?`hooks/`:void 0,t.instructions.length>0?`instructions`:void 0,t.lib.length>0?`lib/`:void 0,t.sandbox===null?void 0:`sandbox/`,t.sandboxWorkspaces.length>0?`sandbox/workspace/`:void 0,t.schedules.length>0?`schedules/`:void 0,t.skills.length>0?`skills/`:void 0,t.subagents.length>0?`subagents/`:void 0,t.tools.length>0?`tools/`:void 0].filter(e=>e!==void 0);if(n.length>0)throw Error(`Remote subagent definition "${e.logicalPath}" cannot include local package entries. Remove unsupported entries: ${n.join(`, `)}.`)}function normalizeDynamicSubagentBuild(e,t){let n=expectObjectRecord(e,t);if(expectOnlyKnownKeys(n,[`externalDependencies`],t),n.externalDependencies===void 0)return{};if(!Array.isArray(n.externalDependencies))throw Error(t);return{externalDependencies:n.externalDependencies.map(e=>expectString(e,t))}}export{assertRemoteAgentDefinitionHasNoLocalPackageEntries,normalizeSubagentConfig};
+import{expectAgentToolExposure,expectBoolean,expectObjectRecord,expectOnlyKnownKeys,expectString}from"#internal/authored-module.js";import{EVE_SESSION_ROUTE_PATH}from"#protocol/routes.js";import{assertDynamicSentinelKeys,isDynamicSentinel}from"#dynamic/definition.js";function normalizeSubagentConfig(e,t){if(isDynamicSentinel(e))return assertDynamicSentinelKeys(e,t),{kind:`dynamic`};if(typeof e==`object`&&e&&e.kind===`remote`){let n=expectObjectRecord(e,t);return expectOnlyKnownKeys(n,[`auth`,`description`,`forwardPrincipal`,`headers`,`kind`,`path`,`tool`,`url`],t),n.forwardPrincipal!==void 0&&expectBoolean(n.forwardPrincipal,`${t} Expected "forwardPrincipal" to be a boolean.`),{description:expectString(n.description,t),kind:`remote`,path:n.path===void 0?EVE_SESSION_ROUTE_PATH:expectString(n.path,t),tool:n.tool===void 0?void 0:expectAgentToolExposure(n.tool,t),url:typeof n.url==`function`?void 0:expectString(n.url,t)}}return{definition:e,kind:`local`}}function assertRemoteAgentDefinitionHasNoLocalPackageEntries(e){let t=e.manifest,n=[t.connections.length>0?`connections/`:void 0,t.hooks.length>0?`hooks/`:void 0,t.instructions.length>0?`instructions`:void 0,t.lib.length>0?`lib/`:void 0,t.sandbox===null?void 0:`sandbox/`,t.sandboxWorkspaces.length>0?`sandbox/workspace/`:void 0,t.schedules.length>0?`schedules/`:void 0,t.skills.length>0?`skills/`:void 0,t.subagents.length>0?`subagents/`:void 0,t.tools.length>0?`tools/`:void 0].filter(e=>e!==void 0);if(n.length>0)throw Error(`Remote subagent definition "${e.logicalPath}" cannot include local package entries. Remove unsupported entries: ${n.join(`, `)}.`)}export{assertRemoteAgentDefinitionHasNoLocalPackageEntries,normalizeSubagentConfig};

package/dist/src/compiler/normalize-tool.js

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{normalizeToolDefinition}from"#internal/authored-definition/schema-backed.js";async function compileToolEntry(e,t,n){let r=normalizeToolDefinition(await loadModuleBackedDefinition({binding:n.binding,kind:`tool`,loadNamespace:n.loadNamespace,source:t}),`Expected the tool export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`),i=stripLogicalPathExtension(t.logicalPath).replace(/^tools\//,``).replaceAll(`/`,`-`),a=eveNamespaceReservation(i);if(a!==void 0)throw Error(`Tool "${t.logicalPath}" uses the reserved name "${i}". Rename its path; ${a}.`);if(r.kind===`disabled`)return{kind:`disabled`,name:i};if(r.kind===`web-search-tool`){if(i!==`web_search`)throw Error(`The webSearch() definition must be exported from "tools/web_search.ts", not "${t.logicalPath}".`);return{definition:{behavior:{availability:[],handling:{kind:`provider-tool`,...r.selection}},description:`Search the web for real-time information. Use this to find up-to-date information about current events, recent developments, or topics that may have changed since the knowledge cutoff.`,exportName:t.exportName,hasExecute:!1,hasModelOutputProjection:!1,inputSchema:null,logicalPath:t.logicalPath,name:i,sourceId:t.sourceId,sourceKind:`module`,requiresApproval:!1},kind:`web-search-tool`}}if(r.kind===`dynamic-tool`)return{kind:`dynamic-tool`,definition:{eventNames:[...r.eventNames],exportName:t.exportName,logicalPath:t.logicalPath,rebindMissingCallbacks:r.rebindMissingCallbacks||void 0,slug:i,sourceId:t.sourceId,sourceKind:`module`}};let{workflow:o}=r.definition,s={suspend:o===void 0?`none`:`workflow`};return{kind:`tool`,definition:{availableInSubagents:r.definition.availableInSubagents,deferred:r.definition.deferred,behavior:o===void 0?r.definition.behavior===void 0?{availability:[],shape:s}:{...r.definition.behavior,shape:s}:{availability:[],handling:{kind:`workflow-tool`,...o},shape:s},description:r.definition.description,exportName:t.exportName,hasExecute:r.definition.hasExecute,hasModelOutputProjection:r.definition.hasModelOutputProjection,inputSchema:r.definition.inputSchema??null,logicalPath:t.logicalPath,modelInputSchema:r.definition.modelInputSchema,name:i,outputSchema:r.definition.outputSchema,requiresApproval:r.definition.hasApproval,sourceId:t.sourceId,sourceKind:`module`,workflowProgram:r.definition.workflowProgram}}}export{compileToolEntry};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{normalizeToolDefinition}from"#internal/authored-definition/schema-backed.js";async function compileToolEntry(e,t,n){let r=normalizeToolDefinition(await loadModuleBackedDefinition({binding:n.binding,kind:`tool`,loadNamespace:n.loadNamespace,source:t}),`Expected the tool export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`),i=stripLogicalPathExtension(t.logicalPath).replace(/^tools\//,``).replaceAll(`/`,`-`),a=eveNamespaceReservation(i);if(a!==void 0)throw Error(`Tool "${t.logicalPath}" uses the reserved name "${i}". Rename its path; ${a}.`);if(r.kind===`disabled`)return{kind:`disabled`,name:i};if(r.kind===`web-search-tool`){if(i!==`web_search`)throw Error(`The webSearch() definition must be exported from "tools/web_search.ts", not "${t.logicalPath}".`);return{definition:{behavior:{availability:[],handling:{kind:`provider-tool`,...r.selection}},description:`Search the web for real-time information. Use this to find up-to-date information about current events, recent developments, or topics that may have changed since the knowledge cutoff.`,exportName:t.exportName,hasExecute:!1,hasModelOutputProjection:!1,inputSchema:null,logicalPath:t.logicalPath,name:i,sourceId:t.sourceId,sourceKind:`module`,requiresApproval:!1},kind:`web-search-tool`}}if(r.kind===`dynamic-tool`)return{kind:`dynamic-tool`,definition:{exportName:t.exportName,logicalPath:t.logicalPath,slug:i,sourceId:t.sourceId,sourceKind:`module`}};let{workflow:o}=r.definition,s={suspend:o===void 0?`none`:`workflow`};return{kind:`tool`,definition:{availableInSubagents:r.definition.availableInSubagents,deferred:r.definition.deferred,behavior:o===void 0?r.definition.behavior===void 0?{availability:[],shape:s}:{...r.definition.behavior,shape:s}:{availability:[],handling:{kind:`workflow-tool`,...o},shape:s},description:r.definition.description,exportName:t.exportName,hasExecute:r.definition.hasExecute,hasModelOutputProjection:r.definition.hasModelOutputProjection,inputSchema:r.definition.inputSchema??null,logicalPath:t.logicalPath,modelInputSchema:r.definition.modelInputSchema,name:i,outputSchema:r.definition.outputSchema,requiresApproval:r.definition.hasApproval,sourceId:t.sourceId,sourceKind:`module`,workflowProgram:r.definition.workflowProgram}}}export{compileToolEntry};

package/dist/src/compiler/remote-agent-node.d.ts

@@ -3,12 +3,7 @@ import type { Node } from "#shared/node.js";
 import type { ModuleSourceRef } from "#shared/source-ref.js";
 import type { AgentSourceOwner, CompiledModuleBinding } from "#compiler/source-graph.js";
 import type { AgentToolExposure } from "#shared/agent-definition.js";
-export interface CompiledDynamicSubagentDefinition extends Readonly<ModuleSourceRef> {
-    readonly build?: {
-        readonly externalDependencies?: readonly string[];
-    };
-    readonly eventNames: readonly string[];
-}
+export type CompiledDynamicSubagentDefinition = Readonly<ModuleSourceRef>;
 /**
  * Remote subagent entry owned by one compiled agent node manifest. Like
  * channels, remote subagents are node-local manifest entries rather than a

package/dist/src/compiler/source-graph.d.ts

@@ -83,7 +83,6 @@ export interface AgentModuleCandidate {
     readonly owner: AgentSourceOwner;
     readonly sourceId: string;
 }
-export declare function bindingMountId(binding: AgentModuleBinding): string | undefined;
 export interface AgentModuleBinding {
     readonly backing: AgentModuleBacking;
     readonly logicalPath: string;

package/dist/src/compiler/source-graph.js

@@ -1 +1 @@
-import{posix}from"node:path";import{normalizeLogicalPath,stripLogicalPathExtension}from"#discover/filesystem.js";import{parseJsonObject}from"#shared/json.js";import{validateProgrammaticLogicalPath,validateProgrammaticLogicalPath as validateProgrammaticLogicalPath$1,validateProgrammaticLogicalPathInternal}from"#compiler/source-graph-paths.js";function memoizeModuleNamespaceFactories(e){return Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>{if(typeof t!=`function`)return[e,t];let n;return[e,new Proxy(t,{apply(e,t,r){return r.length>0?Reflect.apply(e,t,r):(n??=Promise.resolve().then(()=>Reflect.apply(e,t,r)),n)}})]})))}var ImmutableProgrammaticSourceMap=class{#e;constructor(e){this.#e=new Map(e),Object.freeze(this)}get size(){return this.#e.size}get[Symbol.toStringTag](){return`ImmutableProgrammaticSourceMap`}[Symbol.iterator](){return this.#e[Symbol.iterator]()}entries(){return this.#e.entries()}forEach(e,t){this.#e.forEach((n,r)=>e.call(t,n,r,this))}get(e){return this.#e.get(e)}has(e){return this.#e.has(e)}keys(){return this.#e.keys()}values(){return this.#e.values()}};function extensionMountId(e,t){return posix.join(e,`extensions`,t)}function bindingMountId(e){return e.backing.kind===`filesystem`&&e.backing.mountId!==void 0?e.backing.mountId:e.owner.kind===`extension`?e.owner.mountId:void 0}function isAgentModuleCandidate(e){return e.backing.kind!==`resource`}const LAYER_PRECEDENCE={"framework-default":0,"extension-package":1,"extension-override":2,application:3},FORM_PRECEDENCE={derived:0,direct:1},registeredProgrammaticTemplates=new WeakSet;function defineProgrammaticAgentSource(e){return defineProgrammaticAgentSourceInternal(e,!1)}function defineProgrammaticAgentSourceInternal(e,t){let n=expectNonEmpty(e.id,`Programmatic agent source id`),r=expectNonEmpty(e.revision,`Programmatic agent source "${n}" revision`),i=new Set,a=e.modules.map(e=>{let r=validateProgrammaticLogicalPathInternal(e.logicalPath,t);if(i.has(r))throw Error(`Programmatic agent source "${n}" declares "${r}" more than once.`);i.add(r);let a=e.semanticRevision===void 0?void 0:expectNonEmpty(e.semanticRevision,`Programmatic module "${n}:${r}" semanticRevision`);return Object.freeze({exportName:e.exportName,loadNamespace:e.loadNamespace,logicalPath:r,semanticRevision:a})});return Object.freeze({id:n,modules:Object.freeze(a),revision:r})}function defineProgrammaticExtensionMountDeclaration(e){return defineProgrammaticAgentSourceInternal(e,!0)}function createAgentSourceRegistry(e,t={}){let n=new Map,r=new Map,addSource=(e,t=!1)=>{let r=defineProgrammaticAgentSourceInternal(e,t);if(n.has(r.id))throw Error(`Programmatic agent source id "${r.id}" is registered more than once.`);return n.set(r.id,r),r},i=e.map(e=>{let t=addSource(e.source);return Object.freeze({applyTo:e.applyTo,source:t})});for(let e of t.extensionDeclarations??[])addSource(e,!0);for(let e of t.templates??[]){let t=addSource(e);if(t.modules.length!==1)throw Error(`Programmatic template source "${t.id}" must register exactly one module.`);let n=Object.freeze({module:t.modules[0],source:t});registeredProgrammaticTemplates.add(n),r.set(t.id,n)}return Object.freeze({registrations:Object.freeze(i),sources:new ImmutableProgrammaticSourceMap(n),templates:new ImmutableProgrammaticSourceMap(r)})}function createProgrammaticModuleCandidates(e){return e.registration.source.modules.map(t=>{let n=`${e.registration.source.id}:${t.logicalPath}`;return Object.freeze({backing:Object.freeze({kind:`programmatic`,moduleId:t.logicalPath,registryId:e.registration.source.id,revision:e.registration.source.revision,semanticRevision:t.semanticRevision}),exportName:t.exportName,form:`direct`,layer:e.layer,logicalPath:t.logicalPath,nodeId:e.nodeId,owner:e.owner,sourceId:n})})}function instantiateProgrammaticTemplate(e){if(!registeredProgrammaticTemplates.has(e.template))throw Error(`Derived programmatic modules require a registered template.`);let t=validateProgrammaticLogicalPath$1(e.logicalPath),n=expectNonEmpty(e.anchor.sourceId,`Derived programmatic module anchor source id`),r=`${e.template.source.id}:${t}:from:${n}`;if(!Object.values(e.dependencies).some(e=>e.sourceId===n))throw Error(`Derived programmatic module "${r}" must include its anchor source as a dependency.`);let i=Object.freeze(Object.fromEntries(Object.entries(e.dependencies).sort(([e],[t])=>e.localeCompare(t)).map(([t,n])=>{if(expectNonEmpty(t,`Derived programmatic module dependency alias`),n.nodeId!==e.anchor.nodeId)throw Error(`Derived programmatic module "${r}" cannot depend on source "${n.sourceId}" from another node.`);return[t,n.sourceId]}))),a=Object.freeze(parseJsonObject(e.parameters??{}));return Object.freeze({backing:Object.freeze({dependencies:i,kind:`programmatic`,moduleId:e.template.module.logicalPath,parameters:a,registryId:e.template.source.id,revision:e.template.source.revision,semanticRevision:e.template.module.semanticRevision}),exportName:e.template.module.exportName,form:`derived`,layer:e.anchor.layer,logicalPath:t,nodeId:e.anchor.nodeId,owner:e.owner,sourceId:r})}function composeAgentModuleCandidates(e){let t=new Map,n=new Set;for(let r of e){if(n.has(r.sourceId))throw Error(`Agent source id "${r.sourceId}" is declared more than once in node "${r.nodeId}".`);n.add(r.sourceId);let e=canonicalSourceSlot(r.logicalPath),i=t.get(e)??[];i.push(r),t.set(e,i)}let r=new Map,i=[];for(let[e,n]of[...t].sort(([e],[t])=>e.localeCompare(t))){let t=new Set;for(let r of n){let n=`${r.layer}:${r.form}`;if(t.has(n))throw Error(`Agent source slot "${e}" has more than one ${r.layer} ${r.form} candidate.`);t.add(n)}let a=[...n].sort((e,t)=>LAYER_PRECEDENCE[t.layer]-LAYER_PRECEDENCE[e.layer]||FORM_PRECEDENCE[t.form]-FORM_PRECEDENCE[e.form]),o=a[0];r.set(e,o);for(let e of a.slice(1))i.push({kind:`shadowed`,source:describeAgentSourceCandidate(e),winnerSourceId:o.sourceId})}return validateSelectedCandidateDependencies(r),{composition:{entries:Object.freeze(i)},selected:r}}function disableComposedCandidate(e){let t=canonicalSourceSlot(e.candidate.logicalPath),n=new Map(e.composed.selected);if(n.get(t)?.sourceId!==e.candidate.sourceId)throw Error(`Only the selected source for "${t}" can disable that slot.`);if(!e.composed.composition.entries.some(t=>t.kind===`shadowed`&&t.winnerSourceId===e.candidate.sourceId)&&e.allowUnmatched!==!0)throw Error(`Source "${e.candidate.logicalPath}" disables a slot with no lower-precedence source.`);return n.delete(t),{composition:{entries:Object.freeze([...e.composed.composition.entries,{kind:`disabled`,source:describeAgentSourceCandidate(e.candidate)}])},selected:n}}function createAgentModuleBinding(e){return Object.freeze({backing:e.backing,logicalPath:e.logicalPath,owner:e.owner})}async function loadProgrammaticModuleNamespace(e){let t=e.registries.map(t=>t.sources.get(e.backing.registryId)).filter(e=>e!==void 0);if(t.length!==1)throw Error(`Expected exactly one registered programmatic source "${e.backing.registryId}", found ${t.length}.`);let n=t[0];if(n.revision!==e.backing.revision)throw Error(`Programmatic source "${n.id}" revision mismatch: artifact requires "${e.backing.revision}", registry provides "${n.revision}".`);let r=n.modules.find(t=>t.logicalPath===e.backing.moduleId);if(r===void 0)throw Error(`Programmatic source "${n.id}" does not register module "${e.backing.moduleId}".`);if(r.semanticRevision!==e.backing.semanticRevision)throw Error(`Programmatic module "${n.id}:${r.logicalPath}" semantic revision does not match the compiled binding.`);let i=Object.fromEntries(Object.entries(e.backing.dependencies??{}).map(([t,i])=>{let a=e.dependencyNamespaces?.[t];if(a===void 0)throw Error(`Programmatic module "${n.id}:${r.logicalPath}" requires unresolved binding "${i}" as dependency "${t}".`);return[t,a]})),a=await r.loadNamespace({dependencies:Object.freeze(i),parameters:Object.freeze(e.backing.parameters??{})});if(typeof a!=`object`||!a)throw Error(`Programmatic module "${n.id}:${r.logicalPath}" loader must return a module namespace object.`);return a}function canonicalSourceSlot(e){let t=normalizeLogicalPath(e);if(t.length===0||t===`.`||t.startsWith(`../`)||t.includes(`/../`)||posix.normalize(t)!==t)throw Error(`Agent source logical path "${e}" is invalid.`);let n=stripLogicalPathExtension(t),r=n.match(/^connections\/([^/]+)\/connection$/);if(r!==null)return`connections/${r[1]}`;if(n===`sandbox/sandbox`)return`sandbox`;let i=n.match(/^skills\/([^/]+)\/SKILL$/);return i===null?n:`skills/${i[1]}`}function describeAgentSourceCandidate(e){return Object.freeze({backing:e.backing,form:e.form,layer:e.layer,logicalPath:e.logicalPath,owner:e.owner,sourceId:e.sourceId})}function validateSelectedCandidateDependencies(e){let t=new Set([...e.values()].map(e=>e.sourceId));for(let n of e.values())if(n.backing.kind===`programmatic`){for(let e of Object.values(n.backing.dependencies??{}))if(!t.has(e))throw Error(`Derived programmatic source "${n.sourceId}" depends on unselected source "${e}".`)}}function expectNonEmpty(e,t){if(e.trim().length===0)throw Error(`${t} must be non-empty.`);return e}export{bindingMountId,canonicalSourceSlot,composeAgentModuleCandidates,createAgentModuleBinding,createAgentSourceRegistry,createProgrammaticModuleCandidates,defineProgrammaticAgentSource,defineProgrammaticExtensionMountDeclaration,describeAgentSourceCandidate,disableComposedCandidate,extensionMountId,instantiateProgrammaticTemplate,isAgentModuleCandidate,loadProgrammaticModuleNamespace,memoizeModuleNamespaceFactories,validateProgrammaticLogicalPath};
+import{posix}from"node:path";import{normalizeLogicalPath,stripLogicalPathExtension}from"#discover/filesystem.js";import{parseJsonObject}from"#shared/json.js";import{validateProgrammaticLogicalPath,validateProgrammaticLogicalPath as validateProgrammaticLogicalPath$1,validateProgrammaticLogicalPathInternal}from"#compiler/source-graph-paths.js";function memoizeModuleNamespaceFactories(e){return Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>{if(typeof t!=`function`)return[e,t];let n;return[e,new Proxy(t,{apply(e,t,r){return r.length>0?Reflect.apply(e,t,r):(n??=Promise.resolve().then(()=>Reflect.apply(e,t,r)),n)}})]})))}var ImmutableProgrammaticSourceMap=class{#e;constructor(e){this.#e=new Map(e),Object.freeze(this)}get size(){return this.#e.size}get[Symbol.toStringTag](){return`ImmutableProgrammaticSourceMap`}[Symbol.iterator](){return this.#e[Symbol.iterator]()}entries(){return this.#e.entries()}forEach(e,t){this.#e.forEach((n,r)=>e.call(t,n,r,this))}get(e){return this.#e.get(e)}has(e){return this.#e.has(e)}keys(){return this.#e.keys()}values(){return this.#e.values()}};function extensionMountId(e,t){return posix.join(e,`extensions`,t)}function isAgentModuleCandidate(e){return e.backing.kind!==`resource`}const LAYER_PRECEDENCE={"framework-default":0,"extension-package":1,"extension-override":2,application:3},FORM_PRECEDENCE={derived:0,direct:1},registeredProgrammaticTemplates=new WeakSet;function defineProgrammaticAgentSource(e){return defineProgrammaticAgentSourceInternal(e,!1)}function defineProgrammaticAgentSourceInternal(e,t){let n=expectNonEmpty(e.id,`Programmatic agent source id`),r=expectNonEmpty(e.revision,`Programmatic agent source "${n}" revision`),i=new Set,a=e.modules.map(e=>{let r=validateProgrammaticLogicalPathInternal(e.logicalPath,t);if(i.has(r))throw Error(`Programmatic agent source "${n}" declares "${r}" more than once.`);i.add(r);let a=e.semanticRevision===void 0?void 0:expectNonEmpty(e.semanticRevision,`Programmatic module "${n}:${r}" semanticRevision`);return Object.freeze({exportName:e.exportName,loadNamespace:e.loadNamespace,logicalPath:r,semanticRevision:a})});return Object.freeze({id:n,modules:Object.freeze(a),revision:r})}function defineProgrammaticExtensionMountDeclaration(e){return defineProgrammaticAgentSourceInternal(e,!0)}function createAgentSourceRegistry(e,t={}){let n=new Map,r=new Map,addSource=(e,t=!1)=>{let r=defineProgrammaticAgentSourceInternal(e,t);if(n.has(r.id))throw Error(`Programmatic agent source id "${r.id}" is registered more than once.`);return n.set(r.id,r),r},i=e.map(e=>{let t=addSource(e.source);return Object.freeze({applyTo:e.applyTo,source:t})});for(let e of t.extensionDeclarations??[])addSource(e,!0);for(let e of t.templates??[]){let t=addSource(e);if(t.modules.length!==1)throw Error(`Programmatic template source "${t.id}" must register exactly one module.`);let n=Object.freeze({module:t.modules[0],source:t});registeredProgrammaticTemplates.add(n),r.set(t.id,n)}return Object.freeze({registrations:Object.freeze(i),sources:new ImmutableProgrammaticSourceMap(n),templates:new ImmutableProgrammaticSourceMap(r)})}function createProgrammaticModuleCandidates(e){return e.registration.source.modules.map(t=>{let n=`${e.registration.source.id}:${t.logicalPath}`;return Object.freeze({backing:Object.freeze({kind:`programmatic`,moduleId:t.logicalPath,registryId:e.registration.source.id,revision:e.registration.source.revision,semanticRevision:t.semanticRevision}),exportName:t.exportName,form:`direct`,layer:e.layer,logicalPath:t.logicalPath,nodeId:e.nodeId,owner:e.owner,sourceId:n})})}function instantiateProgrammaticTemplate(e){if(!registeredProgrammaticTemplates.has(e.template))throw Error(`Derived programmatic modules require a registered template.`);let t=validateProgrammaticLogicalPath$1(e.logicalPath),n=expectNonEmpty(e.anchor.sourceId,`Derived programmatic module anchor source id`),r=`${e.template.source.id}:${t}:from:${n}`;if(!Object.values(e.dependencies).some(e=>e.sourceId===n))throw Error(`Derived programmatic module "${r}" must include its anchor source as a dependency.`);let i=Object.freeze(Object.fromEntries(Object.entries(e.dependencies).sort(([e],[t])=>e.localeCompare(t)).map(([t,n])=>{if(expectNonEmpty(t,`Derived programmatic module dependency alias`),n.nodeId!==e.anchor.nodeId)throw Error(`Derived programmatic module "${r}" cannot depend on source "${n.sourceId}" from another node.`);return[t,n.sourceId]}))),a=Object.freeze(parseJsonObject(e.parameters??{}));return Object.freeze({backing:Object.freeze({dependencies:i,kind:`programmatic`,moduleId:e.template.module.logicalPath,parameters:a,registryId:e.template.source.id,revision:e.template.source.revision,semanticRevision:e.template.module.semanticRevision}),exportName:e.template.module.exportName,form:`derived`,layer:e.anchor.layer,logicalPath:t,nodeId:e.anchor.nodeId,owner:e.owner,sourceId:r})}function composeAgentModuleCandidates(e){let t=new Map,n=new Set;for(let r of e){if(n.has(r.sourceId))throw Error(`Agent source id "${r.sourceId}" is declared more than once in node "${r.nodeId}".`);n.add(r.sourceId);let e=canonicalSourceSlot(r.logicalPath),i=t.get(e)??[];i.push(r),t.set(e,i)}let r=new Map,i=[];for(let[e,n]of[...t].sort(([e],[t])=>e.localeCompare(t))){let t=new Set;for(let r of n){let n=`${r.layer}:${r.form}`;if(t.has(n))throw Error(`Agent source slot "${e}" has more than one ${r.layer} ${r.form} candidate.`);t.add(n)}let a=[...n].sort((e,t)=>LAYER_PRECEDENCE[t.layer]-LAYER_PRECEDENCE[e.layer]||FORM_PRECEDENCE[t.form]-FORM_PRECEDENCE[e.form]),o=a[0];r.set(e,o);for(let e of a.slice(1))i.push({kind:`shadowed`,source:describeAgentSourceCandidate(e),winnerSourceId:o.sourceId})}return validateSelectedCandidateDependencies(r),{composition:{entries:Object.freeze(i)},selected:r}}function disableComposedCandidate(e){let t=canonicalSourceSlot(e.candidate.logicalPath),n=new Map(e.composed.selected);if(n.get(t)?.sourceId!==e.candidate.sourceId)throw Error(`Only the selected source for "${t}" can disable that slot.`);if(!e.composed.composition.entries.some(t=>t.kind===`shadowed`&&t.winnerSourceId===e.candidate.sourceId)&&e.allowUnmatched!==!0)throw Error(`Source "${e.candidate.logicalPath}" disables a slot with no lower-precedence source.`);return n.delete(t),{composition:{entries:Object.freeze([...e.composed.composition.entries,{kind:`disabled`,source:describeAgentSourceCandidate(e.candidate)}])},selected:n}}function createAgentModuleBinding(e){return Object.freeze({backing:e.backing,logicalPath:e.logicalPath,owner:e.owner})}async function loadProgrammaticModuleNamespace(e){let t=e.registries.map(t=>t.sources.get(e.backing.registryId)).filter(e=>e!==void 0);if(t.length!==1)throw Error(`Expected exactly one registered programmatic source "${e.backing.registryId}", found ${t.length}.`);let n=t[0];if(n.revision!==e.backing.revision)throw Error(`Programmatic source "${n.id}" revision mismatch: artifact requires "${e.backing.revision}", registry provides "${n.revision}".`);let r=n.modules.find(t=>t.logicalPath===e.backing.moduleId);if(r===void 0)throw Error(`Programmatic source "${n.id}" does not register module "${e.backing.moduleId}".`);if(r.semanticRevision!==e.backing.semanticRevision)throw Error(`Programmatic module "${n.id}:${r.logicalPath}" semantic revision does not match the compiled binding.`);let i=Object.fromEntries(Object.entries(e.backing.dependencies??{}).map(([t,i])=>{let a=e.dependencyNamespaces?.[t];if(a===void 0)throw Error(`Programmatic module "${n.id}:${r.logicalPath}" requires unresolved binding "${i}" as dependency "${t}".`);return[t,a]})),a=await r.loadNamespace({dependencies:Object.freeze(i),parameters:Object.freeze(e.backing.parameters??{})});if(typeof a!=`object`||!a)throw Error(`Programmatic module "${n.id}:${r.logicalPath}" loader must return a module namespace object.`);return a}function canonicalSourceSlot(e){let t=normalizeLogicalPath(e);if(t.length===0||t===`.`||t.startsWith(`../`)||t.includes(`/../`)||posix.normalize(t)!==t)throw Error(`Agent source logical path "${e}" is invalid.`);let n=stripLogicalPathExtension(t),r=n.match(/^connections\/([^/]+)\/connection$/);if(r!==null)return`connections/${r[1]}`;if(n===`sandbox/sandbox`)return`sandbox`;let i=n.match(/^skills\/([^/]+)\/SKILL$/);return i===null?n:`skills/${i[1]}`}function describeAgentSourceCandidate(e){return Object.freeze({backing:e.backing,form:e.form,layer:e.layer,logicalPath:e.logicalPath,owner:e.owner,sourceId:e.sourceId})}function validateSelectedCandidateDependencies(e){let t=new Set([...e.values()].map(e=>e.sourceId));for(let n of e.values())if(n.backing.kind===`programmatic`){for(let e of Object.values(n.backing.dependencies??{}))if(!t.has(e))throw Error(`Derived programmatic source "${n.sourceId}" depends on unselected source "${e}".`)}}function expectNonEmpty(e,t){if(e.trim().length===0)throw Error(`${t} must be non-empty.`);return e}export{canonicalSourceSlot,composeAgentModuleCandidates,createAgentModuleBinding,createAgentSourceRegistry,createProgrammaticModuleCandidates,defineProgrammaticAgentSource,defineProgrammaticExtensionMountDeclaration,describeAgentSourceCandidate,disableComposedCandidate,extensionMountId,instantiateProgrammaticTemplate,isAgentModuleCandidate,loadProgrammaticModuleNamespace,memoizeModuleNamespaceFactories,validateProgrammaticLogicalPath};

package/dist/src/computer-use/extension/lib/computer-use-sandbox.js

@@ -1,5 +1,5 @@
 import{commandFailureDetail}from"./command-failure.js";import{COMPUTER_USE_DRIVER_SOURCES}from"./computer-use-driver-source.js";import{shellQuote}from"./shell.js";import{computerUseDisplayCommand,computerUseDriverStartCommand,computerUsePaths,computerUseReadyCommand}from"./computer-use.js";const COMPUTER_USE_REVALIDATION_KEY=`computer-use:0.12.5:2026-09-17.1`;async function installComputerUse(e){let t=computerUsePaths(e),n=e.resolvePath(`.eve-code/install-computer-use.sh`);await e.run({command:`mkdir -p ${shellQuote(t.driverRoot)}`}),await Promise.all([...Object.entries(COMPUTER_USE_DRIVER_SOURCES).map(([n,r])=>e.writeTextFile({path:`${t.driverRoot}/${n}`,content:r})),e.writeTextFile({path:n,content:computerUseInstallScript(e)})]);let r=await e.run({command:[`set -e`,`if [ "$(id -u)" = 0 ]; then`,`  bash ${shellQuote(n)}`,`elif command -v sudo >/dev/null 2>&1; then`,`  sudo -n bash ${shellQuote(n)}`,`else`,`  echo 'computer-use requires an apt-based sandbox image with root or passwordless sudo' >&2`,`  exit 1`,`fi`].join(`
-`)});if(r.exitCode!==0)throw Error(`computer-use installation failed (exit ${r.exitCode}): ${commandFailureDetail(r)}`)}async function startComputerUse(e){let t={TERM:`xterm-256color`},n=await e.run({command:computerUseDisplayCommand(e),env:t});if(n.exitCode!==0)throw Error(`computer-use display startup failed (exit ${n.exitCode}): ${commandFailureDetail(n)}`);let r=await e.run({command:computerUseDriverStartCommand(e),env:t});if(r.exitCode!==0)throw Error(`computer-use driver startup failed (exit ${r.exitCode}): ${commandFailureDetail(r)}`)}async function ensureComputerUse(e,t){(await e.run({command:computerUseReadyCommand(e),abortSignal:t})).exitCode!==0&&await startComputerUse(e)}function computerUseInstallScript(e){let t=computerUsePaths(e);return`#!/usr/bin/env bash
+`)});if(r.exitCode!==0)throw Error(`computer-use installation failed (exit ${r.exitCode}): ${commandFailureDetail(r)}`)}async function startComputerUse(e){let t={TERM:`xterm-256color`},n=await e.run({command:computerUseDisplayCommand(e),env:t});if(n.exitCode!==0)throw Error(`computer-use display startup failed (exit ${n.exitCode}): ${commandFailureDetail(n)}`);let r=await e.run({command:computerUseDriverStartCommand(e),env:t});if(r.exitCode!==0)throw Error(`computer-use driver startup failed (exit ${r.exitCode}): ${commandFailureDetail(r)}`)}async function ensureComputerUse(e,t){(await e.run({command:computerUseReadyCommand(e),signal:t})).exitCode!==0&&await startComputerUse(e)}function computerUseInstallScript(e){let t=computerUsePaths(e);return`#!/usr/bin/env bash
 set -euo pipefail
 
 command -v apt-get >/dev/null || {

package/dist/src/computer-use/extension/lib/sandbox.d.ts

@@ -1 +1 @@
-export { COMPUTER_USE_REVALIDATION_KEY, installComputerUse, startComputerUse, } from "./computer-use-sandbox.ts";
+export { installComputerUse, startComputerUse } from "./computer-use-sandbox.ts";

package/dist/src/computer-use/extension/lib/sandbox.js

@@ -1 +1 @@
-import{COMPUTER_USE_REVALIDATION_KEY,installComputerUse,startComputerUse}from"./computer-use-sandbox.js";export{COMPUTER_USE_REVALIDATION_KEY,installComputerUse,startComputerUse};
+import{installComputerUse,startComputerUse}from"./computer-use-sandbox.js";export{installComputerUse,startComputerUse};

package/dist/src/computer-use/extension/tools/computer_use.js

@@ -1 +1 @@
-import{computerUseDesktopSizeCommand,computerUseDriverCommand,computerUseDriverRequest,computerUseFocusCommand,computerUseLaunchCommand,computerUsePaths,computerUseWindowLayoutCommand,recordingPath,screenshotPath}from"../lib/computer-use.js";import{ensureComputerUse}from"../lib/computer-use-sandbox.js";import{z}from"#compiled/zod/index.js";import{defineTool}from"eve/tools";import{never}from"eve/tools/approval";const coordinate=z.number().int().min(0),screenshotFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.png$/u),recordingFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.mp4$/u),key=z.string().regex(/^[A-Za-z0-9_.-]+$/u),browserUrl=z.string().url().refine(isHttpUrl,{message:`browser URL must use HTTP or HTTPS`}),button=z.enum([`left`,`middle`,`wheel`,`right`,`back`,`forward`]).default(`left`),modifierKeys=z.array(key).min(1).max(4).optional();function typeActionShape(e){return{action:z.literal(`type`),text:z.string().min(1).max(e),typingDelayMs:z.number().int().min(0).max(200).optional(),typingStyle:z.literal(`natural`).optional()}}const typingStyleRefinement=[e=>e.typingDelayMs===void 0||e.typingStyle===void 0,{message:`type action cannot set both typingDelayMs and typingStyle`}],sequenceTypeActionSchema=z.object(typeActionShape(2e3)).refine(...typingStyleRefinement),typeActionSchema=z.object(typeActionShape(1e4)).refine(...typingStyleRefinement),movementStyle=z.enum([`natural`,`precision`]).optional(),pointerDurationMs=z.number().int().min(0).max(2e3).optional().describe(`optional cursor travel duration for recorded demos; use about 600ms`),precisionMovementStyle=z.literal(`precision`).optional(),dragPoint=z.object({x:coordinate.max(1919),y:coordinate.max(1079)}),windowSelectorSchema=z.discriminatedUnion(`app`,[z.object({app:z.literal(`firefox`)}),z.object({app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`])})]),windowRegionSchema=z.object({x:z.number().min(0).max(1),y:z.number().min(0).max(1),width:z.number().positive().max(1),height:z.number().positive().max(1)}).refine(e=>e.x+e.width<=1&&e.y+e.height<=1,{message:`window region must fit within the desktop`}),arrangeWindowsSchema=z.object({action:z.literal(`arrange_windows`),windows:z.array(z.object({selector:windowSelectorSchema,region:windowRegionSchema})).min(1).max(4),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),sequenceActionSchema=z.discriminatedUnion(`action`,[z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),durationMs:pointerDurationMs,movementStyle}),sequenceTypeActionSchema,z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4)}),arrangeWindowsSchema,z.object({action:z.literal(`record_start`),path:recordingFileName}),z.object({action:z.literal(`record_stop`)})]),driverResponseSchema=z.object({backend:z.literal(`cua-driver`),screenshot:z.string(),state:z.string(),action:z.unknown().optional(),version:z.literal(`0.12.5`)}).passthrough(),inputSchema=z.union([z.union([z.object({action:z.literal(`set_desktop_size`),size:z.enum([`full_hd`,`large_16_9`,`social_16_9`])}),z.object({action:z.literal(`launch`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`focus`),app:z.literal(`firefox`)}),z.object({action:z.literal(`focus`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`arrange_pair`),pair:z.enum([`terminal_browser`,`terminal_terminal`]),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),arrangeWindowsSchema,z.object({action:z.literal(`window_layout`),app:z.literal(`desktop`),layout:z.enum([`maximized`,`left`,`right`])}),z.object({action:z.literal(`launch`),app:z.literal(`firefox`),url:browserUrl.optional()})]),z.discriminatedUnion(`action`,[z.object({action:z.literal(`screenshot`),path:screenshotFileName.optional()}),z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),keys:modifierKeys,movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`scroll`),x:coordinate.max(1919),y:coordinate.max(1079),scroll_x:z.number().finite().min(-1e4).max(1e4),scroll_y:z.number().finite().min(-1e4).max(1e4),keys:modifierKeys}),typeActionSchema,z.object({action:z.literal(`clipboard_read`),selection:z.enum([`clipboard`,`primary`])}),z.object({action:z.literal(`clipboard_write`),selection:z.enum([`clipboard`,`primary`]),text:z.string().max(1e4)}),z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4).optional().default(2e3)}),z.object({action:z.literal(`record_start`),path:recordingFileName.optional()}),z.object({action:z.literal(`record_stop`)}),z.object({action:z.literal(`sequence`),actions:z.array(sequenceActionSchema).min(1).max(30)})])]);var computer_use_default=defineTool({description:`Pass the selected action inside request, for example {request:{action:"screenshot"}}. Execute an OpenAI computer-use action against the isolated X11 desktop. Use set_desktop_size before launching managed windows to select full_hd (1920x1080), large_16_9 (1600x900), or social_16_9 (1280x720); smaller desktops make fixed-size UI and terminal text occupy more of the recording. Each action runs through Cua Driver and returns a fresh screenshot path plus the foreground application grounding window, pointer position, and bounded accessibility elements with screen coordinates. Actions execute without a human approval prompt. Use those coordinates for the next action. Use launch with app firefox and an optional HTTP(S) URL for the browser. Use launch with app xterm and instance primary or secondary for up to two managed terminals. Use focus to activate an existing app without changing its geometry. Use arrange_pair for common 50/50 terminal/browser or two-terminal layouts. Use arrange_windows for custom one-to-four-window scenes with proportional regions; it resolves every managed selector before moving any window, rejects overlap and unreadable geometry, waits boundedly for newly opened windows, and verifies the applied scene. Use window_layout with app desktop only for a single active window. Do not launch either application through a shell command. The action shape follows the OpenAI computer tool: screenshot, click, double_click, triple_click, drag, keypress, move, scroll, type, clipboard_read, clipboard_write, and wait, plus constrained layout, launch, and recording lifecycle actions. arrange_windows is available inside sequence for a deterministic mid-demo transition after an interaction opens Firefox. Use sequence for a rehearsed recording so up to 30 actions execute in one sandbox round trip with only one final screenshot. Pointer movement remains direct when movementStyle is omitted, preserving faithful exploratory and bug-repro interaction. For polished recordings, explicitly use movementStyle natural for confident curved moves/clicks and precision for drags; precision approaches the drag start naturally, pauses briefly around mouse-down, makes one subtle undershoot and exact correction while held, then pauses before mouse-up. Natural duration is distance-based and deliberately brisk; durationMs can override styled moves, clicks, and drags when exact timing matters. Recording actions return the sandbox path of the MP4 file; recordings stop automatically after five minutes. Requests have a two-minute deadline including queue time. Typing is limited to 10000 characters total per request; paced typing additionally allows at most 1000 graphemes and 30000ms of planned delay across the whole sequence. Omit typingStyle and typingDelayMs for longer text. Paced typing timings retain only the final driver result and grapheme count.`,inputSchema:z.object({request:inputSchema}),approval:never(),async execute({request:e},t){let n=await t.getSandbox();if(`keys`in e&&e.action!==`keypress`&&e.keys?.length)throw Error(`computer-use pointer action modifiers are not supported`);e.action===`sequence`&&validateSequenceBudget(e.actions),await ensureComputerUse(n,t.abortSignal);let r=e.action===`arrange_pair`?arrangePairAction(e.pair,e.waitForMs):e.action===`sequence`?{...e,actions:e.actions.map(e=>e.action===`record_start`?{...e,path:recordingPath(n,e.path)}:e)}:e.action===`record_start`?{...e,path:recordingPath(n,e.path??`recording-${crypto.randomUUID()}.mp4`)}:e.action===`scroll`?{...e,scrollX:e.scroll_x,scrollY:e.scroll_y}:e;if(r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`){let i=await n.run({command:r.action===`set_desktop_size`?computerUseDesktopSizeCommand(n,r.size):r.action===`launch`?computerUseLaunchCommand(n,r):r.action===`focus`?computerUseFocusCommand(n,r.app,r.app===`xterm`?r.instance:void 0):computerUseWindowLayoutCommand(n,r.layout),abortSignal:t.abortSignal});ensureSuccess(e.action,i)}let i=r.action===`screenshot`?screenshotPath(n,r.path):screenshotPath(n),a=r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`?{action:`screenshot`}:r,o=await callComputerUseDriver(n,computerUseDriverRequest(a,i),t.abortSignal);if(o.screenshot!==i)throw Error(`computer-use driver returned an unexpected screenshot path`);let s={action:e.action,backend:o.backend,path:r.action===`screenshot`?i:r.action===`record_start`?r.path:r.action===`sequence`?r.actions.find(e=>e.action===`record_start`)?.path??null:null,screenshot:i,state:o.state,version:o.version};return(e.action===`clipboard_read`||e.action===`clipboard_write`)&&(s.result=o.action),r.action===`sequence`&&(s.timings=o.action),s}});async function callComputerUseDriver(e,t,n){let r=await e.run({command:computerUseDriverCommand(e),env:{COMPUTER_USE_REQUEST:JSON.stringify(t),COMPUTER_USE_SOCKET_PATH:computerUsePaths(e).driverSocket},abortSignal:n});ensureSuccess(t.action.action,r);try{return driverResponseSchema.parse(JSON.parse(r.stdout))}catch(e){throw Error(`computer-use driver returned an invalid response`,{cause:e})}}function arrangePairAction(e,t){return{action:`arrange_windows`,waitForMs:t,windows:[{selector:e===`terminal_browser`?{app:`firefox`}:{app:`xterm`,instance:`primary`},region:{x:0,y:0,width:.5,height:1}},{selector:e===`terminal_browser`?{app:`xterm`,instance:`primary`}:{app:`xterm`,instance:`secondary`},region:{x:.5,y:0,width:.5,height:1}}]}}function validateSequenceBudget(e){let t=e.reduce((e,t)=>e+(t.action===`type`?t.text.length:0),0),n=e.flatMap((e,t)=>e.action===`record_start`?[t]:[]),r=e.flatMap((e,t)=>e.action===`record_stop`?[t]:[]),i=n.length,a=r.length;if(t>1e4)throw Error(`computer-use sequence may type at most 10000 characters`);if(i>1||a>1)throw Error(`computer-use sequence may record at most one take`);if(i===0!=(a===0))throw Error(`computer-use recording sequence requires one start and one stop`);if(i===1&&(n[0]!==0||r[0]!==e.length-1))throw Error(`computer-use recording sequence must start first and stop last`)}function ensureSuccess(e,t){if(t.exitCode!==0)throw Error(`computer ${e} failed (exit ${t.exitCode}): ${t.stderr}`)}function isHttpUrl(e){if(!URL.canParse(e))return!1;let t=new URL(e).protocol;return t===`http:`||t===`https:`}export{computer_use_default as default};
+import{computerUseDesktopSizeCommand,computerUseDriverCommand,computerUseDriverRequest,computerUseFocusCommand,computerUseLaunchCommand,computerUsePaths,computerUseWindowLayoutCommand,recordingPath,screenshotPath}from"../lib/computer-use.js";import{ensureComputerUse}from"../lib/computer-use-sandbox.js";import{z}from"#compiled/zod/index.js";import{defineTool}from"eve/tools";import{never}from"eve/tools/approval";const coordinate=z.number().int().min(0),screenshotFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.png$/u),recordingFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.mp4$/u),key=z.string().regex(/^[A-Za-z0-9_.-]+$/u),browserUrl=z.string().url().refine(isHttpUrl,{message:`browser URL must use HTTP or HTTPS`}),button=z.enum([`left`,`middle`,`wheel`,`right`,`back`,`forward`]).default(`left`),modifierKeys=z.array(key).min(1).max(4).optional();function typeActionShape(e){return{action:z.literal(`type`),text:z.string().min(1).max(e),typingDelayMs:z.number().int().min(0).max(200).optional(),typingStyle:z.literal(`natural`).optional()}}const typingStyleRefinement=[e=>e.typingDelayMs===void 0||e.typingStyle===void 0,{message:`type action cannot set both typingDelayMs and typingStyle`}],sequenceTypeActionSchema=z.object(typeActionShape(2e3)).refine(...typingStyleRefinement),typeActionSchema=z.object(typeActionShape(1e4)).refine(...typingStyleRefinement),movementStyle=z.enum([`natural`,`precision`]).optional(),pointerDurationMs=z.number().int().min(0).max(2e3).optional().describe(`optional cursor travel duration for recorded demos; use about 600ms`),precisionMovementStyle=z.literal(`precision`).optional(),dragPoint=z.object({x:coordinate.max(1919),y:coordinate.max(1079)}),windowSelectorSchema=z.discriminatedUnion(`app`,[z.object({app:z.literal(`firefox`)}),z.object({app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`])})]),windowRegionSchema=z.object({x:z.number().min(0).max(1),y:z.number().min(0).max(1),width:z.number().positive().max(1),height:z.number().positive().max(1)}).refine(e=>e.x+e.width<=1&&e.y+e.height<=1,{message:`window region must fit within the desktop`}),arrangeWindowsSchema=z.object({action:z.literal(`arrange_windows`),windows:z.array(z.object({selector:windowSelectorSchema,region:windowRegionSchema})).min(1).max(4),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),sequenceActionSchema=z.discriminatedUnion(`action`,[z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),durationMs:pointerDurationMs,movementStyle}),sequenceTypeActionSchema,z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4)}),arrangeWindowsSchema,z.object({action:z.literal(`record_start`),path:recordingFileName}),z.object({action:z.literal(`record_stop`)})]),driverResponseSchema=z.object({backend:z.literal(`cua-driver`),screenshot:z.string(),state:z.string(),action:z.unknown().optional(),version:z.literal(`0.12.5`)}).passthrough(),inputSchema=z.union([z.union([z.object({action:z.literal(`set_desktop_size`),size:z.enum([`full_hd`,`large_16_9`,`social_16_9`])}),z.object({action:z.literal(`launch`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`focus`),app:z.literal(`firefox`)}),z.object({action:z.literal(`focus`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`arrange_pair`),pair:z.enum([`terminal_browser`,`terminal_terminal`]),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),arrangeWindowsSchema,z.object({action:z.literal(`window_layout`),app:z.literal(`desktop`),layout:z.enum([`maximized`,`left`,`right`])}),z.object({action:z.literal(`launch`),app:z.literal(`firefox`),url:browserUrl.optional()})]),z.discriminatedUnion(`action`,[z.object({action:z.literal(`screenshot`),path:screenshotFileName.optional()}),z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),keys:modifierKeys,movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`scroll`),x:coordinate.max(1919),y:coordinate.max(1079),scroll_x:z.number().finite().min(-1e4).max(1e4),scroll_y:z.number().finite().min(-1e4).max(1e4),keys:modifierKeys}),typeActionSchema,z.object({action:z.literal(`clipboard_read`),selection:z.enum([`clipboard`,`primary`])}),z.object({action:z.literal(`clipboard_write`),selection:z.enum([`clipboard`,`primary`]),text:z.string().max(1e4)}),z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4).optional().default(2e3)}),z.object({action:z.literal(`record_start`),path:recordingFileName.optional()}),z.object({action:z.literal(`record_stop`)}),z.object({action:z.literal(`sequence`),actions:z.array(sequenceActionSchema).min(1).max(30)})])]);var computer_use_default=defineTool({description:`Pass the selected action inside request, for example {request:{action:"screenshot"}}. Execute an OpenAI computer-use action against the isolated X11 desktop. Use set_desktop_size before launching managed windows to select full_hd (1920x1080), large_16_9 (1600x900), or social_16_9 (1280x720); smaller desktops make fixed-size UI and terminal text occupy more of the recording. Each action runs through Cua Driver and returns a fresh screenshot path plus the foreground application grounding window, pointer position, and bounded accessibility elements with screen coordinates. Actions execute without a human approval prompt. Use those coordinates for the next action. Use launch with app firefox and an optional HTTP(S) URL for the browser. Use launch with app xterm and instance primary or secondary for up to two managed terminals. Use focus to activate an existing app without changing its geometry. Use arrange_pair for common 50/50 terminal/browser or two-terminal layouts. Use arrange_windows for custom one-to-four-window scenes with proportional regions; it resolves every managed selector before moving any window, rejects overlap and unreadable geometry, waits boundedly for newly opened windows, and verifies the applied scene. Use window_layout with app desktop only for a single active window. Do not launch either application through a shell command. The action shape follows the OpenAI computer tool: screenshot, click, double_click, triple_click, drag, keypress, move, scroll, type, clipboard_read, clipboard_write, and wait, plus constrained layout, launch, and recording lifecycle actions. arrange_windows is available inside sequence for a deterministic mid-demo transition after an interaction opens Firefox. Use sequence for a rehearsed recording so up to 30 actions execute in one sandbox round trip with only one final screenshot. Pointer movement remains direct when movementStyle is omitted, preserving faithful exploratory and bug-repro interaction. For polished recordings, explicitly use movementStyle natural for confident curved moves/clicks and precision for drags; precision approaches the drag start naturally, pauses briefly around mouse-down, makes one subtle undershoot and exact correction while held, then pauses before mouse-up. Natural duration is distance-based and deliberately brisk; durationMs can override styled moves, clicks, and drags when exact timing matters. Recording actions return the sandbox path of the MP4 file; recordings stop automatically after five minutes. Requests have a two-minute deadline including queue time. Typing is limited to 10000 characters total per request; paced typing additionally allows at most 1000 graphemes and 30000ms of planned delay across the whole sequence. Omit typingStyle and typingDelayMs for longer text. Paced typing timings retain only the final driver result and grapheme count.`,inputSchema:z.object({request:inputSchema}),approval:never(),async execute({request:e},t){let n=await t.getSandbox();if(`keys`in e&&e.action!==`keypress`&&e.keys?.length)throw Error(`computer-use pointer action modifiers are not supported`);e.action===`sequence`&&validateSequenceBudget(e.actions),await ensureComputerUse(n,t.abortSignal);let r=e.action===`arrange_pair`?arrangePairAction(e.pair,e.waitForMs):e.action===`sequence`?{...e,actions:e.actions.map(e=>e.action===`record_start`?{...e,path:recordingPath(n,e.path)}:e)}:e.action===`record_start`?{...e,path:recordingPath(n,e.path??`recording-${crypto.randomUUID()}.mp4`)}:e.action===`scroll`?{...e,scrollX:e.scroll_x,scrollY:e.scroll_y}:e;if(r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`){let i=await n.run({command:r.action===`set_desktop_size`?computerUseDesktopSizeCommand(n,r.size):r.action===`launch`?computerUseLaunchCommand(n,r):r.action===`focus`?computerUseFocusCommand(n,r.app,r.app===`xterm`?r.instance:void 0):computerUseWindowLayoutCommand(n,r.layout),signal:t.abortSignal});ensureSuccess(e.action,i)}let i=r.action===`screenshot`?screenshotPath(n,r.path):screenshotPath(n),a=r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`?{action:`screenshot`}:r,o=await callComputerUseDriver(n,computerUseDriverRequest(a,i),t.abortSignal);if(o.screenshot!==i)throw Error(`computer-use driver returned an unexpected screenshot path`);let s={action:e.action,backend:o.backend,path:r.action===`screenshot`?i:r.action===`record_start`?r.path:r.action===`sequence`?r.actions.find(e=>e.action===`record_start`)?.path??null:null,screenshot:i,state:o.state,version:o.version};return(e.action===`clipboard_read`||e.action===`clipboard_write`)&&(s.result=o.action),r.action===`sequence`&&(s.timings=o.action),s}});async function callComputerUseDriver(e,t,n){let r=await e.run({command:computerUseDriverCommand(e),env:{COMPUTER_USE_REQUEST:JSON.stringify(t),COMPUTER_USE_SOCKET_PATH:computerUsePaths(e).driverSocket},signal:n});ensureSuccess(t.action.action,r);try{return driverResponseSchema.parse(JSON.parse(r.stdout))}catch(e){throw Error(`computer-use driver returned an invalid response`,{cause:e})}}function arrangePairAction(e,t){return{action:`arrange_windows`,waitForMs:t,windows:[{selector:e===`terminal_browser`?{app:`firefox`}:{app:`xterm`,instance:`primary`},region:{x:0,y:0,width:.5,height:1}},{selector:e===`terminal_browser`?{app:`xterm`,instance:`primary`}:{app:`xterm`,instance:`secondary`},region:{x:.5,y:0,width:.5,height:1}}]}}function validateSequenceBudget(e){let t=e.reduce((e,t)=>e+(t.action===`type`?t.text.length:0),0),n=e.flatMap((e,t)=>e.action===`record_start`?[t]:[]),r=e.flatMap((e,t)=>e.action===`record_stop`?[t]:[]),i=n.length,a=r.length;if(t>1e4)throw Error(`computer-use sequence may type at most 10000 characters`);if(i>1||a>1)throw Error(`computer-use sequence may record at most one take`);if(i===0!=(a===0))throw Error(`computer-use recording sequence requires one start and one stop`);if(i===1&&(n[0]!==0||r[0]!==e.length-1))throw Error(`computer-use recording sequence must start first and stop last`)}function ensureSuccess(e,t){if(t.exitCode!==0)throw Error(`computer ${e} failed (exit ${t.exitCode}): ${t.stderr}`)}function isHttpUrl(e){if(!URL.canParse(e))return!1;let t=new URL(e).protocol;return t===`http:`||t===`https:`}export{computer_use_default as default};

package/dist/src/connections/errors.d.ts

@@ -59,7 +59,7 @@ export interface ConnectionAuthorizationFailedErrorOptions {
     /**
      * Stable machine-readable code describing why authorization failed.
      *
-     * The runtime surfaces this code on the `authorization.completed`
+     * The runtime surfaces this code on the sign-in `interaction.settled`
      * stream event and on the failed tool result the model sees. Use a
      * short kebab- or snake-cased string (e.g. `"access_denied"`,
      * `"invalid_grant"`).
@@ -87,9 +87,9 @@ export interface ConnectionAuthorizationFailedErrorOptions {
  * Thrown from a connection's `getToken` when no valid credential is
  * available and authorization must be completed before the connection
  * can be used. Covers both interactive OAuth (the runtime emits
- * `authorization.required` and suspends the turn on a webhook) and
+ * sign-in `interaction.opened` and suspends the turn on a webhook) and
  * non-interactive / out-of-band flows such as static API keys (the
- * runtime emits `authorization.required` without suspending).
+ * runtime emits sign-in `interaction.opened` without suspending).
  */
 export declare class ConnectionAuthorizationRequiredError extends Error {
     readonly connectionName: string;

package/dist/src/context/accessors.d.ts

@@ -6,19 +6,6 @@ export type { Session, SessionAuth, SessionAuthContext, SessionParent, SessionPr
  * @throws When called outside of a managed step execution.
  */
 export declare function getContext<T>(key: ContextKey<T>): T | undefined;
-/**
- * Returns the current value of a context key, throwing when unset.
- *
- * @throws When the key is not set or when called outside of a managed
- *   step execution.
- */
-export declare function requireContext<T>(key: ContextKey<T>): T;
-/**
- * Returns whether the key is currently set in the active context.
- *
- * @throws When called outside of a managed step execution.
- */
-export declare function hasContext<T>(key: ContextKey<T>): boolean;
 /**
  * Sets the durable value of a context key in the active context.
  *

package/dist/src/context/accessors.js

@@ -1 +1 @@
-import{loadContext}from"#context/container.js";function getContext(e){return loadContext().get(e)}function requireContext(e){return loadContext().require(e)}function hasContext(e){return loadContext().has(e)}function setContext(e,t){return loadContext().set(e,t)}function ensureContext(e,t){return loadContext().ensure(e,t)}export{ensureContext,getContext,hasContext,requireContext,setContext};
+import{loadContext}from"#context/container.js";function getContext(e){return loadContext().get(e)}function setContext(e,t){return loadContext().set(e,t)}function ensureContext(e,t){return loadContext().ensure(e,t)}export{ensureContext,getContext,setContext};

package/dist/src/context/container.d.ts

@@ -1,4 +1,3 @@
-import { AsyncLocalStorage } from "node:async_hooks";
 import { type ContextAccessor, type ContextKey } from "#context/key.js";
 import { type LocalDevRequestProvenance } from "#context/keys.js";
 /**
@@ -56,16 +55,14 @@ export declare class ContextContainer implements AlsContext {
     setVirtualContext<T>(key: ContextKey<T>, value: T): void;
     entries(): Generator<readonly [ContextKey<unknown>, unknown]>;
 }
-/**
- * Process-wide AsyncLocalStorage used by every eve module copy in the current
- * runtime.
- *
- * Nitro step bundles can inline parts of eve while authored modules still
- * import `eve/*` from disk. Backing the storage with a global
- * symbol keeps those copies on the same ALS instance so authored tools,
- * model callbacks, and step code observe one unified eve context.
- */
-export declare const contextStorage: AsyncLocalStorage<AlsContext>;
+export declare const contextStorage: {
+    getStore: () => AlsContext | undefined;
+    run: <T>(context: AlsContext, fn: () => T) => T;
+};
+/** Reads branch-local metadata without changing the identity of the active context. */
+export declare function contextScopeValue<T>(key: symbol): T | undefined;
+/** Runs one async branch with metadata on the existing context storage, not another ALS. */
+export declare function withContextScopeValue<T>(key: symbol, value: unknown, fn: () => T): T;
 /**
  * Returns the active context, throwing when called outside a managed scope.
  */

package/dist/src/context/container.js

@@ -1 +1 @@
-import{LocalDevRequestKey}from"#context/keys.js";import{AsyncLocalStorage}from"node:async_hooks";import{resolveKey}from"#context/key.js";const EVE_CONTEXT_STORAGE_KEY=Symbol.for(`eve.context-storage`);var ContextContainer=class{_durableValues=new Map;_virtualValues=new Map;constructor(e){let t=e!==void 0&&Object.hasOwn(e,`localDevRequest`)?e.localDevRequest:contextStorage.getStore()?.localDevRequest;t!==void 0&&this._durableValues.set(LocalDevRequestKey.name,t)}get localDevRequest(){return this.get(LocalDevRequestKey)}get(e){return this._virtualValues.has(e.name)?this._virtualValues.get(e.name):this._durableValues.get(e.name)}require(e){if(!this.has(e))throw Error(`Context key "${e.name}" is not set.`);return this.get(e)}has(e){return this._virtualValues.has(e.name)||this._durableValues.has(e.name)}set(e,t){let n=typeof t==`function`?t(this.get(e)):t;return this._durableValues.set(e.name,n),n}ensure(e,t){return this.has(e)?this.require(e):this.set(e,t())}delete(e){let t=this._durableValues.delete(e.name),n=this._virtualValues.delete(e.name);return t||n}clearVirtualContext(){this._virtualValues.clear()}setVirtualContext(e,t){this._virtualValues.set(e.name,t)}*entries(){for(let[e,t]of this._durableValues){let n=resolveKey(e);n!==void 0&&(yield[n,t])}}};const globalContextStorage=globalThis;globalContextStorage[EVE_CONTEXT_STORAGE_KEY]===void 0&&(globalContextStorage[EVE_CONTEXT_STORAGE_KEY]=new AsyncLocalStorage);const contextStorage=globalContextStorage[EVE_CONTEXT_STORAGE_KEY];function loadContext(){let e=contextStorage.getStore();if(e===void 0)throw Error(`No active eve context. Call this function only from authored runtime code such as tools, steps, and model callbacks.`);return e}export{ContextContainer,contextStorage,loadContext};
+import{LocalDevRequestKey}from"#context/keys.js";import{AsyncLocalStorage}from"node:async_hooks";import{resolveKey}from"#context/key.js";const EVE_CONTEXT_STORAGE_KEY=Symbol.for(`eve.context-storage`);var ContextContainer=class{_durableValues=new Map;_virtualValues=new Map;constructor(e){let t=e!==void 0&&Object.hasOwn(e,`localDevRequest`)?e.localDevRequest:contextStorage.getStore()?.localDevRequest;t!==void 0&&this._durableValues.set(LocalDevRequestKey.name,t)}get localDevRequest(){return this.get(LocalDevRequestKey)}get(e){return this._virtualValues.has(e.name)?this._virtualValues.get(e.name):this._durableValues.get(e.name)}require(e){if(!this.has(e))throw Error(`Context key "${e.name}" is not set.`);return this.get(e)}has(e){return this._virtualValues.has(e.name)||this._durableValues.has(e.name)}set(e,t){let n=typeof t==`function`?t(this.get(e)):t;return this._durableValues.set(e.name,n),n}ensure(e,t){return this.has(e)?this.require(e):this.set(e,t())}delete(e){let t=this._durableValues.delete(e.name),n=this._virtualValues.delete(e.name);return t||n}clearVirtualContext(){this._virtualValues.clear()}setVirtualContext(e,t){this._virtualValues.set(e.name,t)}*entries(){for(let[e,t]of this._durableValues){let n=resolveKey(e);n!==void 0&&(yield[n,t])}}};const globalContextStorage=globalThis;globalContextStorage[EVE_CONTEXT_STORAGE_KEY]===void 0&&(globalContextStorage[EVE_CONTEXT_STORAGE_KEY]=new AsyncLocalStorage);const storage=globalContextStorage[EVE_CONTEXT_STORAGE_KEY],contextStorage={getStore:()=>storage.getStore()?.context,run:(e,t)=>storage.run({context:e},t)};function contextScopeValue(e){return storage.getStore()?.values?.get(e)}function withContextScopeValue(e,t,n){let r=storage.getStore(),i=new Map(r?.values);return i.set(e,t),storage.run({context:r?.context,values:i},n)}function loadContext(){let e=contextStorage.getStore();if(e===void 0)throw Error(`No active eve context. Call this function only from authored runtime code such as tools, steps, and model callbacks.`);return e}export{ContextContainer,contextScopeValue,contextStorage,loadContext,withContextScopeValue};

package/dist/src/context/key-names.d.ts

@@ -11,3 +11,4 @@
 export declare const BUNDLE_CONTEXT_KEY_NAME = "eve.bundle";
 export declare const CHANNEL_CONTEXT_KEY_NAME = "eve.channel";
 export declare const SESSION_CALLBACK_CONTEXT_KEY_NAME = "eve.sessionCallback";
+export declare const EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME = "eve.earlierRemoteCaller";

package/dist/src/context/key-names.js

@@ -1 +1 @@
-const BUNDLE_CONTEXT_KEY_NAME=`eve.bundle`,CHANNEL_CONTEXT_KEY_NAME=`eve.channel`,SESSION_CALLBACK_CONTEXT_KEY_NAME=`eve.sessionCallback`;export{BUNDLE_CONTEXT_KEY_NAME,CHANNEL_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME};
+const BUNDLE_CONTEXT_KEY_NAME=`eve.bundle`,CHANNEL_CONTEXT_KEY_NAME=`eve.channel`,SESSION_CALLBACK_CONTEXT_KEY_NAME=`eve.sessionCallback`,EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME=`eve.earlierRemoteCaller`;export{BUNDLE_CONTEXT_KEY_NAME,CHANNEL_CONTEXT_KEY_NAME,EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME};