eve 0.11.1 → 0.11.3

package/dist/src/setup/vercel-project.js

@@ -1 +1 @@
-import{__toESM}from"../_virtual/_rolldown/runtime.js";import{require_picocolors}from"../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js";import{boolean,object,record,string,unknown}from"../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/schemas.js";import"../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js";import{captureVercel,runVercel}from"#setup/primitives/index.js";import{HumanActionRequiredError}from"#setup/human-action.js";import{whimsyFor}from"#setup/cli/index.js";var import_picocolors=__toESM(require_picocolors(),1);const JsonObjectSchema=record(string(),unknown()),VercelTeamListEntrySchema=object({name:string(),slug:string(),current:boolean()}),VercelProjectListEntrySchema=object({name:string(),id:string()}),VercelProjectReferenceSchema=object({id:string(),name:string()}),VercelApiErrorSchema=object({error:object({code:string().optional(),message:string().optional()}).optional()});function unresolvedProject(){return{kind:`unresolved`}}async function withNetworkSpinner(e,t,n){let r=e.log.spinner?.(t);try{return await n()}finally{r?.stop()}}function projectIdFromResolution(e){return e.kind===`unresolved`?void 0:e.projectId}function parseJson(e,t){try{return JSON.parse(e)}catch{throw Error(`Could not parse ${t} JSON from Vercel CLI output.`)}}function parseVercelJsonList(e,t,n){let r=parseJson(e,t),i=JsonObjectSchema.safeParse(r);if(!i.success)throw Error(`Could not read ${t} from Vercel CLI JSON output.`);let a=i.data[t];if(!Array.isArray(a))throw Error(`Vercel CLI JSON output did not include ${t}.`);let o=[];for(let e of a){let t=n.safeParse(e);t.success&&o.push(t.data)}return o}function parseTeamList(e){return e===void 0?[]:parseVercelJsonList(e,`teams`,VercelTeamListEntrySchema)}async function listTeams(e,t={}){let n=await captureVercel([`teams`,`ls`,`--format`,`json`],{cwd:e,signal:t.signal});if(!n.ok)throw isForbiddenApiFailure(n.failure)&&requireVercelTeamAccess(n.failure),Error(`Could not list Vercel teams. ${n.failure.message}`);return parseTeamList(n.stdout)}function parseProjectList(e){return e===void 0?[]:parseVercelJsonList(e,`projects`,VercelProjectListEntrySchema)}async function listProjects(e,t,n={}){let r=await captureVercel([`project`,`ls`,`--format`,`json`,`--scope`,t],{cwd:e,signal:n.signal});if(!r.ok)throw isForbiddenApiFailure(r.failure)&&requireVercelTeamAccess(r.failure),Error(`Could not list Vercel projects in ${t}. ${r.failure.message}`);return parseProjectList(r.stdout)}function isNotFoundApiFailure(e){if(e.code===404)return!0;let t=VercelApiErrorSchema.safeParse(safeParseJson(e.stdout)),n=t.success?t.data.error:void 0,r=`${n?.code??``} ${n?.message??``} ${e.stderr}`.toLowerCase();return r.includes(`not_found`)||r.includes(`not found`)||r.includes(`404`)}function isConflictApiFailure(e){let t=VercelApiErrorSchema.safeParse(safeParseJson(e.stdout)),n=t.success?t.data.error:void 0,r=`${n?.code??``} ${n?.message??``} ${e.stdout} ${e.stderr}`.toLowerCase();return r.includes(`409`)||r.includes(`conflict`)||r.includes(`already exists`)}function isForbiddenApiFailure(e){let t=VercelApiErrorSchema.safeParse(safeParseJson(e.stdout)),n=t.success?t.data.error:void 0,r=`${n?.code??``} ${n?.message??``} ${e.stdout} ${e.stderr}`.toLowerCase();return r.includes(`403`)||r.includes(`forbidden`)||r.includes(`not_authorized`)||r.includes(`not authorized`)||r.includes(`sso`)||r.includes(`saml`)}function safeParseJson(e){try{return JSON.parse(e)}catch{return}}function parseProjectReference(e,t){let n=VercelProjectReferenceSchema.safeParse(parseJson(e,t));if(!n.success)throw Error(`Could not read Vercel project identity from ${t}.`);return n.data}async function resolveProjectByNameOrId(e,t,n,r={}){let i=await captureVercel([`api`,`/v9/projects/${encodeURIComponent(n)}`,`--scope`,t,`--raw`],{cwd:e,signal:r.signal});if(i.ok)return parseProjectReference(i.stdout,`project ${n}`);if(isNotFoundApiFailure(i.failure))return null;throw isForbiddenApiFailure(i.failure)&&requireVercelTeamAccess(i.failure),Error(`Could not resolve project "${n}" in ${t}. ${i.failure.message}`)}async function createProject(e,t,n,r,i){let a=await captureVercel([`api`,`/v10/projects`,`--scope`,t,`--method`,`POST`,`--raw-field`,`name=${n}`,`--raw`],{cwd:e,onOutput:r,signal:i.signal});if(a.ok)return parseProjectReference(a.stdout,`created project ${n}`);throw isConflictApiFailure(a.failure)?Error(projectNameCollisionMessage(n,t)):(isForbiddenApiFailure(a.failure)&&requireVercelTeamAccess(a.failure),Error(`Could not create Vercel project "${n}" in ${t}. ${a.failure.message}`))}function projectNameCollisionMessage(e,t){return`Vercel project "${e}" already exists in ${t}. Pass --project ${e} to link it, or choose a different project name.`}async function assertNewProjectNameAvailable(e,t,n,r={}){if(await resolveProjectByNameOrId(e,t,n,r)!==null)throw Error(projectNameCollisionMessage(n,t))}function requireVercelLogin(e){let t=`Provisioning a Vercel project requires you to be logged in to Vercel.`,n=e?.stderr.trim();throw new HumanActionRequiredError({kind:`vercel-login`,command:`vercel login`,reason:e?`${t} The Vercel CLI check did not succeed: ${e.message}${n?` ${n}`:``}`:t})}function probeWhoami(e,t){return captureVercel([`whoami`],{cwd:e,signal:t.signal,timeoutMs:1e4})}function isLoggedOutFailure(e){let t=`${e.stdout} ${e.stderr}`.toLowerCase();return t.includes(`credentials`)||t.includes(`not authenticated`)||t.includes(`not logged in`)}function requireVercelAuth(e){if(e.errno===`ENOENT`)throw new HumanActionRequiredError({kind:`vercel-cli-missing`,command:`npm i -g vercel@latest`,reason:e.message});isLoggedOutFailure(e)&&requireVercelLogin(e);let t=e.stderr.trim();throw Error(`Couldn't verify your Vercel login: ${e.message}${t?` ${t}`:``}`)}async function getVercelAuthStatus(e,t={}){let n=await probeWhoami(e,t);return t.signal?.throwIfAborted(),n.ok?`authenticated`:n.failure.errno===`ENOENT`?`cli-missing`:isLoggedOutFailure(n.failure)?`logged-out`:`unavailable`}function requireVercelTeamAccess(e){let t=e.stderr.trim();throw new HumanActionRequiredError({kind:`vercel-forbidden`,command:`vercel login`,reason:`Vercel denied access to this scope.${t?` ${t}`:``} Re-authenticate (for example to complete a team's SSO) or switch to a team you can access.`})}async function requireAuth(e,t,n={}){let check=async()=>{let t=await probeWhoami(e,n);n.signal?.throwIfAborted(),t.ok||requireVercelAuth(t.failure)};if(t===void 0){await check();return}await withNetworkSpinner(t,whimsyFor(`auth`),check)}async function isVercelAuthenticated(e,t={}){return await getVercelAuthStatus(e,t)===`authenticated`}async function whoamiScope(e,t){let n=await probeWhoami(e,t);return t.signal?.throwIfAborted(),n.ok||requireVercelAuth(n.failure),n.stdout.trim()}async function resolveTeam(e,t,n={}){return t===void 0?(await listTeams(e,n)).find(e=>e.current)?.slug??await whoamiScope(e,n):t}async function validateTeam(e,t,n,r={}){if(n===void 0)return;let i=await listTeams(t,r);if(i.length>0&&!i.some(e=>e.slug===n))throw Error(`Team "${n}" was not found in \`vercel teams ls\`. Pass a valid team slug or omit --team.`)}async function pickTeam(e,t,n,r={}){if(n!==void 0)return await validateTeam(e,t,n,r),resolveTeam(t,n,r);let i=await withNetworkSpinner(e,whimsyFor(`teams`),()=>listTeams(t,r));return i.length<=1?i.find(e=>e.current)?.slug??await whoamiScope(t,r):e.select({message:`Select your team`,search:!0,placeholder:`type to search teams`,options:i.map(e=>({value:e.slug,label:e.current?`${e.name} (current)`:e.name})),initialValue:i.find(e=>e.current)?.slug})}async function pickProject(e,t,n,r={}){let i=await withNetworkSpinner(e,whimsyFor(`projects`,n),()=>listProjects(t,n,r));if(i.length===0){if(r.allowCreateWhenEmpty===!1)throw Error(`No existing Vercel projects found in ${n}. Create one in Vercel, then try again.`);return{project:await e.text({message:`No projects found in ${n}. Enter a project name to create`,validate:e=>e.trim().length===0?`Project name cannot be empty.`:void 0}),exists:!1}}return{project:await e.select({message:`Project to link`,search:!0,placeholder:`type to filter projects`,options:i.map(e=>({value:e.name,label:e.name}))}),exists:!0}}async function pickNewProjectName(e,t,n,r,i={}){let a=await withNetworkSpinner(e,whimsyFor(`project-name`,n),()=>resolveProjectByNameOrId(t,n,r.trim(),i)),o=r.trim();for(;a!==null;)o=(await e.text({message:`New project name`,defaultValue:`${o}-2`,notices:[{tone:`warning`,text:`${import_picocolors.default.yellow(`Project named`)} '${import_picocolors.default.blue(o)}' ${import_picocolors.default.yellow(`already exists in`)} '${import_picocolors.default.blue(n)}'`}],validate:e=>{if(e.trim().length===0)return`Project name cannot be empty.`}})).trim(),a=await resolveProjectByNameOrId(t,n,o,i);return o}async function linkProject(e,t,n,r,i={}){let a=[`--scope`,n.team],o;if(n.kind===`new`)o=await withNetworkSpinner(e,`Creating Vercel project "${n.project}" in ${n.team}...`,async()=>(await assertNewProjectNameAvailable(t,n.team,n.project,i),createProject(t,n.team,n.project,r,i)));else{let e=await resolveProjectByNameOrId(t,n.team,n.project,i);if(e===null)throw Error(`Vercel project "${n.project}" was not found in ${n.team}.`);o=e}return withNetworkSpinner(e,`Linking this directory to Vercel project "${o.name}"...`,()=>runVercel([`link`,`--project`,o.id,...a,`--yes`],{cwd:t,onOutput:r,signal:i.signal}))}export{assertNewProjectNameAvailable,getVercelAuthStatus,isVercelAuthenticated,linkProject,listProjects,listTeams,pickNewProjectName,pickProject,pickTeam,projectIdFromResolution,requireAuth,requireVercelAuth,requireVercelLogin,requireVercelTeamAccess,resolveProjectByNameOrId,resolveTeam,unresolvedProject,validateTeam,withNetworkSpinner};
+import{__toESM}from"../_virtual/_rolldown/runtime.js";import{require_picocolors}from"../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js";import{boolean,object,record,string,unknown}from"../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/schemas.js";import"../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js";import{captureVercel,runVercel}from"#setup/primitives/index.js";import{HumanActionRequiredError}from"#setup/human-action.js";import{whimsyFor}from"#setup/cli/index.js";var import_picocolors=__toESM(require_picocolors(),1);const JsonObjectSchema=record(string(),unknown()),VercelTeamListEntrySchema=object({name:string(),slug:string(),current:boolean()}),VercelProjectListEntrySchema=object({name:string(),id:string()}),VercelProjectReferenceSchema=object({id:string(),name:string()}),VercelApiErrorSchema=object({error:object({code:string().optional(),message:string().optional()}).optional()});function unresolvedProject(){return{kind:`unresolved`}}async function withNetworkSpinner(e,t,n){let r=e.log.spinner?.(t);try{return await n()}finally{r?.stop()}}function projectIdFromResolution(e){return e.kind===`unresolved`?void 0:e.projectId}function parseJson(e,t){try{return JSON.parse(e)}catch{throw Error(`Could not parse ${t} JSON from Vercel CLI output.`)}}function parseVercelJsonList(e,t,n){let r=parseJson(e,t),i=JsonObjectSchema.safeParse(r);if(!i.success)throw Error(`Could not read ${t} from Vercel CLI JSON output.`);let a=i.data[t];if(!Array.isArray(a))throw Error(`Vercel CLI JSON output did not include ${t}.`);let o=[];for(let e of a){let t=n.safeParse(e);t.success&&o.push(t.data)}return o}function parseTeamList(e){return e===void 0?[]:parseVercelJsonList(e,`teams`,VercelTeamListEntrySchema)}async function listTeams(e,t={}){let n=await captureVercel([`teams`,`ls`,`--format`,`json`],{cwd:e,signal:t.signal});if(!n.ok)throw isForbiddenApiFailure(n.failure)&&requireVercelTeamAccess(n.failure),Error(`Could not list Vercel teams. ${n.failure.message}`);return parseTeamList(n.stdout)}function parseProjectList(e){return e===void 0?[]:parseVercelJsonList(e,`projects`,VercelProjectListEntrySchema)}async function listProjects(e,t,n={}){let r=await captureVercel([`project`,`ls`,`--format`,`json`,`--scope`,t],{cwd:e,signal:n.signal});if(!r.ok)throw isForbiddenApiFailure(r.failure)&&requireVercelTeamAccess(r.failure),Error(`Could not list Vercel projects in ${t}. ${r.failure.message}`);return parseProjectList(r.stdout)}function isNotFoundApiFailure(e){if(e.code===404)return!0;let t=VercelApiErrorSchema.safeParse(safeParseJson(e.stdout)),n=t.success?t.data.error:void 0,r=`${n?.code??``} ${n?.message??``} ${e.stderr}`.toLowerCase();return r.includes(`not_found`)||r.includes(`not found`)||r.includes(`404`)}function isConflictApiFailure(e){let t=VercelApiErrorSchema.safeParse(safeParseJson(e.stdout)),n=t.success?t.data.error:void 0,r=`${n?.code??``} ${n?.message??``} ${e.stdout} ${e.stderr}`.toLowerCase();return r.includes(`409`)||r.includes(`conflict`)||r.includes(`already exists`)}function isForbiddenApiFailure(e){let t=VercelApiErrorSchema.safeParse(safeParseJson(e.stdout)),n=t.success?t.data.error:void 0,r=`${n?.code??``} ${n?.message??``} ${e.stdout} ${e.stderr}`.toLowerCase();return r.includes(`403`)||r.includes(`forbidden`)||r.includes(`not_authorized`)||r.includes(`not authorized`)||r.includes(`sso`)||r.includes(`saml`)}function safeParseJson(e){try{return JSON.parse(e)}catch{return}}function parseProjectReference(e,t){let n=VercelProjectReferenceSchema.safeParse(parseJson(e,t));if(!n.success)throw Error(`Could not read Vercel project identity from ${t}.`);return n.data}async function resolveProjectByNameOrId(e,t,n,r={}){let i=await captureVercel([`api`,`/v9/projects/${encodeURIComponent(n)}`,`--scope`,t,`--raw`],{cwd:e,signal:r.signal});if(i.ok)return parseProjectReference(i.stdout,`project ${n}`);if(isNotFoundApiFailure(i.failure))return null;throw isForbiddenApiFailure(i.failure)&&requireVercelTeamAccess(i.failure),Error(`Could not resolve project "${n}" in ${t}. ${i.failure.message}`)}async function createProject(e,t,n,r,i){let a=await captureVercel([`api`,`/v10/projects`,`--scope`,t,`--method`,`POST`,`--raw-field`,`name=${n}`,`--raw`],{cwd:e,onOutput:r,signal:i.signal});if(a.ok)return parseProjectReference(a.stdout,`created project ${n}`);throw isConflictApiFailure(a.failure)?Error(projectNameCollisionMessage(n,t)):(isForbiddenApiFailure(a.failure)&&requireVercelTeamAccess(a.failure),Error(`Could not create Vercel project "${n}" in ${t}. ${a.failure.message}`))}function projectNameCollisionMessage(e,t){return`Vercel project "${e}" already exists in ${t}. Pass --project ${e} to link it, or choose a different project name.`}async function assertNewProjectNameAvailable(e,t,n,r={}){if(await resolveProjectByNameOrId(e,t,n,r)!==null)throw Error(projectNameCollisionMessage(n,t))}function requireVercelLogin(e){let t=`Provisioning a Vercel project requires you to be logged in to Vercel.`,n=e?.stderr.trim();throw new HumanActionRequiredError({kind:`vercel-login`,command:`vercel login`,reason:e?`${t} The Vercel CLI check did not succeed: ${e.message}${n?` ${n}`:``}`:t})}function probeWhoami(e,t){return captureVercel([`whoami`],{cwd:e,signal:t.signal,timeoutMs:1e4})}function isLoggedOutFailure(e){let t=`${e.stdout} ${e.stderr}`.toLowerCase();return t.includes(`credentials`)||t.includes(`not authenticated`)||t.includes(`not logged in`)}function requireVercelAuth(e){if(e.errno===`ENOENT`)throw new HumanActionRequiredError({kind:`vercel-cli-missing`,command:`npm i -g vercel@latest`,reason:e.message});isLoggedOutFailure(e)&&requireVercelLogin(e);let t=e.stderr.trim();throw Error(`Couldn't verify your Vercel login: ${e.message}${t?` ${t}`:``}`)}async function getVercelAuthStatus(e,t={}){let n=await probeWhoami(e,t);return t.signal?.throwIfAborted(),n.ok?`authenticated`:n.failure.errno===`ENOENT`?`cli-missing`:isLoggedOutFailure(n.failure)?`logged-out`:`unavailable`}function requireVercelTeamAccess(e){let t=e.stderr.trim();throw new HumanActionRequiredError({kind:`vercel-forbidden`,command:`vercel login`,reason:`Vercel denied access to this scope.${t?` ${t}`:``} Re-authenticate (for example to complete a team's SSO) or switch to a team you can access.`})}async function requireAuth(e,t,n={}){let check=async()=>{let t=await probeWhoami(e,n);n.signal?.throwIfAborted(),t.ok||requireVercelAuth(t.failure)};if(t===void 0){await check();return}await withNetworkSpinner(t,whimsyFor(`auth`),check)}async function isVercelAuthenticated(e,t={}){return await getVercelAuthStatus(e,t)===`authenticated`}async function whoamiScope(e,t){let n=await probeWhoami(e,t);return t.signal?.throwIfAborted(),n.ok||requireVercelAuth(n.failure),n.stdout.trim()}async function resolveTeam(e,t,n={}){return t===void 0?(await listTeams(e,n)).find(e=>e.current)?.slug??await whoamiScope(e,n):t}async function validateTeam(e,t,n,r={}){if(n===void 0)return;let i=await listTeams(t,r);if(i.length>0&&!i.some(e=>e.slug===n))throw Error(`Team "${n}" was not found in \`vercel teams ls\`. Pass a valid team slug or omit --team.`)}async function pickTeam(e,t,n,r={}){if(n!==void 0)return await validateTeam(e,t,n,r),resolveTeam(t,n,r);let i=await withNetworkSpinner(e,whimsyFor(`teams`),()=>listTeams(t,r));return i.length<=1?i.find(e=>e.current)?.slug??await whoamiScope(t,r):e.select({message:`Select your team`,search:!0,placeholder:`type to search teams`,options:i.map(e=>({value:e.slug,label:e.current?`${e.name} (current)`:e.name})),initialValue:i.find(e=>e.current)?.slug})}async function pickProject(e,t,n,r={}){let i=await withNetworkSpinner(e,whimsyFor(`projects`,n),()=>listProjects(t,n,r));if(i.length===0){if(r.allowCreateWhenEmpty===!1)throw Error(`No existing Vercel projects found in ${n}. Create one in Vercel, then try again.`);return{project:await e.text({message:`No projects found in ${n}. Enter a project name to create`,validate:e=>e.trim().length===0?`Project name cannot be empty.`:void 0}),exists:!1}}return{project:await e.select({message:`Project to link`,search:!0,placeholder:`type to filter projects`,options:i.map(e=>({value:e.name,label:e.name}))}),exists:!0}}async function pickNewProjectName(e,t,n,r,i={}){let a=await withNetworkSpinner(e,whimsyFor(`project-name`,n),()=>resolveProjectByNameOrId(t,n,r.trim(),i)),o=r.trim();for(;a!==null;)o=(await e.text({message:`New project name`,defaultValue:`${o}-2`,notices:[{tone:`warning`,text:`${import_picocolors.default.yellow(`Project named`)} '${import_picocolors.default.blue(o)}' ${import_picocolors.default.yellow(`already exists in`)} '${import_picocolors.default.blue(n)}'`}],validate:e=>{if(e.trim().length===0)return`Project name cannot be empty.`}})).trim(),a=await resolveProjectByNameOrId(t,n,o,i);return o}async function linkProject(e,t,n,r,i={}){let a=[`--scope`,n.team],o;if(n.kind===`new`)o=await withNetworkSpinner(e,`Creating Vercel project "${n.project}" in ${n.team}...`,async()=>(await assertNewProjectNameAvailable(t,n.team,n.project,i),createProject(t,n.team,n.project,r,i)));else{let e=await resolveProjectByNameOrId(t,n.team,n.project,i);if(e===null)throw Error(`Vercel project "${n.project}" was not found in ${n.team}.`);o=e}return withNetworkSpinner(e,`Linking this directory to Vercel project "${o.name}"...`,()=>runVercel([`link`,`--project`,o.id,...a,`--yes`],{cwd:t,onOutput:r,nonInteractive:!0,signal:i.signal}))}export{assertNewProjectNameAvailable,getVercelAuthStatus,isVercelAuthenticated,linkProject,listProjects,listTeams,pickNewProjectName,pickProject,pickTeam,projectIdFromResolution,requireAuth,requireVercelAuth,requireVercelLogin,requireVercelTeamAccess,resolveProjectByNameOrId,resolveTeam,unresolvedProject,validateTeam,withNetworkSpinner};

