eve 0.83.2 → 0.84.0

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

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{mountIdSchema}from"#shared/extension-mount.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`),mountId:mountIdSchema.optional(),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`),mountId:z.string().optional(),sourcePath:z.string()}).strict(),z.object({dependencies:z.record(z.string(),z.string()).optional(),kind:z.literal(`programmatic`),mountId:z.string().optional(),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`,`oauth`]),team:z.optional(z.string())}).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({provider:z.string().optional(),environmentExportName:z.string().optional(),revisionHash:z.string()}).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.union([z.enum([`subagent-call`,`workflow-tool-call`]),z.literal(`unrecognized`)]).catch(`unrecognized`).optional(),audience:z.array(z.union([z.literal(`root-session`),z.literal(`unrecognized`)]).catch(`unrecognized`)),kind:z.union([z.enum([`dispatch`,`provider-tool`]),z.literal(`unrecognized`)]).catch(`unrecognized`),sourceId:z.string()}).strict(),compositionDiagnostic=z.object({kind:z.enum([`disabled`,`shadowed`]),logicalPath:z.string(),owner,sourceId:z.string(),winnerSourceId:z.string().optional()}).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(5),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.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};
+import{z}from"#compiled/zod/index.js";import{mountIdSchema}from"#shared/extension-mount.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`),mountId:mountIdSchema.optional(),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`),mountId:z.string().optional(),sourcePath:z.string()}).strict(),z.object({dependencies:z.record(z.string(),z.string()).optional(),kind:z.literal(`programmatic`),mountId:z.string().optional(),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({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`,`oauth`]),team:z.optional(z.string())}).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()}).strict(),sandbox=source.extend({provider:z.string().optional(),environmentExportName:z.string().optional(),revisionHash:z.string()}).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.union([z.enum([`subagent-call`,`workflow-tool-call`]),z.literal(`unrecognized`)]).catch(`unrecognized`).optional(),audience:z.array(z.union([z.literal(`root-session`),z.literal(`unrecognized`)]).catch(`unrecognized`)),kind:z.union([z.enum([`dispatch`,`provider-tool`]),z.literal(`unrecognized`)]).catch(`unrecognized`),sourceId:z.string()}).strict(),compositionDiagnostic=z.object({kind:z.enum([`disabled`,`shadowed`]),logicalPath:z.string(),owner,sourceId:z.string(),winnerSourceId:z.string().optional()}).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(5),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.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/agent-info-types.d.ts

