eve 0.44.4 → 0.45.1

package/dist/src/client/agent-info-schema.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";const source=z.object({exportName:z.string().optional(),logicalPath:z.string(),sourceId:z.string().optional(),sourceKind:z.string()}),entry=source.extend({name:z.string()}),modelRouting=z.discriminatedUnion(`kind`,[z.object({kind:z.literal(`gateway`),target:z.string(),byok:z.string().optional()}),z.object({kind:z.literal(`external`),provider:z.string()})]),modelEndpoint=z.union([z.object({kind:z.literal(`external`),provider:z.string()}),z.object({kind:z.literal(`chatgpt`),state:z.enum([`checking`,`ready`,`signed-out`,`reauth-required`,`unavailable`]),accountLabel:z.string().optional()}),z.object({kind:z.literal(`gateway`),connected:z.literal(!0),credential:z.enum([`api-key`,`oidc`])}),z.object({kind:z.literal(`gateway`),connected:z.literal(!1)})]),agentModelBaseFields={contextWindowTokens:z.number().optional(),providerOptions:z.unknown().optional(),reasoning:z.enum([`provider-default`,`none`,`minimal`,`low`,`medium`,`high`,`xhigh`]).optional().catch(void 0),source:source.optional()},agentModel=z.union([z.object({...agentModelBaseFields,id:z.string(),routing:modelRouting,endpoint:modelEndpoint.optional()}).strict(),z.object({...agentModelBaseFields,endpoint:z.never().optional(),id:z.never().optional(),routing:z.object({kind:z.literal(`dynamic`)}).strict()}).strict()]),tool=entry.extend({description:z.string(),hasAuth:z.boolean(),hasExecute:z.boolean(),hasModelOutputProjection:z.boolean(),hasOutputSchema:z.boolean(),inputSchema:z.unknown(),origin:z.enum([`authored`,`framework`]),outputSchema:z.unknown().optional(),replacesFrameworkTool:z.boolean(),requiresApproval:z.boolean()}),frameworkTool=tool.extend({disabledByAuthor:z.boolean(),replacedByAuthoredTool:z.boolean(),status:z.enum([`active`,`disabled`,`opt-in`,`replaced`])}),dynamicResolver=source.extend({eventNames:z.array(z.string()),origin:z.enum([`authored`,`framework`]),slug:z.string()}),skill=entry.extend({description:z.string(),license:z.string().optional(),markdown:z.string(),metadata:z.record(z.string(),z.string()).optional()}),instructions=entry.extend({content:z.string(),role:z.enum([`system`,`user`])}),schedule=entry.extend({cron:z.string(),hasRun:z.boolean(),markdown:z.string().optional()}),subagent=entry.extend({description:z.string().optional(),entryPath:z.string(),nodeId:z.string(),rootPath:z.string(),summary:z.object({channels:z.number(),connections:z.number(),hooks:z.number(),instructions:z.boolean(),schedules:z.number(),skills:z.number(),tools:z.number()})}),channel=entry.extend({adapterKind:z.string().optional(),method:z.string(),origin:z.enum([`authored`,`framework`]),urlPath:z.string()}),frameworkChannel=channel.extend({disabledByAuthor:z.boolean(),replacedByAuthoredChannel:z.boolean(),status:z.enum([`active`,`disabled`,`replaced`])}),connection=source.extend({connectionName:z.string(),description:z.string(),hasApproval:z.boolean(),hasAuthorization:z.boolean(),hasHeaders:z.boolean(),protocol:z.string(),toolFilter:z.unknown().optional(),url:z.string()}),hook=source.extend({eventNames:z.array(z.string()),slug:z.string()}),sandbox=source.extend({backendKind:z.string().optional(),description:z.string().optional(),hasBootstrap:z.boolean(),hasOnSession:z.boolean(),revalidationKey:z.string().optional(),sourceHash:z.string().optional()}),AgentInfoResultSchema=z.object({agent:z.object({agentRoot:z.string(),appRoot:z.string(),configSource:source.optional(),description:z.string().optional(),model:agentModel,name:z.string(),outputSchema:z.unknown().optional()}),capabilities:z.object({devRoutes:z.boolean()}),channels:z.object({authored:z.array(channel),available:z.array(channel),disabledFramework:z.array(z.string()),framework:z.array(frameworkChannel)}),connections:z.array(connection),diagnostics:z.object({discoveryErrors:z.number(),discoveryWarnings:z.number()}),hooks:z.array(hook),instructions:z.object({dynamic:z.array(dynamicResolver),static:z.array(instructions)}),kind:z.literal(`eve-agent-info`),mode:z.enum([`development`,`production`]),sandbox:sandbox.nullable(),schedules:z.array(schedule),skills:z.object({dynamic:z.array(dynamicResolver),static:z.array(skill)}),subagents:z.object({local:z.array(subagent),total:z.number()}),tools:z.object({authored:z.array(tool),available:z.array(tool),disabledFramework:z.array(z.string()),dynamic:z.array(dynamicResolver),framework:z.array(frameworkTool),reserved:z.array(z.string())}),version:z.literal(2),workflow:z.object({enabled:z.boolean(),toolName:z.string()}),workspace:z.object({resourceRoot:z.unknown(),rootEntries:z.array(z.string())})});export{AgentInfoResultSchema};
+import{z}from"#compiled/zod/index.js";const owner=z.discriminatedUnion(`kind`,[z.object({kind:z.literal(`application`)}).strict(),z.object({feature:z.string(),kind:z.literal(`framework`)}).strict(),z.object({kind:z.literal(`extension`),namespace:z.string(),packageName:z.string()}).strict()]),moduleBacking=z.discriminatedUnion(`kind`,[z.object({externalDependencies:z.array(z.string()),extensionScope:z.object({namespace:z.string(),sourceRoot:z.string()}).strict().optional(),kind:z.literal(`filesystem`),sourcePath:z.string()}).strict(),z.object({dependencies:z.record(z.string(),z.string()).optional(),kind:z.literal(`programmatic`),moduleId:z.string(),parameters:z.record(z.string(),z.unknown()).optional(),registryId:z.string(),revision:z.string(),semanticRevision:z.string().optional()}).strict()]),binding=z.object({backing:moduleBacking,logicalPath:z.string(),owner}).strict(),source=z.object({binding:binding.optional(),exportName:z.string().optional(),logicalPath:z.string(),owner,sourceId:z.string(),sourceKind:z.enum([`markdown`,`module`,`skill-package`])}).strict(),entry=source.extend({name:z.string()}).strict(),dynamicResolver=source.extend({eventNames:z.array(z.string()),slug:z.string()}).strict(),modelRouting=z.discriminatedUnion(`kind`,[z.object({kind:z.literal(`gateway`),target:z.string(),byok:z.string().optional()}).strict(),z.object({kind:z.literal(`external`),provider:z.string()}).strict()]),modelEndpoint=z.union([z.object({kind:z.literal(`external`),provider:z.string()}).strict(),z.object({kind:z.literal(`chatgpt`),state:z.enum([`checking`,`ready`,`signed-out`,`reauth-required`,`unavailable`]),accountLabel:z.string().optional()}).strict(),z.object({kind:z.literal(`gateway`),connected:z.literal(!0),credential:z.enum([`api-key`,`oidc`])}).strict(),z.object({kind:z.literal(`gateway`),connected:z.literal(!1)}).strict()]),modelBaseFields={contextWindowTokens:z.number().optional(),providerOptions:z.unknown().optional(),reasoning:z.enum([`provider-default`,`none`,`minimal`,`low`,`medium`,`high`,`xhigh`]).optional().catch(void 0),source:source.optional()},agentModel=z.union([z.object({...modelBaseFields,endpoint:modelEndpoint.optional(),id:z.string(),routing:modelRouting}).strict(),z.object({...modelBaseFields,endpoint:z.never().optional(),id:z.never().optional(),routing:z.object({kind:z.literal(`dynamic`),resolver:dynamicResolver}).strict()}).strict()]),tool=entry.extend({description:z.string(),hasAuth:z.boolean(),hasExecute:z.boolean(),hasModelOutputProjection:z.boolean(),hasOutputSchema:z.boolean(),inputSchema:z.unknown(),outputSchema:z.unknown().optional(),requiresApproval:z.boolean()}).strict(),skill=entry.extend({description:z.string(),license:z.string().optional(),markdown:z.string(),metadata:z.record(z.string(),z.string()).optional()}).strict(),instructions=entry.extend({content:z.string(),role:z.enum([`system`,`user`])}).strict(),schedule=entry.extend({cron:z.string(),hasRun:z.boolean(),markdown:z.string().optional()}).strict(),channelMethod=z.enum([`GET`,`HEAD`,`POST`,`PUT`,`PATCH`,`DELETE`,`OPTIONS`,`WEBSOCKET`]),channelRoute=entry.extend({adapterKind:z.string().optional(),method:channelMethod,urlPath:z.string()}).strict(),sourceDescriptor=z.object({backing:z.union([moduleBacking,z.object({kind:z.literal(`resource`),sourcePath:z.string()}).strict()]),form:z.enum([`derived`,`direct`]),layer:z.enum([`framework-default`,`extension-package`,`extension-override`,`application`]),logicalPath:z.string(),owner,sourceId:z.string()}).strict(),shadowedChannelRoute=z.object({method:channelMethod,source:sourceDescriptor,urlPath:z.string(),winnerSourceId:z.string()}).strict(),connection=source.extend({connectionName:z.string(),description:z.string(),hasApproval:z.boolean(),hasAuthorization:z.boolean(),hasHeaders:z.boolean(),protocol:z.string(),toolFilter:z.unknown().optional(),url:z.string()}).strict(),hook=source.extend({eventNames:z.array(z.string()),slug:z.string()}).strict(),memory=source.extend({description:z.string().optional(),slot:z.string(),visibility:z.enum([`scope`,`session`])}).strict(),sandbox=source.extend({backendKind:z.string().optional(),description:z.string().optional(),hasBootstrap:z.boolean(),hasOnSession:z.boolean(),revalidationKey:z.string().optional(),sourceHash:z.string().optional()}).strict(),subagent=entry.extend({configResolver:dynamicResolver.optional(),description:z.string().optional(),entryPath:z.string(),nodeId:z.string(),parentNodeId:z.string(),rootPath:z.string(),summary:z.object({channels:z.number(),connections:z.number(),hooks:z.number(),instructions:z.number(),memories:z.number(),schedules:z.number(),skills:z.number(),tools:z.number()}).strict()}).strict(),remoteAgent=entry.extend({description:z.string(),nodeId:z.string(),parentNodeId:z.string(),url:z.string().optional()}).strict(),kernelEffect=z.object({action:z.enum([`subagent-call`,`task-update`,`task-cancel`]).optional(),audience:z.array(z.enum([`root-session`,`delegated-task-child`,`requires-request-input`,`requires-loadable-skill`,`below-subagent-depth`])),kind:z.enum([`request-input`,`dispatch`,`provider-tool`]),sourceId:z.string()}).strict(),compositionDiagnostic=z.object({kind:z.enum([`disabled`,`shadowed`]),logicalPath:z.string(),owner,sourceId:z.string(),winnerSourceId:z.string().optional()}).strict(),workflow=z.discriminatedUnion(`enabled`,[z.object({enabled:z.literal(!1),toolName:z.string()}).strict(),z.object({enabled:z.literal(!0),source,toolName:z.string()}).strict()]),AgentInfoResultSchema=z.object({agent:z.object({agentRoot:z.string(),appRoot:z.string(),config:source.extend({binding}).strict(),description:z.string().optional(),model:agentModel,name:z.string(),nodeId:z.string(),outputSchema:z.unknown().optional()}).strict(),capabilities:z.object({devRoutes:z.boolean()}).strict(),channels:z.object({routes:z.array(channelRoute),shadowed:z.array(shadowedChannelRoute)}).strict(),composition:z.object({disabled:z.array(compositionDiagnostic),shadowed:z.array(compositionDiagnostic)}).strict(),connections:z.array(connection),diagnostics:z.object({discoveryErrors:z.number(),discoveryWarnings:z.number()}).strict(),hooks:z.array(hook),instructions:z.object({dynamic:z.array(dynamicResolver),static:z.array(instructions)}).strict(),instrumentation:source.optional(),kernelEffects:z.array(kernelEffect),kind:z.literal(`eve-agent-info`),memories:z.array(memory),mode:z.enum([`development`,`production`]),remoteAgents:z.object({entries:z.array(remoteAgent),total:z.number()}).strict(),sandbox,schedules:z.array(schedule),skills:z.object({dynamic:z.array(dynamicResolver),static:z.array(skill)}).strict(),subagents:z.object({local:z.array(subagent),total:z.number()}).strict(),tools:z.object({dynamic:z.array(dynamicResolver),static:z.array(tool)}).strict(),version:z.literal(4),workflow,workspace:z.object({resourceRoot:z.unknown(),rootEntries:z.array(z.string())}).strict()}).strict().superRefine((e,t)=>{let assertUnique=(e,n,r)=>{let i=new Set;e.forEach((e,a)=>{let o=n(e);i.has(o)&&t.addIssue({code:`custom`,message:`Duplicate public identity "${o}".`,path:[...r,a]}),i.add(o)})},assertTotal=(e,n,r)=>{(!Number.isSafeInteger(e)||e<0||e!==n.length)&&t.addIssue({code:`custom`,message:`Expected total ${n.length}, received ${e}.`,path:[...r]})};assertUnique(e.tools.static,e=>e.name,[`tools`,`static`]),assertUnique(e.tools.dynamic,e=>e.slug,[`tools`,`dynamic`]),assertUnique(e.skills.static,e=>e.name,[`skills`,`static`]),assertUnique(e.skills.dynamic,e=>e.slug,[`skills`,`dynamic`]),assertUnique(e.instructions.static,e=>e.name,[`instructions`,`static`]),assertUnique(e.instructions.dynamic,e=>e.slug,[`instructions`,`dynamic`]),assertUnique(e.schedules,e=>e.name,[`schedules`]),assertUnique(e.connections,e=>e.connectionName,[`connections`]),assertUnique(e.hooks,e=>e.slug,[`hooks`]),assertUnique(e.memories,e=>e.slot,[`memories`]),assertUnique(e.channels.routes,e=>`${e.method} ${normalizeRoutePattern(e.urlPath)}`,[`channels`,`routes`]),assertUnique(e.subagents.local,e=>e.nodeId,[`subagents`,`local`]),assertUnique(e.remoteAgents.entries,e=>e.nodeId,[`remoteAgents`,`entries`]),assertTotal(e.subagents.total,e.subagents.local,[`subagents`,`total`]),assertTotal(e.remoteAgents.total,e.remoteAgents.entries,[`remoteAgents`,`total`]);let n=[[e.agent.config,[`agent`,`config`]],...e.agent.model.source===void 0?[]:[[e.agent.model.source,[`agent`,`model`,`source`]]],...e.agent.model.routing.kind===`dynamic`?[[e.agent.model.routing.resolver,[`agent`,`model`,`routing`,`resolver`]]]:[],...e.channels.routes.map((e,t)=>[e,[`channels`,`routes`,t]]),...e.connections.map((e,t)=>[e,[`connections`,t]]),...e.hooks.map((e,t)=>[e,[`hooks`,t]]),...e.instructions.dynamic.map((e,t)=>[e,[`instructions`,`dynamic`,t]]),...e.instructions.static.map((e,t)=>[e,[`instructions`,`static`,t]]),...e.memories.map((e,t)=>[e,[`memories`,t]]),...e.instrumentation===void 0?[]:[[e.instrumentation,[`instrumentation`]]],...e.remoteAgents.entries.map((e,t)=>[e,[`remoteAgents`,`entries`,t]]),...e.schedules.map((e,t)=>[e,[`schedules`,t]]),...e.skills.dynamic.map((e,t)=>[e,[`skills`,`dynamic`,t]]),...e.skills.static.map((e,t)=>[e,[`skills`,`static`,t]]),...e.subagents.local.flatMap((e,t)=>e.configResolver===void 0?[]:[[e.configResolver,[`subagents`,`local`,t,`configResolver`]]]),...e.tools.dynamic.map((e,t)=>[e,[`tools`,`dynamic`,t]]),...e.tools.static.map((e,t)=>[e,[`tools`,`static`,t]]),...e.workflow.enabled?[[e.workflow.source,[`workflow`,`source`]]]:[],[e.sandbox,[`sandbox`]]];for(let[e,r]of n){if(e.sourceKind===`module`&&e.binding===void 0){t.addIssue({code:`custom`,message:`Module source is missing its compiled binding.`,path:[...r,`binding`]});continue}if(e.sourceKind!==`module`&&e.binding!==void 0){t.addIssue({code:`custom`,message:`${e.sourceKind} source cannot carry a module binding.`,path:[...r,`binding`]});continue}e.binding!==void 0&&(e.binding.logicalPath!==e.logicalPath&&t.addIssue({code:`custom`,message:`Source and binding logical paths do not match.`,path:[...r,`binding`,`logicalPath`]}),JSON.stringify(e.binding.owner)!==JSON.stringify(e.owner)&&t.addIssue({code:`custom`,message:`Source and binding owners do not match.`,path:[...r,`binding`,`owner`]}))}});function normalizeRoutePattern(e){return e.replace(/^\/+|\/+$/g,``).split(`/`).map(e=>e.startsWith(`:`)||/^\[[^\]]+\]$/.test(e)?`:`:e).join(`/`)}export{AgentInfoResultSchema};