package/dist/src/shared/agent-definition.d.ts

@@ -3,7 +3,7 @@ import type { StandardJSONSchemaV1 } from "#compiled/@standard-schema/spec/index
 import type { JsonObject } from "#shared/json.js";
 import type { ModuleSourceRef } from "#shared/source-ref.js";
 /**
- * Optional overrides that Eve forwards to the AI SDK model runtime call for
+ * Optional overrides that eve forwards to the AI SDK model runtime call for
  * this model.
  */
 export interface AgentModelOptionsDefinition {
@@ -44,27 +44,27 @@ export type InternalAgentModelDefinition = {
 /**
  * The model handle you assign to an agent's `model` field. This is the AI SDK
  * `LanguageModel` value (for example, the result of a provider or gateway
- * model call), not an Eve-authored definition object.
+ * model call), not an eve-authored definition object.
  */
 export type PublicAgentModelDefinition = LanguageModel;
 export interface InternalAgentCompactionDefinition {
     /**
      * Optional model used only for generating compaction summaries.
      *
-     * When omitted, Eve uses the active turn model for the summary call.
+     * When omitted, eve uses the active turn model for the summary call.
      */
     model?: InternalAgentModelDefinition;
     /**
      * Fraction of the primary model context window that triggers compaction.
      *
-     * Eve defaults to `0.9` when this is omitted.
+     * eve defaults to `0.9` when this is omitted.
      */
     thresholdPercent?: number;
 }
 /**
  * Configures conversation compaction: when the model context window fills past
- * `thresholdPercent`, Eve summarizes earlier turns to reclaim space. Every
- * field is optional; omit the block to use Eve's defaults.
+ * `thresholdPercent`, eve summarizes earlier turns to reclaim space. Every
+ * field is optional; omit the block to use eve's defaults.
  */
 export interface PublicAgentCompactionDefinition {
     /**
@@ -72,20 +72,20 @@ export interface PublicAgentCompactionDefinition {
      * in tokens.
      *
      * Same escape hatch as the agent-level `modelContextWindowTokens`. When set,
-     * Eve uses this value verbatim and skips the AI Gateway lookup for the
+     * eve uses this value verbatim and skips the AI Gateway lookup for the
      * compaction summary model.
      */
     readonly modelContextWindowTokens?: number;
     /**
      * Optional model used only for generating compaction summaries.
      *
-     * When omitted, Eve uses the active turn model for the summary call.
+     * When omitted, eve uses the active turn model for the summary call.
      */
     readonly model?: PublicAgentModelDefinition;
     /**
      * Fraction of the primary model context window that triggers compaction.
      *
-     * Eve defaults to `0.9` when this is omitted.
+     * eve defaults to `0.9` when this is omitted.
      */
     readonly thresholdPercent?: number;
 }
@@ -103,7 +103,7 @@ export interface AgentExperimentalDefinition {
      * instead of exposing them directly to the model. The model writes
      * JavaScript that calls the tools inside the sandbox.
      *
-     * When unset, Eve falls back to the `EVE_EXPERIMENTAL_CODE_MODE`
+     * When unset, eve falls back to the `EVE_EXPERIMENTAL_CODE_MODE`
      * environment variable (`"1"` enables it) for backwards compatibility.
      */
     readonly codeMode?: boolean;
@@ -116,8 +116,8 @@ export interface AgentExperimentalDefinition {
  */
 export interface AgentBuildDefinition {
     /**
-     * Additional imported package names that Eve should keep external and trace
-     * into hosted build output. Eve also keeps matching imports external while
+     * Additional imported package names that eve should keep external and trace
+     * into hosted build output. eve also keeps matching imports external while
      * compiling authored TypeScript modules such as tools, channels, and
      * schedules.
      *
@@ -169,10 +169,10 @@ export type PublicAgentDefinition = {
     /**
      * Optional override for the primary model's context window size, in tokens.
      *
-     * Escape hatch for cases where Eve cannot resolve the model's metadata via
+     * Escape hatch for cases where eve cannot resolve the model's metadata via
      * the AI Gateway model catalog (e.g. a custom or unlisted model id). When
-     * set, Eve uses this value verbatim and skips the AI Gateway lookup. Prefer
-     * leaving this unset so Eve can stay in sync with provider metadata.
+     * set, eve uses this value verbatim and skips the AI Gateway lookup. Prefer
+     * leaving this unset so eve can stay in sync with provider metadata.
      */
     readonly modelContextWindowTokens?: number;
     readonly modelOptions?: AgentModelOptionsDefinition;

package/dist/src/shared/code-mode.d.ts

@@ -1,8 +1,8 @@
 import type * as CodeModeModule from "#compiled/experimental-ai-sdk-code-mode/index.js";
-/** Internal AI SDK tool name used for Eve's code-mode wrapper. */
+/** Internal AI SDK tool name used for eve's code-mode wrapper. */
 export declare const CODE_MODE_TOOL_NAME = "code_mode";
 /**
- * Model-facing tool name for Eve's `Workflow` orchestration wrapper — a
+ * Model-facing tool name for eve's `Workflow` orchestration wrapper — a
  * code-mode sandbox restricted to subagent and remote-agent calls. Reserved so
  * authored tools cannot collide with it.
  */
@@ -19,7 +19,7 @@ export declare function isCodeModeEnvEnabled(env?: {
 }): boolean;
 /**
  * Resolves the effective code-mode setting for one agent. The authored
- * `experimental.codeMode` flag wins; when omitted, Eve falls back to the
+ * `experimental.codeMode` flag wins; when omitted, eve falls back to the
  * {@link isCodeModeEnvEnabled} environment backstop.
  */
 export declare function resolveCodeModeEnabled(experimentalCodeMode: boolean | undefined, env?: {

package/dist/src/shared/json-schema.d.ts

@@ -3,7 +3,7 @@ import { type JsonObject } from "#shared/json.js";
 type JsonSchemaDirection = "input" | "output";
 /**
  * Normalizes one Standard Schema or JSON Schema definition into plain JSON
- * Schema data that can cross Eve runtime and client boundaries.
+ * Schema data that can cross eve runtime and client boundaries.
  */
 export declare function normalizeJsonSchemaDefinition(value: StandardJSONSchemaV1 | Record<string, unknown> | unknown, direction?: JsonSchemaDirection): JsonObject;
 export {};

package/dist/src/shared/model-endpoint-status.d.ts

@@ -4,10 +4,10 @@
  * dev TUI status bar, or any other consumer of `/eve/v1/info`) shows and gates
  * on three states:
  *
- * - `external`: a direct provider endpoint, not the gateway. Eve makes no
+ * - `external`: a direct provider endpoint, not the gateway. eve makes no
  *   connectedness claim, since the provider key lives in the agent's own code
  *   rather than the gateway's credentials, and model selection is disabled
- *   because Eve cannot rewrite the authored source.
+ *   because eve cannot rewrite the authored source.
  * - `gateway` + `connected: true`: routed through the Vercel AI Gateway with a
  *   resolvable credential (`api-key` from `AI_GATEWAY_API_KEY`, else `oidc`).
  * - `gateway` + `connected: false`: routed through the gateway with neither a

package/dist/src/shared/sandbox-backend.d.ts

@@ -37,7 +37,7 @@ export interface SandboxSeedFile {
  * Diagnostic tags attached to provider-owned sandbox resources.
  *
  * Built-in backends may forward these into their hosting platform's
- * native tagging system. Eve supplies stable tags such as the active
+ * native tagging system. eve supplies stable tags such as the active
  * agent, channel, and session id so sandboxes can be found and
  * attributed in provider dashboards.
  */
@@ -60,7 +60,7 @@ export interface SandboxBackendRuntimeContext {
  */
 export interface SandboxBackendCreateInput {
     /**
-     * Reusable template key to open this session from. `null` means Eve
+     * Reusable template key to open this session from. `null` means eve
      * intentionally skipped template prewarm because the sandbox has no
      * `bootstrap()` and no seed files, so the backend should create a
      * fresh session from its default base runtime.
@@ -114,7 +114,7 @@ export interface SandboxBackendPrewarmResult {
  *
  * A `SandboxBackend` is a value an author attaches to a
  * {@link SandboxDefinition} to choose which underlying runtime hosts the
- * sandbox. Eve ships built-in backends (`docker()`,
+ * sandbox. eve ships built-in backends (`docker()`,
  * `justbash()`, `microsandbox()`,
  * `vercel()`, and the availability-aware
  * `defaultSandbox()`), but the interface is public so authors can write
@@ -143,7 +143,7 @@ export interface SandboxBackend<BO = Record<string, never>, SO = Record<string,
      */
     create(input: SandboxBackendCreateInput): Promise<SandboxBackendHandle<SO>>;
     /**
-     * Build-time prewarm hook. Eve invokes this for every authored
+     * Build-time prewarm hook. eve invokes this for every authored
      * sandbox in the compiled graph before serving traffic so the backend
      * can capture reusable template state. Idempotent against existing state
      * keyed by `templateKey`.

package/dist/src/shared/sandbox-definition.d.ts

@@ -35,7 +35,7 @@ export interface SandboxSessionContext<O = Record<string, never>> {
     readonly use: SandboxSessionUseFn<O>;
 }
 /**
- * Resolves a build-time revalidation key for a bootstrap snapshot. Eve
+ * Resolves a build-time revalidation key for a bootstrap snapshot. eve
  * evaluates it during compile/build and freezes the result into compiled
  * artifacts. Supply one only for external inputs that affect bootstrap
  * output; authored source and managed seeds are tracked automatically.
@@ -73,7 +73,7 @@ interface SandboxDefinitionBase<BO = Record<string, never>, SO = Record<string,
      * });
      * ```
      *
-     * When this field is omitted, Eve substitutes `defaultSandbox()` at
+     * When this field is omitted, eve substitutes `defaultSandbox()` at
      * runtime, which picks the best available backend: `vercel()`
      * on hosted Vercel (where `process.env.VERCEL` is set), then Docker,
      * microsandbox, or just-bash
@@ -94,7 +94,7 @@ export interface SandboxDefinitionWithBootstrap<BO = Record<string, never>, SO =
     bootstrap(input: SandboxBootstrapContext<BO>): Promise<void> | void;
     /**
      * Optional build-time revalidation key for the reusable sandbox
-     * snapshot produced by {@link bootstrap}. Eve evaluates this
+     * snapshot produced by {@link bootstrap}. eve evaluates this
      * function during compile/build, stores the resolved string in
      * compiled artifacts, and uses that frozen value for both prewarm and
      * runtime session create. Authored sandbox source and

package/dist/src/shared/sandbox-network-policy.d.ts

@@ -2,7 +2,7 @@ import type { NetworkPolicy } from "#compiled/@vercel/sandbox/index.js";
 /**
  * Firewall network policy applied to a live sandbox session.
  *
- * Eve-owned alias of the backend network-policy shape. Use it to restrict
+ * eve-owned alias of the backend network-policy shape. Use it to restrict
  * egress (`"deny-all"`, an allow-list) or to broker credentials onto
  * outgoing requests. A per-domain `transform` injects headers at the
  * firewall so secrets never enter the sandbox process:

package/dist/src/shared/sandbox-session.d.ts

@@ -64,13 +64,13 @@ export interface SandboxRemovePathOptions {
     readonly recursive?: boolean;
 }
 /**
- * Public Eve-owned sandbox session exposed to authored lifecycle hooks.
+ * Public eve-owned sandbox session exposed to authored lifecycle hooks.
  *
  * The eight I/O methods (`run`, `spawn`, `readFile`, `readBinaryFile`,
  * `readTextFile`, `writeFile`, `writeBinaryFile`, `writeTextFile`) are
  * pulled directly from the AI SDK {@link AiSdkSandbox} type, so authored
  * code that targets either surface uses identical signatures. `id` and
- * `resolvePath` are Eve-specific extensions that the runtime relies on
+ * `resolvePath` are eve-specific extensions that the runtime relies on
  * for caching and `/workspace` path anchoring.
  *
  * Relative paths resolve from `/workspace`, the live working directory

package/dist/src/shared/skill-package.d.ts

@@ -14,7 +14,7 @@ export interface MaterializableSkillPackage {
     readonly name: string;
 }
 /**
- * Normalizes one named skill package into the concrete files Eve writes to
+ * Normalizes one named skill package into the concrete files eve writes to
  * workspace resources or the live sandbox.
  */
 export declare function normalizeSkillPackage(input: NamedSkillDefinition): MaterializableSkillPackage;

package/dist/src/shared/skill-package.js

@@ -1 +1 @@
-import{dirname,join}from"node:path";import{mkdir,writeFile}from"node:fs/promises";import{Buffer}from"node:buffer";const WORKSPACE_ROOT=`/workspace`;function normalizeSkillPackage(e){assertSafeSkillPackageName(e.name);let t=[{content:Buffer.from(e.markdown,`utf8`),relativePath:`SKILL.md`}];for(let[n,r]of Object.entries(e.files??{}))assertSafeSkillPackageFilePath(n),t.push({content:contentToBuffer(r),relativePath:n});return t.sort((e,t)=>comparePaths(e.relativePath,t.relativePath)),{description:e.description,files:t,license:e.license,markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name}}async function writeSkillPackageDirectory(i){for(let a of i.skill.files){let o=join(i.rootPath,`skills`,i.skill.name,a.relativePath);await mkdir(dirname(o),{recursive:!0}),await writeFile(o,a.content)}}async function writeSkillPackageToSandbox(e){for(let t of e.skill.files)await e.sandbox.writeBinaryFile({content:t.content,path:`${WORKSPACE_ROOT}/skills/${e.skill.name}/${t.relativePath}`})}async function removeSkillPackageFromSandbox(e){assertSafeSkillPackageName(e.name),await e.sandbox.removePath({force:!0,path:`${WORKSPACE_ROOT}/skills/${e.name}`,recursive:!0})}function assertSafeSkillPackageName(e){if(e.length===0||e.startsWith(`.`)||e.includes(`/`)||e.includes(`\\`)||e.includes(`..`)||!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(e)||/^[A-Za-z]:/.test(e))throw Error(`Expected skill name to be a non-empty shell-safe path segment starting with an alphanumeric character and containing only alphanumerics, ".", "_", or "-".`)}function assertSafeSkillPackageFilePath(e){if(e===`SKILL.md`)throw Error(`Skill package files must not include "SKILL.md"; Eve generates it.`);if(e.length===0||e.startsWith(`/`)||e.includes(`\\`)||/^[A-Za-z]:/.test(e)||e.split(`/`).some(e=>e.length===0||e===`.`||e===`..`))throw Error(`Expected skill package file paths to be relative POSIX paths.`)}function contentToBuffer(e){return typeof e==`string`?Buffer.from(e,`utf8`):Buffer.from(e)}function comparePaths(e,t){return e<t?-1:+(e>t)}export{assertSafeSkillPackageName,normalizeSkillPackage,removeSkillPackageFromSandbox,writeSkillPackageDirectory,writeSkillPackageToSandbox};
+import{dirname,join}from"node:path";import{mkdir,writeFile}from"node:fs/promises";import{Buffer}from"node:buffer";const WORKSPACE_ROOT=`/workspace`;function normalizeSkillPackage(e){assertSafeSkillPackageName(e.name);let t=[{content:Buffer.from(e.markdown,`utf8`),relativePath:`SKILL.md`}];for(let[n,r]of Object.entries(e.files??{}))assertSafeSkillPackageFilePath(n),t.push({content:contentToBuffer(r),relativePath:n});return t.sort((e,t)=>comparePaths(e.relativePath,t.relativePath)),{description:e.description,files:t,license:e.license,markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name}}async function writeSkillPackageDirectory(i){for(let a of i.skill.files){let o=join(i.rootPath,`skills`,i.skill.name,a.relativePath);await mkdir(dirname(o),{recursive:!0}),await writeFile(o,a.content)}}async function writeSkillPackageToSandbox(e){for(let t of e.skill.files)await e.sandbox.writeBinaryFile({content:t.content,path:`${WORKSPACE_ROOT}/skills/${e.skill.name}/${t.relativePath}`})}async function removeSkillPackageFromSandbox(e){assertSafeSkillPackageName(e.name),await e.sandbox.removePath({force:!0,path:`${WORKSPACE_ROOT}/skills/${e.name}`,recursive:!0})}function assertSafeSkillPackageName(e){if(e.length===0||e.startsWith(`.`)||e.includes(`/`)||e.includes(`\\`)||e.includes(`..`)||!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(e)||/^[A-Za-z]:/.test(e))throw Error(`Expected skill name to be a non-empty shell-safe path segment starting with an alphanumeric character and containing only alphanumerics, ".", "_", or "-".`)}function assertSafeSkillPackageFilePath(e){if(e===`SKILL.md`)throw Error(`Skill package files must not include "SKILL.md"; eve generates it.`);if(e.length===0||e.startsWith(`/`)||e.includes(`\\`)||/^[A-Za-z]:/.test(e)||e.split(`/`).some(e=>e.length===0||e===`.`||e===`..`))throw Error(`Expected skill package file paths to be relative POSIX paths.`)}function contentToBuffer(e){return typeof e==`string`?Buffer.from(e,`utf8`):Buffer.from(e)}function comparePaths(e,t){return e<t?-1:+(e>t)}export{assertSafeSkillPackageName,normalizeSkillPackage,removeSkillPackageFromSandbox,writeSkillPackageDirectory,writeSkillPackageToSandbox};

package/dist/src/shared/tool-definition.d.ts

@@ -44,7 +44,7 @@ export interface PublicToolDefinitionWithExecuteFn<TInput = unknown, TOutput = u
     execute: ToolExecuteFn<TInput, TOutput>;
 }
 /**
- * Eve-owned shape for the model-facing tool result produced by
+ * eve-owned shape for the model-facing tool result produced by
  * `toModelOutput`. Structurally compatible with the AI SDK's
  * `ToolResultOutput` so the harness can forward it without conversion.
  */

package/dist/src/svelte/index.js

@@ -1,3 +1,3 @@
-import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-CdETo3qQ.js";
+import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-D9ZhQhyV.js";
 
 export { defaultMessageReducer, useEveAgent };

package/dist/src/svelte/use-eve-agent.d.ts

@@ -12,7 +12,7 @@ export type { PrepareSend };
  */
 export type UseEveAgentStatus = EveAgentStoreStatus;
 /**
- * Immutable point-in-time view of an Eve agent session: projected `data`, the
+ * Immutable point-in-time view of an eve agent session: projected `data`, the
  * last `error`, the raw `events` stream, the `session` cursor, and `status`.
  * `useEveAgent` passes this snapshot to the `onFinish` callback.
  */
@@ -21,7 +21,7 @@ export type UseEveAgentSnapshot<TData> = EveAgentStoreSnapshot<TData>;
  * Reactive return value from `useEveAgent`.
  *
  * The state properties are Svelte 5 rune-friendly getters. Read them from a
- * template, `$derived`, or `$effect` and Svelte will update when Eve streams
+ * template, `$derived`, or `$effect` and Svelte will update when eve streams
  * new events.
  */
 export interface UseEveAgentReturn<TData> {
@@ -43,7 +43,7 @@ export interface UseEveAgentReturn<TData> {
     readonly stop: () => void;
 }
 /**
- * Configuration for a Svelte Eve agent session.
+ * Configuration for a Svelte eve agent session.
  *
  * Read once when `useEveAgent` creates its store; create a new binding to
  * change host, reducer, or session. To rotate credentials or headers without
@@ -62,9 +62,9 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
      */
     readonly headers?: HeadersValue;
     /**
-     * Base URL for Eve client requests. Empty targets same-origin Eve routes
+     * Base URL for eve client requests. Empty targets same-origin eve routes
      * such as `/eve/v1/...`; a same-origin prefix like `/api` routes through an
-     * app-owned proxy; an absolute origin hits an Eve server directly.
+     * app-owned proxy; an absolute origin hits an eve server directly.
      *
      * @default ""
      */
@@ -80,10 +80,10 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
      */
     readonly maxReconnectAttempts?: number;
     /**
-     * Project submitted user messages before Eve confirms them with a
+     * Project submitted user messages before eve confirms them with a
      * `message.received` stream event. Optimistic events are reducer-facing
      * projection only and never appear in `events`, which stays the
-     * authoritative Eve stream.
+     * authoritative eve stream.
      *
      * @default true
      */

package/dist/src/svelte/use-eve-agent.js

@@ -1,3 +1,3 @@
-import { t as useEveAgent } from "../chunks/use-eve-agent-CdETo3qQ.js";
+import { t as useEveAgent } from "../chunks/use-eve-agent-D9ZhQhyV.js";
 
 export { useEveAgent };

package/dist/src/vue/index.js

@@ -1,3 +1,3 @@
-import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-ClyM-_UT.js";
+import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-DFI0POM9.js";
 
 export { defaultMessageReducer, useEveAgent };

package/dist/src/vue/use-eve-agent.d.ts

@@ -13,7 +13,7 @@ export type { PrepareSend };
  */
 export type UseEveAgentStatus = EveAgentStoreStatus;
 /**
- * Point-in-time projected state for an Eve agent session (`data`, `error`,
+ * Point-in-time projected state for an eve agent session (`data`, `error`,
  * `events`, `session`, `status`).
  *
  * `useEveAgent` passes this shape to callbacks such as `onFinish`, but exposes
@@ -42,7 +42,7 @@ export interface UseEveAgentReturn<TData> {
     readonly stop: () => void;
 }
 /**
- * Configuration for creating or binding a Vue Eve agent session.
+ * Configuration for creating or binding a Vue eve agent session.
  *
  * Session configuration is read once when the composable creates its internal
  * store; to change the host, reducer, or session, remount the component. For
@@ -59,11 +59,11 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
     /** Custom headers; a function value is resolved per request. */
     readonly headers?: HeadersValue;
     /**
-     * Base URL used for Eve client requests.
+     * Base URL used for eve client requests.
      *
-     * By default, requests target same-origin Eve routes such as `/eve/v1/...`.
+     * By default, requests target same-origin eve routes such as `/eve/v1/...`.
      * Pass a same-origin prefix such as `/api` to use an app-owned proxy, or an
-     * absolute origin to talk to an Eve server directly.
+     * absolute origin to talk to an eve server directly.
      *
      * @default ""
      */
@@ -75,11 +75,11 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
     /** Maximum SSE reconnection attempts per turn. @default 3 */
     readonly maxReconnectAttempts?: number;
     /**
-     * Project submitted user messages before Eve confirms them with a
+     * Project submitted user messages before eve confirms them with a
      * `message.received` stream event.
      *
      * Optimistic events are reducer-facing projection events only. They are not
-     * exposed through `events`, which remains the authoritative Eve stream.
+     * exposed through `events`, which remains the authoritative eve stream.
      *
      * @default true
      */

package/dist/src/vue/use-eve-agent.js

@@ -1,3 +1,3 @@
-import { t as useEveAgent } from "../chunks/use-eve-agent-ClyM-_UT.js";
+import { t as useEveAgent } from "../chunks/use-eve-agent-DFI0POM9.js";
 
 export { useEveAgent };

package/docs/README.md

@@ -1,28 +1,28 @@
-# Eve Public Docs
+# eve Public Docs
 
-This folder is for app authors using Eve as a framework.
+This folder is for app authors using eve as a framework.
 
-If you want to understand how to build agents with Eve, start here.
+If you want to understand how to build agents with eve, start here.
 
 Important naming note:
 
-- The framework is called Eve.
+- The framework is called eve.
 - The current published package name is `eve`.
 - The CLI binary is `eve`.
 
 ## Legal and safeguards
 
-Eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
+eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
 
 As the deployer, it is your responsibility to ensure your agent complies with applicable laws.
 
 You are responsible for configuring approval policies, tool restrictions, connection scopes, route/session authorization, sandbox controls, telemetry exports, and other safeguards appropriate for your use case.
 
-Before using Eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
+Before using eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
 
 Require human approval or other safeguards for sensitive, irreversible, regulated, financial, healthcare, employment, housing, legal, safety-impacting, user-impacting, or external side-effecting actions.
 
-Unless you configure stricter controls, Eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
+Unless you configure stricter controls, eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
 
 Casing convention:
 
@@ -40,7 +40,7 @@ Read in this order:
 5. [TypeScript API](./reference/typescript-api.md)
 6. [Context Control](./concepts/context-control.md)
 7. [Skills](./skills.mdx)
-8. [Tools](./tools.mdx)
+8. [Tools](./tools/overview.mdx)
 9. [Connections](./connections.mdx)
 10. [Sandboxes](./sandbox.mdx)
 11. [Channels](./channels/overview.mdx)
@@ -56,7 +56,7 @@ Read in this order:
 
 ## The public mental model
 
-Eve is a filesystem-first framework for durable backend agents.
+eve is a filesystem-first framework for durable backend agents.
 
 You author an agent as files on disk:
 
@@ -71,7 +71,7 @@ You author an agent as files on disk:
 - recurring jobs in `schedules/`
 - additive runtime config in `agent.ts`
 
-Eve then gives you:
+eve then gives you:
 
 - a stable HTTP message route
 - optional channel webhook routes
@@ -89,7 +89,7 @@ know:
 - the harness does one unit of AI work and decides whether to continue, wait, or finish
 - the runtime persists session state, streams events, and owns workflow orchestration
 
-That is why Eve exposes two identifiers:
+That is why eve exposes two identifiers:
 
 - `continuationToken` for the next user message
 - `sessionId` for streaming and inspection

package/docs/agent-config.md

@@ -17,7 +17,7 @@ export default defineAgent({
 });
 ```
 
-The root `agent.ts` can be omitted when no runtime config is needed. In that case, Eve defaults
+The root `agent.ts` can be omitted when no runtime config is needed. In that case, eve defaults
 to `anthropic/claude-sonnet-4.6`. When `agent.ts` is present, `model` is required.
 
 `model` accepts a gateway model id string, which routes through the [Vercel AI Gateway](https://vercel.com/docs/ai-gateway). To call a provider directly and configure the model in code, pass a provider-authored `LanguageModel`:
@@ -57,7 +57,7 @@ See [Default harness](./concepts/default-harness#compaction) for how the loop ap
 | `modelOptions` | `AgentModelOptionsDefinition`           | none        | Provider option overrides forwarded to the model call.                                                                                                                                                                                                   |
 | `experimental` | `{ codeMode?: boolean }`                | flags unset | Opt-in flags that can change or disappear in any release. Treat them as unstable. `codeMode` routes executable tools through a sandboxed code-execution wrapper, where the model writes JavaScript that calls the tools inside the [sandbox](./sandbox). |
 | `outputSchema` | Standard Schema or a JSON Schema object | none        | Structured return type for task-mode runs (a subagent, schedule, or remote job). Interactive conversation turns ignore it unless the client supplies a per-message schema.                                                                               |
-| `build`        | `{ externalDependencies?: string[] }`   | none        | Hosted-build packaging controls. `externalDependencies` keeps listed packages external while Eve compiles authored modules such as tools and channels, and traces those packages into the hosted output.                                                 |
+| `build`        | `{ externalDependencies?: string[] }`   | none        | Hosted-build packaging controls. `externalDependencies` keeps listed packages external while eve compiles authored modules such as tools and channels, and traces those packages into the hosted output.                                                 |
 
 `codeMode` is experimental and may change or be removed.
 

package/docs/channels/custom.mdx

@@ -3,7 +3,7 @@ title: "Custom Channels"
 description: "Author custom HTTP and WebSocket channels with routes, events, metadata, continuation tokens, and file uploads."
 ---
 
-When Eve doesn't ship a channel for your surface, you build one. Custom channels expose HTTP or WebSocket endpoints, parse incoming requests, start or resume sessions, observe runtime events, and own delivery back to your platform.
+When eve doesn't ship a channel for your surface, you build one. Custom channels expose HTTP or WebSocket endpoints, parse incoming requests, start or resume sessions, observe runtime events, and own delivery back to your platform.
 
 ## File location and identity
 
@@ -53,7 +53,7 @@ Declare routes with the `POST()` and `GET()` helpers. Each route handler receive
 - `waitUntil(promise)` extends the request lifetime for background work.
 - `requestIp` is the client IP, or `null` when the host cannot provide it.
 
-Event handlers like `"message.completed"` are declared under the `events` key. They receive `(eventData, channel, ctx)`, where `eventData` is the event payload, `channel` carries platform handles and session continuation operations, and `ctx` is the Eve `SessionContext`. Every channel kind shares this signature. The one exception is `session.failed`, which receives only `(eventData, channel)` with no `ctx`.
+Event handlers like `"message.completed"` are declared under the `events` key. They receive `(eventData, channel, ctx)`, where `eventData` is the event payload, `channel` carries platform handles and session continuation operations, and `ctx` is the eve `SessionContext`. Every channel kind shares this signature. The one exception is `session.failed`, which receives only `(eventData, channel)` with no `ctx`.
 
 ## WebSocket routes
 
@@ -76,11 +76,11 @@ export default defineChannel({
 });
 ```
 
-`WS()` handlers receive the same helpers as HTTP route handlers: `send`, `getSession`, `receive`, `params`, `waitUntil`, and `requestIp`. The returned hooks are Eve-owned structural types compatible with Nitro/H3 websocket routing, including `upgrade`, `open`, `message`, `close`, and `error`.
+`WS()` handlers receive the same helpers as HTTP route handlers: `send`, `getSession`, `receive`, `params`, `waitUntil`, and `requestIp`. The returned hooks are eve-owned structural types compatible with Nitro/H3 websocket routing, including `upgrade`, `open`, `message`, `close`, and `error`.
 
 ### Node upgrade server escape hatch
 
-Prefer the `WS()` lifecycle hooks above when you own the websocket behavior. Eve also exposes `createWebSocketUpgradeServer()` for the narrower case where a third-party SDK or framework expects to bind directly to a Node `http.Server` with `server.on("upgrade", ...)`.
+Prefer the `WS()` lifecycle hooks above when you own the websocket behavior. eve also exposes `createWebSocketUpgradeServer()` for the narrower case where a third-party SDK or framework expects to bind directly to a Node `http.Server` with `server.on("upgrade", ...)`.
 
 ```ts
 import { defineChannel, WS, createWebSocketUpgradeServer } from "eve/channels";
@@ -94,7 +94,7 @@ export default defineChannel({
 });
 ```
 
-The bridge server does not listen on its own port. It receives only upgrade events that matched the Eve route, and only on hosts where Nitro exposes the raw Node upgrade request, socket, and head. Treat it as a compatibility adapter for libraries with server-binding APIs, not the primary way to build websocket channels in Eve.
+The bridge server does not listen on its own port. It receives only upgrade events that matched the eve route, and only on hosts where Nitro exposes the raw Node upgrade request, socket, and head. Treat it as a compatibility adapter for libraries with server-binding APIs, not the primary way to build websocket channels in eve.
 
 ## Cross-channel hand-off
 

package/docs/channels/discord.mdx

@@ -4,7 +4,7 @@ description: "Reach your agent from Discord HTTP Interactions, including slash c
 type: integration
 ---
 
-The Discord channel wires your agent into Discord's HTTP Interactions, including slash and application commands, message components, and modal submissions. Discord enforces a three-second ACK deadline, so the channel verifies the Ed25519 signature headers, acknowledges the command right away, and runs the Eve work in the background. See [Channels](./overview) for the contract this builds on.
+The Discord channel wires your agent into Discord's HTTP Interactions, including slash and application commands, message components, and modal submissions. Discord enforces a three-second ACK deadline, so the channel verifies the Ed25519 signature headers, acknowledges the command right away, and runs the eve work in the background. See [Channels](./overview) for the contract this builds on.
 
 ## Add the channel
 
@@ -24,12 +24,12 @@ To skip env vars, pass the same values through `credentials: { applicationId, bo
 
 ## Register a command
 
-Registering commands is on you, not the channel. Use Discord's API or the Developer Portal. A string option named `message` lines up with Eve's default prompt extraction:
+Registering commands is on you, not the channel. Use Discord's API or the Developer Portal. A string option named `message` lines up with eve's default prompt extraction:
 
 ```bash
 curl -X PUT "https://discord.com/api/v10/applications/$DISCORD_APPLICATION_ID/commands" \
   -H "Authorization: Bot $DISCORD_BOT_TOKEN" -H "Content-Type: application/json" \
-  -d '[{"name":"ask","description":"Ask the Eve agent","type":1,
+  -d '[{"name":"ask","description":"Ask the eve agent","type":1,
     "options":[{"name":"message","description":"What should the agent do?","type":3,"required":true}]}]'
 ```