@vibesdotdev/plugins 0.0.0-stage → 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
+# @vibesdotdev/plugins
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Compose the scope-neutral core with the root array or selectable plugin:
+
+```ts
+import plugins from '@vibesdotdev/plugins';
+// Or select '@vibesdotdev/plugins/plugin' in a string plugin list.
+```
+
+Consumer hosts use the full nine-family graph through explicit consumer entries:
+
+```ts
+import plugins from '@vibesdotdev/plugins/consumer';
+// Or select '@vibesdotdev/plugins/consumer.plugin'.
+```
+
+Both forms preserve dependency order. Choose one graph per runtime; both
+selectable plugins retain the same public plugin id. Native filesystem adapters
+come from the host environment. Core-only consumers select
+`@vibesdotdev/plugins/core/consumer.plugin`.
+
+`./schemas/core` owns core validation, adapter forms and scope defaults.
+Malformed fields refuse typed; installed optional-plugin defects retain their
+stage and cause instead of being skipped. Storage ids (`cloud-api`, `json`,
+`localdb`) and filesystem ids (`platform` framework-loaded; `bun`,
+`cloudflare`, `artifacts`, `s3` host-composed) resolve through a declared
+lookup. Unknown ids refuse `UNAVAILABLE` / `storage-adapter-unknown` or
+`filesystem-adapter-unknown`; there is no silent fallback. Dynamic imports are
+still static bundler edges: consumer and CLI composition belongs on explicit
+entrypoints.
+
+Family roots (`./auth`, `./automation`, `./comms`, `./data`, `./devtools`,
+`./ui`, and `./ai`) compose scope-neutral contracts and narrow clients.
+Use `./<family>/consumer.plugin` for a family's full native graph;
+`./ai/plugin` also retains its consumer compatibility meaning. TUI applications
+remain behind `./tui/plugin`.
+
+Family schemas live under `./schemas/<family>`. Malformed present fields refuse
+`INVALID_INPUT` with reason `plugins-<family>-config-invalid` and the field name.
+Filesystem exposes its validated open-string connector selection
+(`providers: string[]`, scope default `[]`) as
+the `plugins/filesystem/config` descriptor `plugins.filesystem`; hosts query it
+and compose the provider owners.
+
+See [SPEC.md](SPEC.md) for contracts and package verification commands.
+
+Importing `./bun/host` or `host-start.mjs` boots nothing; call `startHost(options)`.
+The legacy `host.mjs` trampoline starts immediately. Discovery prefers
+`src/bun/host.ts` in a checkout and `dist/bun/host.js` in an install, through the
+host-owned loader. CLI process duties belong to `surface-cli`.
+
+Seed/repair obtains the registry origin from Config's active environment by default; callers may name an environment explicitly or supply a registry URL. Self-update verifies the digest and requires the filesystem adapter's chmod capability before atomic replacement. A refusal preserves the target and removes the temporary download.
+
+Verify with `bun run check`, `bun run test`, `bun run build`, the package oxlint
+ratchet and `workspace-rules`. Check includes tests; build emits production only.

package/VIBES.md