package/dist/src/client/client.js

@@ -1 +1 @@
-import{EVE_HEALTH_ROUTE_PATH,EVE_INFO_ROUTE_PATH}from"#protocol/routes.js";import{encodeBasicCredentials}from"#internal/http/basic-auth.js";import{AgentInfoResponseError}from"#client/agent-info-error.js";import{AgentInfoResultSchema}from"#client/agent-info-schema.js";import{ClientError}from"#client/client-error.js";import{ClientSessions}from"#client/sessions.js";import{createClientUrl}from"#client/url.js";import{VERCEL_TRUSTED_OIDC_IDP_TOKEN_HEADER}from"#client/types.js";var Client=class{#e;#t;#n;#r;sessions;constructor(e){this.#n=e.host,this.#e=e.auth,this.#t=e.headers,this.#r=e.redirect,this.sessions=new ClientSessions({host:this.#n,redirect:this.#r,resolveHeaders:e=>this.#i(e)})}async health(){let t=createClientUrl(this.#n,EVE_HEALTH_ROUTE_PATH),n=await this.#i(),r=await fetch(t,withRedirectPolicy({headers:n},this.#r));if(!r.ok){let e=await r.text();throw new ClientError(r.status,e,r.headers)}return await r.json()}async info(){let e=await this.fetch(EVE_INFO_ROUTE_PATH);if(!e.ok){let t=await e.text();throw new ClientError(e.status,t,e.headers)}let n;try{n=await e.json()}catch{throw new AgentInfoResponseError}let i=AgentInfoResultSchema.safeParse(n);if(!i.success)throw new AgentInfoResponseError(i.error.issues.slice(0,5).map(e=>{let t=e.path.join(`.`);return t.length===0?e.message:`${t}: ${e.message}`}));return i.data}async fetch(e,t={}){let n=createClientUrl(this.#n,e),r=await this.#i(headersInitToRecord(t.headers));return await fetch(n,withRedirectPolicy({...t,headers:r},this.#r))}async#i(e){let t=new Headers,[n,r]=await Promise.all([resolveHeadersValue(this.#t),this.#a()]);for(let[e,r]of Object.entries(n))t.set(e,r);for(let[e,n]of Object.entries(r))t.set(e,n);if(e)for(let[n,r]of Object.entries(e))t.set(n,r);return t}async#a(){let e=this.#e;if(!e)return{};if(`vercelOidc`in e){let t=(await resolveTokenValue(e.vercelOidc.token)).trim();return t.length===0?{}:{authorization:`Bearer ${t}`,[VERCEL_TRUSTED_OIDC_IDP_TOKEN_HEADER]:t}}if(`bearer`in e){let t=(await resolveTokenValue(e.bearer)).trim();return t.length===0?{}:{authorization:`Bearer ${t}`}}if(`basic`in e){let t=await resolveTokenValue(e.basic.password);return{authorization:`Basic ${encodeBasicCredentials(e.basic.username,t)}`}}return{}}};async function resolveTokenValue(e){return typeof e==`function`?e():e}async function resolveHeadersValue(e){return e===void 0?{}:typeof e==`function`?await e():e}function headersInitToRecord(e){return e===void 0?{}:Object.fromEntries(new Headers(e).entries())}function withRedirectPolicy(e,t){return t===void 0?e:{...e,redirect:t}}export{Client};
+import{EVE_HEALTH_ROUTE_PATH,EVE_INFO_ROUTE_PATH}from"#protocol/routes.js";import{encodeBasicCredentials}from"#internal/http/basic-auth.js";import{AgentInfoResponseError}from"#client/agent-info-error.js";import{HealthResponseError}from"#client/health-response-error.js";import{HealthResultSchema}from"#client/health-schema.js";import{AgentInfoResultSchema}from"#client/agent-info-schema.js";import{ClientError}from"#client/client-error.js";import{ClientSessions}from"#client/sessions.js";import{createClientUrl}from"#client/url.js";import{VERCEL_TRUSTED_OIDC_IDP_TOKEN_HEADER}from"#client/types.js";var Client=class{#e;#t;#n;#r;sessions;constructor(e){this.#n=e.host,this.#e=e.auth,this.#t=e.headers,this.#r=e.redirect,this.sessions=new ClientSessions({host:this.#n,redirect:this.#r,resolveHeaders:e=>this.#i(e)})}async health(){let t=createClientUrl(this.#n,EVE_HEALTH_ROUTE_PATH),n=await this.#i(),r=await fetch(t,withRedirectPolicy({headers:n},this.#r));if(!r.ok){let e=await r.text();throw new ClientError(r.status,e,r.headers)}let a;try{a=await r.json()}catch{throw new HealthResponseError}let o=HealthResultSchema.safeParse(a);if(!o.success)throw new HealthResponseError(o.error.issues.slice(0,5).map(e=>{let t=e.path.join(`.`);return t.length===0?e.message:`${t}: ${e.message}`}));return o.data}async info(){let e=await this.fetch(EVE_INFO_ROUTE_PATH);if(!e.ok){let t=await e.text();throw new ClientError(e.status,t,e.headers)}let n;try{n=await e.json()}catch{throw new AgentInfoResponseError}let i=AgentInfoResultSchema.safeParse(n);if(!i.success)throw new AgentInfoResponseError(i.error.issues.slice(0,5).map(e=>{let t=e.path.join(`.`);return t.length===0?e.message:`${t}: ${e.message}`}));return i.data}async fetch(e,t={}){let n=createClientUrl(this.#n,e),r=await this.#i(headersInitToRecord(t.headers));return await fetch(n,withRedirectPolicy({...t,headers:r},this.#r))}async#i(e){let t=new Headers,[n,r]=await Promise.all([resolveHeadersValue(this.#t),this.#a()]);for(let[e,r]of Object.entries(n))t.set(e,r);for(let[e,n]of Object.entries(r))t.set(e,n);if(e)for(let[n,r]of Object.entries(e))t.set(n,r);return t}async#a(){let e=this.#e;if(!e)return{};if(`vercelOidc`in e){let t=(await resolveTokenValue(e.vercelOidc.token)).trim();return t.length===0?{}:{authorization:`Bearer ${t}`,[VERCEL_TRUSTED_OIDC_IDP_TOKEN_HEADER]:t}}if(`bearer`in e){let t=(await resolveTokenValue(e.bearer)).trim();return t.length===0?{}:{authorization:`Bearer ${t}`}}if(`basic`in e){let t=await resolveTokenValue(e.basic.password);return{authorization:`Basic ${encodeBasicCredentials(e.basic.username,t)}`}}return{}}};async function resolveTokenValue(e){return typeof e==`function`?e():e}async function resolveHeadersValue(e){return e===void 0?{}:typeof e==`function`?await e():e}function headersInitToRecord(e){return e===void 0?{}:Object.fromEntries(new Headers(e).entries())}function withRedirectPolicy(e,t){return t===void 0?e:{...e,redirect:t}}export{Client};

package/dist/src/client/eve-agent-store.d.ts

@@ -3,12 +3,13 @@ import type { ClientSession } from "#client/session.js";
 import { type MessageStreamEvent } from "#protocol/message.js";
 import type { CancelSessionResult, ClientAuth, HeadersValue, SendTurnPayload, ClientSessionState } from "#client/types.js";
 /**
- * Lifecycle state of an {@link EveAgentStore}: `ready` (idle), `submitted`
- * (turn sent, awaiting the first event), `streaming` (events arriving), and
- * `error` (the turn failed). A turn advances `ready` to `submitted` to
- * `streaming` to `ready` (or `error`).
+ * Lifecycle state of an {@link EveAgentStore}: `ready` (idle), `resuming`
+ * (checking an attached session for continuation), `submitted` (turn sent,
+ * awaiting the first event), `streaming` (events arriving), and `error` (the
+ * turn failed). A new turn advances `ready` to `submitted` to `streaming` to
+ * `ready` (or `error`).
  */
-export type EveAgentStoreStatus = "error" | "ready" | "streaming" | "submitted";
+export type EveAgentStoreStatus = "error" | "ready" | "resuming" | "streaming" | "submitted";
 /**
  * Prepares one outbound turn immediately before the client sends it, e.g. to
  * attach fresh one-turn client state such as page context via `clientContext`.

package/dist/src/client/eve-agent-store.js

@@ -1 +1 @@
-import{toError}from"#shared/errors.js";import{createEventDeduper}from"#protocol/event-dedupe.js";import{isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{Client}from"#client/client.js";import{assertExclusiveTurnInput,collectPendingAuthorizations,createAbortSignal,createSubmissionId,isAbortError,isSettledSessionTail,summarizeUserContent,toTerminalStreamFailureError,updatePendingAuthorizations}from"#client/eve-agent-store-helpers.js";const detachStore=Symbol(`detachEveAgentStore`);var EveAgentStore=class{#e;#t;#n;#r;#i=new Set;#a=createEventDeduper();#o;#s={};#c;#l;#u;#d=[];#f;#p;#m;#h;#g=`ready`;constructor(e){this.#t=e.session!==void 0,this.#e=this.#t?void 0:new Client({auth:e.auth,headers:e.headers,host:e.host??``});let t=[];for(let n of e.initialEvents??[])this.#a.admit(n)&&t.push(n);this.#u=t,this.#f=[...this.#u],this.#n=e.optimistic??!0,this.#r=e.reducer,this.#m=e.session??(e.initialSession===void 0?void 0:this.#e?.sessions.attach(e.initialSession.sessionId,{streamIndex:e.initialSession.streamIndex})),this.#c=this.#j(this.#f),this.#h=this.#M()}get snapshot(){return this.#h}setCallbacks(e){this.#s=e}subscribe(e){return this.#i.add(e),()=>{this.#i.delete(e)}}async send(t){if(this.#o!==void 0)return await this.#v(this.#o,t);let n=Promise.withResolvers(),r=Promise.withResolvers(),a={abortController:new AbortController,acceptedFollowUps:0,cancel:()=>a.acceptedFollowUps>0&&this.#m!==void 0?this.#m.cancel():n.promise.then(e=>e===void 0?{status:`no_active_turn`}:e.cancel()),completion:r.promise,followUpDispatches:new Set,receivedFollowUps:0,resolveCompletion:r.resolve,response:n.promise,resolveResponse:n.resolve};this.#o=a,this.#l=void 0,this.#g=`submitted`,this.#N();try{let e=await this.#s.prepareSend?.(t)??t;if(assertExclusiveTurnInput(e),!this.#S(a))return;this.#C(e),this.#w(e),this.#N();let n={...e,signal:createAbortSignal(e.signal,a.abortController.signal)},r=await this.#x(n);if(!this.#S(a))return;a.resolveResponse(r);for await(let e of r){if(!this.#S(a))return;this.#T(e)}if(!this.#S(a)||(await this.#y(a),!this.#S(a)))return;this.#g=this.#l===void 0?`ready`:`error`}catch(t){if(!this.#S(a))return;isAbortError(t)?(this.#g=`ready`,this.#O(toError(t))):(this.#l=toError(t),this.#g=`error`,this.#O(this.#l),this.#s.onError?.(this.#l))}finally{this.#S(a)&&(a.resolveResponse(void 0),this.#o=void 0,this.#s.onSessionChange?.(this.#m?.state),this.#N(),this.#s.onFinish?.(this.#h),a.resolveCompletion())}}resume(){if(this.#p!==void 0)return this.#p;let e=this.#_();this.#p=e;let clear=()=>{this.#p===e&&(this.#p=void 0)};return e.then(clear,clear),e}async#_(){if(this.#g===`streaming`||this.#g===`submitted`)throw Error(`eve session is already processing a turn.`);if(this.#m===void 0)throw Error(`An eve session is required before resuming.`);let t=Promise.withResolvers(),r=Promise.withResolvers(),i=this.#m,o={abortController:new AbortController,acceptedFollowUps:0,cancel:()=>i.cancel(),completion:r.promise,followUpDispatches:new Set,receivedFollowUps:0,resolveCompletion:r.resolve,response:t.promise,resolveResponse:t.resolve};this.#o=o,o.resolveResponse(void 0),this.#l=void 0,this.#g=`submitted`,this.#N();try{let e=[];for await(let t of i.stream({follow:!1,signal:o.abortController.signal,startIndex:0})){if(!this.#S(o))return;e.push(t),this.#T(t,!1)}if(!this.#S(o))return;this.#N();let t=isSettledSessionTail(e);if(!t||e.at(-1)?.type===`session.waiting`){let r=collectPendingAuthorizations(e);for await(let e of i.stream({signal:o.abortController.signal,streamReconnectPolicy:t?{reconnect:!1}:void 0})){if(!this.#S(o))return;if(this.#T(e),updatePendingAuthorizations(r,e),isCurrentTurnBoundaryEvent(e)&&(e.type!==`session.waiting`||r.size===0))break}}await this.#y(o),this.#S(o)&&(this.#g=this.#l===void 0?`ready`:`error`)}catch(t){if(!this.#S(o))return;isAbortError(t)?this.#g=`ready`:(this.#l=toError(t),this.#g=`error`,this.#s.onError?.(this.#l))}finally{this.#S(o)&&(o.resolveResponse(void 0),this.#o=void 0,this.#s.onSessionChange?.(i.state),this.#N(),this.#s.onFinish?.(this.#h),o.resolveCompletion())}}cancel(){let e=this.#o;return e===void 0?Promise.resolve({status:`no_active_turn`}):e.cancel()}[detachStore](){this.#o?.abortController.abort()}reset(){let e=this.#o;this.#o=void 0,e?.resolveResponse(void 0),e?.resolveCompletion(),e?.abortController.abort(),this.#t||(this.#m=void 0),this.#u=[],this.#a=createEventDeduper(),this.#d=[],this.#f=[],this.#c=this.#r.initial(),this.#l=void 0,this.#g=`ready`,this.#s.onSessionChange?.(this.#m?.state),this.#N()}async#v(t,n){if(n.message===void 0||n.turnPolicy!==`steer`)throw Error(`eve session is already processing a turn. Send a message with turnPolicy: "steer" to replace it.`);let r=await this.#s.prepareSend?.(n)??n;if(assertExclusiveTurnInput(r),r.message===void 0||r.turnPolicy!==`steer`)throw Error(`An in-flight follow-up requires a message with turnPolicy: "steer".`);if(!this.#S(t))return await this.send(r);let a=this.#C(r);this.#N();let o;o=(async()=>{try{if(await t.response,!this.#S(t)||this.#m===void 0)throw Error(`The active eve turn ended before the follow-up could be sent.`);let{message:e,...n}=r;await this.#m.send(e,n),t.acceptedFollowUps+=1}catch(t){throw this.#O(toError(t),a),this.#N(),t}finally{t.followUpDispatches.delete(o)}})(),t.followUpDispatches.add(o),await o,await t.completion}async#y(e){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(!(e.receivedFollowUps>=e.acceptedFollowUps||this.#m===void 0))for await(let t of this.#m.stream({signal:e.abortController.signal})){if(!this.#S(e))return;if(t.type===`message.received`&&(e.receivedFollowUps+=1),this.#T(t),isCurrentTurnBoundaryEvent(t)){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(e.receivedFollowUps>=e.acceptedFollowUps)return}}}async#b(e){if(this.#e===void 0)throw Error(`An external eve session is required before sending.`);if(e.message===void 0)throw Error(`Cannot answer an input request before the session starts.`);let t=await this.#e.sessions.create({...e,message:e.message});return this.#m=t.session,this.#s.onSessionChange?.(t.session.state),this.#N(),t.response}async#x(e){if(this.#m===void 0)return await this.#b(e);if(e.inputResponses===void 0){let{message:t,...n}=e;return await this.#m.send(t,n)}let{inputResponses:t,...n}=e;return await this.#m.respond(t,n)}#S(e){return this.#o===e}#C(e){if(!this.#n||e.message===void 0)return;let t=createSubmissionId(),n={createdAt:Date.now(),id:t,message:summarizeUserContent(e.message)};return this.#d=[...this.#d,n],this.#k({data:{createdAt:n.createdAt,message:n.message,submissionId:n.id},type:`client.message.submitted`}),t}#w(e){e.inputResponses===void 0||e.inputResponses.length===0||this.#k({data:{createdAt:Date.now(),responses:e.inputResponses},type:`client.input.responded`})}#T(e,t=!0){this.#a.admit(e)&&(this.#u=[...this.#u,e],this.#E(e),this.#s.onEvent?.(e),this.#g=`streaming`,this.#D(e),t&&this.#N())}#E(e){let t=this.#d[0];if(e.type===`message.received`&&t!==void 0){let n=t.id;this.#d=this.#d.slice(1),this.#A(e=>e.type===`client.message.submitted`&&e.data.submissionId===n,e);return}this.#k(e)}#D(e){let t=toTerminalStreamFailureError(e);t!==void 0&&(this.#g=`error`,this.#O(t),this.#l===void 0&&(this.#l=t,this.#s.onError?.(t)))}#O(e,t){let n=t===void 0?this.#d[0]:this.#d.find(e=>e.id===t);n!==void 0&&(this.#d=this.#d.filter(e=>e.id!==n.id),this.#A(e=>e.type===`client.message.submitted`&&e.data.submissionId===n.id,{data:{createdAt:n.createdAt,error:{message:e.message},message:n.message,submissionId:n.id},type:`client.message.failed`}))}#k(e){this.#f=[...this.#f,e],this.#c=this.#r.reduce(this.#c,e)}#A(e,t){let n=!1;this.#f=this.#f.map(r=>!n&&e(r)?(n=!0,t):r),n||(this.#f=[...this.#f,t]),this.#c=this.#j(this.#f)}#j(e){let t=this.#r.initial();for(let n of e)t=this.#r.reduce(t,n);return t}#M(){return{data:this.#c,error:this.#l,events:this.#u,session:this.#m?.state,status:this.#g}}#N(){this.#h=this.#M();for(let e of this.#i)e()}};function detachEveAgentStore(e){e[detachStore]()}export{EveAgentStore,detachEveAgentStore};
+import{toError}from"#shared/errors.js";import{createEventDeduper}from"#protocol/event-dedupe.js";import{isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{Client}from"#client/client.js";import{assertExclusiveTurnInput,collectPendingAuthorizations,createAbortSignal,createSubmissionId,isAbortError,isSettledSessionTail,summarizeUserContent,toTerminalStreamFailureError,updatePendingAuthorizations}from"#client/eve-agent-store-helpers.js";const detachStore=Symbol(`detachEveAgentStore`);var EveAgentStore=class{#e;#t;#n;#r;#i=new Set;#a=createEventDeduper();#o;#s={};#c;#l;#u;#d=[];#f;#p;#m;#h;#g=`ready`;constructor(e){this.#t=e.session!==void 0,this.#e=this.#t?void 0:new Client({auth:e.auth,headers:e.headers,host:e.host??``});let t=[];for(let n of e.initialEvents??[])this.#a.admit(n)&&t.push(n);this.#u=t,this.#f=[...this.#u],this.#n=e.optimistic??!0,this.#r=e.reducer,this.#m=e.session??(e.initialSession===void 0?void 0:this.#e?.sessions.attach(e.initialSession.sessionId,{streamIndex:e.initialSession.streamIndex})),this.#c=this.#j(this.#f),this.#h=this.#M()}get snapshot(){return this.#h}setCallbacks(e){this.#s=e}subscribe(e){return this.#i.add(e),()=>{this.#i.delete(e)}}async send(t){if(this.#o!==void 0){if(this.#g===`resuming`)throw Error(`eve session is resuming.`);return await this.#v(this.#o,t)}let n=Promise.withResolvers(),r=Promise.withResolvers(),a={abortController:new AbortController,acceptedFollowUps:0,cancel:()=>a.acceptedFollowUps>0&&this.#m!==void 0?this.#m.cancel():n.promise.then(e=>e===void 0?{status:`no_active_turn`}:e.cancel()),completion:r.promise,followUpDispatches:new Set,receivedFollowUps:0,resolveCompletion:r.resolve,response:n.promise,resolveResponse:n.resolve};this.#o=a,this.#l=void 0,this.#g=`submitted`,this.#N();try{let e=await this.#s.prepareSend?.(t)??t;if(assertExclusiveTurnInput(e),!this.#S(a))return;this.#C(e),this.#w(e),this.#N();let n={...e,signal:createAbortSignal(e.signal,a.abortController.signal)},r=await this.#x(n);if(!this.#S(a))return;a.resolveResponse(r);for await(let e of r){if(!this.#S(a))return;this.#T(e)}if(!this.#S(a)||(await this.#y(a),!this.#S(a)))return;this.#g=this.#l===void 0?`ready`:`error`}catch(t){if(!this.#S(a))return;isAbortError(t)?(this.#g=`ready`,this.#O(toError(t))):(this.#l=toError(t),this.#g=`error`,this.#O(this.#l),this.#s.onError?.(this.#l))}finally{this.#S(a)&&(a.resolveResponse(void 0),this.#o=void 0,this.#s.onSessionChange?.(this.#m?.state),this.#N(),this.#s.onFinish?.(this.#h),a.resolveCompletion())}}resume(){if(this.#p!==void 0)return this.#p;let e=this.#_();this.#p=e;let clear=()=>{this.#p===e&&(this.#p=void 0)};return e.then(clear,clear),e}async#_(){if(this.#g===`resuming`||this.#g===`streaming`||this.#g===`submitted`)throw Error(`eve session is already processing a turn.`);if(this.#m===void 0)throw Error(`An eve session is required before resuming.`);let t=Promise.withResolvers(),r=Promise.withResolvers(),i=this.#m,o={abortController:new AbortController,acceptedFollowUps:0,cancel:()=>i.cancel(),completion:r.promise,followUpDispatches:new Set,receivedFollowUps:0,resolveCompletion:r.resolve,response:t.promise,resolveResponse:t.resolve};this.#o=o,o.resolveResponse(void 0),this.#l=void 0,this.#g=`resuming`,this.#N();try{let e=this.#u.length===i.state.streamIndex,t=e?[...this.#u]:[];for await(let n of i.stream({follow:!1,signal:o.abortController.signal,startIndex:e?i.state.streamIndex:0})){if(!this.#S(o))return;t.push(n),this.#T(n,{publish:!1,transitionToStreaming:!1})}if(!this.#S(o))return;let r=t.at(-1);r!==void 0&&this.#D(r);let s=isSettledSessionTail(t);if(this.#l===void 0&&(!s||r?.type===`session.waiting`)){let e=collectPendingAuthorizations(t);s||(this.#g=`streaming`),this.#N();for await(let t of i.stream({signal:o.abortController.signal,streamReconnectPolicy:s?{reconnect:!1}:void 0})){if(!this.#S(o))return;if(this.#T(t),updatePendingAuthorizations(e,t),isCurrentTurnBoundaryEvent(t)&&(t.type!==`session.waiting`||e.size===0))break}}else this.#g=this.#l===void 0?`ready`:`error`,this.#N();await this.#y(o),this.#S(o)&&(this.#g=this.#l===void 0?`ready`:`error`)}catch(t){if(!this.#S(o))return;isAbortError(t)?this.#g=`ready`:(this.#l=toError(t),this.#g=`error`,this.#s.onError?.(this.#l))}finally{this.#S(o)&&(o.resolveResponse(void 0),this.#o=void 0,this.#s.onSessionChange?.(i.state),this.#N(),this.#s.onFinish?.(this.#h),o.resolveCompletion())}}cancel(){let e=this.#o;return e===void 0?Promise.resolve({status:`no_active_turn`}):e.cancel()}[detachStore](){this.#o?.abortController.abort()}reset(){let e=this.#o;this.#o=void 0,e?.resolveResponse(void 0),e?.resolveCompletion(),e?.abortController.abort(),this.#t||(this.#m=void 0),this.#u=[],this.#a=createEventDeduper(),this.#d=[],this.#f=[],this.#c=this.#r.initial(),this.#l=void 0,this.#g=`ready`,this.#s.onSessionChange?.(this.#m?.state),this.#N()}async#v(t,n){if(n.message===void 0||n.turnPolicy!==`steer`)throw Error(`eve session is already processing a turn. Send a message with turnPolicy: "steer" to replace it.`);let r=await this.#s.prepareSend?.(n)??n;if(assertExclusiveTurnInput(r),r.message===void 0||r.turnPolicy!==`steer`)throw Error(`An in-flight follow-up requires a message with turnPolicy: "steer".`);if(!this.#S(t))return await this.send(r);let a=this.#C(r);this.#N();let o;o=(async()=>{try{if(await t.response,!this.#S(t)||this.#m===void 0)throw Error(`The active eve turn ended before the follow-up could be sent.`);let{message:e,...n}=r;await this.#m.send(e,n),t.acceptedFollowUps+=1}catch(t){throw this.#O(toError(t),a),this.#N(),t}finally{t.followUpDispatches.delete(o)}})(),t.followUpDispatches.add(o),await o,await t.completion}async#y(e){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(!(e.receivedFollowUps>=e.acceptedFollowUps||this.#m===void 0))for await(let t of this.#m.stream({signal:e.abortController.signal})){if(!this.#S(e))return;if(t.type===`message.received`&&(e.receivedFollowUps+=1),this.#T(t),isCurrentTurnBoundaryEvent(t)){for(;e.followUpDispatches.size>0;)await Promise.allSettled(e.followUpDispatches);if(e.receivedFollowUps>=e.acceptedFollowUps)return}}}async#b(e){if(this.#e===void 0)throw Error(`An external eve session is required before sending.`);if(e.message===void 0)throw Error(`Cannot answer an input request before the session starts.`);let t=await this.#e.sessions.create({...e,message:e.message});return this.#m=t.session,this.#s.onSessionChange?.(t.session.state),this.#N(),t.response}async#x(e){if(this.#m===void 0)return await this.#b(e);if(e.inputResponses===void 0){let{message:t,...n}=e;return await this.#m.send(t,n)}let{inputResponses:t,...n}=e;return await this.#m.respond(t,n)}#S(e){return this.#o===e}#C(e){if(!this.#n||e.message===void 0)return;let t=createSubmissionId(),n={createdAt:Date.now(),id:t,message:summarizeUserContent(e.message)};return this.#d=[...this.#d,n],this.#k({data:{createdAt:n.createdAt,message:n.message,submissionId:n.id},type:`client.message.submitted`}),t}#w(e){e.inputResponses===void 0||e.inputResponses.length===0||this.#k({data:{createdAt:Date.now(),responses:e.inputResponses},type:`client.input.responded`})}#T(e,t={}){this.#a.admit(e)&&(this.#u=[...this.#u,e],this.#E(e),this.#s.onEvent?.(e),(t.transitionToStreaming??!0)&&(this.#g=`streaming`),this.#D(e),(t.publish??!0)&&this.#N())}#E(e){let t=this.#d[0];if(e.type===`message.received`&&t!==void 0){let n=t.id;this.#d=this.#d.slice(1),this.#A(e=>e.type===`client.message.submitted`&&e.data.submissionId===n,e);return}this.#k(e)}#D(e){let t=toTerminalStreamFailureError(e);t!==void 0&&(this.#g=`error`,this.#O(t),this.#l===void 0&&(this.#l=t,this.#s.onError?.(t)))}#O(e,t){let n=t===void 0?this.#d[0]:this.#d.find(e=>e.id===t);n!==void 0&&(this.#d=this.#d.filter(e=>e.id!==n.id),this.#A(e=>e.type===`client.message.submitted`&&e.data.submissionId===n.id,{data:{createdAt:n.createdAt,error:{message:e.message},message:n.message,submissionId:n.id},type:`client.message.failed`}))}#k(e){this.#f=[...this.#f,e],this.#c=this.#r.reduce(this.#c,e)}#A(e,t){let n=!1;this.#f=this.#f.map(r=>!n&&e(r)?(n=!0,t):r),n||(this.#f=[...this.#f,t]),this.#c=this.#j(this.#f)}#j(e){let t=this.#r.initial();for(let n of e)t=this.#r.reduce(t,n);return t}#M(){return{data:this.#c,error:this.#l,events:this.#u,session:this.#m?.state,status:this.#g}}#N(){this.#h=this.#M();for(let e of this.#i)e()}};function detachEveAgentStore(e){e[detachStore]()}export{EveAgentStore,detachEveAgentStore};

package/dist/src/client/health-response-error.d.ts

@@ -0,0 +1,5 @@
+/** A successful health request returned an unusable payload. */
+export declare class HealthResponseError extends Error {
+    readonly issues: readonly string[];
+    constructor(issues?: readonly string[]);
+}

package/dist/src/client/health-response-error.js

@@ -0,0 +1 @@
+var HealthResponseError=class extends Error{issues;constructor(e=[]){let t=e.length===0?``:` (${e.join(`; `)})`;super(`The server returned an unrecognized eve health response.${t}`),this.name=`HealthResponseError`,this.issues=e}};export{HealthResponseError};

package/dist/src/client/health-schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from "#compiled/zod/index.js";
+export declare const HealthResultSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    status: z.ZodLiteral<"ready">;
+    workflowId: z.ZodString;
+}, z.core.$strict>;
+export type HealthResult = z.infer<typeof HealthResultSchema>;

package/dist/src/client/health-schema.js

@@ -0,0 +1 @@
+import{z}from"#compiled/zod/index.js";const HealthResultSchema=z.object({ok:z.literal(!0),status:z.literal(`ready`),workflowId:z.string().min(1)}).strict();export{HealthResultSchema};

package/dist/src/client/index.d.ts

@@ -1,6 +1,9 @@
 export { EveAgentStore } from "#client/eve-agent-store.js";
 export { Client } from "#client/client.js";
 export { AgentInfoResponseError } from "#client/agent-info-error.js";
+export { AgentInfoResultSchema } from "#client/agent-info-schema.js";
+export { HealthResponseError } from "#client/health-response-error.js";
+export { HealthResultSchema } from "#client/health-schema.js";
 export { ClientError } from "#client/client-error.js";
 export { defaultMessageReducer } from "#client/message-reducer.js";
 export { createDataUrlFilePart, createTextWithFileContent } from "#client/file-parts.js";
@@ -8,11 +11,11 @@ export { MessageResponse } from "#client/message-response.js";
 export { ClientSession } from "#client/session.js";
 export { ClientSessions, type CreatedClientSession } from "#client/sessions.js";
 export type { EveAgentStoreCallbacks, EveAgentStoreInit, EveAgentStoreSnapshot, EveAgentStoreStatus, PrepareSend, } from "#client/eve-agent-store.js";
-export type { AgentInfoEntry, AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoFrameworkChannelEntry, AgentInfoFrameworkToolEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoResult, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, CancelSessionResult, ClearResult, CompactResult, ClientAuth, ClientOptions, ClientRedirectPolicy, HeadersValue, HealthResult, MessageResult, RespondTurnOptions, ResetResult, ResolvedStreamReconnectPolicy, SendTurnInput, SendTurnOptions, SessionSnapshot, ClientSessionState, StreamOptions, StreamReconnectPolicy, StreamReconnectRetryPolicy, TokenValue, } from "#client/types.js";
+export type { AgentInfoEntry, AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoResult, AgentInfoRemoteAgentEntry, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, CancelSessionResult, ClearResult, CompactResult, ClientAuth, ClientOptions, ClientRedirectPolicy, HeadersValue, HealthResult, MessageResult, RespondTurnOptions, ResetResult, ResolvedStreamReconnectPolicy, SendTurnInput, SendTurnOptions, SessionSnapshot, ClientSessionState, StreamOptions, StreamReconnectPolicy, StreamReconnectRetryPolicy, TokenValue, } from "#client/types.js";
 export type { EveAgentReducer, EveAgentReducerEvent, ClientInputRespondedEvent, ClientMessageFailedEvent, ClientMessageSubmittedEvent, } from "#client/reducer.js";
 export type { EveAuthorizationChallenge, EveAuthorizationOutcome, EveAuthorizationPart, EveMessageData, EveDynamicToolPart, EveMessageInputRequest, EveMessage, EveMessageMetadata, EveMessagePart, EveMessageToolMetadata, } from "#client/message-reducer.js";
 export type { ActionPartialStreamEvent, ActionResultStreamEvent, ActionsRequestedStreamEvent, AssistantStepFinishReason, AuthorizationOutcome, CompactionCompletedStreamEvent, CompactionRequestedStreamEvent, AuthorizationCompletedStreamEvent, ConnectionAuthorizationOutcome, AuthorizationRequiredStreamEvent, HandleMessageStreamEvent, MessageStreamEventMeta, InputResolution, InputResolutionOutcome, InputResolvedStreamEvent, InputRequestedStreamEvent, MessageAppendedStreamEvent, MessageCompletedStreamEvent, MessageReceivedPart, MessageReceivedStreamEvent, ReasoningAppendedStreamEvent, ReasoningCompletedStreamEvent, ResultCompletedStreamEvent, RuntimeTraceContext, SessionCompletedStreamEvent, SessionFailedStreamEvent, SessionStartedStreamEvent, SessionWaitingStreamEvent, MessageStreamEvent, StepCompletedStreamEvent, StepFailedStreamEvent, StepStartedStreamEvent, SubagentCalledStreamEvent, SubagentChildEventStreamEvent, SubagentCompletedStreamEvent, SubagentStartedStreamEvent, TurnCancelledStreamEvent, TurnCompletedStreamEvent, TurnFailedStreamEvent, TurnStartedStreamEvent, TurnFailureStreamEvent, } from "#protocol/message.js";
 export { isCurrentTurnBoundaryEvent, isTurnFailureEvent } from "#protocol/message.js";
-export type { InputOption, InputRequest, InputRequestKind, InputResponse, } from "#runtime/input/types.js";
-export { inputOptionSchema, inputRequestKindSchema, inputRequestSchema, inputResponseSchema, isInputRequest, isInputResponse, parseInputResponse, parseInputResponses, } from "#runtime/input/types.js";
+export type { InputOption, InputRequest, InputRequestKind, InputResponse } from "#shared/input.js";
+export { inputOptionSchema, inputRequestKindSchema, inputRequestSchema, inputResponseSchema, isInputRequest, isInputResponse, parseInputResponse, parseInputResponses, } from "#shared/input.js";
 export { resolveTextToResponse, resolveTextToResponses } from "#channel/resolve-text.js";

package/dist/src/client/index.js

@@ -1 +1 @@
-import{inputOptionSchema,inputRequestKindSchema,inputRequestSchema,inputResponseSchema,isInputRequest,isInputResponse,parseInputResponse,parseInputResponses}from"#runtime/input/types.js";import{isCurrentTurnBoundaryEvent,isTurnFailureEvent}from"#protocol/message.js";import{AgentInfoResponseError}from"#client/agent-info-error.js";import{ClientError}from"#client/client-error.js";import{ClientSessions}from"#client/sessions.js";import{Client}from"#client/client.js";import{EveAgentStore}from"#client/eve-agent-store.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{createDataUrlFilePart,createTextWithFileContent}from"#client/file-parts.js";import{MessageResponse}from"#client/message-response.js";import{ClientSession}from"#client/session.js";import{resolveTextToResponse,resolveTextToResponses}from"#channel/resolve-text.js";export{AgentInfoResponseError,Client,ClientError,ClientSession,ClientSessions,EveAgentStore,MessageResponse,createDataUrlFilePart,createTextWithFileContent,defaultMessageReducer,inputOptionSchema,inputRequestKindSchema,inputRequestSchema,inputResponseSchema,isCurrentTurnBoundaryEvent,isInputRequest,isInputResponse,isTurnFailureEvent,parseInputResponse,parseInputResponses,resolveTextToResponse,resolveTextToResponses};
+import{inputOptionSchema,inputRequestKindSchema,inputRequestSchema,inputResponseSchema,isInputRequest,isInputResponse,parseInputResponse,parseInputResponses}from"#shared/input.js";import{isCurrentTurnBoundaryEvent,isTurnFailureEvent}from"#protocol/message.js";import{AgentInfoResponseError}from"#client/agent-info-error.js";import{HealthResponseError}from"#client/health-response-error.js";import{HealthResultSchema}from"#client/health-schema.js";import{AgentInfoResultSchema}from"#client/agent-info-schema.js";import{ClientError}from"#client/client-error.js";import{ClientSessions}from"#client/sessions.js";import{Client}from"#client/client.js";import{EveAgentStore}from"#client/eve-agent-store.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{createDataUrlFilePart,createTextWithFileContent}from"#client/file-parts.js";import{MessageResponse}from"#client/message-response.js";import{ClientSession}from"#client/session.js";import{resolveTextToResponse,resolveTextToResponses}from"#channel/resolve-text.js";export{AgentInfoResponseError,AgentInfoResultSchema,Client,ClientError,ClientSession,ClientSessions,EveAgentStore,HealthResponseError,HealthResultSchema,MessageResponse,createDataUrlFilePart,createTextWithFileContent,defaultMessageReducer,inputOptionSchema,inputRequestKindSchema,inputRequestSchema,inputResponseSchema,isCurrentTurnBoundaryEvent,isInputRequest,isInputResponse,isTurnFailureEvent,parseInputResponse,parseInputResponses,resolveTextToResponse,resolveTextToResponses};

package/dist/src/client/message-action-parts.d.ts

@@ -1,5 +1,5 @@
-import type { RuntimeActionRequest, RuntimeActionResult } from "#runtime/actions/types.js";
-import type { InputRequest } from "#runtime/input/types.js";
+import type { RuntimeActionRequest, RuntimeActionResult } from "#shared/action-types.js";
+import type { InputRequest } from "#shared/input.js";
 import type { EveDynamicToolPart, EveMessageInputRequest, EveMessageToolMetadata } from "#client/message-reducer-types.js";
 /**
  * Normalized tool descriptor derived from a runtime action request or result.

package/dist/src/client/message-reducer-types.d.ts

@@ -1,4 +1,4 @@
-import type { InputRequest, InputResponse } from "#runtime/input/types.js";
+import type { InputRequest, InputResponse } from "#shared/input.js";
 import type { AuthorizationOutcome } from "#protocol/message.js";
 /**
  * UIMessage-compatible eve message projection for chat and agent UIs.

package/dist/src/client/reducer.d.ts

@@ -1,5 +1,5 @@
 import type { MessageStreamEvent } from "#protocol/message.js";
-import type { InputResponse } from "#runtime/input/types.js";
+import type { InputResponse } from "#shared/input.js";
 /**
  * Client-side reducer event emitted before eve confirms a submitted user
  * message with a `message.received` stream event.

package/dist/src/client/session-utils.d.ts

@@ -1,5 +1,5 @@
 import type { AuthorizationRequiredStreamEvent, TurnFailureStreamEvent, UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { InputRequest } from "#runtime/input/types.js";
+import type { InputRequest } from "#shared/input.js";
 /** A connection authorization challenge that remains unresolved at a turn boundary. */
 export interface PendingAuthorization {
     readonly authorization?: AuthorizationRequiredStreamEvent["data"]["authorization"];

package/dist/src/client/session.d.ts

@@ -1,6 +1,6 @@
 import type { MessageStreamEvent } from "#protocol/message.js";
 import { MessageResponse } from "#client/message-response.js";
-import type { InputResponse } from "#runtime/input/types.js";
+import type { InputResponse } from "#shared/input.js";
 import type { CancelSessionResult, ClearResult, ClientSessionState, CompactResult, ClientRedirectPolicy, RespondTurnOptions, ResetResult, SendTurnInput, SendTurnOptions, SessionSnapshot, StreamOptions } from "#client/types.js";
 /**
  * Internal interface that a {@link ClientSession} uses to access client-level

package/dist/src/client/session.js

@@ -1 +1 @@
-import{EVE_SESSION_ROUTE_PATH,createEveSessionRoutePath}from"#protocol/routes.js";import{EVE_SESSION_ID_HEADER,isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{ClientError}from"#client/client-error.js";import{createClientUrl}from"#client/url.js";import{MessageResponse}from"#client/message-response.js";import{followStreamIterable}from"#client/open-stream.js";import{cancelClientSession,clearClientSession,compactClientSession,resetClientSession}from"#client/session-controls.js";import{serializeOutputSchema}from"#shared/tool-schema.js";var ClientSession=class ClientSession{#e;#t;constructor(e,t){this.#e=e,this.#t=t}static async create(t,n){let r=await postTurn(t,EVE_SESSION_ROUTE_PATH,n,!0),i=await readSessionId(r),a=new ClientSession(t,{sessionId:i,streamIndex:0});return{response:a.#r(r,n,0),session:a}}get state(){return this.#t}async snapshot(e){e?.signal?.throwIfAborted();let t=[];for await(let n of this.#o({follow:!1,signal:e?.signal,startIndex:0}))t.push(n);return e?.signal?.throwIfAborted(),{events:t,session:{sessionId:this.#t.sessionId,streamIndex:t.length}}}async send(e,t={}){return await this.#n({...t,message:e})}async respond(e,t={}){if(e.length===0)throw Error(`ClientSession.respond() requires at least one input response.`);return await this.#n({...t,inputResponses:e})}async#n(e){let n=this.#t.streamIndex,r=await postTurn(this.#e,createEveSessionRoutePath(this.#t.sessionId),e,!1);if(await readSessionId(r,this.#t.sessionId)!==this.#t.sessionId)throw Error(`Message route returned a different session id.`);return this.#r(r,e,n)}async cancel(e){return await cancelClientSession({context:this.#e,options:e,sessionId:this.#t.sessionId})}async clear(){return await clearClientSession({context:this.#e,sessionId:this.#t.sessionId})}async compact(){return await compactClientSession({context:this.#e,sessionId:this.#t.sessionId})}async reset(e){return await resetClientSession({context:this.#e,options:e,sessionId:this.#t.sessionId})}stream(e){if(e?.follow===!1&&(e.startIndex??this.#t.streamIndex)<0)throw Error(`stream({ follow: false }) requires a nonnegative startIndex; a tail-relative cursor cannot be bounded.`);return this.#a(e)}#r(e,t,n){return e.body?.cancel().catch(()=>{}),new MessageResponse({cancelTurn:async e=>await this.cancel({turnId:e}),createStream:()=>this.#i(n,t),sessionId:this.#t.sessionId})}async*#i(e,t){let n=0,i=new Set;try{for await(let a of this.#o({headers:t.headers,keepAlive:shouldKeepActiveTurnAlive(t.streamReconnectPolicy),signal:t.signal,startIndex:e,streamReconnectPolicy:t.streamReconnectPolicy}))if(n+=1,a.type===`authorization.required`&&a.data.webhookUrl!==void 0?i.add(a.data.name):a.type===`authorization.completed`&&i.delete(a.data.name),yield a,isCurrentTurnBoundaryEvent(a)&&(a.type!==`session.waiting`||i.size===0))break}finally{this.#t={sessionId:this.#t.sessionId,streamIndex:e+n}}}async*#a(e){let t=e?.startIndex??this.#t.streamIndex,n=0;try{for await(let r of this.#o({follow:e?.follow,signal:e?.signal,startIndex:t,streamReconnectPolicy:e?.streamReconnectPolicy}))n+=1,yield r}finally{t>=0&&(this.#t={sessionId:this.#t.sessionId,streamIndex:t+n})}}#o(e){return followStreamIterable({follow:e.follow,host:this.#e.host,keepAlive:e.keepAlive,resolveHeaders:()=>this.#e.resolveHeaders(e.headers),redirect:this.#e.redirect,sessionId:this.#t.sessionId,signal:e.signal,startIndex:e.startIndex,streamReconnectPolicy:e.streamReconnectPolicy})}};function shouldKeepActiveTurnAlive(e){return e&&`reconnect`in e?!1:e?.streamIdleReconnectPolicy?.maxAttempts===void 0}async function postTurn(e,t,n,r){let o=createMessageBody(n,r);if(o===null)throw Error(r?`Creating a session requires a non-empty message.`:`A session turn requires a non-empty message or inputResponses.`);let s=await e.resolveHeaders(n.headers);s.set(`content-type`,`application/json`);let c=await fetch(createClientUrl(e.host,t),{body:JSON.stringify(o),headers:s,method:`POST`,redirect:e.redirect,signal:n.signal??null});if(!c.ok){let e=await c.text();throw new ClientError(c.status,e,c.headers)}return c}async function readSessionId(e,t){let r=await e.json(),i=(typeof r.sessionId==`string`?r.sessionId:void 0)??e.headers.get(EVE_SESSION_ID_HEADER)?.trim()??t;if(!i)throw Error(`Message route did not return a session id.`);return i}function createMessageBody(e,t){let n={};e.message!==void 0&&(n.message=e.message),e.inputResponses!==void 0&&e.inputResponses.length>0&&(n.inputResponses=e.inputResponses),!t&&e.message!==void 0&&e.turnPolicy!==void 0&&(n.turnPolicy=e.turnPolicy),e.clientContext!==void 0&&(n.clientContext=e.clientContext);let r=serializeOutputSchema(e.outputSchema);return r!==void 0&&(n.outputSchema=r),t&&n.message===void 0||n.message===void 0&&n.inputResponses===void 0?null:n}export{ClientSession};
+import{EVE_SESSION_ROUTE_PATH,createEveSessionRoutePath}from"#protocol/routes.js";import{EVE_SESSION_ID_HEADER,isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{ClientError}from"#client/client-error.js";import{createClientUrl}from"#client/url.js";import{MessageResponse}from"#client/message-response.js";import{followStreamIterable}from"#client/open-stream.js";import{cancelClientSession,clearClientSession,compactClientSession,resetClientSession}from"#client/session-controls.js";import{serializeOutputSchema}from"#tools/schema.js";var ClientSession=class ClientSession{#e;#t;constructor(e,t){this.#e=e,this.#t=t}static async create(t,n){let r=await postTurn(t,EVE_SESSION_ROUTE_PATH,n,!0),i=await readSessionId(r),a=new ClientSession(t,{sessionId:i,streamIndex:0});return{response:a.#r(r,n,0),session:a}}get state(){return this.#t}async snapshot(e){e?.signal?.throwIfAborted();let t=[];for await(let n of this.#o({follow:!1,signal:e?.signal,startIndex:0}))t.push(n);return e?.signal?.throwIfAborted(),{events:t,session:{sessionId:this.#t.sessionId,streamIndex:t.length}}}async send(e,t={}){return await this.#n({...t,message:e})}async respond(e,t={}){if(e.length===0)throw Error(`ClientSession.respond() requires at least one input response.`);return await this.#n({...t,inputResponses:e})}async#n(e){let n=this.#t.streamIndex,r=await postTurn(this.#e,createEveSessionRoutePath(this.#t.sessionId),e,!1);if(await readSessionId(r,this.#t.sessionId)!==this.#t.sessionId)throw Error(`Message route returned a different session id.`);return this.#r(r,e,n)}async cancel(e){return await cancelClientSession({context:this.#e,options:e,sessionId:this.#t.sessionId})}async clear(){return await clearClientSession({context:this.#e,sessionId:this.#t.sessionId})}async compact(){return await compactClientSession({context:this.#e,sessionId:this.#t.sessionId})}async reset(e){return await resetClientSession({context:this.#e,options:e,sessionId:this.#t.sessionId})}stream(e){if(e?.follow===!1&&(e.startIndex??this.#t.streamIndex)<0)throw Error(`stream({ follow: false }) requires a nonnegative startIndex; a tail-relative cursor cannot be bounded.`);return this.#a(e)}#r(e,t,n){return e.body?.cancel().catch(()=>{}),new MessageResponse({cancelTurn:async e=>await this.cancel({turnId:e}),createStream:()=>this.#i(n,t),sessionId:this.#t.sessionId})}async*#i(e,t){let n=0,i=new Set;try{for await(let a of this.#o({headers:t.headers,keepAlive:shouldKeepActiveTurnAlive(t.streamReconnectPolicy),signal:t.signal,startIndex:e,streamReconnectPolicy:t.streamReconnectPolicy}))if(n+=1,a.type===`authorization.required`&&a.data.webhookUrl!==void 0?i.add(a.data.name):a.type===`authorization.completed`&&i.delete(a.data.name),yield a,isCurrentTurnBoundaryEvent(a)&&(a.type!==`session.waiting`||i.size===0))break}finally{this.#t={sessionId:this.#t.sessionId,streamIndex:e+n}}}async*#a(e){let t=e?.startIndex??this.#t.streamIndex,n=0;try{for await(let r of this.#o({follow:e?.follow,signal:e?.signal,startIndex:t,streamReconnectPolicy:e?.streamReconnectPolicy}))n+=1,yield r}finally{t>=0&&(this.#t={sessionId:this.#t.sessionId,streamIndex:t+n})}}#o(e){return followStreamIterable({follow:e.follow,host:this.#e.host,keepAlive:e.keepAlive,resolveHeaders:()=>this.#e.resolveHeaders(e.headers),redirect:this.#e.redirect,sessionId:this.#t.sessionId,signal:e.signal,startIndex:e.startIndex,streamReconnectPolicy:e.streamReconnectPolicy})}};function shouldKeepActiveTurnAlive(e){return e&&`reconnect`in e?!1:e?.streamIdleReconnectPolicy?.maxAttempts===void 0}async function postTurn(e,t,n,r){let o=createMessageBody(n,r);if(o===null)throw Error(r?`Creating a session requires a non-empty message.`:`A session turn requires a non-empty message or inputResponses.`);let s=await e.resolveHeaders(n.headers);s.set(`content-type`,`application/json`);let c=await fetch(createClientUrl(e.host,t),{body:JSON.stringify(o),headers:s,method:`POST`,redirect:e.redirect,signal:n.signal??null});if(!c.ok){let e=await c.text();throw new ClientError(c.status,e,c.headers)}return c}async function readSessionId(e,t){let r=await e.json(),i=(typeof r.sessionId==`string`?r.sessionId:void 0)??e.headers.get(EVE_SESSION_ID_HEADER)?.trim()??t;if(!i)throw Error(`Message route did not return a session id.`);return i}function createMessageBody(e,t){let n={};e.message!==void 0&&(n.message=e.message),e.inputResponses!==void 0&&e.inputResponses.length>0&&(n.inputResponses=e.inputResponses),!t&&e.message!==void 0&&e.turnPolicy!==void 0&&(n.turnPolicy=e.turnPolicy),e.clientContext!==void 0&&(n.clientContext=e.clientContext);let r=serializeOutputSchema(e.outputSchema);return r!==void 0&&(n.outputSchema=r),t&&n.message===void 0||n.message===void 0&&n.inputResponses===void 0?null:n}export{ClientSession};

package/dist/src/client/types.d.ts

@@ -6,9 +6,10 @@ import type { ClearStatus } from "#protocol/clear-session.js";
 import type { CompactStatus } from "#protocol/compact-session.js";
 import type { ResetStatus } from "#protocol/reset-session.js";
 import type { TurnPolicy } from "#channel/types.js";
-import type { InputRequest, InputResponse } from "#runtime/input/types.js";
+import type { InputRequest, InputResponse } from "#shared/input.js";
 import type { JsonObject } from "#shared/json.js";
-export type { AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoEntry, AgentInfoFrameworkChannelEntry, AgentInfoFrameworkToolEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoResult, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, } from "./agent-info-schema.js";
+export type { HealthResult } from "#client/health-schema.js";
+export type { AgentInfoChannelEntry, AgentInfoChannels, AgentInfoConnectionEntry, AgentInfoDynamicResolverEntry, AgentInfoEntry, AgentInfoHookEntry, AgentInfoInstructions, AgentInfoInstructionsEntry, AgentInfoMemoryEntry, AgentInfoResult, AgentInfoRemoteAgentEntry, AgentInfoSandboxEntry, AgentInfoScheduleEntry, AgentInfoSkillEntry, AgentInfoSource, AgentInfoSubagentEntry, AgentInfoToolEntry, AgentInfoTools, } from "./agent-info-schema.js";
 /**
  * Static credential value or per-request credential resolver.
  */
@@ -244,11 +245,6 @@ export interface MessageResult<TOutput = unknown> {
 /**
  * Response from the health endpoint.
  */
-export interface HealthResult {
-    readonly ok: true;
-    readonly status: "ready";
-    readonly workflowId: string;
-}
 /**
  * Serializable cursor for one fixed, ID-addressed client session.
  */

package/dist/src/compiler/artifacts.d.ts

@@ -1,14 +1,16 @@
-import type { DiscoverDiagnostic, DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
+import { z } from "#compiled/zod/index.js";
+import { type DiscoverDiagnostic, type DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
 import type { AgentSourceManifest } from "#discover/manifest.js";
 import type { CompiledAgentManifest } from "#compiler/manifest.js";
+import { type CompilerDiagnostic } from "#compiler/diagnostics.js";
 /**
  * Stable diagnostics artifact kind emitted by the compiler.
  */
-declare const DISCOVERY_DIAGNOSTICS_ARTIFACT_KIND = "eve-discovery-diagnostics";
+export declare const COMPILER_DIAGNOSTICS_ARTIFACT_KIND = "eve-compiler-diagnostics";
 /**
  * Current diagnostics artifact schema version.
  */
-declare const DISCOVERY_DIAGNOSTICS_ARTIFACT_VERSION = 1;
+export declare const COMPILER_DIAGNOSTICS_ARTIFACT_VERSION = 2;
 /**
  * Stable compile metadata artifact kind emitted by the compiler.
  */
@@ -16,7 +18,7 @@ export declare const COMPILE_METADATA_KIND = "eve-compile-metadata";
 /**
  * Current compile metadata schema version.
  */
-export declare const COMPILE_METADATA_VERSION = 5;
+export declare const COMPILE_METADATA_VERSION = 6;
 /**
  * Structured paths for compiler-owned artifacts under `.eve/`.
  */
@@ -31,14 +33,36 @@ export interface CompilerArtifactPaths {
     moduleMapPath: string;
 }
 /**
- * Machine-readable discovery diagnostics artifact written by the compiler.
+ * Machine-readable compiler diagnostics artifact written by the compiler.
  */
-interface DiscoveryDiagnosticsArtifact {
-    diagnostics: DiscoverDiagnostic[];
-    kind: typeof DISCOVERY_DIAGNOSTICS_ARTIFACT_KIND;
+export interface CompilerDiagnosticsArtifact {
+    diagnostics: CompilerDiagnostic[];
+    kind: typeof COMPILER_DIAGNOSTICS_ARTIFACT_KIND;
     summary: DiscoverDiagnosticsSummary;
-    version: typeof DISCOVERY_DIAGNOSTICS_ARTIFACT_VERSION;
+    version: typeof COMPILER_DIAGNOSTICS_ARTIFACT_VERSION;
 }
+export declare const compilerDiagnosticsArtifactSchema: z.ZodObject<{
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        sources: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            logicalPath: z.ZodOptional<z.ZodString>;
+            nodeId: z.ZodString;
+            sourceId: z.ZodOptional<z.ZodString>;
+            sourcePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    kind: z.ZodLiteral<"eve-compiler-diagnostics">;
+    summary: z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+    }, z.core.$strict>;
+    version: z.ZodLiteral<2>;
+}, z.core.$strict>;
 /**
  * One artifact digest recorded in compile metadata.
  */
@@ -51,6 +75,7 @@ interface CompileArtifactDigest {
  */
 export interface CompileMetadata {
     compile: {
+        manifest: CompileArtifactDigest;
         moduleMap: CompileArtifactDigest;
     };
     discovery: {
@@ -72,7 +97,7 @@ export interface CompilerArtifactLocations {
     readonly writeRoot: string;
 }
 /**
- * Input for writing compiler-owned discovery artifacts.
+ * Input for writing compiler-owned source and diagnostic artifacts.
  */
 interface WriteCompilerArtifactsInput {
     appRoot: string;
@@ -85,7 +110,7 @@ interface WriteCompilerArtifactsInput {
  */
 interface WriteCompilerArtifactsResult {
     compiledManifest: CompiledAgentManifest;
-    diagnosticsArtifact: DiscoveryDiagnosticsArtifact;
+    diagnosticsArtifact: CompilerDiagnosticsArtifact;
     metadata: CompileMetadata;
     moduleMapSource: string;
     paths: CompilerArtifactPaths;
@@ -98,6 +123,7 @@ export declare function resolveCompilerArtifactPaths(appRoot: string): CompilerA
  */
 export declare function createCompileMetadata(input: {
     appRoot: string;
+    compiledManifestJson: string;
     diagnosticsArtifactJson: string;
     diagnosticsSummary: DiscoverDiagnosticsSummary;
     discoveryManifestJson: string;

package/dist/src/compiler/artifacts.js

@@ -1 +1 @@
-import{createHash}from"node:crypto";import{mkdir,writeFile}from"node:fs/promises";import{join,relative,resolve}from"node:path";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{normalizeLogicalPath}from"#discover/filesystem.js";import{summarizeDiscoverDiagnostics}from"#discover/diagnostics.js";import{createCompiledModuleMapSource}from"#compiler/module-map.js";import{compileAgentManifest}from"#compiler/normalize-manifest.js";import{materializeWorkspaceResources}from"#compiler/workspace-resources.js";const COMPILE_METADATA_KIND=`eve-compile-metadata`,COMPILE_METADATA_VERSION=5;function resolveCompilerArtifactPaths(e){return resolveCompilerArtifactPathsAt(e,join(resolve(e),`.eve`))}function resolveCompilerArtifactPathsAt(e,t){let n=resolve(e),i=resolve(t),o=join(i,`discovery`),s=join(i,`compile`);return{appRoot:n,compiledManifestPath:join(s,`compiled-agent-manifest.json`),compileDirectoryPath:s,compileMetadataPath:join(s,`compile-metadata.json`),diagnosticsPath:join(o,`diagnostics.json`),discoveryManifestPath:join(o,`agent-discovery-manifest.json`),discoveryDirectoryPath:o,moduleMapPath:join(s,`module-map.mjs`)}}function createDiscoveryDiagnosticsArtifact(e){return{diagnostics:[...e],kind:`eve-discovery-diagnostics`,summary:summarizeDiscoverDiagnostics(e),version:1}}function createCompileMetadata(e){let t=resolveInstalledPackageInfo(),n=createContentHash(e.discoveryManifestJson),r=createContentHash(e.diagnosticsArtifactJson),i=createContentHash(e.moduleMapSource);return{compile:{moduleMap:{path:toArtifactRelativePath(e.appRoot,e.paths.moduleMapPath),sha256:i}},discovery:{diagnostics:{path:toArtifactRelativePath(e.appRoot,e.paths.diagnosticsPath),sha256:r},manifest:{path:toArtifactRelativePath(e.appRoot,e.paths.discoveryManifestPath),sha256:n},sourceGraphHash:createContentHash(`${n}:${r}:${i}`),summary:e.diagnosticsSummary},generator:{name:t.name,version:t.version},kind:COMPILE_METADATA_KIND,status:e.diagnosticsSummary.errors>0?`failed`:`ready`,version:5}}async function writeCompilerArtifacts(e){let r=resolveCompilerArtifactPathsAt(e.appRoot,e.artifactLocations.writeRoot),i=resolveCompilerArtifactPathsAt(e.appRoot,e.artifactLocations.publishedRoot),a=createDiscoveryDiagnosticsArtifact(e.diagnostics),o=await materializeWorkspaceResources({compileDirectoryPath:r.compileDirectoryPath,manifest:await compileAgentManifest(e.manifest)}),s=serializeArtifactJson(o),c=serializeArtifactJson(e.manifest),l=serializeArtifactJson(a),u=createCompiledModuleMapSource({manifest:o,moduleMapPath:i.moduleMapPath}),d=createCompileMetadata({appRoot:e.appRoot,diagnosticsArtifactJson:l,diagnosticsSummary:a.summary,discoveryManifestJson:c,moduleMapSource:u,paths:i}),f=serializeArtifactJson(d);return await mkdir(r.discoveryDirectoryPath,{recursive:!0}),await mkdir(r.compileDirectoryPath,{recursive:!0}),await Promise.all([writeFile(r.compiledManifestPath,s),writeFile(r.diagnosticsPath,l),writeFile(r.discoveryManifestPath,c),writeFile(r.moduleMapPath,u),writeFile(r.compileMetadataPath,f)]),{compiledManifest:o,diagnosticsArtifact:a,metadata:d,moduleMapSource:u,paths:r}}function createContentHash(t){return createHash(`sha256`).update(t).digest(`hex`)}function serializeArtifactJson(e){return`${JSON.stringify(e,null,2)}\n`}function toArtifactRelativePath(e,t){return normalizeLogicalPath(relative(resolve(e),t))}export{COMPILE_METADATA_KIND,COMPILE_METADATA_VERSION,createCompileMetadata,resolveCompilerArtifactPaths,writeCompilerArtifacts};
+import{createHash}from"node:crypto";import{mkdir,writeFile}from"node:fs/promises";import{z}from"#compiled/zod/index.js";import{join,relative,resolve}from"node:path";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{normalizeLogicalPath}from"#discover/filesystem.js";import{discoverDiagnosticsSummarySchema}from"#discover/diagnostics.js";import{ROOT_COMPILED_AGENT_NODE_ID}from"#compiler/manifest.js";import{compilerDiagnosticSchema,projectDiscoverDiagnostic,summarizeCompilerDiagnostics}from"#compiler/diagnostics.js";import{createCompiledModuleMapSource}from"#compiler/module-map.js";import{compileAgentManifest}from"#compiler/normalize-manifest.js";import{materializeWorkspaceResources}from"#compiler/workspace-resources.js";const COMPILER_DIAGNOSTICS_ARTIFACT_KIND=`eve-compiler-diagnostics`,COMPILER_DIAGNOSTICS_ARTIFACT_VERSION=2,COMPILE_METADATA_KIND=`eve-compile-metadata`,COMPILE_METADATA_VERSION=6,compilerDiagnosticsArtifactSchema=z.object({diagnostics:z.array(compilerDiagnosticSchema),kind:z.literal(COMPILER_DIAGNOSTICS_ARTIFACT_KIND),summary:discoverDiagnosticsSummarySchema,version:z.literal(2)}).strict();function resolveCompilerArtifactPaths(e){return resolveCompilerArtifactPathsAt(e,join(resolve(e),`.eve`))}function resolveCompilerArtifactPathsAt(e,t){let n=resolve(e),r=resolve(t),a=join(r,`discovery`),s=join(r,`compile`);return{appRoot:n,compiledManifestPath:join(s,`compiled-agent-manifest.json`),compileDirectoryPath:s,compileMetadataPath:join(s,`compile-metadata.json`),diagnosticsPath:join(a,`diagnostics.json`),discoveryManifestPath:join(a,`agent-discovery-manifest.json`),discoveryDirectoryPath:a,moduleMapPath:join(s,`module-map.mjs`)}}function createCompilerDiagnosticsArtifact(e){return{diagnostics:[...e],kind:COMPILER_DIAGNOSTICS_ARTIFACT_KIND,summary:summarizeCompilerDiagnostics(e),version:2}}function createCompileMetadata(e){let t=resolveInstalledPackageInfo(),n=createContentHash(e.compiledManifestJson),r=createContentHash(e.discoveryManifestJson),i=createContentHash(e.diagnosticsArtifactJson),a=createContentHash(e.moduleMapSource);return{compile:{manifest:{path:toArtifactRelativePath(e.appRoot,e.paths.compiledManifestPath),sha256:n},moduleMap:{path:toArtifactRelativePath(e.appRoot,e.paths.moduleMapPath),sha256:a}},discovery:{diagnostics:{path:toArtifactRelativePath(e.appRoot,e.paths.diagnosticsPath),sha256:i},manifest:{path:toArtifactRelativePath(e.appRoot,e.paths.discoveryManifestPath),sha256:r},sourceGraphHash:createContentHash(`${n}:${r}:${i}:${a}`),summary:e.diagnosticsSummary},generator:{name:t.name,version:t.version},kind:COMPILE_METADATA_KIND,status:e.diagnosticsSummary.errors>0?`failed`:`ready`,version:6}}async function writeCompilerArtifacts(e){let r=resolveCompilerArtifactPathsAt(e.appRoot,e.artifactLocations.writeRoot),i=resolveCompilerArtifactPathsAt(e.appRoot,e.artifactLocations.publishedRoot),a=e.diagnostics.map(e=>projectDiscoverDiagnostic(e,ROOT_COMPILED_AGENT_NODE_ID)),o=await materializeWorkspaceResources({compileDirectoryPath:r.compileDirectoryPath,manifest:await compileAgentManifest(e.manifest,{diagnostics:a})}),s=createCompilerDiagnosticsArtifact(a),c=serializeArtifactJson(o),l=serializeArtifactJson(e.manifest),u=serializeArtifactJson(s),d=createCompiledModuleMapSource({manifest:o,moduleMapPath:i.moduleMapPath}),f=createCompileMetadata({appRoot:e.appRoot,compiledManifestJson:c,diagnosticsArtifactJson:u,diagnosticsSummary:s.summary,discoveryManifestJson:l,moduleMapSource:d,paths:i}),p=serializeArtifactJson(f);return await mkdir(r.discoveryDirectoryPath,{recursive:!0}),await mkdir(r.compileDirectoryPath,{recursive:!0}),await Promise.all([writeFile(r.compiledManifestPath,c),writeFile(r.diagnosticsPath,u),writeFile(r.discoveryManifestPath,l),writeFile(r.moduleMapPath,d),writeFile(r.compileMetadataPath,p)]),{compiledManifest:o,diagnosticsArtifact:s,metadata:f,moduleMapSource:d,paths:r}}function createContentHash(t){return createHash(`sha256`).update(t).digest(`hex`)}function serializeArtifactJson(e){return`${JSON.stringify(e,null,2)}\n`}function toArtifactRelativePath(e,t){return normalizeLogicalPath(relative(resolve(e),t))}export{COMPILER_DIAGNOSTICS_ARTIFACT_KIND,COMPILER_DIAGNOSTICS_ARTIFACT_VERSION,COMPILE_METADATA_KIND,COMPILE_METADATA_VERSION,compilerDiagnosticsArtifactSchema,createCompileMetadata,resolveCompilerArtifactPaths,writeCompilerArtifacts};

package/dist/src/compiler/channel-route-plan.d.ts

@@ -0,0 +1,10 @@
+import type { CompiledChannelDefinition, CompiledChannelRoutePlan } from "#compiler/manifest.js";
+import type { AgentSourceDescriptor, CompiledModuleBinding } from "#compiler/source-graph.js";
+import { type CompilerDiagnostic } from "#compiler/diagnostics.js";
+export declare function createCompiledChannelRoutePlan(input: {
+    readonly bindings: Readonly<Record<string, CompiledModuleBinding>>;
+    readonly channels: readonly CompiledChannelDefinition[];
+    readonly diagnostics?: CompilerDiagnostic[];
+    readonly nodeId: string;
+    readonly sources: Readonly<Record<string, AgentSourceDescriptor>>;
+}): CompiledChannelRoutePlan;

package/dist/src/compiler/channel-route-plan.js

@@ -0,0 +1 @@
+import{createChannelRouteShadowedDiagnostic}from"#compiler/diagnostics.js";import{HOST_HTTP_INVENTORY}from"#framework/host-inventory.js";function createCompiledChannelRoutePlan(n){let r=[],i=[];for(let a of n.channels){let o=HOST_HTTP_INVENTORY.find(e=>routesOverlap(a,e));if(o!==void 0)throw Error(`compile/reserved-route-collision: ${a.method} ${a.urlPath} overlaps reserved ${o.method} ${o.path}.`);let s=r.find(e=>routesOverlap(a,e));if(s===void 0){r.push(a);continue}if(s.sourceId===a.sourceId)throw Error(`compile/channel-route-duplicate: source "${a.sourceId}" emits ${a.method} ${a.urlPath} more than once.`);let c=n.bindings[a.sourceId],l=n.sources[a.sourceId],u=n.sources[s.sourceId];if(c===void 0||l===void 0||u===void 0)throw Error(`Channel source "${a.sourceId}" has no compiled binding.`);i.push({method:a.method,source:l,urlPath:a.urlPath,winnerSourceId:s.sourceId}),n.diagnostics?.push(createChannelRouteShadowedDiagnostic({loser:l,method:a.method,nodeId:n.nodeId,urlPath:a.urlPath,winner:u}))}let a=derivePreflights(r);return{effective:Object.freeze(r),preflight:Object.freeze(a),shadowed:Object.freeze(i)}}function derivePreflights(e){let t=e.filter(e=>e.method!==`WEBSOCKET`&&e.cors!==void 0);for(let[e,n]of t.entries()){let r=t.slice(e+1).find(e=>routePatternsOverlap(n.urlPath,e.urlPath)&&JSON.stringify(n.cors)!==JSON.stringify(e.cors));if(r!==void 0)throw Error(`compile/channel-cors-conflict: overlapping routes at "${n.urlPath}" and "${r.urlPath}" declare different CORS policies.`)}let n=new Map;for(let e of t){let t=normalizeRoutePattern(e.urlPath),r=n.get(t)??[];r.push(e),n.set(t,r)}let r=[];for(let t of n.values()){let n=t[0],i=JSON.stringify(n.cors);if(t.some(e=>JSON.stringify(e.cors)!==i))throw Error(`compile/channel-cors-conflict: routes at "${n.urlPath}" declare different CORS policies.`);if(e.some(e=>e.method===`OPTIONS`&&routePatternsOverlap(e.urlPath,n.urlPath)))throw Error(`compile/channel-preflight-collision: explicit OPTIONS route overlaps generated preflight at "${n.urlPath}".`);r.push({cors:n.cors,method:`OPTIONS`,sourceIds:[...new Set(t.map(e=>e.sourceId))],urlPath:n.urlPath})}return r}function routesOverlap(e,t){return methodsOverlap(e.method,t.method)&&routePatternsOverlap(e.urlPath,t.path??t.urlPath)}function methodsOverlap(e,t){return e===`ALL`||t===`ALL`||e===t}function routePatternsOverlap(e,t){let n=splitRoute(e),r=splitRoute(t);return n.length===r.length&&n.every((e,t)=>isParameter(e)||isParameter(r[t])||e===r[t])}function normalizeRoutePattern(e){return splitRoute(e).map(e=>isParameter(e)?`:`:e).join(`/`)}function splitRoute(e){return e.replace(/^\/+|\/+$/g,``).split(`/`)}function isParameter(e){return e.startsWith(`:`)||/^\[[^\]]+\]$/.test(e)}export{createCompiledChannelRoutePlan};

package/dist/src/compiler/compile-agent.d.ts

@@ -1,8 +1,8 @@
-import type { DiscoverDiagnostic } from "#discover/diagnostics.js";
 import type { ResolvedDiscoveryProject } from "#discover/project.js";
 import { type ProjectSource } from "#discover/project-source.js";
 import { type CompileMetadata, type CompilerArtifactLocations, type CompilerArtifactPaths } from "#compiler/artifacts.js";
 import type { CompiledAgentManifest } from "#compiler/manifest.js";
+import { type CompilerDiagnostic } from "#compiler/diagnostics.js";
 /**
  * Input for compiling the current authored agent into framework-owned
  * discovery artifacts.
@@ -20,7 +20,7 @@ export interface CompileAgentInput {
  * artifacts.
  */
 export interface CompileAgentResult {
-    diagnostics: DiscoverDiagnostic[];
+    diagnostics: CompilerDiagnostic[];
     manifest: CompiledAgentManifest;
     metadata: CompileMetadata;
     paths: CompilerArtifactPaths;

package/dist/src/compiler/compile-agent.js

@@ -1,3 +1,3 @@
-import{join}from"node:path";import{resolveDiscoveryProject}from"#discover/project.js";import{discoverAgent}from"#discover/discover-agent.js";import{hasDiscoverErrors,summarizeDiscoverDiagnostics}from"#discover/diagnostics.js";import{createDiskProjectSource}from"#discover/project-source.js";import{writeCompilerArtifacts}from"#compiler/artifacts.js";var CompileAgentError=class CompileAgentError extends Error{result;constructor(e,t){super(t),this.name=`CompileAgentError`,this.result=e}static fromDurableArtifacts(e){let[t,...n]=formatCompileAgentErrorLines(e.diagnostics);return new CompileAgentError(e,[t,`Diagnostics artifact: ${e.paths.diagnosticsPath}`,...n].join(`
+import{join}from"node:path";import{resolveDiscoveryProject}from"#discover/project.js";import{discoverAgent}from"#discover/discover-agent.js";import{summarizeCompilerDiagnostics}from"#compiler/diagnostics.js";import{createDiskProjectSource}from"#discover/project-source.js";import{writeCompilerArtifacts}from"#compiler/artifacts.js";var CompileAgentError=class CompileAgentError extends Error{result;constructor(e,t){super(t),this.name=`CompileAgentError`,this.result=e}static fromDurableArtifacts(e){let[t,...n]=formatCompileAgentErrorLines(e.diagnostics);return new CompileAgentError(e,[t,`Diagnostics artifact: ${e.paths.diagnosticsPath}`,...n].join(`
 `))}static fromTransientArtifacts(e){return new CompileAgentError(e,formatCompileAgentErrorLines(e.diagnostics).join(`
-`))}};async function compileAgent(t={}){let n=await discoverAgentForCompilation(t),r=join(n.project.appRoot,`.eve`);return finishAgentCompilation(await writeAgentCompilation(n,{publishedRoot:r,writeRoot:r}),CompileAgentError.fromDurableArtifacts)}async function compileAgentInWorkspace(e){return finishAgentCompilation(await writeAgentCompilation(await discoverAgentForCompilation({startPath:e.startPath}),e.artifactLocations),CompileAgentError.fromTransientArtifacts)}async function discoverAgentForCompilation(e){let r=e.source??createDiskProjectSource(),i=await resolveDiscoveryProject(e.startPath,{source:r}),a=await discoverAgent({...i,source:r});return{diagnostics:a.diagnostics,manifest:a.manifest,project:i}}async function writeAgentCompilation(e,t){let n=await writeCompilerArtifacts({appRoot:e.project.appRoot,artifactLocations:t,diagnostics:e.diagnostics,manifest:e.manifest});return{diagnostics:e.diagnostics,manifest:n.compiledManifest,metadata:n.metadata,paths:n.paths,project:e.project}}function finishAgentCompilation(e,t){if(hasDiscoverErrors(e.diagnostics))throw t(e);return reportDiscoverWarnings(e.diagnostics),e}function reportDiscoverWarnings(e){let t=e.filter(e=>e.severity===`warning`);if(t.length!==0)for(let e of t)console.warn(`Warning [${e.code}]: ${e.message}\n  source: ${e.sourcePath}`)}function formatCompileAgentErrorLines(e){let t=summarizeDiscoverDiagnostics(e),n=[`Discovery failed with ${t.errors} error(s) and ${t.warnings} warning(s).`];if(e.length===0)return n;n.push(`Discovery diagnostics:`);for(let t of e)n.push(`- ${formatDiagnosticSeverity(t.severity)}: ${t.message}`),n.push(`  source: ${t.sourcePath}`);return n}function formatDiagnosticSeverity(e){return e===`error`?`Error`:`Warning`}export{CompileAgentError,compileAgent,compileAgentInWorkspace};
+`))}};async function compileAgent(t={}){let n=await discoverAgentForCompilation(t),r=join(n.project.appRoot,`.eve`);return finishAgentCompilation(await writeAgentCompilation(n,{publishedRoot:r,writeRoot:r}),CompileAgentError.fromDurableArtifacts)}async function compileAgentInWorkspace(e){return finishAgentCompilation(await writeAgentCompilation(await discoverAgentForCompilation({startPath:e.startPath}),e.artifactLocations),CompileAgentError.fromTransientArtifacts)}async function discoverAgentForCompilation(e){let r=e.source??createDiskProjectSource(),i=await resolveDiscoveryProject(e.startPath,{source:r}),a=await discoverAgent({...i,source:r});return{diagnostics:a.diagnostics,manifest:a.manifest,project:i}}async function writeAgentCompilation(e,t){let n=await writeCompilerArtifacts({appRoot:e.project.appRoot,artifactLocations:t,diagnostics:e.diagnostics,manifest:e.manifest});return{diagnostics:n.diagnosticsArtifact.diagnostics,manifest:n.compiledManifest,metadata:n.metadata,paths:n.paths,project:e.project}}function finishAgentCompilation(e,t){if(e.diagnostics.some(e=>e.severity===`error`))throw t(e);return reportDiscoverWarnings(e.diagnostics),e}function reportDiscoverWarnings(e){let t=e.filter(e=>e.severity===`warning`);if(t.length!==0)for(let e of t)console.warn(`Warning [${e.code}]: ${e.message}\n  source: ${formatDiagnosticSources(e)}`)}function formatCompileAgentErrorLines(e){let t=summarizeCompilerDiagnostics(e),n=[`Discovery failed with ${t.errors} error(s) and ${t.warnings} warning(s).`];if(e.length===0)return n;n.push(`Discovery diagnostics:`);for(let t of e)n.push(`- ${formatDiagnosticSeverity(t.severity)}: ${t.message}`),n.push(`  source: ${formatDiagnosticSources(t)}`);return n}function formatDiagnosticSources(e){return e.sources.map(e=>e.sourcePath??e.logicalPath??e.sourceId??e.nodeId).join(`, `)}function formatDiagnosticSeverity(e){return e===`error`?`Error`:`Warning`}export{CompileAgentError,compileAgent,compileAgentInWorkspace};

package/dist/src/compiler/compile-from-memory.d.ts

@@ -1,82 +1,43 @@
 import type { JsonObject } from "#shared/json.js";
-import { type CompiledAgentManifest } from "#compiler/manifest.js";
-import type { CompiledModuleMap } from "#compiler/module-map.js";
-/**
- * Declarative description of an in-memory authored agent used by the test
- * harness.
- */
+import { type AgentDefinition } from "#public/definitions/agent.js";
+import { type ToolDefinition } from "#tools/definition.js";
+import type { CompiledAgentManifest } from "#compiler/manifest.js";
+import { type CompiledModuleMap } from "#compiler/module-map.js";
+import { type ProgrammaticAgentModule } from "#compiler/source-graph.js";
 export interface CompileFromMemoryInput {
-    /** Identifies this synthetic agent in manifest metadata and error output. */
+    readonly agent?: AgentDefinition;
     readonly name?: string;
-    /**
-     * Virtual app root used in manifest paths. The directory does not need to
-     * exist on disk; discovery never runs against it.
-     */
     readonly appRoot?: string;
-    /**
-     * Virtual agent root. Defaults to `<appRoot>/agent`.
-     */
     readonly agentRoot?: string;
-    /** Model id assigned to the synthetic agent config. */
     readonly model: string;
-    /** Session token limits assigned to the synthetic agent config. */
     readonly limits?: {
         readonly maxInputTokensPerSession?: number | false;
         readonly maxOutputTokensPerSession?: number | false;
         readonly sessionTimeoutMs?: number | false;
     };
     readonly outputSchema?: JsonObject;
-    /**
-     * Authored tools to project into the compiled manifest and module map.
-     *
-     * Each entry corresponds to a single module-backed tool. The harness does
-     * not load the tool module from disk — its runtime behaviour is injected
-     * separately via the AppHarness `mockTool` API.
-     */
+    readonly revision?: string;
+    readonly modules?: readonly ProgrammaticAgentModule[];
     readonly tools?: readonly CompileFromMemoryToolInput[];
-    /**
-     * Authored markdown skills to include in the manifest.
-     */
     readonly skills?: readonly CompileFromMemorySkillInput[];
 }
-/**
- * Per-tool descriptor entry consumed by {@link compileFromMemory}.
- */
 export interface CompileFromMemoryToolInput {
-    /** Model-facing tool name; must match the slot name in the module map. */
     readonly name: string;
-    /** Human-readable description propagated to the compiled manifest. */
     readonly description?: string;
-    /**
-     * JSON-schema-like object describing the tool input. Passed through as-is
-     * (lowered to `null` when omitted).
-     */
     readonly inputSchema?: JsonObject | null;
-    /** JSON-schema-like object describing the tool output. */
     readonly outputSchema?: JsonObject;
+    readonly execute?: ToolDefinition["execute"];
+    readonly approval?: ToolDefinition["approval"];
+    readonly toModelOutput?: ToolDefinition["toModelOutput"];
 }
-/**
- * Per-skill descriptor entry consumed by {@link compileFromMemory}.
- */
 export interface CompileFromMemorySkillInput {
     readonly name: string;
     readonly description: string;
     readonly markdown?: string;
 }
-/**
- * Result produced by {@link compileFromMemory}. Shaped to match the subset
- * of `CompileAgentResult` that the runtime and harness need.
- */
 export interface CompileFromMemoryResult {
     readonly manifest: CompiledAgentManifest;
     readonly moduleMap: CompiledModuleMap;
 }
-/**
- * Builds a compiled manifest and matching module map directly from an
- * in-memory descriptor, bypassing discovery and bundling entirely.
- *
- * Intended for integration tests that want to exercise runtime behaviour
- * without the cost of real compilation. Production code must continue to
- * use {@link compileAgent}.
- */
-export declare function compileFromMemory(input: CompileFromMemoryInput): CompileFromMemoryResult;
+/** Compiles a synthetic application by registering one ordinary programmatic source. */
+export declare function compileFromMemory(input: CompileFromMemoryInput): Promise<CompileFromMemoryResult>;

package/dist/src/compiler/compile-from-memory.js

@@ -1 +1 @@
-import{classifyModelRouting}from"#internal/classify-model-routing.js";import{ROOT_COMPILED_AGENT_NODE_ID,createCompiledAgentManifest}from"#compiler/manifest.js";function compileFromMemory(t){let n=t.appRoot??`/virtual/eve-memory-app`,r=t.agentRoot??`${n}/agent`,i=t.name??`memory-agent`,a={model:{id:t.model,routing:classifyModelRouting(t.model)},name:i};t.limits!==void 0&&(a.limits=t.limits),t.outputSchema!==void 0&&(a.outputSchema=t.outputSchema);let o=(t.tools??[]).map(e=>({description:e.description??`${e.name} test tool.`,inputSchema:e.inputSchema??null,logicalPath:`tools/${e.name}.ts`,name:e.name,outputSchema:e.outputSchema,sourceId:createMemorySourceId(`tools/${e.name}.ts`),sourceKind:`module`}));return{manifest:createCompiledAgentManifest({agentRoot:r,appRoot:n,config:a,skills:(t.skills??[]).map(e=>({description:e.description,logicalPath:`skills/${e.name}.md`,markdown:e.markdown??`# ${e.name}\n`,name:e.name,sourceId:createMemorySourceId(`skills/${e.name}.md`),sourceKind:`markdown`})),tools:o}),moduleMap:{nodes:{[ROOT_COMPILED_AGENT_NODE_ID]:{modules:Object.fromEntries(o.map(e=>[e.sourceId,Object.freeze({})]))}}}}}function createMemorySourceId(e){return`memory::${e}`}export{compileFromMemory};
+import{randomUUID}from"node:crypto";import{createProgrammaticCompiledModuleMap}from"#compiler/module-map.js";import{compileAgentManifest}from"#compiler/normalize-manifest.js";import{createAgentSourceManifest}from"#discover/manifest.js";import{defineAgent}from"#public/definitions/agent.js";import{defineSkill}from"#public/definitions/skill.js";import{defineTool}from"#tools/definition.js";import{createAgentSourceRegistry,defineProgrammaticAgentSource}from"#compiler/source-graph.js";import{frameworkAgentSourceRegistry}from"#framework/sources/registry.js";async function compileFromMemory(t){let n=t.appRoot??`/virtual/eve-memory-app`,r=t.agentRoot??`${n}/agent`,i=`memory:${t.name??`memory-agent`}`,a=defineAgent(t.agent??{limits:t.limits,model:t.model,outputSchema:t.outputSchema}),o=createAgentSourceRegistry([{applyTo:`root`,source:defineProgrammaticAgentSource({id:i,modules:[{loadNamespace:async()=>({default:a}),logicalPath:`agent.ts`},...t.modules??[],...(t.tools??[]).map(e=>({loadNamespace:async()=>({default:createMemoryToolDefinition(e)}),logicalPath:`tools/${e.name}.ts`})),...(t.skills??[]).map(e=>({loadNamespace:async()=>({default:defineSkill({description:e.description,markdown:e.markdown??`# ${e.name}\n`})}),logicalPath:`skills/${e.name}.ts`}))],revision:t.revision??`memory-generation:${randomUUID()}`})}]),s=await compileAgentManifest(createAgentSourceManifest({agentId:t.name??`memory-agent`,agentRoot:r,appRoot:n}),{sourceRegistries:[o]});return{manifest:s,moduleMap:await createProgrammaticCompiledModuleMap(s,[frameworkAgentSourceRegistry,o])}}function createMemoryToolDefinition(e){return defineTool({approval:e.approval,description:e.description??`${e.name} test tool.`,execute:e.execute??(()=>{throw Error(`Memory tool "${e.name}" has no installed executor.`)}),inputSchema:e.inputSchema??{additionalProperties:!0,type:`object`},outputSchema:e.outputSchema,toModelOutput:e.toModelOutput})}export{compileFromMemory};

package/dist/src/compiler/diagnostics.d.ts

@@ -0,0 +1,38 @@
+import { z } from "#compiled/zod/index.js";
+import type { DiscoverDiagnostic, DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
+import type { AgentSourceDescriptor } from "#compiler/source-graph.js";
+export declare const compilerDiagnosticSeveritySchema: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+}>;
+export declare const compilerDiagnosticSourceSchema: z.ZodObject<{
+    logicalPath: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodString;
+    sourceId: z.ZodOptional<z.ZodString>;
+    sourcePath: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CompilerDiagnosticSource = z.infer<typeof compilerDiagnosticSourceSchema>;
+export declare const compilerDiagnosticSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    sources: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        logicalPath: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodString;
+        sourceId: z.ZodOptional<z.ZodString>;
+        sourcePath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type CompilerDiagnostic = z.infer<typeof compilerDiagnosticSchema>;
+export declare function projectDiscoverDiagnostic(diagnostic: DiscoverDiagnostic, nodeId: string): CompilerDiagnostic;
+export declare function createChannelRouteShadowedDiagnostic(input: {
+    readonly loser: AgentSourceDescriptor;
+    readonly method: string;
+    readonly nodeId: string;
+    readonly urlPath: string;
+    readonly winner: AgentSourceDescriptor;
+}): CompilerDiagnostic;
+export declare function summarizeCompilerDiagnostics(diagnostics: readonly CompilerDiagnostic[]): DiscoverDiagnosticsSummary;