eve 0.31.2 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # eve
 
+## 0.32.0
+
+### Minor Changes
+
+- 1702f91: Tool approval responses now use `cancel` instead of `deny`, while retaining `approve` for the positive response, aligning the public protocol with the user-facing flow-control semantics.
+- cbe7105: Allow authored hooks, tools, and channel callbacks to stop their active sandbox through `ctx.getSandbox().stop()`. Every built-in backend preserves the durable session for a later callback, and custom sandbox backend handles must now implement `stop()`.
+
+### Patch Changes
+
+- ea530ec: Update `eve add` to better support agent-based invocation of guided setup flows. Interactive setup links a Vercel project when needed; after each deployable setup, `/add` offers to add more by default, deploy to production, or finish.
+- a29cc8e: Update the bundled AI SDK to 7.0.58 and the `@ai-sdk/*` providers to their latest minors.
+- 39c76ca: AI Gateway models now use Exa by default for the built-in `web_search` tool. Agents can continue to select Parallel explicitly with `webSearch({ provider: "parallel" })`.
+- 261af74: Photon setup now shows an existing project's dedicated number when available, rather than allocating and showing a shared fallback number.
+- 55b5cc7: Teach newly scaffolded coding agents to discover integrations and follow the structured `eve add --headless` setup flow through completion.
+- 91cca9a: Slack now posts tool input previews separately from approval controls so large inputs no longer inflate button callbacks and approvals remain responsive.
+- 50f2d96: Conversation sessions no longer stall while an interactive authorization challenge is open: ordinary messages run as normal turns, while tasks defer unrelated input until their blocked authorization completes. Callbacks are bound to the exact challenge attempt and initiating connection principal, remain live across parked activity, and start a valid callback turn after the authorization park closes its boundary. Session timeouts are also honored during an open challenge, and `client.fetch` preserves query strings embedded in the request path.
+- 7449917: Stop completed and cancelled todo lists from being re-injected as user messages after compaction. Lists that still contain active work continue to be preserved in full.
+- 63a76f0: Local traces now record `agent.turn` with the turn's real duration instead of a zero-duration marker, and the separate `agent.turn.terminal` marker span is gone — terminal and transition events land on the turn span itself. `agent.session` window roots remain zero-duration markers because an idle session never closes.
+- a159596: Export telemetry for every step of multi-step turns when an OpenTelemetry consumer groups spans by completed local segments.
+- e1080e0: Reject HTML sign-in pages returned by Slack private file downloads and explain how to restore attachment access.
+- 52000dd: Build tool input schemas authored with Zod 3 instead of crashing during JSON Schema conversion.
+- f06e12e: Add a structured `eve add --non-interactive` flow with stable setup answers, component selection, and resumable setup blockers for coding agents.
+
+## 0.31.3
+
+### Patch Changes
+
+- 0dbe7ef: Add `toolCall.providedArguments` to MCP and OpenAPI connections so applications can hide and supply application-owned arguments on every remote tool call.
+- 53c05ff: Allow Linear channels to configure the accepted webhook timestamp skew for retry deliveries.
+
 ## 0.31.2
 
 ### Patch Changes

package/dist/src/chunks/{use-eve-agent-CF5D6jSV.js → use-eve-agent-CX87G1vU.js}

@@ -1,5 +1,6 @@
 import { computed, onScopeDispose, shallowRef } from "vue";
 import { z } from "#compiled/zod/index.js";
+import { asSchema } from "ai";
 
 //#region src/protocol/routes.ts
 const EVE_ROUTE_PREFIX = "/eve/v1";
@@ -17,7 +18,8 @@ const EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/dev/runtime-ar
 const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`;
 const EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`;
 const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;