@@ -0,0 +1,281 @@
+/** Origin of a capability visible in agent inspection. */
+type Owner = {
+    readonly kind: "application";
+} | {
+    readonly kind: "framework";
+    readonly feature: string;
+} | {
+    readonly kind: "extension";
+    readonly mountId?: string;
+    readonly namespace: string;
+    readonly packageName: string;
+};
+type ModuleBacking = {
+    readonly kind: "filesystem";
+    readonly externalDependencies: readonly string[];
+    readonly extensionScope?: {
+        readonly namespace: string;
+        readonly sourceRoot: string;
+    };
+    readonly mountId?: string;
+    readonly sourcePath: string;
+} | {
+    readonly kind: "programmatic";
+    readonly dependencies?: Readonly<Record<string, string>>;
+    readonly mountId?: string;
+    readonly moduleId: string;
+    readonly parameters?: Readonly<Record<string, unknown>>;
+    readonly registryId: string;
+    readonly revision: string;
+    readonly semanticRevision?: string;
+};
+type Binding = {
+    readonly backing: ModuleBacking;
+    readonly logicalPath: string;
+    readonly owner: Owner;
+};
+/** Source of an inspected agent capability. */
+export interface AgentInfoSource {
+    readonly binding?: Binding;
+    readonly exportName?: string;
+    readonly logicalPath: string;
+    readonly owner: Owner;
+    readonly sourceId: string;
+    readonly sourceKind: "markdown" | "module" | "skill-package";
+}
+/** A named, inspected capability. */
+export interface AgentInfoEntry extends AgentInfoSource {
+    readonly name: string;
+}
+/** A dynamic capability definition. */
+export interface AgentInfoDynamicResolverEntry extends AgentInfoSource {
+    readonly slug: string;
+}
+/** An inspected tool definition. */
+export interface AgentInfoToolEntry extends AgentInfoEntry {
+    readonly description: string;
+    readonly hasAuth: boolean;
+    readonly hasExecute: boolean;
+    readonly hasModelOutputProjection: boolean;
+    readonly hasOutputSchema: boolean;
+    readonly inputSchema: unknown;
+    readonly outputSchema?: unknown;
+    readonly requiresApproval: boolean;
+}
+/** An inspected skill definition. */
+export interface AgentInfoSkillEntry extends AgentInfoEntry {
+    readonly description: string;
+    readonly license?: string;
+    readonly markdown: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+/** An inspected static instruction. */
+export interface AgentInfoInstructionsEntry extends AgentInfoEntry {
+    readonly content: string;
+    readonly role: "system" | "user";
+}
+/** An inspected schedule. */
+export interface AgentInfoScheduleEntry extends AgentInfoEntry {
+    readonly cron: string;
+    readonly hasRun: boolean;
+    readonly markdown?: string;
+}
+type ChannelMethod = "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "WEBSOCKET";
+/** An inspected channel route. */
+export interface AgentInfoChannelEntry extends AgentInfoEntry {
+    readonly adapterKind?: string;
+    readonly method: ChannelMethod;
+    readonly urlPath: string;
+}
+type SourceDescriptor = {
+    readonly backing: ModuleBacking | {
+        readonly kind: "resource";
+        readonly sourcePath: string;
+    };
+    readonly form: "derived" | "direct";
+    readonly layer: "framework-default" | "extension-package" | "extension-override" | "application";
+    readonly logicalPath: string;
+    readonly owner: Owner;
+    readonly sourceId: string;
+};
+/** Inspected winning and shadowed channel routes. */
+export interface AgentInfoChannels {
+    readonly routes: readonly AgentInfoChannelEntry[];
+    readonly shadowed: readonly {
+        readonly method: ChannelMethod;
+        readonly source: SourceDescriptor;
+        readonly urlPath: string;
+        readonly winnerSourceId: string;
+    }[];
+}
+/** An inspected connection. */
+export interface AgentInfoConnectionEntry extends AgentInfoSource {
+    readonly connectionName: string;
+    readonly description: string;
+    readonly hasApproval: boolean;
+    readonly hasAuthorization: boolean;
+    readonly hasHeaders: boolean;
+    readonly protocol: string;
+    readonly toolFilter?: unknown;
+    readonly url: string;
+}
+/** An inspected hook. */
+export interface AgentInfoHookEntry extends AgentInfoSource {
+    readonly eventNames: readonly string[];
+    readonly slug: string;
+}
+/** An inspected memory provider. */
+export interface AgentInfoMemoryEntry extends AgentInfoSource {
+    readonly description?: string;
+    readonly slot: string;
+}
+/** An inspected sandbox definition. */
+export interface AgentInfoSandboxEntry extends AgentInfoSource {
+    readonly provider?: string;
+    readonly environmentExportName?: string;
+    readonly revisionHash: string;
+}
+/** An inspected local agent. */
+export interface AgentInfoSubagentEntry extends AgentInfoEntry {
+    readonly configResolver?: AgentInfoDynamicResolverEntry;
+    readonly description?: string;
+    readonly entryPath: string;
+    readonly nodeId: string;
+    readonly parentNodeId: string;
+    readonly rootPath: string;
+    readonly summary: {
+        readonly channels: number;
+        readonly connections: number;
+        readonly hooks: number;
+        readonly instructions: number;
+        readonly memories: number;
+        readonly schedules: number;
+        readonly skills: number;
+        readonly tools: number;
+    };
+}
+/** An inspected remote agent. */
+export interface AgentInfoRemoteAgentEntry extends AgentInfoEntry {
+    readonly description: string;
+    readonly nodeId: string;
+    readonly parentNodeId: string;
+    readonly url?: string;
+}
+/** Static and dynamically resolved tools. */
+export interface AgentInfoTools {
+    readonly dynamic: readonly AgentInfoDynamicResolverEntry[];
+    readonly static: readonly AgentInfoToolEntry[];
+}
+/** Static and dynamically resolved instructions. */
+export interface AgentInfoInstructions {
+    readonly dynamic: readonly AgentInfoDynamicResolverEntry[];
+    readonly static: readonly AgentInfoInstructionsEntry[];
+}
+type ModelEndpoint = {
+    readonly kind: "external";
+    readonly provider: string;
+} | {
+    readonly kind: "chatgpt";
+    readonly state: "checking" | "ready" | "signed-out" | "reauth-required" | "unavailable";
+    readonly accountLabel?: string;
+} | {
+    readonly kind: "gateway";
+    readonly connected: true;
+    readonly credential: "api-key" | "oidc" | "oauth";
+    readonly team?: string;
+} | {
+    readonly kind: "gateway";
+    readonly connected: false;
+};
+type AgentModel = {
+    readonly contextWindowTokens?: number;
+    readonly providerOptions?: unknown;
+    readonly reasoning?: "provider-default" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    readonly source?: AgentInfoSource;
+} & ({
+    readonly endpoint?: ModelEndpoint;
+    readonly id: string;
+    readonly routing: {
+        readonly kind: "gateway";
+        readonly target: string;
+        readonly byok?: string;
+    } | {
+        readonly kind: "external";
+        readonly provider: string;
+    };
+} | {
+    readonly endpoint?: never;
+    readonly id?: never;
+    readonly routing: {
+        readonly kind: "dynamic";
+        readonly resolver: AgentInfoDynamicResolverEntry;
+    };
+});
+type CompositionDiagnostic = {
+    readonly kind: "disabled" | "shadowed";
+    readonly logicalPath: string;
+    readonly owner: Owner;
+    readonly sourceId: string;
+    readonly winnerSourceId?: string;
+};
+/** Authoritative `/eve/v1/info` v5 response, independent of its runtime validator. */
+export interface AgentInfoResult {
+    readonly agent: {
+        readonly agentRoot: string;
+        readonly appRoot: string;
+        readonly config: AgentInfoSource & {
+            readonly binding: Binding;
+        };
+        readonly description?: string;
+        readonly model: AgentModel;
+        readonly name: string;
+        readonly nodeId: string;
+        readonly outputSchema?: unknown;
+    };
+    readonly capabilities: {
+        readonly devRoutes: boolean;
+    };
+    readonly channels: AgentInfoChannels;
+    readonly composition: {
+        readonly disabled: readonly CompositionDiagnostic[];
+        readonly shadowed: readonly CompositionDiagnostic[];
+    };
+    readonly connections: readonly AgentInfoConnectionEntry[];
+    readonly diagnostics: {
+        readonly discoveryErrors: number;
+        readonly discoveryWarnings: number;
+    };
+    readonly hooks: readonly AgentInfoHookEntry[];
+    readonly instructions: AgentInfoInstructions;
+    readonly instrumentation?: AgentInfoSource;
+    readonly kernelEffects: readonly {
+        readonly action?: "subagent-call" | "workflow-tool-call" | "unrecognized";
+        readonly audience: readonly ("root-session" | "unrecognized")[];
+        readonly kind: "dispatch" | "provider-tool" | "unrecognized";
+        readonly sourceId: string;
+    }[];
+    readonly kind: "eve-agent-info";
+    readonly memories: readonly AgentInfoMemoryEntry[];
+    readonly mode: "development" | "production";
+    readonly remoteAgents: {
+        readonly entries: readonly AgentInfoRemoteAgentEntry[];
+        readonly total: number;
+    };
+    readonly sandbox: AgentInfoSandboxEntry;
+    readonly schedules: readonly AgentInfoScheduleEntry[];
+    readonly skills: {
+        readonly dynamic: readonly AgentInfoDynamicResolverEntry[];
+        readonly static: readonly AgentInfoSkillEntry[];
+    };
+    readonly subagents: {
+        readonly local: readonly AgentInfoSubagentEntry[];
+        readonly total: number;
+    };
+    readonly tools: AgentInfoTools;
+    readonly version: 5;
+    readonly workspace: {
+        readonly resourceRoot: unknown;
+        readonly rootEntries: readonly string[];
+    };
+}
+export {};

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

@@ -1,28 +1,25 @@
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import type { SessionReader } from "#shared/session.js";
+import { type FollowedEvent } from "#client/open-stream.js";
 import type { ClientSessionContext } from "#client/session.js";
-import type { StreamOptions } from "#client/types.js";
-import type { AgentStartedStreamEvent, MessageStreamEvent } from "#protocol/message.js";
-/**
- * A session an agent run opened, reached through the parent session whose
- * stream announced it with `agent.started`. Get one with
- * `session.agent(started)`. Every read uses the parent's host and
- * credentials: a local child's own route, or the parent-origin proxy for a
- * remote child, which the parent deployment authenticates to the remote agent
- * after checking that it recorded the child.
- */
-export declare class ClientAgentSession {
+import type { SessionStreamOptions } from "#client/types.js";
+import { type DescendantHop } from "#protocol/descendant-observation.js";
+/** A read-only child reached through recorded relationships on its parent's authorized reader. */
+export declare class ClientAgentSession implements SessionReader {
     #private;
-    /** The agent's name, as `agent.started` reports it. */
     readonly name: string;
-    /** The child session's id. */
-    readonly sessionId: string;
-    /** The task whose run opened the session; absent when an `execute` call opened it. */
+    readonly id: string;
     readonly taskId: string | undefined;
     /** @internal */
-    constructor(context: ClientSessionContext, started: AgentStartedStreamEvent);
-    /**
-     * Follows the child's durable event stream. Reading it never advances the
-     * parent session's cursor. The child cursor starts at `0`; pass `startIndex`
-     * to resume. Stop at a child turn boundary with `isCurrentTurnBoundaryEvent`.
-     */
-    stream(options?: StreamOptions): AsyncIterable<MessageStreamEvent>;
+    constructor(context: ClientSessionContext, rootId: string, opened: Extract<SessionStreamEvent, {
+        type: "child.opened";
+    }>, children?: readonly DescendantHop[]);
+    /** Resolves a further recorded child through this reader, including remote proxy hops. */
+    agent(opened: Extract<SessionStreamEvent, {
+        type: "child.opened";
+    }>): ClientAgentSession;
+    /** Reads independently of its parent; `follow: false` stops at the captured durable tail. */
+    stream(options?: SessionStreamOptions): AsyncGenerator<SessionStreamEvent>;
+    /** @internal The child's events and durable line cursor, with server-established provenance. */
+    follow(options?: SessionStreamOptions, onIdentity?: (key: string) => void, onCaughtUp?: () => void, onPosition?: (position: number) => void): AsyncIterable<FollowedEvent>;
 }

package/dist/src/client/agent-session.js

@@ -1 +1 @@
-import{followStreamIterable}from"#client/open-stream.js";var ClientAgentSession=class{name;sessionId;taskId;#e;#t;constructor(e,t){this.#e=e,this.#t=t.data.streamPath,this.name=t.data.name,this.sessionId=t.data.sessionId,this.taskId=t.data.taskId}stream(e){let t=e?.startIndex??0;if(e?.follow===!1&&t<0)throw Error(`agent(started).stream({ follow: false }) requires a nonnegative startIndex; a tail-relative cursor cannot be bounded.`);return followStreamIterable({follow:e?.follow,host:this.#e.host,path:this.#t,redirect:this.#e.redirect,resolveHeaders:()=>this.#e.resolveHeaders(),signal:e?.signal,startIndex:t,streamReconnectPolicy:e?.streamReconnectPolicy})}};export{ClientAgentSession};
+import{createEveDescendantStreamRoutePath}from"#protocol/routes.js";import{ClientError}from"#client/client-error.js";import{followStreamIterable}from"#client/open-stream.js";import{EVE_OBSERVATION_KEY_HEADER}from"#protocol/descendant-observation.js";var ClientAgentSession=class ClientAgentSession{name;id;taskId;#e;#t;#n;constructor(e,t,n,r=[]){let i=n.meta?.position?.line;if(!Number.isSafeInteger(i)||i<0)throw TypeError(`Pass a received child.opened event with its committed source position.`);this.#e=e,this.#t=t,this.#n=[...r,{sessionId:n.data.sessionId,position:i}],this.name=n.data.name,this.id=n.data.sessionId,this.taskId=n.scope?.taskId??(`taskId`in n.data.owner?n.data.owner.taskId:void 0)}agent(e){return new ClientAgentSession(this.#e,this.#t,e,this.#n)}async*stream(e){for await(let{event:t}of this.follow(e))yield t}follow(e,t,n,r){return followStreamIterable({follow:e?.follow,onCaughtUp:n,onPosition:r,baseUrl:this.#e.baseUrl,path:createEveDescendantStreamRoutePath(this.#t),searchParams:{children:JSON.stringify(this.#n)},redirect:`error`,resolveHeaders:()=>this.#e.resolveHeaders(),signal:e?.signal,startIndex:e?.startIndex??0,streamReconnectPolicy:e?.streamReconnectPolicy,onOpen:e=>{if(t===void 0)return;let n=e.get(EVE_OBSERVATION_KEY_HEADER);if(n===null||n.length>8192)throw new ClientError(422,`Descendant reader provenance is unavailable.`);t(n)}})}};export{ClientAgentSession};

package/dist/src/client/agent-stream-follower.d.ts

@@ -1,26 +1,17 @@
-import { type ConversationState } from "#client/conversation-state.js";
 import type { ClientSession } from "#client/session.js";
-import type { MessageStreamEvent } from "#protocol/message.js";
-export interface AgentStreamFollowerOptions {
-    /** The session whose stream announced the agents; reads use its host and credentials. */
-    readonly session: ClientSession;
-    readonly getState: () => ConversationState;
-    readonly onFollowing: (sessionId: string) => void;
-    readonly onEvent: (sessionId: string, event: MessageStreamEvent) => void;
-    readonly onIdle: (sessionId: string) => void;
-    readonly onUnavailable: (sessionId: string) => void;
-    /** Retained by the transport owner across detach and reattach. */
-    readonly cursors: Map<string, number>;
-}
-/**
- * Follows each agent tool's session while its task has content the conversation has not shown.
- * The conversation decides when a session is caught up; this class only owns transport.
- */
+import { Conversation } from "#client/conversation.js";
+import type { FollowAgents } from "#client/conversation-state.js";
+/** One bounded scheduler and projection registry for the root's entire observed descendant graph. */
 export declare class AgentStreamFollower {
     #private;
-    constructor(options: AgentStreamFollowerOptions);
-    acceptParentEvent(event: MessageStreamEvent): void;
-    /** Starts, resumes, or pauses subscriptions to match the conversation. */
+    constructor(options: {
+        session: ClientSession;
+        conversation: Conversation;
+        policy: FollowAgents;
+        onChange: () => void;
+    });
+    start(): void;
+    /** Discovery sees committed projections, never a partially received opening. */
     reconcile(): void;
     abortAll(): void;
 }

package/dist/src/client/agent-stream-follower.js

@@ -1 +1 @@
-import{agentToolTask,isAgentSessionCaughtUp}from"#client/conversation-state.js";const agentStreamReconnectPolicy={streamIdleReconnectPolicy:{maxAttempts:1/0},streamOpenReconnectPolicy:{maxAttempts:1/0}};var AgentStreamFollower=class{#e;#t=new Map;#n=new Map;#r=new Set;#i=!1;constructor(e){this.#e=e}acceptParentEvent(e){e.type===`agent.started`&&this.#t.set(e.data.sessionId,e)}reconcile(){if(this.#i)return;let e=this.#e.getState();for(let t of Object.values(e.agents)){if(agentToolTask(e,t)===void 0)continue;let n=this.#n.get(t.sessionId),r=isAgentSessionCaughtUp(e,t);n!==void 0&&r?(this.#n.delete(t.sessionId),n.abort(),this.#e.onIdle(t.sessionId)):n===void 0&&!r&&!this.#r.has(t.sessionId)&&this.#a(t.sessionId)}}abortAll(){this.#i=!0;for(let e of this.#n.values())e.abort();this.#n.clear()}#a(e){let t=this.#t.get(e);if(t===void 0)return;let n=new AbortController;this.#n.set(e,n),this.#e.onFollowing(e);let{cursors:r}=this.#e;(async()=>{let i=r.get(e)??0;try{for await(let a of this.#e.session.agent(t).stream({signal:n.signal,startIndex:i,streamReconnectPolicy:agentStreamReconnectPolicy})){if(n.signal.aborted)return;r.set(e,++i),this.#e.onEvent(e,a),this.reconcile()}}catch{}n.signal.aborted||this.#n.get(e)!==n||(this.#n.delete(e),this.#r.add(e),this.#e.onUnavailable(e))})()}};export{AgentStreamFollower};
+import{ClientError}from"#client/client-error.js";import{DEFAULT_STREAM_RECONNECT_POLICY,RECONNECT_BACKOFF,isRetryableStreamError}from"#client/open-stream.js";import{DESCENDANT_MAX_DEPTH,DESCENDANT_MAX_READS,DESCENDANT_MAX_SESSIONS,localObservationKey}from"#protocol/descendant-observation.js";import{Conversation}from"#client/conversation.js";var AgentStreamFollower=class{#e;#t=new Set;#n=new Map;#r;#i;#a=!1;#o=0;#s;constructor(e){this.#r=e.policy,this.#i=e.onChange,this.#e=this.#c(e.session,e.conversation,0),this.#e.key=localObservationKey(e.session.id),this.#n.set(this.#e.key,this.#e)}start(){if(!this.#a){this.#a=!0;for(let e of this.#t)e.readyAt=0,e.status===`interrupted`&&e.reason===`detached`&&(e.status=`queued`);this.reconcile()}}reconcile(){this.#a&&(this.#l(this.#e),this.#a&&(this.#f(),this.#u()))}abortAll(){this.#a=!1,this.#o+=1,clearTimeout(this.#s),this.#s=void 0;for(let e of this.#t)e.controller?.abort(),e.controller=void 0,e.conversation.discardUncommitted(),e.status!==`unavailable`&&(e.status=`interrupted`,e.reason=`detached`);this.#f()}#c(e,t,n){return{reader:e,conversation:t,readerDepth:n,depths:new Set([n]),edges:new Map,status:`queued`,caughtUp:!1,readyAt:0,failures:0,idleReads:0}}#l(e){let t=this.#o;for(let n of Object.values(e.conversation.view.children)){let r=e.edges.get(n.sessionId)??{depths:new Set};e.edges.set(n.sessionId,r);for(let i of e.depths){if(!this.#a||t!==this.#o)return;let a=i+1;if(r.depths.has(a))continue;r.depths.add(a);let o;if(a>DESCENDANT_MAX_DEPTH)o=`depth-limit`;else if(typeof this.#r==`function`)try{this.#r({depth:a,name:n.name,sessionId:n.sessionId,owner:n.owner})||(o=`predicate`)}catch{o=`predicate`}else this.#r||(o=`predicate`);if(!this.#a||t!==this.#o)return;if(o===void 0&&r.child===void 0&&this.#t.size>=DESCENDANT_MAX_SESSIONS&&(o=`session-limit`),o!==void 0){r.child===void 0&&(r.excluded=o);continue}let s=e.reader.agent({type:`child.opened`,data:n,meta:{at:n.startedAt,endOfLine:!0,position:{line:n.introducedAt,index:0}}});if(r.child===void 0)r.child=this.#c(s,new Conversation,a),r.child.readerDepth=e.readerDepth+1,r.excluded=void 0,this.#t.add(r.child);else{let t=r.child.alias??r.child;e.readerDepth+1<t.readerDepth&&(t.reader=s,t.readerDepth=e.readerDepth+1),t!==this.#e&&!t.depths.has(a)&&(t.depths.add(a),this.#l(t))}}}}#u(){if(clearTimeout(this.#s),this.#s=void 0,!this.#a)return;let e=this.#o,t=[...this.#t].filter(e=>e.controller!==void 0).length,n=1/0;for(let r of[...this.#t].sort((e,t)=>e.readyAt-t.readyAt)){if(!this.#a||e!==this.#o)return;r.alias===void 0&&r.controller===void 0&&r.status!==`unavailable`&&(t<DESCENDANT_MAX_READS&&r.readyAt<=Date.now()?(t+=1,this.#d(r)):n=Math.min(n,r.readyAt))}t<DESCENDANT_MAX_READS&&n!==1/0&&(this.#s=setTimeout(()=>this.#u(),Math.max(1,n-Date.now())))}#d(e){let t=this.#o,n=new AbortController,current=()=>this.#a&&t===this.#o&&!n.signal.aborted,{conversation:r}=e;if(e.controller=n,e.status=`following`,e.reason=void 0,e.caughtUp=!1,this.#f(),!current()){n.abort();return}let i=setTimeout(()=>n.abort(),1e4);n.signal.addEventListener(`abort`,()=>clearTimeout(i),{once:!0});let a=r.view.position;(async()=>{try{let t=e.reader,i=!1;for await(let{event:a}of t.follow({signal:n.signal,startIndex:r.view.position,follow:!1,streamReconnectPolicy:{reconnect:!1}},t=>{if(!current())throw Error(`Observation stopped.`);if(e.key!==void 0&&e.key!==t)throw new ClientError(422,`Descendant reader identity changed.`);e.key=t;let r=this.#n.get(t);if(r!==void 0&&r!==e){if(e.alias=r,r!==this.#e){e.readerDepth<r.readerDepth&&(r.reader=e.reader,r.readerDepth=e.readerDepth);for(let t of e.depths)r.depths.add(t);this.#l(r)}n.abort()}else this.#n.set(t,e)},()=>{i=!0},e=>{!current()||e<=r.view.position||(r.advancePosition(e),this.#f())})){if(!current())return;if(r.observe(a),a.meta.endOfLine!==!1){if(this.#l(e),!current())return;this.#f(),this.#u()}}if(!current())return;if(!i)throw Error(`The descendant stream disconnected before its captured tail.`);e.caughtUp=!0,e.status=`caught-up`,e.failures=0,e.idleReads=r.view.position===a?e.idleReads+1:0,e.readyAt=Date.now()+Math.min(1e4,1e3*2**Math.min(e.idleReads,4))}catch(t){if(!current())return;e.failures+=1;let n=t instanceof ClientError?t.status:void 0;e.status=isRetryableStreamError(t)&&e.failures<DEFAULT_STREAM_RECONNECT_POLICY.streamOpenReconnectPolicy.maxAttempts?`interrupted`:`unavailable`,e.reason=n===401||n===403?`unauthorized`:n===410?`expired`:n===422?t instanceof ClientError&&t.code===`cycle`?`cycle`:`unsupported`:`transport`,e.readyAt=Date.now()+Math.min(RECONNECT_BACKOFF.maxDelayMs,RECONNECT_BACKOFF.baseDelayMs*2**Math.min(e.failures-1,5))}finally{clearTimeout(i),t===this.#o&&(e.controller=void 0,n.signal.aborted&&(e.status=`queued`,e.readyAt=Date.now()),r.discardUncommitted(),this.#a&&(this.#f(),this.#u()))}})()}#f(){let e=new Set,visit=(t,n)=>{if(e.has(t))return;e.add(t);let r=new Set([...n,t]);for(let[e,n]of t.edges){if(n.child===void 0){t.conversation.observeAgent(e,{status:`not-followed`,reason:n.excluded});continue}let i=n.child.alias??n.child;if(r.has(i)){t.conversation.observeAgent(e,{status:`not-followed`,reason:`cycle`});continue}visit(i,r),t.conversation.observeAgent(e,{status:i.status,key:i.key,conversation:i.conversation.state,position:i.conversation.view.position,caughtUp:i.caughtUp,reason:i.reason})}};visit(this.#e,new Set),this.#i()}};export{AgentStreamFollower};

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

@@ -1,3 +1,4 @@
+import { SessionNotActiveError } from "#channel/session-not-active-error.js";
 /**
  * Error thrown when the eve server returns a non-successful HTTP response.
  */
@@ -33,4 +34,4 @@ export declare class ClientSessionStrandedError extends ClientError {
     });
 }
 /** Builds the most specific client error for a failed eve session request. */
-export declare function createClientError(status: number, body: string, headers?: ConstructorParameters<typeof Headers>[0]): ClientError;
+export declare function createClientError(status: number, body: string, headers?: ConstructorParameters<typeof Headers>[0]): ClientError | SessionNotActiveError;

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

@@ -1 +1 @@
-import{isObject}from"#shared/guards.js";var ClientError=class extends Error{code;status;body;headers;constructor(e,t,n){let r=Object.freeze(Object.fromEntries(new Headers(n).entries())),i=r[`content-type`]?.toLowerCase(),a=parseJsonObject(t),o=t||`Server returned ${e}.`;typeof a?.error==`string`?o=a.error:a===void 0&&i?.includes(`text/html`)&&(o=`Server returned ${e} with an HTML response. Check the eve route and development server configuration.`),super(o),this.name=`ClientError`,this.code=typeof a?.code==`string`?a.code:void 0,this.status=e,this.body=t,this.headers=r}},ClientSessionStrandedError=class extends ClientError{eveVersion;constructor(e,t,n,r){super(e,t,n),this.name=`ClientSessionStrandedError`,this.eveVersion=r.eveVersion}};function createClientError(e,t,n){let r=e===409?parseJsonObject(t):void 0;return r?.code===`session_stranded`?new ClientSessionStrandedError(e,t,n,{eveVersion:typeof r.eveVersion==`string`?r.eveVersion:void 0}):new ClientError(e,t,n)}function parseJsonObject(e){try{let t=JSON.parse(e);return isObject(t)?t:void 0}catch{return}}export{ClientError,ClientSessionStrandedError,createClientError};
+import{isObject}from"#shared/guards.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";var ClientError=class extends Error{code;status;body;headers;constructor(e,t,n){let r=Object.freeze(Object.fromEntries(new Headers(n).entries())),i=r[`content-type`]?.toLowerCase(),a=parseJsonObject(t),o=t||`Server returned ${e}.`;typeof a?.error==`string`?o=a.error:a===void 0&&i?.includes(`text/html`)&&(o=`Server returned ${e} with an HTML response. Check the eve route and development server configuration.`),super(o),this.name=`ClientError`,this.code=typeof a?.code==`string`?a.code:void 0,this.status=e,this.body=t,this.headers=r}},ClientSessionStrandedError=class extends ClientError{eveVersion;constructor(e,t,n,r){super(e,t,n),this.name=`ClientSessionStrandedError`,this.eveVersion=r.eveVersion}};function createClientError(e,t,n){let r=e===409?parseJsonObject(t):void 0;return r?.code===`session_not_active`||r?.code===`session_not_ready`?new SessionNotActiveError({retryable:r.code===`session_not_ready`}):r?.code===`session_stranded`?new ClientSessionStrandedError(e,t,n,{eveVersion:typeof r.eveVersion==`string`?r.eveVersion:void 0}):new ClientError(e,t,n)}function parseJsonObject(e){try{let t=JSON.parse(e);return isObject(t)?t:void 0}catch{return}}export{ClientError,ClientSessionStrandedError,createClientError};

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

@@ -3,7 +3,7 @@ import type { AgentInfoResult, ClientOptions, HealthResult } from "#client/types
 /**
  * HTTP client for talking to a deployed eve agent.
  *
- * A single client is bound to one host and auth configuration. Its
+ * A single client is bound to one base URL and auth configuration. Its
  * `sessions` collection can create or attach many independent fixed session
  * handles.
  */

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{ClientError}from"#client/client-error.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{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 e=createClientUrl(this.#n,EVE_HEALTH_ROUTE_PATH),t=await this.#i(),n=await fetch(e,withRedirectPolicy({headers:t},this.#r));if(!n.ok){let e=await n.text();throw new ClientError(n.status,e,n.headers)}let r;try{r=await n.json()}catch{throw new HealthResponseError}let i=HealthResultSchema.safeParse(r);if(!i.success)throw new HealthResponseError(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 info(e={}){let t=await this.fetch(EVE_INFO_ROUTE_PATH,e);if(!t.ok){let e=await t.text();throw new ClientError(t.status,e,t.headers)}let n;try{n=await t.json()}catch{throw new AgentInfoResponseError}let r=AgentInfoResultSchema.safeParse(n);if(!r.success)throw new AgentInfoResponseError(r.error.issues.slice(0,5).map(e=>{let t=e.path.join(`.`);return t.length===0?e.message:`${t}: ${e.message}`}));return r.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{ClientError}from"#client/client-error.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{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.baseUrl,this.#e=e.auth,this.#t=e.headers,this.#r=e.redirect,this.sessions=new ClientSessions({baseUrl:this.#n,redirect:this.#r,resolveHeaders:e=>this.#i(e)})}async health(){let e=createClientUrl(this.#n,EVE_HEALTH_ROUTE_PATH),t=await this.#i(),n=await fetch(e,withRedirectPolicy({headers:t},this.#r));if(!n.ok){let e=await n.text();throw new ClientError(n.status,e,n.headers)}let r;try{r=await n.json()}catch{throw new HealthResponseError}let i=HealthResultSchema.safeParse(r);if(!i.success)throw new HealthResponseError(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 info(e={}){let t=await this.fetch(EVE_INFO_ROUTE_PATH,e);if(!t.ok){let e=await t.text();throw new ClientError(t.status,e,t.headers)}let n;try{n=await t.json()}catch{throw new AgentInfoResponseError}let r=AgentInfoResultSchema.safeParse(n);if(!r.success)throw new AgentInfoResponseError(r.error.issues.slice(0,5).map(e=>{let t=e.path.join(`.`);return t.length===0?e.message:`${t}: ${e.message}`}));return r.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/conversation-client.d.ts

@@ -1,41 +1,50 @@
-import type { ConversationState } from "#client/conversation-state.js";
-import { EveAgentProjection, type EveAgentEventLog } from "#client/eve-agent-projection.js";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import type { ConversationState, FollowAgents } from "#client/conversation-state.js";
+import { type LocalSubmission } from "#client/conversation.js";
 import type { SendTurnPayload } from "#client/types.js";
-import type { EveAgentReducerEvent } from "#client/reducer.js";
-import type { MessageStreamEvent } from "#protocol/message.js";
-import type { InputResponse } from "#shared/input.js";
+import type { SessionView } from "#protocol/session-projection/tables.js";
+import type { Answer } from "#shared/input.js";
 import { SessionEventStream, type SessionEventStreamOptions } from "#client/session-event-stream.js";
 import type { ClientSession } from "#client/session.js";
-/** Owns the canonical conversation and its root and agent-session transports for one client session. */
-export declare class ConversationClient<TData = ConversationState> {
+/** Owns one client session's conversation and its root and agent-session transports. */
+export declare class ConversationClient {
     #private;
-    readonly projection: EveAgentProjection<TData>;
-    constructor(projection: EveAgentProjection<TData>, onChange: (data: TData, previous: TData) => void, onConversationChange?: (state: ConversationState, previous: ConversationState) => void);
-    get data(): TData;
+    constructor(onChange: () => void);
     get conversation(): ConversationState;
-    get projections(): readonly EveAgentEventLog[];
-    get following(): boolean;
-    append(event: EveAgentReducerEvent): void;
-    /** Projects submitted answers; the returned callback withdraws them if the server never accepts. */
-    projectResponses(responses: readonly InputResponse[] | undefined): (() => void) | undefined;
-    /** Swaps projected answers for a prepared payload's, which must still be answerable. */
-    replaceResponses(retract: (() => void) | undefined, input: SendTurnPayload): (() => void) | undefined;
-    /** Admit and project a root event before the agent sessions it announces are followed. */
-    observe(event: MessageStreamEvent, options?: {
-        /** The store reconciles optimistic messages instead of directly appending the event. */
-        project?: (event: MessageStreamEvent) => void;
-        /** Record the accepted event before projection or child notifications. */
-        onAccepted?: (event: MessageStreamEvent) => void;
+    get view(): SessionView;
+    confirmSubmission(id: string, deliveryId: string): void;
+    holdUnconfirmedMessages(hold: boolean): void;
+    get streaming(): boolean;
+    /** Shows the messages this client sent that eve hasn't consumed. */
+    showSubmissions(submissions: readonly LocalSubmission[]): void;
+    /** Projects answers during the POST round trip, then hands ownership to the view. */
+    projectAnswers(answers: readonly Answer[] | undefined): {
+        (): void;
+        accept: (deliveryId: string) => void;
+    } | undefined;
+    /** Swaps shown answers for a prepared payload's, which must still be answerable. */
+    replaceAnswers(retract: ReturnType<ConversationClient["projectAnswers"]>, input: SendTurnPayload): {
+        (): void;
+        accept: (deliveryId: string) => void;
+    } | undefined;
+    /** Admits and folds a root event before the agent sessions it announces are followed. */
+    observe(event: SessionStreamEvent, options?: {
+        /** Reconciles the messages this client sent with the event. */
+        reconcile?: (event: SessionStreamEvent) => void;
+        /** Records the accepted event before it folds or children hear of it. */
+        onAccepted?: (event: SessionStreamEvent) => void;
         /** The store publishes after updating its event log and status. */
         notify?: boolean;
     }): boolean;
-    /** Admit and project a hydrated root event without notifying subscribers. */
-    hydrate(event: MessageStreamEvent): boolean;
-    /** Start following the agent sessions the root stream has announced so far. */
-    follow(session: ClientSession, events?: readonly MessageStreamEvent[]): void;
+    /** Called after the store has published the root's matching event prefix and lifecycle. */
+    reconcileFollowing(): void;
+    /** Admits and folds a saved root event without notifying subscribers. */
+    hydrate(event: SessionStreamEvent): boolean;
+    /** Starts following the agent sessions the root stream has announced so far. */
+    follow(session: ClientSession, policy: FollowAgents): void;
     /** Follows the root session continuously; operation readers subscribe to this one stream. */
     stream(session: ClientSession, options: SessionEventStreamOptions): SessionEventStream;
-    /** Closes the root stream; the next `stream()` call reopens it from the session cursor. */
+    /** Closes the root stream; the next read replays any partial line from the folded cursor. */
     closeStream(): void;
     stop(): void;
     reset(): void;

package/dist/src/client/conversation-client.js

@@ -1 +1 @@
-import{assertAnswerable}from"#client/eve-agent-store-helpers.js";import{AgentStreamFollower}from"#client/agent-stream-follower.js";import{canonicalConversationReducer,conversationReducer}from"#client/conversation-reducer.js";import{EveAgentProjection}from"#client/eve-agent-projection.js";import{createEventDeduper}from"#protocol/event-dedupe.js";import{SessionEventStream}from"#client/session-event-stream.js";var ConversationClient=class{projection;#e;#t=new Map;#n=createEventDeduper();#r;#i;#a;#o;constructor(e,t,n){this.projection=e,this.#e=e.reducer===conversationReducer?e:new EveAgentProjection(canonicalConversationReducer,[]),this.#a=t,this.#o=n}get data(){return this.projection.data}get conversation(){return this.#e.data}get projections(){return this.#e===this.projection?[this.projection]:[this.#e,this.projection]}get following(){return this.#r!==void 0}append(e){let t=this.data,n=this.conversation;this.#c(e),t===this.data?n!==this.conversation&&this.#o?.(this.conversation,n):this.#a(this.data,t)}projectResponses(e){if(!e?.length)return;let t={data:{createdAt:Date.now(),responses:e},type:`client.input.responded`};return this.append(t),()=>this.#s(t)}replaceResponses(e,t){return e?.(),assertAnswerable(t,this.conversation),this.projectResponses(t.inputResponses)}#s(e){let t=this.data,n=this.conversation;for(let t of this.projections)t.remove(t=>t===e);t===this.data?n!==this.conversation&&this.#o?.(this.conversation,n):this.#a(this.data,t)}observe(e,t={}){if(!this.#n.admit(e))return!1;t.onAccepted?.(e);let n=this.data,r=this.conversation;return t.project?t.project(e):this.#c(e),t.notify!==!1&&(n===this.data?r!==this.conversation&&this.#o?.(this.conversation,r):this.#a(this.data,n)),this.#r?.acceptParentEvent(e),this.#r?.reconcile(),!0}hydrate(e){return this.#n.admit(e)?(this.#c(e),!0):!1}follow(e,t=[]){this.#r?.abortAll();let n=new AgentStreamFollower({session:e,cursors:this.#t,getState:()=>this.conversation,onFollowing:e=>this.#l({type:`client.agent.following`,data:{sessionId:e}}),onEvent:(e,t)=>this.#l({type:`client.agent.observed`,data:{sessionId:e,event:t}}),onIdle:e=>this.#l({type:`client.agent.idle`,data:{sessionId:e}}),onUnavailable:e=>this.#l({type:`client.agent.unavailable`,data:{sessionId:e}})});this.#r=n;for(let e of t)n.acceptParentEvent(e);n.reconcile()}#c(e){for(let t of this.projections)t.append(e)}#l(e){let t=this.data,n=this.conversation;this.#e.append(e),t===this.data?n!==this.conversation&&this.#o?.(this.conversation,n):this.#a(this.data,t)}stream(e,t){return this.#i!==void 0&&!this.#i.ended?(this.#i.setOptions(t),this.#i):(this.#i=new SessionEventStream(e,t),this.#i)}closeStream(){this.#i?.close(),this.#i=void 0}stop(){this.#r?.abortAll(),this.#r=void 0,this.closeStream()}reset(){this.stop(),this.#t.clear(),this.#n=createEventDeduper();for(let e of this.projections)e.reset()}};export{ConversationClient};
+import{isFactType,isProgressType}from"#protocol/session-events/catalog.js";import{assertAnswerable}from"#client/session-store-helpers.js";import{Conversation}from"#client/conversation.js";import{AgentStreamFollower}from"#client/agent-stream-follower.js";import{SessionEventStream}from"#client/session-event-stream.js";var ConversationClient=class{#e=new Conversation;#t;#n;#r;constructor(e){this.#r=e}get conversation(){return this.#e.state}get view(){return this.#e.view}confirmSubmission(e,t){this.#e.confirmSubmission(e,t)}holdUnconfirmedMessages(e){this.#e.holdUnconfirmedMessages(e)}get streaming(){return this.#n!==void 0&&!this.#n.ended}showSubmissions(e){this.#e.setSubmissions(e)}projectAnswers(e){if(!e?.length)return;let t=this.#e,n=t.answer(e);this.#r();let withdraw=()=>{t===this.#e&&(n(),this.#r())};return withdraw.accept=e=>{t===this.#e&&(n.accept(e),this.#r())},withdraw}replaceAnswers(e,t){return e?.(),assertAnswerable(t,this.conversation),this.projectAnswers(t.answers)}observe(e,t={}){return this.#e.observe(e)?(t.onAccepted?.(e),t.reconcile?.(e),t.notify!==!1&&(this.#r(),e.meta.endOfLine!==!1&&this.reconcileFollowing()),!0):!1}reconcileFollowing(){this.#t?.reconcile()}hydrate(e){assertCurrentSavedEvent(e);let t=this.#e.view.position;if(!this.#e.observe(e))return!1;let{next:n,position:r,endOfLine:i}=e.meta;if(r.line<t)throw TypeError(`Saved events overlap source lines already covered by the conversation. Save the ordered events as eve read them, or read the session again from position 0.`);if(n!==void 0){if(i!==!0||!Number.isSafeInteger(n)||n<r.line+1)throw TypeError("Saved `meta.next` must cover a complete source line with a safe integer cursor. Save the events as eve read them, or read the session again from position 0.");this.#e.advancePosition(n)}return!0}follow(e,t){this.#t??=new AgentStreamFollower({session:e,policy:t,conversation:this.#e,onChange:this.#r}),this.#t.start()}stream(e,t){return this.#n!==void 0&&!this.#n.ended?(this.#n.setOptions(t),this.#n):(this.#n=new SessionEventStream(e,{...t,startIndex:t.startIndex??this.#e.view.position}),this.#n)}closeStream(){this.#n?.close(),this.#n=void 0,this.#e.discardUncommitted()}stop(){this.#t?.abortAll(),this.closeStream()}reset(){this.stop(),this.#t=void 0,this.#e=new Conversation}};function assertCurrentSavedEvent(e){let{meta:t,type:n}=e;if(t?.position===void 0||!isFactType(n)&&!isProgressType(n))throw TypeError(`Saved session event ${JSON.stringify(n)} has no stream position this eve version can read; it was likely saved by eve < 27. Discard saved \`initialEvents\` and the saved session state from before the upgrade, then start a new session.`)}export{ConversationClient};