The Open Framework for Building Agents
refactor(eve): remove registry packages (#3364)
Andrew Barba6ce61cd85ecf
diff --git a/.changeset/remove-registry-packages.md b/.changeset/remove-registry-packages.mdnew file mode 100644index 000000000..43fa1e8ee--- /dev/null+++ b/.changeset/remove-registry-packages.md@@ -0,0 +1,5 @@+---+"eve": minor+---++Remove aggregate registry packages and their component-selection flow. Install Linear integrations separately with `eve add channel/linear` and `eve add connection/linear`.diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex ca8b0fba7..c4175b4e7 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -378,7 +378,7 @@ export default githubChannel({install: `Add this channel from eve's registry to create a Vercel Connect client, route verified Agent Session events, and write \`agent/channels/linear.ts\`:\`\`\`bash-eve add channel/linear-agent+eve add channel/linear\`\`\``,quickStart: `The guided setup writes \`agent/channels/linear.ts\`:diff --git a/apps/docs/registry.json b/apps/docs/registry.jsonindex b96e86320..3690c9c36 100644--- a/apps/docs/registry.json+++ b/apps/docs/registry.json@@ -3,31 +3,6 @@"name": "eve","homepage": "https://eve.dev","items": [- {- "name": "linear",- "type": "registry:item",- "title": "Linear",- "description": "Receive delegated Linear work and give your agent tools for issues, projects, and comments.",- "meta": {- "eve": {- "requires": ">=0.30.6",- "components": [- {- "item": "channel/linear-agent",- "label": "Linear Channel",- "description": "Interact with your eve agent natively in Linear",- "default": true- },- {- "item": "connection/linear",- "label": "Linear MCP",- "description": "Use the Linear MCP",- "default": true- }- ]- }- }- },{"name": "eve/self-modification","type": "registry:item",@@ -1815,7 +1790,7 @@"devDependencies": ["vercel@>=58.5.1"]},{- "name": "channel/linear-agent",+ "name": "channel/linear","type": "registry:item","title": "Linear Agent","description": "Delegate Linear issues and comments through Agent Sessions, with guided Vercel Connect setup.",diff --git a/apps/docs/scripts/validate-channel-registry.ts b/apps/docs/scripts/validate-channel-registry.tsindex a3b986626..1e4836d89 100644--- a/apps/docs/scripts/validate-channel-registry.ts+++ b/apps/docs/scripts/validate-channel-registry.ts@@ -39,6 +39,7 @@ const registrySlugsByCatalogSlug: Readonly<Record<string, string>> = {eve: "web",linq: "linq",photon: "photon-imessage",+ "linear-agent": "linear",};const setupKindsByCatalogSlug: Readonly<Record<string, string>> = {diff --git a/docs/channels/linear.mdx b/docs/channels/linear.mdxindex 572377d6c..2e95cc09c 100644--- a/docs/channels/linear.mdx+++ b/docs/channels/linear.mdx@@ -11,12 +11,16 @@ The Linear channel uses Linear's Agent Session surface rather than ordinary commRun the registry setup from the agent directory:```bash-eve add linear+eve add channel/linear```-Select **Linear Channel** in the component checklist. **Linear MCP** is also selected by default if you want the agent to search and update Linear through MCP. Run `eve add channel/linear-agent` instead to install only the channel directly.+To let the agent search and update Linear through MCP, install the separate Linear connection:-The flow signs you in to Vercel when needed, creates or links a Vercel project, reuses a compatible existing connector when available or provisions an app-scoped Linear Connect client, and registers `/eve/v1/linear` as a trigger destination. It then installs `@vercel/connect` and writes `agent/channels/linear.ts` with the connector UID.+```bash+eve add connection/linear+```++The channel setup flow signs you in to Vercel when needed, creates or links a Vercel project, reuses a compatible existing connector when available or provisions an app-scoped Linear Connect client, and registers `/eve/v1/linear` as a trigger destination. It then installs `@vercel/connect` and writes `agent/channels/linear.ts` with the connector UID.Vercel Connect creates the Linear app with the `app:assignable` and `app:mentionable` scopes required for Agent Sessions, receives and verifies `AgentSessionEvent` webhooks, and forwards them to the deployed agent. After deploying, open the Linear app in the Connect dashboard and install it in the workspace where you want to delegate work. Then delegate an issue or mention the agent in a Linear Agent Session.diff --git a/docs/guides/dev-tui.md b/docs/guides/dev-tui.mdindex 3daee3a3d..f4abdb20c 100644--- a/docs/guides/dev-tui.md+++ b/docs/guides/dev-tui.md@@ -49,7 +49,7 @@ Pass an item address to `/add` to confirm and install that exact address without```text/add channel/slack/add extension/agent-browser-/add linear+/add channel/linear/add @acme/analytics```diff --git a/docs/install-integrations.mdx b/docs/install-integrations.mdxindex 19d961d36..5249df392 100644--- a/docs/install-integrations.mdx+++ b/docs/install-integrations.mdx@@ -12,7 +12,7 @@ Run `eve add` from an eve agent project. This installs the integration's depende```basheve add extension/agent-browser-eve add linear+eve add channel/lineareve add instrumentation/braintrusteve add memory/file```@@ -25,9 +25,7 @@ If you do not know an item name yet, run `eve add` without an argument. Its helpExtensions may create a mount under `agent/extensions/`. Connections write their initial definition under `agent/connections/` and install `@vercel/connect` when required. Instrumentation providers write `agent/instrumentation.ts`; because an agent has one instrumentation file, compose multiple exporters there by hand. Configure generated files and required environment variables before running your agent.-Some integrations package several independently installable components. For example, `eve add linear` lets you choose the Linear Channel, Linear MCP, or both; both are selected by default. The specific `eve add channel/linear-agent` and `eve add connection/linear` commands remain available.--When an official item declares an interactive setup flow or flows, eve asks whether to run them after installation and runs multiple flows in declaration order. Run the printed `eve add <item> --skip-install` command to resume a skipped or cancelled setup later; it reruns the selected components' declared flows from the beginning.+When an official item declares an interactive setup flow or flows, eve asks whether to run them after installation and runs multiple flows in declaration order. Run the printed `eve add <item> --skip-install` command to resume a skipped or cancelled setup later; it reruns the item's declared flows from the beginning.For example, `eve add memory/file` can provision its required storage through the same setup flow. After **Install and set up**, eve creates or reuses a dedicated private Vercel Blob store, connects production, preview, and development with namespaced credentials, pulls the environment, and offers to deploy. The review and setup transcript show the project, store, primary function region, environments, and possible Blob usage charges before provisioning.diff --git a/docs/reference/cli.md b/docs/reference/cli.mdindex 8f1277b9d..bd40fac96 100644--- a/docs/reference/cli.md+++ b/docs/reference/cli.md@@ -123,7 +123,7 @@ Commands for installing and discovering [shadcn registry](https://ui.shadcn.com/```basheve add extension/agent-browser-eve add linear+eve add channel/lineareve add channel/slack --skip-installeve add https://example.com/r/my-extension.json --overwriteeve registry add @acme=https://example.com/r/{name}.json@@ -134,11 +134,11 @@ eve registry view @acme/my-extensioneve add @acme/my-extension```-`eve add` asks before running setup declared by an official item and runs multiple declared flows in declaration order. Product-level packages can offer independently installable components: `eve add linear` lets you select the Linear Channel, Linear MCP, or both, with both selected by default. Interactive Vercel-backed setup signs in and creates or links a project when needed instead of stopping with a prerequisite. `--yes` installs a package's default components and accepts detected or recommended setup answers.+`eve add` asks before running setup declared by an official item and runs multiple declared flows in declaration order. Interactive Vercel-backed setup signs in and creates or links a project when needed instead of stopping with a prerequisite. `--yes` accepts detected or recommended setup answers.-Coding agents should use `eve add <item> --non-interactive`, adding `--yes` to accept recommended setup values and reduce setup round trips. Explicit `--answer` values take precedence. This mode never opens an eve prompt. When a component or setup decision is missing, the NDJSON terminal event includes a stable question key and a safe continuation command; add the requested answer to that command. Supply answers with repeatable `--answer 'key=<JSON value>'` options. Follow a reported `eve link` prerequisite before retrying Vercel Connect setup. Do not put secrets in command-line answers; use the integration's documented environment variable or secret store.+Coding agents should use `eve add <item> --non-interactive`, adding `--yes` to accept recommended setup values and reduce setup round trips. Explicit `--answer` values take precedence. This mode never opens an eve prompt. When a setup decision is missing, the NDJSON terminal event includes a stable question key and a safe continuation command; add the requested answer to that command. Supply answers with repeatable `--answer 'key=<JSON value>'` options. Follow a reported `eve link` prerequisite before retrying Vercel Connect setup. Do not put secrets in command-line answers; use the integration's documented environment variable or secret store.-When setup is skipped, cancelled, or needs more input after installation, eve prints or returns the matching `eve add <item> --skip-install` continuation. It reruns the selected components' declared flows without reinstalling registry files.+When setup is skipped, cancelled, or needs more input after installation, eve prints or returns the matching `eve add <item> --skip-install` continuation. It reruns the item's declared flows without reinstalling registry files.`eve registry add` records configured sources in `package.json#registries`. `eve registry list` aggregates the official catalog and all configured sources by default. `eve registry search` also includes [skills.sh](https://skills.sh), available without configuration at `@skills`, and groups results by source with each source's available result count. Search returns up to 10 matches per source by default; pass `--limit <count>` to request between 1 and 100. Either command can browse one supplied URL or namespace. Official and other universal items with explicit file targets do not require shadcn project configuration.diff --git a/packages/eve/src/cli/commands/registry-metadata.ts b/packages/eve/src/cli/commands/registry-metadata.tsindex a49538cbb..5ecaa4ba4 100644--- a/packages/eve/src/cli/commands/registry-metadata.ts+++ b/packages/eve/src/cli/commands/registry-metadata.ts@@ -1,7 +1,5 @@import { z } from "#compiled/zod/index.js";-import { RegistryPackageComponentSchema } from "./registry-package.js";-const RegistrySetupSchema = z.object({package: z.string().min(1),bin: z.string().min(1),@@ -33,7 +31,6 @@ const EveRegistryMetadataSchema = z.object({.union([RegistrySetupSchema, z.array(RegistrySetupSchema).min(1)]).transform((setup) => (Array.isArray(setup) ? setup : [setup])).optional(),- components: z.array(RegistryPackageComponentSchema).min(1).optional(),});const EveRegistryItemMetadataSchema = z.object({diff --git a/packages/eve/src/cli/commands/registry-package.ts b/packages/eve/src/cli/commands/registry-package.tsdeleted file mode 100644index ffa0e70d2..000000000--- a/packages/eve/src/cli/commands/registry-package.ts+++ /dev/null@@ -1,188 +0,0 @@-import {- addRegistryItems,- getRegistryItems,- type RegistryConfig,-} from "#compiled/shadcn-registry/index.js";-import { z } from "#compiled/zod/index.js";-import { headlessAsker, interactiveAsker, withAnswers, withPolicy } from "#setup/ask.js";-import { createPrompter, type Prompter } from "#setup/prompter.js";-import { mergeRegistrySetupCompletions } from "#setup/registry-setup-completion.js";-import type { RegistrySetupCompletion } from "#setup/registry-setup-protocol.js";--import { hasInteractiveTerminal } from "./preconditions.js";-import type { AddCommandOptions, RegistryCommandLogger } from "./registry.js";-import {- prepareDeclaredPnpmBuildPolicy,- type DeclaredPnpmBuildPolicy,-} from "./registry-pnpm-build-policy-flow.js";-import type { RegistrySetupCommand } from "./registry-setup-command.js";-import { headlessSetupContinuation, serializeHeadlessSetupEvent } from "./setup-headless.js";--export const RegistryPackageComponentSchema = z.object({- item: z.string().min(1),- label: z.string().min(1),- description: z.string().optional(),- default: z.boolean().default(false),-});-export type RegistryPackageComponent = z.infer<typeof RegistryPackageComponentSchema>;-interface PackageMetadata {- requires?: string;- install?: { pnpm?: { buildScripts: readonly DeclaredPnpmBuildPolicy[] } };- setup?: RegistrySetupCommand[];-}-export interface RegistryPackageDependencies {- createPrompter?: () => Prompter;- hasInteractiveTerminal?: () => boolean;-}-export interface RegistryPackageOperations {- itemAddress(item: string): string;- metadata(item: unknown): PackageMetadata | undefined;- assertCompatibleVersion(requiredVersion: string | undefined): void;- runSetups(input: {- item: string;- setups: RegistrySetupCommand[];- prompter: Prompter;- }): Promise<RegistrySetupCompletion | false>;- setupReminder(item: string): string;-}--async function selectComponents(- logger: RegistryCommandLogger,- item: string,- components: readonly RegistryPackageComponent[],- options: AddCommandOptions & { prompter?: Prompter },- interactive: boolean,- getPrompter: () => Prompter,-): Promise<readonly RegistryPackageComponent[] | undefined> {- if (- options.prompter === undefined &&- !options.nonInteractive &&- (options.yes === true || !interactive)- ) {- return components.filter((component) => component.default);- }- const question = {- key: "components",- message: `Add ${item}`,- required: true,- recommended: components.filter((component) => component.default),- options: components.map((component) => ({- id: component.item,- value: component,- label: component.label,- hint: component.description,- })),- };- const asker = options.nonInteractive- ? withAnswers(options.answers ?? {})(- options.yes ? withPolicy("assume")(headlessAsker()) : headlessAsker(),- )- : interactiveAsker(getPrompter());- try {- return await asker.askMany(question);- } catch (error) {- if (- !options.nonInteractive ||- !(error instanceof Error) ||- error.name !== "InteractionRequired"- )- throw error;- const question = (error as import("#setup/ask.js").InteractionRequired).question;- const { setupQuestionToWire } = await import("#setup/setup-question-wire.js");- const wireQuestion = setupQuestionToWire(question);- logger.error(- serializeHeadlessSetupEvent({- version: 1,- type: "blocked",- status: "input_required",- item,- installed: false,- completedItems: [],- question: wireQuestion,- next: headlessSetupContinuation({- item,- installed: false,- answers: options.answers,- question: wireQuestion,- }),- }),- );- process.exitCode = 2;- return undefined;- }-}--export async function runRegistryPackage(input: {- logger: RegistryCommandLogger;- appRoot: string;- item: string;- components: readonly RegistryPackageComponent[];- config: RegistryConfig;- options: AddCommandOptions & { prompter?: Prompter; signal?: AbortSignal };- dependencies: RegistryPackageDependencies;- operations: RegistryPackageOperations;-}): Promise<RegistrySetupCompletion | false> {- const { logger, appRoot, item, components, config, options, dependencies, operations } = input;- const interactive = dependencies.hasInteractiveTerminal?.() ?? hasInteractiveTerminal();- let prompter = options.prompter;- const getPrompter = (): Prompter =>- (prompter ??= dependencies.createPrompter?.() ?? createPrompter());- const selected = await selectComponents(- logger,- item,- components,- options,- interactive,- getPrompter,- );- if (selected === undefined) return false;- const addresses = selected.map((component) => operations.itemAddress(component.item));- const manifests = await getRegistryItems(addresses, { config });- if (manifests.length !== selected.length)- throw new Error(`Registry package "${item}" could not resolve all selected components.`);- const entries = manifests.map((manifest) => {- const metadata = operations.metadata(manifest);- operations.assertCompatibleVersion(metadata?.requires);- return metadata;- });- if (- options.skipInstall !== true &&- !(await prepareDeclaredPnpmBuildPolicy({- logger,- appRoot,- item,- policies: entries.flatMap((entry) => entry?.install?.pnpm?.buildScripts ?? []),- options,- }))- )- return false;- if (options.skipInstall !== true)- await addRegistryItems(addresses, {- config,- cwd: appRoot,- overwrite: options.overwrite,- silent: options.silent,- });- let completion: RegistrySetupCompletion = { facts: [] };- if (options.skipSetup === true) return completion;- if (- !options.nonInteractive &&- options.yes !== true &&- options.prompter === undefined &&- !interactive- ) {- logger.log(operations.setupReminder(item));- return completion;- }- for (const metadata of entries) {- if (metadata?.setup === undefined) continue;- const result = await operations.runSetups({- item,- setups: metadata.setup,- prompter: getPrompter(),- });- if (result === false) return false;- completion = mergeRegistrySetupCompletions(completion, result);- }- return completion;-}diff --git a/packages/eve/src/cli/commands/registry.test.ts b/packages/eve/src/cli/commands/registry.test.tsindex c87b3f99b..23b17635c 100644--- a/packages/eve/src/cli/commands/registry.test.ts+++ b/packages/eve/src/cli/commands/registry.test.ts@@ -410,43 +410,6 @@ describe("registry commands", () => {},);- it("returns a structured component question before installing a package headlessly", async () => {- const logger = createLogger();- getRegistryItems.mockResolvedValueOnce([- {- meta: {- eve: {- components: [- { item: "channel/linear-agent", label: "Linear Channel", default: true },- { item: "connection/linear", label: "Linear MCP", default: true },- ],- },- },- },- ]);-- await runAddCommand(- logger,- "/project",- "linear",- { nonInteractive: true },- { loadSetupCommandRunner: vi.fn() },- );-- expect(addRegistryItems).not.toHaveBeenCalled();- expect(JSON.parse(logger.errors[0]!)).toMatchObject({- status: "input_required",- item: "linear",- installed: false,- question: { key: "components" },- next: {- command: "eve",- args: ["add", "linear", "--non-interactive", "--answer", "components=<JSON value>"],- },- });- expect(process.exitCode).toBe(2);- });-it("rejects Web Chat before it can write into an agent workspace member", async () => {const logger = createLogger();const appRoot = "/project/agents/support";@@ -535,226 +498,6 @@ describe("registry commands", () => {});});- it("uses an answered component selection headlessly", async () => {- const logger = createLogger();- getRegistryItems- .mockResolvedValueOnce([- {- meta: {- eve: {- components: [- { item: "channel/linear-agent", label: "Linear Channel", default: true },- { item: "connection/linear", label: "Linear MCP", default: true },- ],- },- },- },- ])- .mockResolvedValueOnce([{ meta: { eve: {} } }]);-- await runAddCommand(- logger,- "/project",- "linear",- { nonInteractive: true, answers: { components: ["channel/linear-agent"] } },- { loadSetupCommandRunner: vi.fn() },- );-- expect(addRegistryItems).toHaveBeenCalledWith(- ["https://eve.dev/r/channel/linear-agent.json"],- expect.objectContaining({ cwd: "/project" }),- );- });-- it("lets interactive users select components from an official registry package", async () => {- const logger = createLogger();- const runSetupCommand = vi.fn(async () => ({ kind: "completed" as const, facts: [] }));- const fake = createFakePrompter({- multiple: (options) => {- expect(options).toMatchObject({- message: "Add linear",- initialValues: ["channel/linear-agent", "connection/linear"],- });- return ["connection/linear"];- },- });- getRegistryItems- .mockResolvedValueOnce([- {- meta: {- eve: {- components: [- {- item: "channel/linear-agent",- label: "Linear Channel",- description: "Interact with your eve agent natively in Linear",- default: true,- },- {- item: "connection/linear",- label: "Linear MCP",- description: "Use the Linear MCP",- default: true,- },- ],- },- },- },- ])- .mockResolvedValueOnce([- {- meta: {- eve: {- setup: [- {- package: "eve",- bin: "eve",- args: ["integration", "connect", "linear", "mcp.linear.app", "linear"],- },- ],- },- },- },- ]);-- await runAddCommand(- logger,- "/project",- "linear",- { prompter: fake.prompter },- { hasInteractiveTerminal: () => true, loadSetupCommandRunner: async () => runSetupCommand },- );-- expect(addRegistryItems).toHaveBeenCalledWith(- ["https://eve.dev/r/connection/linear.json"],- expect.objectContaining({ cwd: "/project" }),- );- expect(runSetupCommand).toHaveBeenCalledWith(- "/project",- expect.objectContaining({- args: ["integration", "connect", "linear", "mcp.linear.app", "linear"],- }),- "linear",- expect.objectContaining({ prompter: fake.prompter }),- );- });-- it("cancels registry package component selection without reporting an error", async () => {- const logger = createLogger();- const fake = createFakePrompter({- multiple: () => {- throw new WizardCancelledError();- },- });- getRegistryItems.mockResolvedValueOnce([- {- meta: {- eve: {- components: [- { item: "channel/linear-agent", label: "Linear Channel", default: true },- { item: "connection/linear", label: "Linear MCP", default: true },- ],- },- },- },- ]);-- await runAddCommand(- logger,- "/project",- "linear",- { prompter: fake.prompter },- { hasInteractiveTerminal: () => true, loadSetupCommandRunner: vi.fn() },- );-- expect(logger.errors).toEqual([]);- expect(addRegistryItems).not.toHaveBeenCalled();- expect(process.exitCode).toBeUndefined();- });-- it("keeps registry package setup interactive when called from the TUI", async () => {- const fake = createFakePrompter({- multiple: () => ["channel/linear-agent", "connection/linear"],- single: () => "yes",- });- const runSetupCommand = vi.fn(- async (- _appRoot: string,- _setup: RegistrySetupCommand,- _item: string,- _options?: RegistrySetupCommandOptions,- ) => ({ kind: "completed" as const, facts: [] }),- );- getRegistryItems- .mockResolvedValueOnce([- {- meta: {- eve: {- components: [- { item: "channel/linear-agent", label: "Linear Channel", default: true },- { item: "connection/linear", label: "Linear MCP", default: true },- ],- },- },- },- ])- .mockResolvedValueOnce([- { meta: { eve: { setup: [{ package: "eve", bin: "eve", args: ["channel-setup"] }] } } },- { meta: { eve: { setup: [{ package: "eve", bin: "eve", args: ["connection-setup"] }] } } },- ]);-- await installRegistryItem(- "/project",- "linear",- { prompter: fake.prompter },- { loadSetupCommandRunner: async () => runSetupCommand },- );-- expect(fake.selectMessages).toEqual(["Add linear"]);- expect(runSetupCommand).toHaveBeenCalledTimes(2);- expect(runSetupCommand.mock.calls[0]?.[1]).toEqual({- package: "eve",- bin: "eve",- args: ["channel-setup"],- });- });-- it("installs a registry package's default components with --yes", async () => {- const logger = createLogger();- const runSetupCommand = vi.fn(async () => ({ kind: "completed" as const, facts: [] }));- getRegistryItems- .mockResolvedValueOnce([- {- meta: {- eve: {- components: [- { item: "channel/linear-agent", label: "Linear Channel", default: true },- { item: "connection/linear", label: "Linear MCP", default: true },- ],- },- },- },- ])- .mockResolvedValueOnce([- { meta: { eve: { setup: [{ package: "eve", bin: "eve", args: ["channel-setup"] }] } } },- { meta: { eve: { setup: [{ package: "eve", bin: "eve", args: ["connection-setup"] }] } } },- ]);-- await runAddCommand(- logger,- "/project",- "linear",- { yes: true },- { loadSetupCommandRunner: async () => runSetupCommand },- );-- expect(addRegistryItems).toHaveBeenCalledWith(- ["https://eve.dev/r/channel/linear-agent.json", "https://eve.dev/r/connection/linear.json"],- expect.objectContaining({ cwd: "/project" }),- );- expect(runSetupCommand).toHaveBeenCalledTimes(2);- });-it("accepts a legacy singular setup command", async () => {const logger = createLogger();const runSetupCommand = vi.fn(async () => ({ kind: "completed" as const, facts: [] }));diff --git a/packages/eve/src/cli/commands/registry.ts b/packages/eve/src/cli/commands/registry.tsindex 3f06b372a..a0cd3eebb 100644--- a/packages/eve/src/cli/commands/registry.ts+++ b/packages/eve/src/cli/commands/registry.ts@@ -28,7 +28,6 @@ import {parseOfficialRegistrySearchMetadata,type RegistrySearchMetadata,} from "./registry-metadata.js";-import { runRegistryPackage } from "./registry-package.js";import { prepareDeclaredPnpmBuildPolicy } from "./registry-pnpm-build-policy-flow.js";import {printRegistrySearchResults,@@ -497,45 +496,6 @@ export async function runAddCommand(: undefined;assertCompatibleEveVersion(eveMetadata?.requires);- if (eveMetadata?.components !== undefined) {- if (!isOfficialItemAddress(address))- throw new Error("Registry packages require the official eve registry.");- const completion = await runRegistryPackage({- logger,- appRoot,- item,- components: eveMetadata.components,- config,- options,- dependencies,- operations: {- itemAddress,- metadata: eveMetadataFromRegistryItem,- assertCompatibleVersion: assertCompatibleEveVersion,- runSetups: ({ item: packageItem, setups, prompter }) =>- runDeclaredSetups({- logger,- appRoot,- item: packageItem,- setups,- options: {- yes: options.yes,- force: options.overwrite,- nonInteractive: options.nonInteractive,- answers: options.answers,- prompter,- signal: options.signal,- },- dependencies,- cancelledReminder: setupReminder(packageItem, "cancelled"),- resumeCommand: setupResumeCommand(packageItem),- }),- setupReminder: (packageItem) => setupReminder(packageItem, "skipped"),- },- });- return reportCompletion(logger, item, completion, options);- }-if (options.skipInstall === true) {if (eveMetadata?.setup === undefined) {throw new Error(`Registry item "${item}" does not declare a setup flow.`);diff --git a/packages/eve/src/self-modification/classify-registry-item.test.ts b/packages/eve/src/self-modification/classify-registry-item.test.tsindex 18934ed84..2be246cc5 100644--- a/packages/eve/src/self-modification/classify-registry-item.test.ts+++ b/packages/eve/src/self-modification/classify-registry-item.test.ts@@ -12,7 +12,7 @@ function entry(overrides: Partial<CatalogEntry> = {}): CatalogEntry {}describe("classifyCatalogEntry", () => {- it("installs an item that declares no setup and no components", () => {+ it("installs an item that declares no setup", () => {expect(classifyCatalogEntry(entry())).toEqual({ kind: "installable" });});@@ -21,22 +21,4 @@ describe("classifyCatalogEntry", () => {expect(result.kind).toBe("needs-terminal");expect(result).toHaveProperty("reason", expect.stringContaining("setup flow"));});-- it("hands a bundle to the terminal and names its components", () => {- const result = classifyCatalogEntry(- entry({ address: "linear", components: ["channel/linear-agent", "connection/linear"] }),- );- expect(result.kind).toBe("needs-terminal");- expect(result).toHaveProperty("reason", expect.stringContaining("channel/linear-agent"));- });-- it("hands over a bundle that also declares setup", () => {- expect(- classifyCatalogEntry(entry({ components: ["channel/x"], declaresSetup: true })).kind,- ).toBe("needs-terminal");- });-- it("treats an empty components list as no bundle", () => {- expect(classifyCatalogEntry(entry({ components: [] })).kind).toBe("installable");- });});diff --git a/packages/eve/src/self-modification/extension/classify-registry-item.ts b/packages/eve/src/self-modification/extension/classify-registry-item.tsindex 853401713..ef3e867d9 100644--- a/packages/eve/src/self-modification/extension/classify-registry-item.ts+++ b/packages/eve/src/self-modification/extension/classify-registry-item.ts@@ -3,9 +3,9 @@ import type { CatalogEntry } from "./tools/search_registry.js";/*** The split rule.*- * An item that declares no setup and no components is installed by the tool. An- * item that declares either is handed to the terminal whole, before anything is- * installed — every question a setup flow asks, and every browser+ * An item that declares no setup is installed by the tool. An item that declares+ * setup is handed to the terminal whole, before anything is installed — every+ * question a setup flow asks, and every browser* authorization or secret it needs, belongs to the surface built to ask.** The rule reads catalog metadata only. It never predicts whether a particular@@ -15,12 +15,6 @@ import type { CatalogEntry } from "./tools/search_registry.js";export function classifyCatalogEntry(entry: CatalogEntry,): { readonly kind: "installable" } | { readonly kind: "needs-terminal"; readonly reason: string } {- if (entry.components !== undefined && entry.components.length > 0) {- return {- kind: "needs-terminal",- reason: `${entry.address} is a bundle of ${entry.components.join(", ")}. Choosing which components to install is a question, so the whole bundle goes to the terminal.`,- };- }if (entry.declaresSetup === true) {return {kind: "needs-terminal",diff --git a/packages/eve/src/self-modification/extension/tools/search_registry.ts b/packages/eve/src/self-modification/extension/tools/search_registry.tsindex 49678e894..d61e31c17 100644--- a/packages/eve/src/self-modification/extension/tools/search_registry.ts+++ b/packages/eve/src/self-modification/extension/tools/search_registry.ts@@ -63,7 +63,6 @@ const outputSchema = {title: { type: "string" },description: { type: "string" },category: { type: "string" },- components: { type: "array", items: { type: "string" } },requires: { type: "string" },installed: { type: "boolean" },},@@ -95,9 +94,6 @@ export interface CatalogEntry {readonly title: string;readonly description?: string;readonly category?: Category;- readonly components?: readonly string[];- /** Component addresses, labels, and descriptions used to search bundles. */- readonly componentSearchTerms?: readonly string[];readonly requires?: string;/** Authored path this item installs, used to detect an existing install. */readonly authoredTarget?: string;@@ -113,7 +109,6 @@ export interface FoundIntegration {readonly title: string;readonly description?: string;readonly category?: Category;- readonly components?: readonly string[];readonly requires?: string;readonly installed?: boolean;}@@ -134,8 +129,8 @@ function isCategory(value: string): value is Category {* Derives the category from the item address.** eve registry addresses carry their category as the leading path segment.- * Bundles (`linear`) and package-scoped items (`eve/self-modification`)- * have none, so the field stays absent rather than being guessed.+ * Package-scoped items such as `eve/self-modification` have no recognized+ * category, so the field stays absent rather than being guessed.*/function categoryOf(address: string): Category | undefined {const segment = address.split("/")[0];@@ -171,29 +166,6 @@ function eveMetadata(entry: Record<string, unknown>): Record<string, unknown> {return isRecord(eve) ? eve : {};}-/** Metadata for bundle components, used both for display and free-text search. */-function componentMetadata(- eve: Record<string, unknown>,-): { readonly addresses: readonly string[]; readonly searchTerms: readonly string[] } | undefined {- const components = eve.components;- if (!Array.isArray(components)) return undefined;-- const addresses: string[] = [];- const searchTerms: string[] = [];- for (const component of components) {- if (!isRecord(component)) continue;- const address = optionalString(component.item);- if (address === undefined) continue;- addresses.push(address);- searchTerms.push(address);- const label = optionalString(component.label);- if (label !== undefined) searchTerms.push(label);- const description = optionalString(component.description);- if (description !== undefined) searchTerms.push(description);- }- return addresses.length > 0 ? { addresses, searchTerms } : undefined;-}-/** First authored file the item installs; identifies an existing install. */function authoredTargetOf(entry: Record<string, unknown>): string | undefined {const files = entry.files;@@ -233,8 +205,6 @@ export function parseRegistryIndex(value: unknown): readonly CatalogEntry[] {address: string;authoredTarget?: string;category?: Category;- componentSearchTerms?: readonly string[];- components?: readonly string[];declaresSetup?: boolean;description?: string;envVars?: readonly string[];@@ -246,11 +216,6 @@ export function parseRegistryIndex(value: unknown): readonly CatalogEntry[] {if (category !== undefined) entry.category = category;const description = optionalString(item.description);if (description !== undefined) entry.description = description;- const components = componentMetadata(eve);- if (components !== undefined) {- entry.components = components.addresses;- entry.componentSearchTerms = components.searchTerms;- }const requires = optionalString(eve.requires);if (requires !== undefined) entry.requires = requires;const authoredTarget = authoredTargetOf(item);@@ -268,9 +233,7 @@ export function parseRegistryIndex(value: unknown): readonly CatalogEntry[] {/*** Filters and bounds catalog entries for one search.*- * A bundle matches when one of its components matches the requested category,- * so asking for channels still surfaces `linear` (which installs a channel)- * instead of hiding it behind its uncategorized address.+ * Category filters match the leading segment of each registry address.*/export function selectIntegrations(input: {readonly category?: Category;@@ -304,13 +267,7 @@ export function selectIntegrationPage(input: {const primaryTerms = `${entry.address} ${entry.title}`.toLowerCase();return {entry,- haystack: [- primaryTerms,- entry.description ?? "",- ...(entry.componentSearchTerms ?? entry.components ?? []),- ]- .join(" ")- .toLowerCase(),+ haystack: [primaryTerms, entry.description ?? ""].join(" ").toLowerCase(),index,primaryTerms,};@@ -346,13 +303,11 @@ export function selectIntegrationPage(input: {const row: {address: string;category?: Category;- components?: readonly string[];description?: string;requires?: string;title: string;} = { address: entry.address, title: entry.title };if (entry.category !== undefined) row.category = entry.category;- if (entry.components !== undefined) row.components = entry.components;if (entry.description !== undefined) row.description = entry.description;if (entry.requires !== undefined) row.requires = entry.requires;return row;@@ -373,8 +328,7 @@ export function selectIntegrationPage(input: {}function matchesCategory(entry: CatalogEntry, category: Category): boolean {- if (entry.category === category) return true;- return entry.components?.some((component) => categoryOf(component) === category) === true;+ return entry.category === category;}/**diff --git a/packages/eve/src/self-modification/registry-add.test.ts b/packages/eve/src/self-modification/registry-add.test.tsindex ff3136071..9b3bf3566 100644--- a/packages/eve/src/self-modification/registry-add.test.ts+++ b/packages/eve/src/self-modification/registry-add.test.ts@@ -41,10 +41,10 @@ const INDEX = {},},{- name: "linear",- title: "Linear",+ name: "channel/linear",+ title: "Linear Agent",meta: {- eve: { components: [{ item: "channel/linear-agent" }, { item: "connection/linear" }] },+ eve: { setup: { package: "eve", bin: "eve", args: ["integration", "setup", "linear"] } },},},{@@ -212,18 +212,6 @@ describe("addLocalRegistryItem", () => {expect(calls).toHaveLength(0);});- it("hands a bundle over without installing anything", async () => {- const { calls, spawn } = fakeSpawn({ code: 0, output: COMPLETED });- const result = await addLocalRegistryItem("linear", {- getCapability: () => capability(),- spawn,- });-- expect(result.status).toBe("needs-terminal");- expect(result.reason).toContain("channel/linear-agent");- expect(calls).toHaveLength(0);- });-it("returns the exact installation command for a headless Linear handoff", async () => {const result = await addLocalRegistryItem("connection/linear", {getCapability: () => capability(),@@ -415,7 +403,7 @@ describe("unsetEnvVars", () => {});it("treats a missing envVars field as declaring none", () => {- expect(unsetEnvVars({ address: "linear", title: "Linear" }, {})).toEqual([]);+ expect(unsetEnvVars({ address: "channel/linear", title: "Linear Agent" }, {})).toEqual([]);});});diff --git a/packages/eve/src/self-modification/search-registry.test.ts b/packages/eve/src/self-modification/search-registry.test.tsindex 963f15d19..180bec4bc 100644--- a/packages/eve/src/self-modification/search-registry.test.ts+++ b/packages/eve/src/self-modification/search-registry.test.ts@@ -31,19 +31,24 @@ const INDEX = {files: [{ target: "agent/connections/notion.ts" }],},{- name: "linear",- title: "Linear",+ name: "channel/linear",+ title: "Linear Agent",description: "Receive delegated Linear work.",+ meta: {+ eve: { setup: { package: "eve", bin: "eve", args: ["integration", "setup", "linear"] } },+ },+ },+ {+ name: "connection/linear",+ title: "Linear MCP",+ description: "Search and update Linear through MCP.",meta: {eve: {- components: [- {- item: "channel/linear-agent",- label: "Linear agent",- description: "Delegate Linear work to an agent.",- },- { item: "connection/linear", label: "Linear connection" },- ],+ setup: {+ package: "eve",+ bin: "eve",+ args: ["integration", "connect", "linear", "mcp.linear.app", "linear"],+ },},},},@@ -70,7 +75,8 @@ describe("parseRegistryIndex", () => {"channel/slack","channel/discord","connection/notion",- "linear",+ "channel/linear",+ "connection/linear","instrumentation/langfuse-tracing",]);expect(entries[0]).toEqual({@@ -83,11 +89,15 @@ describe("parseRegistryIndex", () => {});});- it("keeps a bundle's components and leaves its category absent", () => {- const bundle = catalog().find((entry) => entry.address === "linear");-- expect(bundle?.category).toBeUndefined();- expect(bundle?.components).toEqual(["channel/linear-agent", "connection/linear"]);+ it("keeps Linear channel and connection entries separate", () => {+ expect(+ catalog()+ .filter((entry) => entry.address.endsWith("/linear"))+ .map((entry) => ({ address: entry.address, category: entry.category })),+ ).toEqual([+ { address: "channel/linear", category: "channel" },+ { address: "connection/linear", category: "connection" },+ ]);});it("recognizes memory registry items", () => {@@ -171,20 +181,20 @@ describe("selectIntegrations", () => {entries: catalog(),query: "Slack channel integration",}).map((row) => row.address),- ).toEqual(["channel/slack", "channel/discord"]);+ ).toEqual(["channel/slack", "channel/discord", "channel/linear"]);expect(selectIntegrations({ entries: catalog(), query: "linear agent" }).map((row) => row.address),- ).toEqual(["linear"]);+ ).toEqual(["channel/linear", "connection/linear"]);expect(selectIntegrations({ entries: catalog(), query: "agent notion" }).map((row) => row.address),- ).toEqual(["connection/notion"]);+ ).toEqual(["connection/notion", "channel/linear"]);expect(selectIntegrations({ entries: catalog(), query: "nothing here" })).toEqual([]);});- it("includes a bundle whose components match the requested category", () => {+ it("filters integrations by their address category", () => {expect(selectIntegrations({ category: "channel", entries: catalog() }).map((row) => row.address),- ).toEqual(["channel/slack", "channel/discord", "linear"]);+ ).toEqual(["channel/slack", "channel/discord", "channel/linear"]);});it("filters memory integrations", () => {@@ -203,7 +213,7 @@ describe("selectIntegrations", () => {it("bounds the result count", () => {expect(selectIntegrations({ entries: catalog(), limit: 2 })).toHaveLength(2);- expect(selectIntegrations({ entries: catalog(), limit: 500 })).toHaveLength(5);+ expect(selectIntegrations({ entries: catalog(), limit: 500 })).toHaveLength(6);});it("reports totals and provides an offset for the next page", () => {@@ -225,12 +235,15 @@ describe("selectIntegrations", () => {},],nextOffset: 2,- total: 5,+ total: 6,});expect(selectIntegrationPage({ entries: catalog(), limit: 2, offset: 4 })).toMatchObject({hasMore: false,- items: [{ address: "instrumentation/langfuse-tracing", title: "Langfuse Tracing" }],- total: 5,+ items: [+ { address: "connection/linear", title: "Linear MCP" },+ { address: "instrumentation/langfuse-tracing", title: "Langfuse Tracing" },+ ],+ total: 6,});});@@ -328,10 +341,10 @@ describe("selfmod__search_registry", () => {title: "Discord",},{- address: "linear",- components: ["channel/linear-agent", "connection/linear"],+ address: "channel/linear",+ category: "channel",description: "Receive delegated Linear work.",- title: "Linear",+ title: "Linear Agent",},],total: 3,diff --git a/packages/eve/src/setup/flows/registry.ts b/packages/eve/src/setup/flows/registry.tsindex 16645c3eb..6ab397a93 100644--- a/packages/eve/src/setup/flows/registry.ts+++ b/packages/eve/src/setup/flows/registry.ts@@ -54,7 +54,7 @@ const SECTIONS = {"channel/web","channel/slack","channel/github",- "channel/linear-agent",+ "channel/linear","channel/photon-imessage",],includes: (item: Item) => item.name.startsWith("channel/"),