-const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
+const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`;
+const EVE_LEGACY_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
 const EVE_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/callback/:token`;
 function createEveSessionRoutePath(sessionId) {
 	return `${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(sessionId)}`;
@@ -503,19 +505,28 @@ async function* readNdjsonStream(body) {
 //#endregion
 //#region src/client/url.ts
 function createClientUrl(host, routePath, searchParams) {
-	const normalizedRoute = routePath.startsWith("/") ? routePath : `/${routePath}`;
+	const queryIndex = routePath.indexOf("?");
+	const pathOnly = queryIndex === -1 ? routePath : routePath.slice(0, queryIndex);
+	const embeddedQuery = queryIndex === -1 ? "" : routePath.slice(queryIndex + 1);
+	const normalizedRoute = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
 	if (isAbsoluteUrl(host)) {
 		const url = new URL(host);
 		url.pathname = `${trimTrailingSlash(url.pathname)}${normalizedRoute}`;
+		mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 		mergeSearchParams(url.searchParams, searchParams);
 		url.hash = "";
 		return url.toString();
 	}
 	const url = new URL(host, "http://eve.local");
 	const basePath = trimTrailingSlash(url.pathname);
+	mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 	mergeSearchParams(url.searchParams, searchParams);
 	return `${basePath}${normalizedRoute}${formatSearch(url.searchParams)}`;
 }
+function mergeEmbeddedQuery(target, embeddedQuery) {
+	if (embeddedQuery.length === 0) return;
+	for (const [name, value] of new URLSearchParams(embeddedQuery)) target.append(name, value);
+}
 function isAbsoluteUrl(value) {
 	return /^[a-z][a-z\d+\-.]*:/i.test(value);
 }
@@ -888,11 +899,25 @@ function serializeSchema(source, direction) {
 	return toJsonObject(source, direction);
 }
 function toJsonObject(source, direction) {
-	const { $schema: _schemaVersion, ...canonical } = isStandardJsonSchema(source) ? parseJsonObject(source["~standard"].jsonSchema[direction]({ target: JSON_SCHEMA_TARGET })) : parseJsonObject(source);
+	const standard = getStandardSchemaProperties(source);
+	const jsonSchema = standard?.jsonSchema;
+	const emit = typeof jsonSchema === "object" && jsonSchema !== null ? jsonSchema[direction] : void 0;
+	const vendor = typeof standard?.vendor === "string" ? standard.vendor : "unknown";
+	if (standard !== void 0 && typeof emit !== "function" && vendor === "zod") {
+		if (direction === "input") {
+			const { $schema: _schemaVersion, ...canonical } = parseJsonObject(asSchema(source).jsonSchema);
+			return canonical;
+		}
+		throw new Error("Zod 3 cannot emit an output JSON Schema. Upgrade to Zod 4 or provide a plain JSON Schema object.");
+	}
+	if (standard !== void 0 && typeof emit !== "function") throw new Error(`Standard Schema vendor "${vendor}" does not support JSON Schema conversion. Provide a Standard Schema implementation with JSON Schema conversion or a plain JSON Schema object.`);
+	const { $schema: _schemaVersion, ...canonical } = standard === void 0 ? parseJsonObject(source) : parseJsonObject(emit({ target: JSON_SCHEMA_TARGET }));
 	return canonical;
 }
-function isStandardJsonSchema(value) {
-	return value !== null && typeof value === "object" && "~standard" in value;
+function getStandardSchemaProperties(value) {
+	if (typeof value !== "object" || value === null || !("~standard" in value)) return void 0;
+	const standard = value["~standard"];
+	return typeof standard === "object" && standard !== null ? standard : void 0;
 }
 
 //#endregion

package/dist/src/chunks/{use-eve-agent-DbYZLG0h.js → use-eve-agent-DwyRde1N.js}

@@ -1,5 +1,6 @@
 import { createSubscriber } from "svelte/reactivity";
 import { z } from "#compiled/zod/index.js";
+import { asSchema } from "ai";
 
 //#region src/protocol/routes.ts
 const EVE_ROUTE_PREFIX = "/eve/v1";
@@ -17,7 +18,8 @@ const EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/dev/runtime-ar
 const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`;
 const EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`;
 const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;
-const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
+const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`;
+const EVE_LEGACY_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
 const EVE_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/callback/:token`;
 function createEveSessionRoutePath(sessionId) {
 	return `${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(sessionId)}`;
@@ -503,19 +505,28 @@ async function* readNdjsonStream(body) {
 //#endregion
 //#region src/client/url.ts
 function createClientUrl(host, routePath, searchParams) {
-	const normalizedRoute = routePath.startsWith("/") ? routePath : `/${routePath}`;
+	const queryIndex = routePath.indexOf("?");
+	const pathOnly = queryIndex === -1 ? routePath : routePath.slice(0, queryIndex);
+	const embeddedQuery = queryIndex === -1 ? "" : routePath.slice(queryIndex + 1);
+	const normalizedRoute = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
 	if (isAbsoluteUrl(host)) {
 		const url = new URL(host);
 		url.pathname = `${trimTrailingSlash(url.pathname)}${normalizedRoute}`;
+		mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 		mergeSearchParams(url.searchParams, searchParams);
 		url.hash = "";
 		return url.toString();
 	}
 	const url = new URL(host, "http://eve.local");
 	const basePath = trimTrailingSlash(url.pathname);
+	mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 	mergeSearchParams(url.searchParams, searchParams);
 	return `${basePath}${normalizedRoute}${formatSearch(url.searchParams)}`;
 }
+function mergeEmbeddedQuery(target, embeddedQuery) {
+	if (embeddedQuery.length === 0) return;
+	for (const [name, value] of new URLSearchParams(embeddedQuery)) target.append(name, value);
+}
 function isAbsoluteUrl(value) {
 	return /^[a-z][a-z\d+\-.]*:/i.test(value);
 }
@@ -888,11 +899,25 @@ function serializeSchema(source, direction) {
 	return toJsonObject(source, direction);
 }
 function toJsonObject(source, direction) {
-	const { $schema: _schemaVersion, ...canonical } = isStandardJsonSchema(source) ? parseJsonObject(source["~standard"].jsonSchema[direction]({ target: JSON_SCHEMA_TARGET })) : parseJsonObject(source);
+	const standard = getStandardSchemaProperties(source);
+	const jsonSchema = standard?.jsonSchema;
+	const emit = typeof jsonSchema === "object" && jsonSchema !== null ? jsonSchema[direction] : void 0;
+	const vendor = typeof standard?.vendor === "string" ? standard.vendor : "unknown";
+	if (standard !== void 0 && typeof emit !== "function" && vendor === "zod") {
+		if (direction === "input") {
+			const { $schema: _schemaVersion, ...canonical } = parseJsonObject(asSchema(source).jsonSchema);
+			return canonical;
+		}
+		throw new Error("Zod 3 cannot emit an output JSON Schema. Upgrade to Zod 4 or provide a plain JSON Schema object.");
+	}
+	if (standard !== void 0 && typeof emit !== "function") throw new Error(`Standard Schema vendor "${vendor}" does not support JSON Schema conversion. Provide a Standard Schema implementation with JSON Schema conversion or a plain JSON Schema object.`);
+	const { $schema: _schemaVersion, ...canonical } = standard === void 0 ? parseJsonObject(source) : parseJsonObject(emit({ target: JSON_SCHEMA_TARGET }));
 	return canonical;
 }
-function isStandardJsonSchema(value) {
-	return value !== null && typeof value === "object" && "~standard" in value;
+function getStandardSchemaProperties(value) {
+	if (typeof value !== "object" || value === null || !("~standard" in value)) return void 0;
+	const standard = value["~standard"];
+	return typeof standard === "object" && standard !== null ? standard : void 0;
 }
 
 //#endregion

package/dist/src/cli/commands/integration-connect.d.ts

@@ -5,6 +5,7 @@ import { type Prompter } from "#setup/prompter.js";
 import { updateConnectionConnectorUid } from "#setup/scaffold/update/update-connection-connector.js";
 import type { RegistryCommandLogger } from "./registry.js";
 export interface IntegrationConnectOptions {
+    nonInteractive?: boolean;
     signal?: AbortSignal;
 }
 export interface IntegrationConnectDependencies {

package/dist/src/cli/commands/integration-connect.js

@@ -1 +1 @@
-import{NOT_AN_AGENT_MESSAGE}from"./preconditions.js";import{join}from"node:path";import{isEveProject}from"#setup/scaffold/index.js";import{createPrompter}from"#setup/prompter.js";import{cleanupCreatedConnectionConnector,setupConnectionConnector}from"#setup/connection-connector.js";import{runLinkFlow}from"#setup/flows/link.js";import{readProjectLink}from"#setup/project-resolution.js";import{createRegistrySetupClient}from"#setup/registry-setup-client.js";import{updateConnectionConnectorUid}from"#setup/scaffold/update/update-connection-connector.js";const defaultDependencies={readProjectLink,runLinkFlow,setupConnectionConnector,cleanupCreatedConnectionConnector,updateConnectionConnectorUid};async function runIntegrationConnect(e){let n={...defaultDependencies,...e.dependencies},r=n.createPrompter?.()??createPrompter(),i=e.options?.signal;r.intro(`Set up ${e.slug}`);let a=await n.readProjectLink(e.appRoot);if(a===void 0){if((await n.runLinkFlow({appRoot:e.appRoot,prompter:r,signal:i,projectSelection:`create-or-link`,teamSelectMessage:()=>`You need to link to a project to use ${e.slug} through Vercel Connect.\n\nSelect your team`,deps:n.linkFlowDeps})).kind===`cancelled`)return;if(a=await n.readProjectLink(e.appRoot),a===void 0)throw Error(`Project link was not found after linking.`)}let o={log:r.log,prompter:r,projectRoot:e.appRoot,slug:e.slug,service:e.service,canonicalConnectorName:e.canonicalConnectorName??e.slug,project:a,signal:i},s=await n.setupConnectionConnector(o),c=join(e.appRoot,`agent`,`connections`,`${e.slug}.ts`);if(!(await n.updateConnectionConnectorUid(c,s.connectorUid)).patched)throw s.kind===`created`&&await n.cleanupCreatedConnectionConnector({log:r.log,projectRoot:e.appRoot,connectorId:s.connectorId,orgId:a.orgId}),Error(`Could not update the connector in agent/connections/${e.slug}.ts.`);r.outro(`Connection ${e.slug} set up.`)}async function runIntegrationConnectCommand(t,r,i,a,o,c={},l=defaultDependencies){if(!await isEveProject(r)){t.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}let u=createRegistrySetupClient({signal:c.signal});try{await runIntegrationConnect({appRoot:r,slug:i,service:a,canonicalConnectorName:o,options:c,dependencies:{...l,createPrompter:()=>u?.prompter??l.createPrompter?.()??createPrompter()}}),u?.complete()}catch(e){u?.fail(e),t.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}export{runIntegrationConnect,runIntegrationConnectCommand};
+import{NOT_AN_AGENT_MESSAGE}from"./preconditions.js";import{serializeHeadlessSetupEvent}from"./setup-headless.js";import{join}from"node:path";import{isEveProject}from"#setup/scaffold/index.js";import{createPrompter}from"#setup/prompter.js";import{cleanupCreatedConnectionConnector,setupConnectionConnector}from"#setup/connection-connector.js";import{runLinkFlow}from"#setup/flows/link.js";import{createHeadlessPrompter}from"#setup/headless.js";import{SetupPrerequisiteRequired}from"#setup/integrations/shared/prerequisite.js";import{resolveIntegrationVercelProject}from"#setup/integrations/shared/vercel-project.js";import{readProjectLink}from"#setup/project-resolution.js";import{createRegistrySetupClient}from"#setup/registry-setup-client.js";import{updateConnectionConnectorUid}from"#setup/scaffold/update/update-connection-connector.js";const defaultDependencies={readProjectLink,runLinkFlow,setupConnectionConnector,cleanupCreatedConnectionConnector,updateConnectionConnectorUid};async function runIntegrationConnect(e){let t={...defaultDependencies,...e.dependencies},r=e.options?.nonInteractive===!0,i=t.createPrompter?.()??(r?createHeadlessPrompter(()=>{}):createPrompter()),a=e.options?.signal;i.intro(`Set up ${e.slug}`);let o=await t.readProjectLink(e.appRoot);if(o===void 0)if(r)o=await resolveIntegrationVercelProject({appRoot:e.appRoot,integration:e.slug,signal:a,deps:{readProjectLink:t.readProjectLink}});else{if((await t.runLinkFlow({appRoot:e.appRoot,prompter:i,signal:a,projectSelection:`create-or-link`,teamSelectMessage:()=>`You need to link to a project to use ${e.slug} through Vercel Connect.\n\nSelect your team`,deps:t.linkFlowDeps})).kind===`cancelled`)return;if(o=await t.readProjectLink(e.appRoot),o===void 0)throw Error(`Project link was not found after linking.`)}let s={log:i.log,prompter:i,projectRoot:e.appRoot,slug:e.slug,service:e.service,canonicalConnectorName:e.canonicalConnectorName??e.slug,project:o,signal:a},l=await t.setupConnectionConnector(s),u=join(e.appRoot,`agent`,`connections`,`${e.slug}.ts`);if(!(await t.updateConnectionConnectorUid(u,l.connectorUid)).patched)throw l.kind===`created`&&await t.cleanupCreatedConnectionConnector({log:i.log,projectRoot:e.appRoot,connectorId:l.connectorId,orgId:o.orgId}),Error(`Could not update the connector in agent/connections/${e.slug}.ts.`);i.outro(`Connection ${e.slug} set up.`)}async function runIntegrationConnectCommand(n,i,a,o,c,l={},d=defaultDependencies){if(!await isEveProject(i)){n.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}let f=createRegistrySetupClient({signal:l.signal});try{await runIntegrationConnect({appRoot:i,slug:a,service:o,canonicalConnectorName:c,options:l,dependencies:{...d,createPrompter:()=>f?.prompter??(l.nonInteractive?createHeadlessPrompter(()=>{}):d.createPrompter?.()??createPrompter())}}),f?.complete()}catch(e){if(f?.fail(e),f!==void 0)return;if(l.nonInteractive&&e instanceof SetupPrerequisiteRequired){n.error(serializeHeadlessSetupEvent({version:1,type:`blocked`,status:`prerequisite_required`,prerequisite:e.prerequisite})),process.exitCode=2;return}n.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}export{runIntegrationConnect,runIntegrationConnectCommand};

package/dist/src/cli/commands/integration-setup.d.ts

@@ -1,13 +1,17 @@
 import { type Prompter } from "#setup/prompter.js";
+import { type SetupProcess } from "#setup/registry-setup-client.js";
 import { type IntegrationSetupRunnerDeps } from "#setup/integrations/runner.js";
 import type { RegistryCommandLogger } from "./registry.js";
 export interface IntegrationSetupOptions {
     yes?: boolean;
+    nonInteractive?: boolean;
+    answers?: Record<string, unknown>;
     signal?: AbortSignal;
 }
 export interface IntegrationSetupDependencies {
     createPrompter?: () => Prompter;
     runnerDeps?: IntegrationSetupRunnerDeps;
+    setupProcess?: SetupProcess;
 }
 /** Runs built-in integration setup after its registry payload is installed. */
 export declare function runIntegrationSetupCommand(logger: RegistryCommandLogger, appRoot: string, kind: string, options?: IntegrationSetupOptions, dependencies?: IntegrationSetupDependencies): Promise<void>;

package/dist/src/cli/commands/integration-setup.js

@@ -1 +1 @@
-import{NOT_AN_AGENT_MESSAGE}from"./preconditions.js";import{isEveProject}from"#setup/scaffold/index.js";import{createPrompter}from"#setup/prompter.js";import{createRegistrySetupClient}from"#setup/registry-setup-client.js";import{runIntegrationSetup}from"#setup/integrations/runner.js";const defaultIntegrationSetupDependencies={};async function runIntegrationSetupCommand(n,r,i,a={},o=defaultIntegrationSetupDependencies){if(!await isEveProject(r)){n.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}let s=createRegistrySetupClient({signal:a.signal});try{let e=s?.prompter??o.createPrompter?.()??createPrompter(),t=await runIntegrationSetup(i,{appRoot:r,prompter:e,signal:s?.signal??a.signal,yes:a.yes},o.runnerDeps);if(t.kind===`cancelled`){s?.cancel(),process.env.EVE_SETUP===`1`&&(process.exitCode=130);return}e.outro(`Integration set up.`),s?.complete(t.facts)}catch(e){s?.fail(e),n.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}export{runIntegrationSetupCommand};
+import{NOT_AN_AGENT_MESSAGE}from"./preconditions.js";import{serializeHeadlessSetupEvent}from"./setup-headless.js";import{isEveProject}from"#setup/scaffold/index.js";import{createPrompter}from"#setup/prompter.js";import{createHeadlessPrompter}from"#setup/headless.js";import{SetupPrerequisiteRequired}from"#setup/integrations/shared/prerequisite.js";import{createRegistrySetupClient}from"#setup/registry-setup-client.js";import{InteractionRequired,InvalidAnswerError,headlessAsker,interactiveAsker,withAnswers,withPolicy}from"#setup/ask.js";import{ensureVercelProject}from"#setup/flows/ensure-vercel-project.js";import{runIntegrationSetup}from"#setup/integrations/runner.js";import{setupQuestionToWire}from"#setup/setup-question-wire.js";const defaultIntegrationSetupDependencies={};async function runIntegrationSetupCommand(a,o,s,c={},l=defaultIntegrationSetupDependencies){if(!await isEveProject(o)){a.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}let u=createRegistrySetupClient({process:l.setupProcess,signal:c.signal});try{let e=c.nonInteractive===!0,t=u?.prompter??l.createPrompter?.()??(e?createHeadlessPrompter(()=>{}):createPrompter()),n=e?headlessAsker():interactiveAsker(t),r=c.yes?withPolicy(`assume`)(n):n,i=await runIntegrationSetup(s,{appRoot:o,prompter:t,asker:withAnswers(c.answers??{})(r),resolveVercelProject:e?void 0:()=>ensureVercelProject({appRoot:o,prompter:t,signal:u?.signal??c.signal}),signal:u?.signal??c.signal,beginExternalAction:e?e=>{let t=`external-action-${crypto.randomUUID()}`;return a.log(serializeHeadlessSetupEvent({version:1,type:`external_action`,id:t,blocking:!0,...e})),{complete(){a.log(serializeHeadlessSetupEvent({version:1,type:`external_action_resolved`,id:t}))}}}:void 0},l.runnerDeps);if(i.kind===`cancelled`){u?.cancel(),process.env.EVE_SETUP===`1`?process.exitCode=130:e&&a.error(serializeHeadlessSetupEvent({version:1,type:`cancelled`,item:s}));return}t.outro(`Integration set up.`),u?.complete(i.completion),e&&u===void 0&&a.log(serializeHeadlessSetupEvent({version:1,type:`completed`,item:s}))}catch(e){if(u?.fail(e),u!==void 0)return;c.nonInteractive&&e instanceof InteractionRequired?(a.error(serializeHeadlessSetupEvent({version:1,type:`blocked`,status:`input_required`,question:setupQuestionToWire(e.question)})),process.exitCode=2):c.nonInteractive&&e instanceof InvalidAnswerError?(a.error(serializeHeadlessSetupEvent({version:1,type:`blocked`,status:`input_required`,question:setupQuestionToWire(e.question),issue:{code:`invalid_answer`,message:e.message}})),process.exitCode=2):c.nonInteractive&&e instanceof SetupPrerequisiteRequired?(a.error(serializeHeadlessSetupEvent({version:1,type:`blocked`,status:`prerequisite_required`,prerequisite:e.prerequisite})),process.exitCode=2):(a.error(e instanceof Error?e.message:String(e)),process.exitCode=1)}}export{runIntegrationSetupCommand};

package/dist/src/cli/commands/register-integration-commands.js

@@ -1 +1 @@
-function registerIntegrationCommands(e){let{appRoot:t,logger:n,program:r}=e,i=r.command(`integration`,{hidden:!0});i.command(`setup <kind>`).option(`-y, --yes`).action(async(e,r)=>{let{runIntegrationSetupCommand:i}=await import(`./integration-setup.js`);await i(n,t,e,{yes:r.yes})}),i.command(`connect <slug> <service> [canonical-name]`).option(`-y, --yes`).action(async(e,r,i)=>{let{runIntegrationConnectCommand:a}=await import(`./integration-connect.js`);await a(n,t,e,r,i)})}export{registerIntegrationCommands};
+import{parseSetupAnswer}from"./setup-answers.js";function registerIntegrationCommands(t){let{appRoot:n,logger:r,program:i}=t,a=i.command(`integration`,{hidden:!0});a.command(`setup <kind>`).option(`-y, --yes`).option(`--non-interactive`,`Run without interactive prompts, instead emit structured NDJSON when further input is required`).option(`--answer <key=value>`,`Answer a setup question; requires --non-interactive.`,parseSetupAnswer,{}).action(async(e,t)=>{let{runIntegrationSetupCommand:i}=await import(`./integration-setup.js`);await i(r,n,e,{yes:t.yes,nonInteractive:t.nonInteractive,answers:t.answer})}),a.command(`connect <slug> <service> [canonical-name]`).option(`-y, --yes`).option(`--non-interactive`,`Run without interactive prompts, instead emit structured NDJSON when further input is required`).action(async(e,t,i,a)=>{let{runIntegrationConnectCommand:o}=await import(`./integration-connect.js`);await o(r,n,e,t,i,a)})}export{registerIntegrationCommands};

package/dist/src/cli/commands/register-registry-commands.js

@@ -1 +1 @@
-import{InvalidArgumentError}from"#compiled/commander/index.js";function parseSearchLimit(t){if(!/^\d+$/u.test(t))throw new InvalidArgumentError(`Expected a positive integer, received "${t}".`);let n=Number(t);if(n<1||n>100)throw new InvalidArgumentError(`Expected a limit between 1 and 100, received "${t}".`);return n}function registerRegistryCommands(e){let{appRoot:t,logger:n,program:r}=e;r.command(`add <item>`).description(`Install a registry item; relative paths use the official eve registry.`).option(`-o, --overwrite`,`Overwrite existing files.`).option(`--skip-install`,`Run the item's setup flow without installing it.`).option(`--skip-setup`,`Skip the item's setup flow.`).option(`-y, --yes`,`Run setup and accept its recommended defaults.`).action(async(e,r)=>{let{runAddCommand:i}=await import(`./registry.js`);await i(n,t,e,r)});let i=r.command(`registry`).description(`Configure and browse extension and agent registry catalogs.`);i.command(`add <registries...>`).description(`Add registry namespace mappings to package.json.`).action(async e=>{let{runRegistryAddCommand:r}=await import(`./registry.js`);await r(n,t,e)}),i.command(`list`).description(`List items from all registries or one source.`).option(`-r, --registry <source>`,`List items from one registry.`).option(`--json`,`Output as JSON`).action(async e=>{let{runRegistryListCommand:r}=await import(`./registry.js`);await r(n,t,e.registry,e)}),i.command(`search <query>`).description(`Search all registries or one source.`).option(`-r, --registry <source>`,`Search one registry.`).option(`--limit <count>`,`Maximum results to return (default: 10).`,parseSearchLimit,10).option(`--json`,`Output as JSON`).action(async(e,r)=>{let{runRegistrySearchCommand:i}=await import(`./registry.js`);await i(n,t,e,r.registry,r)}),i.command(`view <item>`).description(`Print one registry item as JSON.`).action(async e=>{let{runRegistryViewCommand:r}=await import(`./registry.js`);await r(n,t,e)})}export{registerRegistryCommands};
+import{parseSetupAnswer}from"./setup-answers.js";import{InvalidArgumentError}from"#compiled/commander/index.js";function parseSearchLimit(e){if(!/^\d+$/u.test(e))throw new InvalidArgumentError(`Expected a positive integer, received "${e}".`);let n=Number(e);if(n<1||n>100)throw new InvalidArgumentError(`Expected a limit between 1 and 100, received "${e}".`);return n}function registerRegistryCommands(n){let{appRoot:r,logger:i,program:a}=n;a.command(`add <item>`).description(`Install a registry item; relative paths use the official eve registry.`).option(`-o, --overwrite`,`Overwrite existing files.`).option(`--skip-install`,`Run the item's setup flow without installing it.`).option(`--skip-setup`,`Skip the item's setup flow.`).option(`--non-interactive`,`Run without interactive prompts, instead emit structured NDJSON when further input is required`).option(`--answer <key=value>`,`Answer a setup question with JSON; requires --non-interactive; repeat for multiple answers.`,parseSetupAnswer).option(`-y, --yes`,`Run setup and accept its recommended defaults.`).action(async(e,n)=>{if(n.answer!==void 0&&!n.nonInteractive)throw new InvalidArgumentError(`--answer requires --non-interactive.`);let{runAddCommand:a}=await import(`./registry.js`);await a(i,r,e,{...n,answers:n.answer})});let o=a.command(`registry`).description(`Configure and browse extension and agent registry catalogs.`);o.command(`add <registries...>`).description(`Add registry namespace mappings to package.json.`).action(async e=>{let{runRegistryAddCommand:t}=await import(`./registry.js`);await t(i,r,e)}),o.command(`list`).description(`List items from all registries or one source.`).option(`-r, --registry <source>`,`List items from one registry.`).option(`--json`,`Output as JSON`).action(async e=>{let{runRegistryListCommand:t}=await import(`./registry.js`);await t(i,r,e.registry,e)}),o.command(`search <query>`).description(`Search all registries or one source.`).option(`-r, --registry <source>`,`Search one registry.`).option(`--limit <count>`,`Maximum results to return (default: 10).`,parseSearchLimit,10).option(`--json`,`Output as JSON`).action(async(e,t)=>{let{runRegistrySearchCommand:n}=await import(`./registry.js`);await n(i,r,e,t.registry,t)}),o.command(`view <item>`).description(`Inspect one registry item.`).option(`--json`,`Output the raw registry item as JSON.`).action(async(e,t)=>{let{runRegistryViewCommand:n}=await import(`./registry.js`);await n(i,r,e,t)})}export{registerRegistryCommands};

package/dist/src/cli/commands/registry-declared-setups.d.ts

@@ -0,0 +1,23 @@
+import { type Prompter } from "#setup/prompter.js";
+import type { RegistrySetupCompletion } from "#setup/registry-setup-protocol.js";
+import type { RegistryCommandLogger, RegistrySetupDependencies } from "./registry.js";
+import type { RegistrySetupCommand } from "./registry-setup-command.js";
+export interface DeclaredSetupOptions {
+    yes?: boolean;
+    nonInteractive?: boolean;
+    answers?: Record<string, unknown>;
+    silent?: boolean;
+    prompter?: Prompter;
+    signal?: AbortSignal;
+}
+/** Runs and combines the setup commands declared by one registry item. */
+export declare function runDeclaredSetups(input: {
+    logger: RegistryCommandLogger;
+    appRoot: string;
+    item: string;
+    setups: readonly RegistrySetupCommand[] | undefined;
+    options: DeclaredSetupOptions;
+    dependencies: RegistrySetupDependencies;
+    cancelledReminder: string;
+    resumeCommand: string;
+}): Promise<RegistrySetupCompletion | false>;

package/dist/src/cli/commands/registry-declared-setups.js

@@ -0,0 +1 @@
+import{headlessSetupContinuation,serializeHeadlessSetupEvent}from"./setup-headless.js";import{createPrompter}from"#setup/prompter.js";import{createHeadlessPrompter}from"#setup/headless.js";import{mergeRegistrySetupCompletions}from"#setup/registry-setup-completion.js";async function runDeclaredSetups(i){let a={facts:[]};if(i.setups===void 0)return a;let o=await i.dependencies.loadSetupCommandRunner(),s=i.options.prompter??(i.options.nonInteractive?createHeadlessPrompter(i.logger.log):createPrompter());try{for(let n of i.setups){let r=await o(i.appRoot,{...n,args:[...n.args,...i.options.yes?[`--yes`]:[],...i.options.nonInteractive?[`--non-interactive`]:[],...Object.entries(i.options.answers??{}).flatMap(([e,t])=>[`--answer`,`${e}=${JSON.stringify(t)}`])]},i.item,{prompter:s,signal:i.options.signal});if(r.kind===`cancelled`)return i.logger.log(i.cancelledReminder),!1;if(r.kind===`blocked`){if(!i.options.nonInteractive)throw Error(`Setup requires more input.`);return i.logger.error(serializeHeadlessSetupEvent({version:1,type:`blocked`,item:i.item,installed:!0,completedItems:[],...r.blocker,next:headlessSetupContinuation({item:i.item,installed:!0})})),process.exitCode=2,!1}if(i.options.silent!==!0)for(let e of r.facts)i.logger.log(`${e.label}: ${e.value}`);a=mergeRegistrySetupCompletions(a,r)}return a}catch(n){let r=n instanceof Error?n.message:String(n);if(i.options.nonInteractive)return i.logger.error(serializeHeadlessSetupEvent({version:1,type:`failed`,item:i.item,completedItems:[],message:r,next:headlessSetupContinuation({item:i.item,installed:!0})})),process.exitCode=1,!1;throw Error(`${r} Try again with \`${i.resumeCommand}\`.`)}}export{runDeclaredSetups};

package/dist/src/cli/commands/registry-metadata.d.ts

@@ -1,6 +1,45 @@
+import { z } from "#compiled/zod/index.js";
+declare const EveRegistryMetadataSchema: z.ZodObject<{
+    requires: z.ZodOptional<z.ZodString>;
+    docs: z.ZodOptional<z.ZodString>;
+    implementation: z.ZodOptional<z.ZodEnum<{
+        "chat-sdk": "chat-sdk";
+        native: "native";
+    }>>;
+    setup: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodObject<{
+        package: z.ZodString;
+        bin: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        package: z.ZodString;
+        bin: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>]>, z.ZodTransform<{
+        package: string;
+        bin: string;
+        args: string[];
+    }[], {
+        package: string;
+        bin: string;
+        args: string[];
+    }[] | {
+        package: string;
+        bin: string;
+        args: string[];
+    }>>>;
+    components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RegistrySearchMetadata = Pick<z.infer<typeof EveRegistryMetadataSchema>, "docs" | "implementation">;
 /** Parses eve-owned metadata from a registry item manifest. */
 export declare function eveMetadataFromRegistryItem(item: unknown): {
     requires?: string | undefined;
+    docs?: string | undefined;
+    implementation?: "chat-sdk" | "native" | undefined;
     setup?: {
         package: string;
         bin: string;
@@ -13,3 +52,33 @@ export declare function eveMetadataFromRegistryItem(item: unknown): {
         default: boolean;
     }[] | undefined;
 } | undefined;
+/** Extracts search metadata from the eve-owned official registry catalog. */
+export declare function parseOfficialRegistrySearchMetadata(input: unknown): ReadonlyMap<string, RegistrySearchMetadata>;
+/** Parses the fields used by the human-readable registry item view. */
+export declare function parseRegistryPresentationManifest(input: unknown): {
+    meta?: {
+        eve?: {
+            requires?: string | undefined;
+            docs?: string | undefined;
+            implementation?: "chat-sdk" | "native" | undefined;
+            setup?: {
+                package: string;
+                bin: string;
+                args: string[];
+            }[] | undefined;
+            components?: {
+                item: string;
+                label: string;
+                description?: string | undefined;
+                default: boolean;
+            }[] | undefined;
+        } | undefined;
+    } | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    dependencies?: string[] | undefined;
+    files?: {
+        target: string;
+    }[] | undefined;
+} | undefined;
+export {};

package/dist/src/cli/commands/registry-metadata.js

@@ -1 +1 @@
-import{RegistryPackageComponentSchema}from"./registry-package.js";import{z}from"#compiled/zod/index.js";const RegistrySetupSchema=z.object({package:z.string().min(1),bin:z.string().min(1),args:z.array(z.string()).default([])}),EveRegistryItemMetadataSchema=z.object({meta:z.object({eve:z.object({requires:z.string().optional(),setup:z.union([RegistrySetupSchema,z.array(RegistrySetupSchema).min(1)]).transform(e=>Array.isArray(e)?e:[e]).optional(),components:z.array(RegistryPackageComponentSchema).min(1).optional()}).optional()}).optional()});function eveMetadataFromRegistryItem(e){return EveRegistryItemMetadataSchema.parse(e).meta?.eve}export{eveMetadataFromRegistryItem};
+import{RegistryPackageComponentSchema}from"./registry-package.js";import{z}from"#compiled/zod/index.js";const RegistrySetupSchema=z.object({package:z.string().min(1),bin:z.string().min(1),args:z.array(z.string()).default([])}),EveRegistryMetadataSchema=z.object({requires:z.string().optional(),docs:z.string().min(1).optional(),implementation:z.enum([`native`,`chat-sdk`]).optional(),setup:z.union([RegistrySetupSchema,z.array(RegistrySetupSchema).min(1)]).transform(e=>Array.isArray(e)?e:[e]).optional(),components:z.array(RegistryPackageComponentSchema).min(1).optional()}),EveRegistryItemMetadataSchema=z.object({meta:z.object({eve:EveRegistryMetadataSchema.optional()}).optional()}),OfficialRegistryCatalogSchema=z.object({items:z.array(z.object({name:z.string().min(1),meta:z.object({eve:EveRegistryMetadataSchema.optional()}).optional()}))}),RegistryPresentationManifestSchema=EveRegistryItemMetadataSchema.extend({title:z.string().optional(),description:z.string().optional(),dependencies:z.array(z.string()).optional(),files:z.array(z.object({target:z.string()})).optional()});function eveMetadataFromRegistryItem(e){return EveRegistryItemMetadataSchema.parse(e).meta?.eve}function parseOfficialRegistrySearchMetadata(e){let{items:t}=OfficialRegistryCatalogSchema.parse(e),n=new Map;for(let e of t){let{docs:t,implementation:r}=e.meta?.eve??{};(t!==void 0||r!==void 0)&&n.set(e.name,{docs:t,implementation:r})}return n}function parseRegistryPresentationManifest(e){return RegistryPresentationManifestSchema.safeParse(e).data}export{eveMetadataFromRegistryItem,parseOfficialRegistrySearchMetadata,parseRegistryPresentationManifest};

package/dist/src/cli/commands/registry-package.d.ts

@@ -1,6 +1,7 @@
 import { type RegistryConfig } from "#compiled/shadcn-registry/index.js";
 import { z } from "#compiled/zod/index.js";
 import { type Prompter } from "#setup/prompter.js";
+import type { RegistrySetupCompletion } from "#setup/registry-setup-protocol.js";
 import type { AddCommandOptions, RegistryCommandLogger } from "./registry.js";
 import type { RegistrySetupCommand } from "./registry-setup-command.js";
 export declare const RegistryPackageComponentSchema: z.ZodObject<{
@@ -26,10 +27,9 @@ export interface RegistryPackageOperations {
         item: string;
         setups: RegistrySetupCommand[];
         prompter: Prompter;
-    }): Promise<boolean>;
+    }): Promise<RegistrySetupCompletion | false>;
     setupReminder(item: string): string;
 }
-/** Resolves, installs, and configures the selected components of a registry package. */
 export declare function runRegistryPackage(input: {
     logger: RegistryCommandLogger;
     appRoot: string;
@@ -42,5 +42,5 @@ export declare function runRegistryPackage(input: {
     };
     dependencies: RegistryPackageDependencies;
     operations: RegistryPackageOperations;
-}): Promise<void>;
+}): Promise<RegistrySetupCompletion | false>;
 export {};

package/dist/src/cli/commands/registry-package.js

@@ -1 +1 @@
-import{hasInteractiveTerminal}from"./preconditions.js";import{z}from"#compiled/zod/index.js";import{createPrompter}from"#setup/prompter.js";import{addRegistryItems,getRegistryItems}from"#compiled/shadcn-registry/index.js";const RegistryPackageComponentSchema=z.object({item:z.string().min(1),label:z.string().min(1),description:z.string().optional(),default:z.boolean().default(!1)});async function selectComponents(e,t,n,r,i){if(n.prompter===void 0&&(n.yes===!0||!r))return t.filter(e=>e.default);let a=await i().select({message:`Add ${e}`,description:`Select what you want to add to your agent.`,multiple:!0,required:!0,initialValues:t.filter(e=>e.default).map(e=>e.item),options:t.map(e=>({value:e.item,label:e.label,hint:e.description}))}),o=new Set(a);return t.filter(e=>o.has(e.item))}async function runRegistryPackage(t){let{logger:a,appRoot:o,item:s,components:c,config:l,options:u,dependencies:d,operations:f}=t,p=d.hasInteractiveTerminal?.()??hasInteractiveTerminal(),m=u.prompter,getPrompter=()=>m??=d.createPrompter?.()??createPrompter(),h=await selectComponents(s,c,u,p,getPrompter),g=h.map(e=>f.itemAddress(e.item)),_=await getRegistryItems(g,{config:l});if(_.length!==h.length)throw Error(`Registry package "${s}" could not resolve all selected components.`);let v=_.map(e=>{let t=f.metadata(e);return f.assertCompatibleVersion(t?.requires),t});if(u.skipInstall!==!0&&await addRegistryItems(g,{config:l,cwd:o,overwrite:u.overwrite,silent:u.silent}),u.skipSetup!==!0){if(u.yes!==!0&&u.prompter===void 0&&!p){a.log(f.setupReminder(s));return}for(let e of v)if(e?.setup!==void 0&&!await f.runSetups({item:s,setups:e.setup,prompter:getPrompter()}))return}}export{RegistryPackageComponentSchema,runRegistryPackage};
+import{hasInteractiveTerminal}from"./preconditions.js";import{headlessSetupContinuation,serializeHeadlessSetupEvent}from"./setup-headless.js";import{z}from"#compiled/zod/index.js";import{createPrompter}from"#setup/prompter.js";import{headlessAsker,interactiveAsker,withAnswers,withPolicy}from"#setup/ask.js";import{mergeRegistrySetupCompletions}from"#setup/registry-setup-completion.js";import{addRegistryItems,getRegistryItems}from"#compiled/shadcn-registry/index.js";const RegistryPackageComponentSchema=z.object({item:z.string().min(1),label:z.string().min(1),description:z.string().optional(),default:z.boolean().default(!1)});async function selectComponents(e,r,i,l,u,d){if(l.prompter===void 0&&!l.nonInteractive&&(l.yes===!0||!u))return i.filter(e=>e.default);let f={key:`components`,message:`Add ${r}`,required:!0,recommended:i.filter(e=>e.default),options:i.map(e=>({id:e.item,value:e,label:e.label,hint:e.description}))},p=l.nonInteractive?withAnswers(l.answers??{})(l.yes?withPolicy(`assume`)(headlessAsker()):headlessAsker()):interactiveAsker(d());try{return await p.askMany(f)}catch(i){if(!l.nonInteractive||!(i instanceof Error)||i.name!==`InteractionRequired`)throw i;let a=i.question,{setupQuestionToWire:o}=await import(`#setup/setup-question-wire.js`);e.error(serializeHeadlessSetupEvent({version:1,type:`blocked`,status:`input_required`,item:r,installed:!1,completedItems:[],question:o(a),next:headlessSetupContinuation({item:r,installed:!1})})),process.exitCode=2;return}}async function runRegistryPackage(t){let{logger:n,appRoot:r,item:a,components:o,config:s,options:c,dependencies:f,operations:p}=t,m=f.hasInteractiveTerminal?.()??hasInteractiveTerminal(),h=c.prompter,getPrompter=()=>h??=f.createPrompter?.()??createPrompter(),g=await selectComponents(n,a,o,c,m,getPrompter);if(g===void 0)return!1;let _=g.map(e=>p.itemAddress(e.item)),v=await getRegistryItems(_,{config:s});if(v.length!==g.length)throw Error(`Registry package "${a}" could not resolve all selected components.`);let y=v.map(e=>{let t=p.metadata(e);return p.assertCompatibleVersion(t?.requires),t});c.skipInstall!==!0&&await addRegistryItems(_,{config:s,cwd:r,overwrite:c.overwrite,silent:c.silent});let b={facts:[]};if(c.skipSetup===!0)return b;if(!c.nonInteractive&&c.yes!==!0&&c.prompter===void 0&&!m)return n.log(p.setupReminder(a)),b;for(let e of y){if(e?.setup===void 0)continue;let t=await p.runSetups({item:a,setups:e.setup,prompter:getPrompter()});if(t===!1)return!1;b=mergeRegistrySetupCompletions(b,t)}return b}export{RegistryPackageComponentSchema,runRegistryPackage};

package/dist/src/cli/commands/registry-presentation.d.ts

@@ -0,0 +1,20 @@
+import type { RegistrySearchItem } from "#compiled/shadcn-registry/index.js";
+import { type RegistrySearchMetadata } from "./registry-metadata.js";
+export interface RegistrySearchPresentationItem extends RegistrySearchMetadata {
+    address: string;
+    item: RegistrySearchItem;
+}
+export interface RegistrySearchPresentationSection {
+    label: string;
+    items: RegistrySearchPresentationItem[];
+    total: number;
+}
+export declare function normalizeRegistryText(value: string): string;
+export declare function printRegistrySearchResults(logger: {
+    log(message: string): void;
+}, input: {
+    json?: unknown;
+    query: string | undefined;
+    sections: readonly RegistrySearchPresentationSection[];
+}): void;
+export declare function registryViewText(item: string, input: unknown): string;

package/dist/src/cli/commands/registry-presentation.js

@@ -0,0 +1,7 @@
+import{parseRegistryPresentationManifest}from"./registry-metadata.js";import{createCliTheme,sanitizeForTerminal}from"#cli/ui/output.js";import{clipVisible,wrapVisibleLine}from"#cli/ui/terminal-text.js";function normalizeRegistryText(e){return sanitizeForTerminal(e).replaceAll(`\\"`,`"`).replaceAll(`\\'`,`'`).replaceAll(/\s+/gu,` `).trim()}function registryDescriptionSummary(e){let t=normalizeRegistryText(e);return t.match(/^.*?[.!?](?=\s|$)/u)?.[0]??t}function renderSearchItem(e,t,n){let a=Math.max(1,t-4),o=wrapVisibleLine(normalizeRegistryText(e.address),a),s=e.implementation===`native`?`First-class eve channel`:e.implementation===`chat-sdk`?`Chat SDK adapter`:void 0,c=normalizeRegistryText(e.item.name),l=c.split(`/`).at(-1)??c,u=[`  ${n.label(l)}${s===void 0?``:n.muted(` · ${s}`)}`,...o.map(e=>`    ${e}`)];if(!e.item.description)return u.join(`
+`);let d=registryDescriptionSummary(e.item.description);if(d.length===0)return u.join(`
+`);let f=wrapVisibleLine(d,a),p=f.length<=2?f:[f[0],`${clipVisible(f[1],Math.max(1,a-1)).trimEnd()}…`];return u.push(...p.map(e=>n.muted(`    ${e}`))),u.join(`
+`)}function printRegistrySearchResults(e,n){if(n.json!==void 0){e.log(JSON.stringify(n.json,null,2));return}if(n.sections.every(e=>e.items.length===0)){let t=n.query&&normalizeRegistryText(n.query);e.log(t?`No registry items match "${t}".`:`No registry items found.`);return}let r=createCliTheme(),i=Math.max(20,process.stdout.columns??80),a=n.sections.flatMap(e=>{if(e.items.length===0)return[];let t=`${e.total} result${e.total===1?``:`s`}`,n=e.items.length<e.total?`showing ${e.items.length} of ${t}`:t;return[[`${r.label(e.label)} ${r.muted(`(${n})`)}`,...e.items.map(e=>renderSearchItem(e,i,r))].join(`
+`)]});e.log(a.join(`
+`))}function registryViewText(t,n){let r=parseRegistryPresentationManifest(n);if(r===void 0)return JSON.stringify(n,null,2);let i=r.meta?.eve,a=[r.title??t,t];if(r.description!==void 0&&a.push(``,r.description),i?.implementation!==void 0&&a.push(``,`Implementation  ${i.implementation===`native`?`First-class eve channel`:`Chat SDK adapter`}`),i?.setup!==void 0&&a.push(`Setup           Guided setup`),i?.docs!==void 0){let e=i.docs.startsWith(`/`)?`https://eve.dev${i.docs}`:i.docs;a.push(`Documentation   ${e}`)}a.push(`Source          Official eve registry`),r.dependencies?.length&&a.push(``,`Packages`,...r.dependencies.map(e=>`  ${e}`));let o=r.files?.map(e=>e.target)??[];return o.length>0&&a.push(``,`Files`,...o.map(e=>`  ${e}`)),a.join(`
+`)}export{normalizeRegistryText,printRegistrySearchResults,registryViewText};

package/dist/src/cli/commands/registry-search-presentation.d.ts

@@ -0,0 +1,16 @@
+import type { RegistrySearchItem } from "#compiled/shadcn-registry/index.js";
+export declare function normalizeRegistryText(value: string): string;
+export declare function printRegistrySearchResults(logger: {
+    log(message: string): void;
+}, result: {
+    items: RegistrySearchItem[];
+}, options: {
+    json?: boolean;
+    query: string | undefined;
+    sections: readonly {
+        label: string;
+        items: RegistrySearchItem[];
+        total: number;
+        address(item: RegistrySearchItem): string;
+    }[];
+}): void;

package/dist/src/cli/commands/registry-search-presentation.js

@@ -0,0 +1,6 @@
+import{createCliTheme,sanitizeForTerminal}from"#cli/ui/output.js";import{clipVisible,wrapVisibleLine}from"#cli/ui/terminal-text.js";function normalizeRegistryText(e){return sanitizeForTerminal(e).replaceAll(`\\"`,`"`).replaceAll(`\\'`,`'`).replaceAll(/\s+/gu,` `).trim()}function registryDescriptionSummary(e){let t=normalizeRegistryText(e);return t.match(/^.*?[.!?](?=\s|$)/u)?.[0]??t}function renderSearchItem(e,t,i,a){let o=Math.max(1,i-4),s=wrapVisibleLine(normalizeRegistryText(t),o),c=normalizeRegistryText(e.name),l=c.split(`/`).at(-1)??c,u=[`  ${a.label(l)}`,...s.map(e=>`    ${e}`)];if(!e.description)return u.join(`
+`);let d=registryDescriptionSummary(e.description);if(d.length===0)return u.join(`
+`);let f=wrapVisibleLine(d,o),p=f.length<=2?f:[f[0],`${clipVisible(f[1],Math.max(1,o-1)).trimEnd()}…`];return u.push(...p.map(e=>a.muted(`    ${e}`))),u.join(`
+`)}function printRegistrySearchResults(t,n,r){if(r.json){t.log(JSON.stringify(n,null,2));return}if(n.items.length===0){let e=r.query&&normalizeRegistryText(r.query);t.log(e?`No registry items match "${e}".`:`No registry items found.`);return}let i=createCliTheme(),a=Math.max(20,process.stdout.columns??80),o=r.sections.flatMap(e=>{if(e.items.length===0)return[];let t=`${e.total} result${e.total===1?``:`s`}`,n=e.items.length<e.total?`showing ${e.items.length} of ${t}`:t;return[[`${i.label(e.label)} ${i.muted(`(${n})`)}`,...e.items.map(t=>renderSearchItem(t,e.address(t),a,i))].join(`
+`)]});t.log(o.join(`
+`))}export{normalizeRegistryText,printRegistrySearchResults};

package/dist/src/cli/commands/registry-setup-command.d.ts

@@ -1,12 +1,15 @@
 import type { Prompter } from "#setup/prompter.js";
+import { type RegistrySetupCompletion, type RegistrySetupBlocker } from "#setup/registry-setup-protocol.js";
 export interface RegistrySetupCommand {
     package: string;
     bin: string;
     args: string[];
 }
-export type RegistrySetupCommandResult = {
+export type RegistrySetupCommandResult = ({
     kind: "completed";
-    output: readonly string[];
+} & RegistrySetupCompletion) | {
+    kind: "blocked";
+    blocker: RegistrySetupBlocker;
 } | {
     kind: "cancelled";
 };

package/dist/src/cli/commands/registry-setup-command.js

@@ -1,2 +1 @@
-import{findPackageJSON}from"node:module";import{readFile}from"node:fs/promises";import{z}from"#compiled/zod/index.js";import{dirname,isAbsolute,relative,resolve}from"node:path";import{spawn}from"node:child_process";import{WizardCancelledError}from"#setup/step.js";import{pathToFileURL}from"node:url";import{createProcessOutputBuffer}from"#setup/primitives/process-output.js";import{REGISTRY_SETUP_PROTOCOL_VERSION,isRegistrySetupChildMessage}from"#setup/registry-setup-protocol.js";const PackageJsonSchema=z.object({name:z.string().min(1),bin:z.union([z.string(),z.record(z.string(),z.string())]).optional()});function declaredBinPath(e,t){return typeof e.bin==`string`?t===e.name.slice(e.name.lastIndexOf(`/`)+1)?e.bin:void 0:e.bin?.[t]}async function resolveNodePackageBin(e,n){let s=dirname(e),c=PackageJsonSchema.parse(JSON.parse(await readFile(e,`utf8`))),l=declaredBinPath(c,n);if(l===void 0)throw Error(`Package "${c.name}" does not declare a "${n}" binary.`);let u=resolve(s,l),d=relative(s,u);if(d.startsWith(`..`)||isAbsolute(d))throw Error(`Package "${c.name}" declares its "${n}" binary outside the package directory.`);return u}function send(e,t){e.connected&&e.send(t)}async function answerPrompt(e,t,n,r){try{let i,a=n.prompt;switch(a.kind){case`text`:i=await t.text(a);break;case`password`:i=await t.password(a);break;case`select`:i=(a.options.multiple,await t.select(a.options));break;case`editable-select`:i=t.selectEditable===void 0?{kind:`selected`,value:await t.select(a.options)}:await t.selectEditable({...a.options,editable:{...a.options.editable,formatHint:e=>e}});break;case`acknowledge`:await t.acknowledge?.(a.options);break;case`choice`:{if(t.awaitChoice===void 0){i=await t.select({message:a.options.context,options:[...a.options.actions]});break}let e=t.awaitChoice(a.options);r.set(n.id,e.close);try{i=await e.choice}finally{r.delete(n.id)}break}}send(e,{type:`prompt-result`,id:n.id,value:i})}catch(t){if(t instanceof WizardCancelledError){send(e,{type:`prompt-result`,id:n.id,cancelled:!0});return}throw t}}function handlePresentation(e,t,n,r){switch(n.type){case`log`:return t.log[n.level](n.text),!0;case`note`:return t.note(n.message,n.title,{tone:n.tone}),!0;case`intro`:return t.intro(n.text,n.subtitle),!0;case`outro`:return t.outro(n.text),!0;case`result`:return!1;case`status`:if(r.get(n.id)?.(),r.delete(n.id),n.status!==void 0){let e=t.log.spinner?.(n.status);e!==void 0&&r.set(n.id,()=>e.stop())}return!0;case`close-prompt`:return r.get(n.id)?.(),r.delete(n.id),!0;case`prompt`:return answerPrompt(e,t,n,r).catch(t=>{terminateChild(e,`SIGTERM`),e.emit(`error`,t)}),!0;case`ready`:return!1}}async function runRegistrySetupCommand(t,n,r,i){let a=findPackageJSON(n.package,pathToFileURL(resolve(t,`package.json`)));if(a===void 0)throw Error(`Setup package "${n.package}" is not installed. Run \`eve add ${r}\` first.`);let c=await resolveNodePackageBin(a,n.bin);if(i===void 0)throw Error(`Registry setup commands require a parent prompter.`);return new Promise((e,a)=>{let o=spawn(process.execPath,[c,...n.args],{cwd:t,env:{...process.env,EVE_SETUP:`1`,EVE_SETUP_ITEM:r,EVE_SETUP_PROTOCOL:String(REGISTRY_SETUP_PROTOCOL_VERSION)},stdio:[`ignore`,`pipe`,`pipe`,`ipc`],detached:process.platform!==`win32`}),l=!1,f=!1,p,m=new Map,h=createProcessOutputBuffer(({text:e})=>i.prompter.log.commandOutput(e));o.stdout?.on(`data`,e=>h.write(`stdout`,e)),o.stderr?.on(`data`,e=>h.write(`stderr`,e));let g,cancel=()=>{send(o,{type:`cancel`}),g=setTimeout(()=>terminateChild(o,`SIGTERM`),3e3),g.unref()};i.signal?.addEventListener(`abort`,cancel,{once:!0});let cleanup=()=>{h.flush(),i.signal?.removeEventListener(`abort`,cancel),g!==void 0&&clearTimeout(g);for(let e of m.values())e();m.clear()};o.on(`message`,e=>{if(!isRegistrySetupChildMessage(e)){cancel(),a(Error(`Setup command sent an invalid registry protocol message.`));return}if(e.type===`ready`){if(e.version!==REGISTRY_SETUP_PROTOCOL_VERSION){cancel(),a(Error(`Setup command does not support registry setup protocol v${REGISTRY_SETUP_PROTOCOL_VERSION}.`));return}f=!0;return}if(e.type===`result`){p=e.outcome;return}handlePresentation(o,i.prompter,e,m)}),o.once(`error`,e=>{cleanup(),a(e)}),o.once(`close`,(t,n)=>{if(cleanup(),!l){if(l=!0,p?.kind===`completed`){if(t!==0){a(Error(`Setup command reported success, then exited with code ${t??`unknown`}.`));return}e({kind:`completed`,output:p.facts.map(e=>`${e.label}: ${e.value}`)});return}if(p?.kind===`cancelled`){e({kind:`cancelled`});return}if(p?.kind===`failed`){let e=p.error.details?.length?`\n${p.error.details.join(`
-`)}`:``;a(Error(`${p.error.message}${e}`));return}if(i.signal?.aborted===!0||t===130||n===`SIGINT`){e({kind:`cancelled`});return}if(t===0&&f){a(Error(`Setup command exited without reporting a result.`));return}a(Error(n===null?`Setup command exited with code ${t??`unknown`} before reporting a result.`:`Setup command was terminated by ${n} before reporting a result.`))}})})}function terminateChild(e,t){if(process.platform!==`win32`&&e.pid!==void 0)try{process.kill(-e.pid,t);return}catch{}e.kill(t)}export{runRegistrySetupCommand};
+import{findPackageJSON}from"node:module";import{readFile}from"node:fs/promises";import{z}from"#compiled/zod/index.js";import{dirname,isAbsolute,relative,resolve}from"node:path";import{spawn}from"node:child_process";import{WizardCancelledError}from"#setup/step.js";import{pathToFileURL}from"node:url";import{createProcessOutputBuffer}from"#setup/primitives/process-output.js";import{REGISTRY_SETUP_PROTOCOL_VERSION,isRegistrySetupChildMessage}from"#setup/registry-setup-protocol.js";const PackageJsonSchema=z.object({name:z.string().min(1),bin:z.union([z.string(),z.record(z.string(),z.string())]).optional()});function declaredBinPath(e,t){return typeof e.bin==`string`?t===e.name.slice(e.name.lastIndexOf(`/`)+1)?e.bin:void 0:e.bin?.[t]}async function resolveNodePackageBin(e,n){let s=dirname(e),c=PackageJsonSchema.parse(JSON.parse(await readFile(e,`utf8`))),l=declaredBinPath(c,n);if(l===void 0)throw Error(`Package "${c.name}" does not declare a "${n}" binary.`);let u=resolve(s,l),d=relative(s,u);if(d.startsWith(`..`)||isAbsolute(d))throw Error(`Package "${c.name}" declares its "${n}" binary outside the package directory.`);return u}function send(e,t){e.connected&&e.send(t)}async function answerPrompt(e,t,n,r){try{let i,a=n.prompt;switch(a.kind){case`text`:i=await t.text(a);break;case`password`:i=await t.password(a);break;case`select`:i=(a.options.multiple,await t.select(a.options));break;case`editable-select`:i=t.selectEditable===void 0?{kind:`selected`,value:await t.select(a.options)}:await t.selectEditable({...a.options,editable:{...a.options.editable,formatHint:e=>e}});break;case`acknowledge`:await t.acknowledge?.(a.options);break;case`choice`:{if(t.awaitChoice===void 0){i=await t.select({message:a.options.context,options:[...a.options.actions]});break}let e=t.awaitChoice(a.options);r.set(n.id,e.close);try{i=await e.choice}finally{r.delete(n.id)}break}}send(e,{type:`prompt-result`,id:n.id,value:i})}catch(t){if(t instanceof WizardCancelledError){send(e,{type:`prompt-result`,id:n.id,cancelled:!0});return}throw t}}function handlePresentation(e,t,n,r){switch(n.type){case`log`:return(t.replaceContent===void 0||n.level===`warning`||n.level===`error`||n.level===`commandOutput`)&&t.log[n.level](n.text),!0;case`note`:return(t.replaceContent===void 0||n.tone===`warning`)&&t.note(n.message,n.title,{tone:n.tone}),!0;case`intro`:return t.intro(n.text,n.subtitle),!0;case`outro`:return t.outro(n.text),!0;case`result`:return!1;case`status`:if(r.get(n.id)?.(),r.delete(n.id),n.status!==void 0){let e=t.log.spinner?.(n.status);e!==void 0&&r.set(n.id,()=>e.stop())}return!0;case`close-prompt`:return r.get(n.id)?.(),r.delete(n.id),!0;case`prompt`:return answerPrompt(e,t,n,r).catch(t=>{terminateChild(e,`SIGTERM`),e.emit(`error`,t)}),!0;case`ready`:return!1}}async function runRegistrySetupCommand(t,n,r,i){let a=findPackageJSON(n.package,pathToFileURL(resolve(t,`package.json`)));if(a===void 0)throw Error(`Setup package "${n.package}" is not installed. Run \`eve add ${r}\` first.`);let c=await resolveNodePackageBin(a,n.bin);if(i===void 0)throw Error(`Registry setup commands require a parent prompter.`);return new Promise((e,a)=>{let o=spawn(process.execPath,[c,...n.args],{cwd:t,env:{...process.env,EVE_SETUP:`1`,EVE_SETUP_ITEM:r,EVE_SETUP_PROTOCOL:String(REGISTRY_SETUP_PROTOCOL_VERSION)},stdio:[`ignore`,`pipe`,`pipe`,`ipc`],detached:process.platform!==`win32`}),l=!1,f=!1,p,m=new Map,h=createProcessOutputBuffer(({text:e})=>i.prompter.log.commandOutput(e));o.stdout?.on(`data`,e=>h.write(`stdout`,e)),o.stderr?.on(`data`,e=>h.write(`stderr`,e));let g,cancel=()=>{send(o,{type:`cancel`}),g=setTimeout(()=>terminateChild(o,`SIGTERM`),3e3),g.unref()};i.signal?.addEventListener(`abort`,cancel,{once:!0});let cleanup=()=>{h.flush(),i.signal?.removeEventListener(`abort`,cancel),g!==void 0&&clearTimeout(g);for(let e of m.values())e();m.clear()};o.on(`message`,e=>{if(!isRegistrySetupChildMessage(e)){cancel(),a(Error(`Setup command sent an invalid registry protocol message.`));return}if(e.type===`ready`){if(e.version!==REGISTRY_SETUP_PROTOCOL_VERSION){cancel(),a(Error(`Setup command does not support registry setup protocol v${REGISTRY_SETUP_PROTOCOL_VERSION}.`));return}f=!0;return}if(e.type===`result`){p=e.outcome;return}handlePresentation(o,i.prompter,e,m)}),o.once(`error`,e=>{cleanup(),a(e)}),o.once(`close`,(t,n)=>{if(cleanup(),!l){if(l=!0,p?.kind===`completed`){if(t!==0){a(Error(`Setup command reported success, then exited with code ${t??`unknown`}.`));return}let n={kind:`completed`,facts:p.facts};p.deploymentRequired===!0&&(n.deploymentRequired=!0),e(n);return}if(p?.kind===`blocked`){e({kind:`blocked`,blocker:p.blocker});return}if(p?.kind===`cancelled`){e({kind:`cancelled`});return}if(p?.kind===`failed`){a(Error(p.error.message));return}if(i.signal?.aborted===!0||t===130||n===`SIGINT`){e({kind:`cancelled`});return}if(t===0&&f){a(Error(`Setup command exited without reporting a result.`));return}a(Error(n===null?`Setup command exited with code ${t??`unknown`} before reporting a result.`:`Setup command was terminated by ${n} before reporting a result.`))}})})}function terminateChild(e,t){if(process.platform!==`win32`&&e.pid!==void 0)try{process.kill(-e.pid,t);return}catch{}e.kill(t)}export{runRegistrySetupCommand};

package/dist/src/cli/commands/registry.d.ts

@@ -1,4 +1,5 @@
 import { type Prompter } from "#setup/prompter.js";
+import type { RegistrySetupCompletion } from "#setup/registry-setup-protocol.js";
 import type { runRegistrySetupCommand } from "./registry-setup-command.js";
 export interface RegistryCommandLogger {
     error(message: string): void;
@@ -9,6 +10,8 @@ export interface AddCommandOptions {
     overwrite?: boolean;
     skipSetup?: boolean;
     yes?: boolean;
+    nonInteractive?: boolean;
+    answers?: Record<string, unknown>;
     /** Suppresses the registry SDK's terminal-native progress output. */
     silent?: boolean;
 }
@@ -29,6 +32,11 @@ export interface AddCommandDependencies extends RegistrySetupDependencies {
     createPrompter?: () => Prompter;
     hasInteractiveTerminal?: () => boolean;
 }
+type RunAddCommandOptions = AddCommandOptions & {
+    prompter?: Prompter;
+    signal?: AbortSignal;
+    setupAuthorized?: boolean;
+};
 /** One discoverable item from an eve-compatible registry catalog. */
 export interface RegistryCatalogItem {
     address: string;
@@ -67,17 +75,18 @@ export declare function getRegistryItemManifest(appRoot: string, item: string):
 export declare function installRegistryItem(appRoot: string, item: string, options?: AddCommandOptions & {
     prompter?: Prompter;
     signal?: AbortSignal;
-}, dependencies?: AddCommandDependencies): Promise<readonly string[]>;
+}, dependencies?: AddCommandDependencies): Promise<{
+    output: readonly string[];
+    setup?: RegistrySetupCompletion;
+}>;
 /** Installs an official, configured, or URL-addressed registry item. */
-export declare function runAddCommand(logger: RegistryCommandLogger, appRoot: string, item: string, options: AddCommandOptions & {
-    prompter?: Prompter;
-    signal?: AbortSignal;
-}, dependencies?: AddCommandDependencies): Promise<void>;
+export declare function runAddCommand(logger: RegistryCommandLogger, appRoot: string, item: string, options: RunAddCommandOptions, dependencies?: AddCommandDependencies): Promise<RegistrySetupCompletion | undefined>;
 /** Adds registry namespace mappings to the project's package.json. */
 export declare function runRegistryAddCommand(logger: RegistryCommandLogger, appRoot: string, mappings: readonly string[]): Promise<void>;
 /** Lists registry items from every configured source or one selected source. */
 export declare function runRegistryListCommand(logger: RegistryCommandLogger, appRoot: string, source?: string, options?: RegistryCommandOptions): Promise<void>;
 /** Searches registry items across every configured source or one selected source. */
 export declare function runRegistrySearchCommand(logger: RegistryCommandLogger, appRoot: string, query: string, source?: string, options?: RegistrySearchCommandOptions): Promise<void>;
-/** Prints one official, configured, or URL-addressed registry item as JSON. */
-export declare function runRegistryViewCommand(logger: RegistryCommandLogger, appRoot: string, item: string): Promise<void>;
+/** Inspects one official, configured, or URL-addressed registry item. */
+export declare function runRegistryViewCommand(logger: RegistryCommandLogger, appRoot: string, item: string, options?: RegistryCommandOptions): Promise<void>;
+export {};