@@ -0,0 +1,165 @@
+---
+slice: repos/platform/framework/plugins
+name: plugins
+generated: 2026-10-27T02:46:14.839Z
+branches: [origin/main, v1/correctness]
+policy:
+  lifecycle: "active"
+  changeResistance: "none"
+  frozen: false
+  frozenAt: null
+  frozenBy: null
+  freezeReason: null
+  enforcement: "error"
+  scope: "all"
+  exceptions: []
+  expiresAt: null
+  expired: false
+  requiresApproval: []
+  violationCount: 0
+  violations: []
+---
+
+# plugins
+
+## Ownership
+
+**owners:** none
+**source:** "none"
+**confidence:** 0
+
+## Dependencies
+
+| sliceId | paths |
+| --- | --- |
+| account | @vibesdotdev/account |
+| agent-execution | @vibesdotdev/agent-execution |
+| agents | @vibesdotdev/agents |
+| ai | @vibesdotdev/ai |
+| ai-schemas | @vibesdotdev/ai-schemas |
+| applets | @vibesdotdev/applets |
+| bridge | @vibesdotdev/bridge |
+| cache | @vibesdotdev/cache |
+| canvas | @vibesdotdev/canvas |
+| chat | @vibesdotdev/chat |
+| client | @vibesdotdev/client |
+| code-sessions | @vibesdotdev/code-sessions |
+| command-palette | @vibesdotdev/command-palette |
+| config | @vibesdotdev/config |
+| control | @vibesdotdev/control |
+| docs | @vibesdotdev/docs |
+| editor | @vibesdotdev/editor |
+| external | @vibesdotdev/external |
+| filesystem | @vibesdotdev/filesystem |
+| forge | @vibesdotdev/forge |
+| git-operations | @vibesdotdev/git-operations |
+| host-bun | @vibesdotdev/host-bun |
+| host-node | @vibesdotdev/host-node |
+| hq | @vibesdotdev/hq |
+| infra-deploy | @vibesdotdev/infra-deploy |
+| kernel | @vibesdotdev/kernel |
+| kernel-rpc | @vibesdotdev/kernel-rpc |
+| knowledge | @vibesdotdev/knowledge |
+| localdb | @vibesdotdev/localdb |
+| logging | @vibesdotdev/logging |
+| mcp | @vibesdotdev/mcp |
+| media | @vibesdotdev/media |
+| notifications | @vibesdotdev/notifications |
+| paths | @vibesdotdev/paths |
+| platform | @vibesdotdev/platform |
+| pm | @vibesdotdev/pm |
+| projects | @vibesdotdev/projects |
+| prompts | @vibesdotdev/prompts |
+| realtime | @vibesdotdev/realtime |
+| runbooks | @vibesdotdev/runbooks |
+| runnable | @vibesdotdev/runnable |
+| scope | @vibesdotdev/scope |
+| secrets | @vibesdotdev/secrets |
+| session | @vibesdotdev/session |
+| shared | @vibesdotdev/shared |
+| studio | @vibesdotdev/studio |
+| surface-cli | @vibesdotdev/surface-cli |
+| surface-sveltekit | @vibesdotdev/surface-sveltekit |
+| terminal-client | @vibesdotdev/terminal-client |
+| testing | @vibesdotdev/testing |
+| tools | @vibesdotdev/tools |
+| tui | @vibesdotdev/tui |
+| vessel | @vibesdotdev/vessel |
+| vibesdotdev.auth | @vibesdotdev/auth |
+| vibesdotdev.cli | @vibesdotdev/cli |
+| vibesdotdev.storage | @vibesdotdev/storage |
+| vibesdotdev.sync | @vibesdotdev/sync |
+| workboard | @vibesdotdev/workboard |
+| workers | @vibesdotdev/workers |
+| workspace | @vibesdotdev/workspace |
+**importedBy:** none
+**external:** @opentui/react, @types/bun, @types/react, @vibesdotdev/plugins, bun:test, node:fs, node:os, node:path, react, typescript, zod
+**source:** "both"
+
+## Health
+
+**ruleViolations:** none
+| package | check | status | findings |
+| --- | --- | --- | --- |
+| @vibesdotdev/developer-bootstrap | import-exports | failed | 22806 |
+| @vibesdotdev/developer-bootstrap | dependency-specs | failed | 182 |
+| @vibesdotdev/plugins | check | failed | 17 |
+| @vibesdotdev/plugins | build | failed | 15 |
+| @vibesdotdev/plugins | test | failed | 1 |
+**typeErrors:** 0
+**warnings:** 0
+**indexCoverage:** 0
+
+## Index State
+
+**dirtyFiles:** 0
+**signalCoverage:** {"workspace.signal.file-stats":0.9235668789808917}
+
+## Lock State
+
+### origin/main
+
+**uncommittedFiles:** none
+**hasConflicts:** false
+**conflictFiles:** none
+**aheadBehind:** {"ahead":0,"behind":0}
+
+### v1/correctness
+
+**uncommittedFiles:** none
+**hasConflicts:** false
+**conflictFiles:** none
+**aheadBehind:** {"ahead":0,"behind":0}
+
+
+## Change Summary
+
+### origin/main
+
+**baseBranch:** "origin/main"
+**filesChanged:** 0
+**insertions:** 0
+**deletions:** 0
+**changedFiles:** none
+**unavailable:** {"reason":"slice-git-unavailable","message":"The slice's Git facts could not be read."}
+
+### v1/correctness
+
+**baseBranch:** "v1/correctness"
+**filesChanged:** 0
+**insertions:** 0
+**deletions:** 0
+**changedFiles:** none
+
+
+## Children
+
+**children:** none
+**totalChildren:** 0
+**frozenChildren:** 0
+**healthyChildren:** 0
+**degradedChildren:** 0
+**totalViolations:** 0
+
+---
+*Generated by vibes workspace slices*

package/dist/ai/index.d.ts

@@ -0,0 +1,4 @@
+export { aiCloudProvidersPlugin as aiPluginsPlugin, default } from './plugin.impl.cloud.ts';
+export { AIPluginsConfigSchema } from '../schemas/ai.ts';
+export type { AIPluginsConfig, AIPluginsInput } from '../schemas/ai.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,IAAI,eAAe,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,3 @@
+export { aiCloudProvidersPlugin as aiPluginsPlugin, default } from "./plugin.impl.cloud.js";
+export { AIPluginsConfigSchema } from "../schemas/ai.js";
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,IAAI,eAAe,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai/plugin.impl.cloud.d.ts

@@ -0,0 +1,4 @@
+/** Scope-pure AI contracts; provider plugins are selected by the host. */
+export declare const aiCloudProvidersPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default aiCloudProvidersPlugin;
+//# sourceMappingURL=plugin.impl.cloud.d.ts.map

package/dist/ai/plugin.impl.cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.impl.cloud.d.ts","sourceRoot":"","sources":["../../src/ai/plugin.impl.cloud.ts"],"names":[],"mappings":"AAMA,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,6CAuBjC,CAAC;AACH,eAAe,sBAAsB,CAAC"}

package/dist/ai/plugin.impl.cloud.js

@@ -0,0 +1,32 @@
+import aiCloudPlugin from '@vibesdotdev/ai/ai.cloud.plugin';
+import { createRuntimePlugin, createRuntimeKind } from '@vibesdotdev/kernel';
+import { z } from 'zod/v4';
+import { AIPluginsConfigSchema, mergeConfig } from "../schemas/ai.js";
+/** Scope-pure AI contracts; provider plugins are selected by the host. */
+export const aiCloudProvidersPlugin = createRuntimePlugin({
+    id: '@vibesdotdev/plugins-ai',
+    name: 'AI Plugins Umbrella (Cloud)',
+    kinds: [createRuntimeKind({
+            id: 'plugins/ai/config',
+            descriptorSchema: z.object({
+                kind: z.literal('plugins/ai/config'), id: z.literal('plugins.ai'), config: AIPluginsConfigSchema
+            })
+        })],
+    async onRegister(runtime) {
+        const input = runtime.hasContext('plugins.ai')
+            ? await runtime.context('plugins.ai') : {};
+        const config = mergeConfig(input, runtime.scope);
+        runtime.registerDescriptor('plugins/ai/config', { kind: 'plugins/ai/config', id: 'plugins.ai', config });
+        if (!config.core)
+            return;
+        await runtime.registerPlugin(aiCloudPlugin);
+        const [{ default: video }, { default: direct }] = await Promise.all([
+            import('@vibesdotdev/ai/generation-video/plugin'),
+            import('@vibesdotdev/ai/executor-direct/cloud.plugin')
+        ]);
+        await runtime.registerPlugin(video);
+        await runtime.registerPlugin(direct);
+    }
+});
+export default aiCloudProvidersPlugin;
+//# sourceMappingURL=plugin.impl.cloud.js.map

package/dist/ai/plugin.impl.cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.impl.cloud.js","sourceRoot":"","sources":["../../src/ai/plugin.impl.cloud.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGtE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;IACzD,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,6BAA6B;IACnC,KAAK,EAAE,CAAC,iBAAiB,CAAC;YACzB,EAAE,EAAE,mBAAmB;YACvB,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,qBAAqB;aAChG,CAAC;SACF,CAAC,CAAC;IACH,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;YAC7C,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAoB,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QACzG,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO;QACzB,MAAM,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnE,MAAM,CAAC,yCAAyC,CAAC;YACjD,MAAM,CAAC,8CAA8C,CAAC;SACtD,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACD,CAAC,CAAC;AACH,eAAe,sBAAsB,CAAC"}

package/dist/ai/plugin.impl.consumer.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimePlugin } from '@vibesdotdev/kernel';
+import { AIPluginsConfigSchema, type AIPluginsInput } from '../schemas/ai.ts';
+export declare function createAIPlugins(customConfig?: AIPluginsInput): RuntimePlugin;
+export declare const aiPluginsPlugin: RuntimePlugin;
+export { AIPluginsConfigSchema };
+export default aiPluginsPlugin;
+//# sourceMappingURL=plugin.impl.consumer.d.ts.map

package/dist/ai/plugin.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/ai/plugin.impl.consumer.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAAE,qBAAqB,EAAmC,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/G,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,cAAc,GAAG,aAAa,CAoL5E;AACD,eAAO,MAAM,eAAe,eAAoB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,eAAe,eAAe,CAAC"}

package/dist/ai/plugin.impl.consumer.js

@@ -0,0 +1,222 @@
+import { optionalMemberRegistrar } from "../core/optional-member.js";
+/**
+ * AI Plugins Umbrella
+ *
+ * Registers a config descriptor under `plugins.ai` that controls
+ * which AI provider plugins are enabled. Provides intelligent defaults
+ * based on runtime scope and available credentials.
+ *
+ * Vision: Background workers are the default execution mode for consumer hardware.
+ * PM daemon and workers auto-launch when needed for parallel, non-blocking generation.
+ *
+ * @example
+ * ```ts
+ * // vibes.config.ts
+ * export default {
+ *   plugins: [() => import('../ai/plugin')],
+ *   config: {
+ *     plugins: {
+ *       ai: {
+ *         core: true,
+ *         providers: {
+ *           anthropic: true,
+ *           fireworks: true,
+ *           lmstudio: false
+ *         },
+ *         defaultProvider: 'anthropic',
+ *         executionMode: 'background' // 'background' | 'single-threaded' | 'cloud'
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import { createRuntimePlugin, createRuntimeKind } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { z } from 'zod/v4';
+import { AIPluginsConfigSchema, mergeConfig, mergeUserAndCustom } from "../schemas/ai.js";
+export function createAIPlugins(customConfig) {
+    return createRuntimePlugin({
+        id: '@vibesdotdev/plugins-ai',
+        name: 'AI Plugins Umbrella',
+        description: 'AI provider plugins with config-driven enablement',
+        dependencies: ['context', '@vibesdotdev/plugins-core'],
+        kinds: [
+            createRuntimeKind({
+                id: 'plugins/ai/config',
+                descriptorSchema: z.object({
+                    kind: z.literal('plugins/ai/config'),
+                    id: z.literal('plugins.ai'),
+                    config: AIPluginsConfigSchema
+                })
+            })
+        ],
+        async onRegister(runtime) {
+            const member = optionalMemberRegistrar('plugins-ai', runtime);
+            const log = getLogger('plugins-ai', runtime);
+            const configId = 'plugins.ai';
+            const userConfig = runtime.hasContext(configId)
+                ? await runtime.context(configId)
+                : {};
+            const combined = mergeUserAndCustom(userConfig, customConfig);
+            const effectiveConfig = mergeConfig(combined, runtime.scope);
+            if (effectiveConfig.core) {
+                const aiModule = await import('@vibesdotdev/ai/ai.plugin');
+                const aiPlugin = aiModule.default;
+                await runtime.registerPlugin(aiPlugin);
+                if (runtime.scope.surface === 'cli') {
+                    await member('@vibesdotdev/ai/cli/plugin', async () => (await import('@vibesdotdev/ai/cli/plugin')).default);
+                }
+                const { default: videoGenerationPlugin } = await import('@vibesdotdev/ai/generation-video/plugin');
+                await runtime.registerPlugin(videoGenerationPlugin);
+                // AI-domain tools (ai-generate, ai-ocr-document) — extracted from
+                // @vibesdotdev/ai into @vibesdotdev/tools/ai so ai stays pure framework
+                // (CORE kinds/descriptors/base-impl). They register against the
+                // tools/tool kind owned by @vibesdotdev/tools (composed by plugins-core,
+                // a declared dependency of this umbrella). Skip gracefully if tools is
+                // not active in this slice — the AI tools simply aren't available.
+                if (runtime.hasKind('tools/tool')) {
+                    // Core AI-router data model: the `ai/router*` kinds + the
+                    // `ai.routers` storage manifest (localdb/json/cloud-api adapters →
+                    // ai-web's /api/routers). Registered unconditionally with the AI
+                    // domain — same posture as the ai.models/ai.providers manifests
+                    // inside aiPlugin — so `runtime.query('ai/router')` and
+                    // `query('storage/manifest').withId('ai.routers')` resolve on
+                    // consumer surfaces. The HTTP router SERVER + CLI stays behind the
+                    // `router` flag below. Declares `dependencies: ['ai', 'tools']`,
+                    // hence this tools-gated branch.
+                    await member('@vibesdotdev/ai/router/plugin', async () => (await import('@vibesdotdev/ai/router/plugin')).default);
+                    await member('@vibesdotdev/ai/tools-impl/plugin', async () => (await import('@vibesdotdev/ai/tools-impl/plugin')).default);
+                    // The Bun/FS-backed ai-generate / generate-image impls are consumer-only
+                    // (split out of ai-tools.plugin to keep their static edge out of cloud
+                    // bundles). Restore them for consumer/CLI/TUI surfaces here.
+                    if (runtime.scope.hardware === 'consumer') {
+                        const { default: aiToolsConsumerPlugin } = await import('@vibesdotdev/ai/tools-impl/consumer.plugin');
+                        await runtime.registerPlugin(aiToolsConsumerPlugin);
+                    }
+                }
+                else {
+                    log.debug('AI tools not composed: tools/tool kind absent', { pluginId: '@vibesdotdev/tools/ai' });
+                }
+                {
+                    await member('@vibesdotdev/ai/scorecard/plugin', async () => (await import('@vibesdotdev/ai/scorecard/plugin')).default);
+                    await member('@vibesdotdev/ai/scorecard/plugin/api-client', async () => (await import('@vibesdotdev/ai/scorecard/plugin/api-client')).default);
+                    {
+                        await member('@vibesdotdev/ai/scorecard/adapters/pier/plugin', async () => (await import('@vibesdotdev/ai/scorecard/adapters/pier/plugin')).default);
+                    }
+                }
+                {
+                    await member('@vibesdotdev/ai/routing/plugin', async () => (await import('@vibesdotdev/ai/routing/plugin')).default);
+                }
+                // Canonical sibling -cli surface for the tools package
+                // (SURFACE-PACKAGE-CONVENTIONS §3). Registers the full end-user
+                // `vibes tools` surface: list|inspect|run|scan|init|export-*|agents.*.
+                // Residual `vibes dev` commands stay on tools.cli.plugin.
+                // CLI-only by surface; cli/group + cli/command kinds exist when
+                // @vibesdotdev/cli is composed (cli-bin does this unconditionally).
+                if (runtime.scope.surface === 'cli') {
+                    {
+                        await member('@vibesdotdev/tools/cli/plugin', async () => (await import('@vibesdotdev/tools/cli/plugin')).default);
+                    }
+                    {
+                        await member('@vibesdotdev/prompts/cli/plugin', async () => (await import('@vibesdotdev/prompts/cli/plugin')).default);
+                    }
+                    {
+                        await member('@vibesdotdev/ai/scorecard/cli/plugin', async () => (await import('@vibesdotdev/ai/scorecard/cli/plugin')).default);
+                    }
+                }
+                // Vision: Auto-start infrastructure for background execution
+                // PM daemon and workers launch automatically when needed
+                if (effectiveConfig.executionMode === 'background' &&
+                    runtime.scope.hardware === 'consumer') {
+                    // Register PM plugin for process management
+                    await member('@vibesdotdev/pm/plugin', async () => (await import('@vibesdotdev/pm/plugin')).default);
+                    // Register workers plugin for job queue
+                    await member('@vibesdotdev/workers/plugin', async () => (await import('@vibesdotdev/workers/plugin')).default);
+                }
+                // Map execution mode to executor plugin
+                // - background → worker executor (queue-based, parallel) + direct executor (used inside worker)
+                // - single-threaded → direct executor (in-process, immediate)
+                // - cloud → api-sse executor (cloud API with SSE streaming)
+                //
+                // In background mode both executors are registered so the worker job
+                // handler can resolve generation.direct inside the worker process.
+                //
+                // The USER's configured mode wins over the scope default.
+                //
+                // `plugins.ai.executionMode` (this plugin's config, consumer default
+                // 'background') decides which executor plugin is REGISTERED, while
+                // `ai.core.generationExecutionMode` — what `vibes ai mode set` and
+                // `vibes ai config set generationExecutionMode` actually write, and what
+                // `resolve-generation-executor.ts` reads to pick the executor that
+                // DECLARES it fulfils that mode on its executing host — was
+                // never consulted here. The two disagreed silently: a consumer could set
+                // cloud mode and still only ever get `generation.worker`, because
+                // `generation.api-sse` was never registered on consumer hardware. That
+                // made cloud execution unreachable from the CLI, which in turn forced
+                // users to hold provider credentials (e.g. a Cloudflare account id and
+                // token) on their own machine to generate anything. Reading the user's
+                // setting here is what makes `vibes ai mode set cloud` mean something.
+                // Plugin registration is metadata composition and must never resolve
+                // persisted `ai.core` state: doing so eagerly opens LocalDB even for
+                // `vibes --help` and completion. Register every executor supported by
+                // this consumer surface; request-time resolution reads the configured
+                // execution mode and selects the executor declaring it (descriptor
+                // `executionModes`, judged on the executing host's scope).
+                const [{ default: workerPlugin }, { default: directPlugin }, { default: apiSSEPlugin }] = await Promise.all([
+                    import('@vibesdotdev/ai/executor-worker/plugin'),
+                    import('@vibesdotdev/ai/executor-direct/plugin'),
+                    import('@vibesdotdev/ai/executor-api-sse/consumer.plugin')
+                ]);
+                await runtime.registerPlugin(workerPlugin);
+                await runtime.registerPlugin(directPlugin);
+                await runtime.registerPlugin(apiSSEPlugin);
+            }
+            // THE CLI SURFACE ALWAYS MOUNTS THE ROUTER COMMAND GROUP.
+            //
+            // `router` defaults to FALSE, and that default is correct for app hosts:
+            // nothing should register an HTTP router server's kinds because a page
+            // imported the AI umbrella. It is wrong for the CLI, and the monolith
+            // hid it — `cli-bin/src/default-plugins.ts:45-46` loaded
+            // `@vibesdotdev/ai/router-server/plugin` and
+            // `@vibesdotdev/ai/cli/router-server/plugin` UNCONDITIONALLY, so every
+            // shipped `vibes` has always carried `ai router` + its nine
+            // subcommands. Under the thin host the CLI obeys the config, and those
+            // ten command paths disappeared from any workspace that does not set
+            // `plugins.ai.router` — measured by `smoke:shipping`'s
+            // `help.command-diff` as "10 of 828 reference command path(s) are
+            // ABSENT". Plan §11 promises every command id in today's `--help`
+            // survives, so that was a capability removal.
+            //
+            // The narrowest repair is the surface, not the default: no app host
+            // changes behaviour, and REGISTERING the server plugin does not START a
+            // server — `ai router serve` does. Flipping the default to `true`
+            // instead would have changed what `runtime.query('ai/router-server')`
+            // resolves on every ai-web surface, which is a product decision this
+            // clause does not need.
+            if (effectiveConfig.router || runtime.scope.surface === 'cli') {
+                {
+                    await member('@vibesdotdev/ai/router/plugin', async () => (await import('@vibesdotdev/ai/router/plugin')).aiRouterPlugin);
+                }
+                {
+                    await member('@vibesdotdev/ai/router-server/plugin', async () => (await import('@vibesdotdev/ai/router-server/plugin')).default);
+                    await member('@vibesdotdev/ai/cli/router-server/plugin', async () => (await import('@vibesdotdev/ai/cli/router-server/plugin')).aiRouterServerCliPlugin);
+                }
+            }
+            if (effectiveConfig.training && runtime.scope.hardware === 'consumer') {
+                // Consumer-local classifier training and model export surface. Local
+                // training installs a non-trivial Python toolchain, so it stays opt-in
+                // via the `training` config flag.
+                const { default: localTrainingPlugin } = await import('@vibesdotdev/ai/training-local/plugin');
+                if (!localTrainingPlugin) {
+                    throw new Error('Missing local AI training plugin default export');
+                }
+                await runtime.registerPlugin(localTrainingPlugin);
+            }
+        }
+    });
+}
+export const aiPluginsPlugin = createAIPlugins();
+export { AIPluginsConfigSchema };
+export default aiPluginsPlugin;
+//# sourceMappingURL=plugin.impl.consumer.js.map

package/dist/ai/plugin.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.impl.consumer.js","sourceRoot":"","sources":["../../src/ai/plugin.impl.consumer.ts"],"names":[],"mappings":"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"}

package/dist/auth/consumer.plugin.d.ts

@@ -0,0 +1,3 @@
+export declare const authPluginsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default authPluginsPlugin;
+//# sourceMappingURL=consumer.plugin.d.ts.map

package/dist/auth/consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.plugin.d.ts","sourceRoot":"","sources":["../../src/auth/consumer.plugin.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,iBAAiB,6CA+E5B,CAAC;AACH,eAAe,iBAAiB,CAAC"}