@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/external.plugin.js

@@ -0,0 +1,184 @@
+import { createRuntimePlugin, createRuntimeKind, loader, } from '@vibesdotdev/kernel';
+import { ExternalHostDescriptorSchema } from "./external-tool/schemas/tool.js";
+import { ExternalAdapterDescriptorSchema } from "./external-adapter/schemas/adapter.js";
+import { mcpExternalAdapterDescriptor, skillsExternalAdapterDescriptor, hooksExternalAdapterDescriptor, pluginsExternalAdapterDescriptor } from "./external-adapter/descriptors.js";
+import { ExternalClient, getVibesExternalClient } from "./client/external-client.js";
+import { EXTERNAL_HOOK_ADAPTER_KIND, ExternalHookAdapterDescriptorSchema } from "./hooks/runtime.js";
+import { externalPresetKind, externalProfileKind, externalOperationKind } from "./runtime.js";
+import { externalCliProjectorKind } from "./runtime/external-surface-projector.js";
+import { externalConfigInstallerKind, jsonMcpInstallerDescriptor, shellHooksInstallerDescriptor, tomlMcpInstallerDescriptor, yamlMcpInstallerDescriptor } from "./plugins/installers/runtime.js";
+import { ACCOUNT_AGENT_ROSTER_PROVIDER_ID, EXTERNAL_AGENT_ROSTER_PROVIDER_KIND, accountAgentRosterProviderDescriptor, externalAgentRosterProviderKind } from "./runtime/agent-roster-provider.js";
+export { enforceFileAccessRetention, FILE_ACCESS_RETENTION_INTERVAL_MS, AGENT_ROSTER_HEARTBEAT_INTERVAL_MS, FILE_ACCESS_RETENTION_TIMEOUT_MS, AGENT_ROSTER_HEARTBEAT_TIMEOUT_MS } from "./client/lifecycle.js";
+import ambientDocsTopic from "./docs/external.ambient.docs.descriptor.js";
+import { externalHarnessPromptDescriptors } from "./harness/prompts/index.js";
+import externalConfigDescriptor from "./config/external.config.descriptor.js";
+// Unified tool
+import externalToolDescriptor from "./tools/unified/external.descriptor.js";
+import { externalActionKind } from "./tools/unified/runtime.js";
+import { contextSummaryActionDescriptor, fileAccessListActionDescriptor, fileAccessTrackActionDescriptor, hookCallActionDescriptor, hookGeneratorActionDescriptor, installActionDescriptor, signalInboxActionDescriptor, signalSendActionDescriptor } from "./tools/unified/action-descriptors.js";
+// Storage + logging
+import fileAccessDescriptor from "./storage/file-access.record.descriptor.js";
+import fileAccessAmbientSubscription from "./ambient/file-access-ambient.subscription.descriptor.js";
+import fileAccessAmbientFsSubscription from "./ambient/file-access-ambient-fs.subscription.descriptor.js";
+import fileAccessAmbientDrainSubscription from "./ambient/file-access-ambient-drain.subscription.descriptor.js";
+import agentMessageDescriptor from "./storage/agent-message.record.descriptor.js";
+import { launchStateRecordDescriptor } from "./launch/consumer/state-rows.js";
+import { reviewStateRecordDescriptor } from "./hooks/review-state.js";
+import subagentOutput from "./ingest/logging/subagent-completions.output.descriptor.js";
+import successOutput from "./ingest/logging/success-patterns.output.descriptor.js";
+import toolUseOutput from "./ingest/logging/tool-use.output.descriptor.js";
+import externalHarnessExecutorDescriptor from "./launch/task-executor/external-harness.descriptor.js";
+const externalHostKind = createRuntimeKind({
+    id: 'external/host',
+    descriptorSchema: ExternalHostDescriptorSchema,
+    contexts: ['runtime/workspace-path']
+});
+const externalAdapterKind = createRuntimeKind({
+    id: 'external/adapter',
+    descriptorSchema: ExternalAdapterDescriptorSchema
+});
+const externalHookAdapterKind = createRuntimeKind({
+    id: EXTERNAL_HOOK_ADAPTER_KIND,
+    descriptorSchema: ExternalHookAdapterDescriptorSchema
+});
+const externalClientDescriptor = {
+    id: 'external',
+    kind: 'runtime/client',
+    name: 'External Client',
+    description: 'Canonical client for external tool projection',
+    configManifestId: 'external'
+};
+export const externalPlugin = createRuntimePlugin({
+    id: 'external',
+    name: 'External',
+    description: 'Projects Vibes capabilities into external tools through runtime adapters',
+    kinds: [
+        externalHostKind,
+        externalAdapterKind,
+        externalHookAdapterKind,
+        externalPresetKind,
+        externalProfileKind,
+        externalOperationKind,
+        externalCliProjectorKind,
+        externalActionKind,
+        externalConfigInstallerKind,
+        externalAgentRosterProviderKind
+    ],
+    onRegister: async (runtime) => {
+        runtime.registerLoader('external/adapter', mcpExternalAdapterDescriptor.id, async () => ({
+            impl: (await import("./external-adapter/implementations.js")).mcpExternalAdapter(runtime)
+        }), { constraint: { hardware: ['consumer'] } });
+        runtime.registerLoader('external/adapter', skillsExternalAdapterDescriptor.id, async () => ({
+            impl: (await import("./external-adapter/implementations.js")).skillsExternalAdapter(runtime)
+        }), { constraint: { hardware: ['consumer'] } });
+        runtime.registerLoader('external/adapter', hooksExternalAdapterDescriptor.id, async () => ({
+            impl: (await import("./external-adapter/implementations.js")).hooksExternalAdapter(runtime)
+        }), { constraint: { hardware: ['consumer'] } });
+        runtime.registerLoader('external/adapter', pluginsExternalAdapterDescriptor.id, async () => ({
+            impl: (await import("./external-adapter/implementations.js")).pluginsExternalAdapter(runtime)
+        }), { constraint: { hardware: ['consumer'] } });
+        // Register the external client descriptor with runtime-client
+        runtime.registerDescriptor('runtime/client', externalClientDescriptor);
+        runtime.registerLoader('runtime/client', 'external', async () => ({
+            impl: ExternalClient
+        }));
+        runtime.registerLoader(EXTERNAL_AGENT_ROSTER_PROVIDER_KIND, ACCOUNT_AGENT_ROSTER_PROVIDER_ID, async () => {
+            const { CloudAgentRosterProvider } = await import("./ambient/cloud-agent-roster-provider.impl.js");
+            const { asCallerBearerRuntime } = await import("./ambient/cloud-authenticated-json.js");
+            return { impl: new CloudAgentRosterProvider(asCallerBearerRuntime(runtime)) };
+        }, { constraint: { hardware: ['consumer'] } });
+    },
+    onActivate: async (runtime) => {
+        const client = await getVibesExternalClient(runtime);
+        await client.activateBackgroundWork();
+    },
+    onDispose: async (runtime) => {
+        // Finalization has aborted the lifecycle signal, so use the kernel's
+        // existing asset directly; never initialize a client during cleanup.
+        if (!runtime.hasKind('runtime/client'))
+            return;
+        await runtime.query('runtime/client').withId('external').peek?.()?.dispose();
+    },
+    descriptors: [
+        externalConfigDescriptor,
+        externalHarnessExecutorDescriptor,
+        ambientDocsTopic,
+        ...externalHarnessPromptDescriptors,
+        // Canonical external projection kinds
+        accountAgentRosterProviderDescriptor,
+        mcpExternalAdapterDescriptor,
+        skillsExternalAdapterDescriptor,
+        hooksExternalAdapterDescriptor,
+        pluginsExternalAdapterDescriptor,
+        jsonMcpInstallerDescriptor,
+        tomlMcpInstallerDescriptor,
+        yamlMcpInstallerDescriptor,
+        shellHooksInstallerDescriptor,
+        // Unified tool
+        externalToolDescriptor,
+        fileAccessTrackActionDescriptor,
+        fileAccessListActionDescriptor,
+        contextSummaryActionDescriptor,
+        hookGeneratorActionDescriptor,
+        installActionDescriptor,
+        hookCallActionDescriptor,
+        signalSendActionDescriptor,
+        signalInboxActionDescriptor,
+        // Storage + logging
+        fileAccessDescriptor,
+        // Ambient file-touch: records every workspace-fs touch and appends the
+        // collision notice. Re-homes the write path orphaned by the
+        // workspace -> workspace-fs split.
+        fileAccessAmbientSubscription,
+        fileAccessAmbientFsSubscription,
+        fileAccessAmbientDrainSubscription,
+        // Ephemeral agent-to-agent messages (same-machine leg; cross-machine
+        // rides the ambient projection endpoint).
+        agentMessageDescriptor,
+        launchStateRecordDescriptor,
+        reviewStateRecordDescriptor,
+        subagentOutput,
+        successOutput,
+        toolUseOutput
+    ],
+    loaders: [
+        loader(externalHarnessExecutorDescriptor.id, { kind: externalHarnessExecutorDescriptor.kind, scope: 'consumer' }, () => import("./launch/task-executor/external-harness.impl.consumer.js")),
+        loader(jsonMcpInstallerDescriptor.id, { kind: 'external/config-installer', scope: 'consumer' }, async () => {
+            const { JsonMcpInstaller } = await import("./plugins/installers/mcp/json-installer.js");
+            return { impl: new JsonMcpInstaller() };
+        }),
+        loader(tomlMcpInstallerDescriptor.id, { kind: 'external/config-installer', scope: 'consumer' }, async () => {
+            const { TomlMcpInstaller } = await import("./plugins/installers/mcp/toml-installer.js");
+            return { impl: new TomlMcpInstaller() };
+        }),
+        loader(yamlMcpInstallerDescriptor.id, { kind: 'external/config-installer', scope: 'consumer' }, async () => {
+            const { YamlMcpInstaller } = await import("./plugins/installers/mcp/yaml-installer.js");
+            return { impl: new YamlMcpInstaller() };
+        }),
+        loader(shellHooksInstallerDescriptor.id, { kind: 'external/config-installer', scope: 'consumer' }, async () => {
+            const { ShellHooksInstaller } = await import("./plugins/installers/hooks/shell-installer.js");
+            return { impl: new ShellHooksInstaller() };
+        }),
+        // Ambient file-touch subscription handler (workspace-fs tool calls).
+        loader('external.file-access.ambient', () => import("./ambient/file-access-ambient.impl.js")),
+        // Ambient file-touch subscription handler (OS-level filesystem watcher).
+        loader('external.file-access.ambient-fs', () => import("./ambient/file-access-ambient-fs.impl.js")),
+        // Ambient notice drain — delivers pending notices on any tool call.
+        loader('external.file-access.ambient-drain', () => import("./ambient/file-access-ambient-drain.impl.js")),
+        // windsurf + cline now detect + configure through the manifest-driven
+        // DefaultExternalHost (platformPaths / extensionMatch) — no bespoke
+        // tool implementations (#816).
+        // Unified tool
+        loader('external', { kind: 'tools/tool', scope: 'consumer' }, () => import("./tools/unified/external.impl.consumer.js")),
+        loader(fileAccessTrackActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).fileAccessTrackAction })),
+        loader(fileAccessListActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).fileAccessListAction })),
+        loader(contextSummaryActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).contextSummaryAction })),
+        loader(hookGeneratorActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).hookGeneratorAction })),
+        loader(installActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).installAction })),
+        loader(hookCallActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).hookCallAction })),
+        loader(signalSendActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).signalSendAction })),
+        loader(signalInboxActionDescriptor.id, { kind: 'external/action', scope: 'consumer' }, async () => ({ impl: (await import("./tools/unified/actions.js")).signalInboxAction }))
+    ]
+});
+export default externalPlugin;
+//# sourceMappingURL=external.plugin.js.map

package/dist/external.plugin.js.map

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

package/dist/harness/agent-host-scope.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The scope an agent host declares when it boots a runtime.
+ *
+ * An agent host is not a new surface the runtime has to be taught: it is the CLI
+ * host's own declaration for a persistent, interactive, local session — same host
+ * identity, same workspace access — so a command or a tool resolves under an
+ * agent host exactly as it would under `vibes`. That sameness is the point. A
+ * scope that claimed something extra would make the agent host's answers differ
+ * from the ones the same workspace gives the terminal, and there would be two
+ * truths about what a plugin provides.
+ *
+ * It is its own module because declaring a scope is not booting a runtime: a host
+ * declares one, the kernel resolves it, and neither step needs the other's code.
+ */
+import type { AgentHostScope, AgentHostScopeInput } from './schemas/agent-host.ts';
+/** The CLI host's own declaration for a persistent, interactive, local session. */
+export declare function agentHostScope(input: AgentHostScopeInput): AgentHostScope;
+//# sourceMappingURL=agent-host-scope.d.ts.map

package/dist/harness/agent-host-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host-scope.d.ts","sourceRoot":"","sources":["../../src/harness/agent-host-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAazE"}

package/dist/harness/agent-host-scope.js

@@ -0,0 +1,30 @@
+/**
+ * The scope an agent host declares when it boots a runtime.
+ *
+ * An agent host is not a new surface the runtime has to be taught: it is the CLI
+ * host's own declaration for a persistent, interactive, local session — same host
+ * identity, same workspace access — so a command or a tool resolves under an
+ * agent host exactly as it would under `vibes`. That sameness is the point. A
+ * scope that claimed something extra would make the agent host's answers differ
+ * from the ones the same workspace gives the terminal, and there would be two
+ * truths about what a plugin provides.
+ *
+ * It is its own module because declaring a scope is not booting a runtime: a host
+ * declares one, the kernel resolves it, and neither step needs the other's code.
+ */
+/** The CLI host's own declaration for a persistent, interactive, local session. */
+export function agentHostScope(input) {
+    const scope = {
+        surface: 'agent',
+        hardware: 'consumer',
+        purpose: 'projection',
+        lifecycle: 'persistent',
+        hosting: { mode: 'local', owner: 'consumer', venue: 'user-device' },
+        capabilities: { interactiveSession: true },
+        workspace: { root: input.workspaceRoot, access: 'write' }
+    };
+    // The qualifier is added only when the host declares one, so a scope with no
+    // `dev` fact carries no `dev` key rather than an empty one.
+    return input.dev === undefined ? scope : { ...scope, qualifiers: { dev: input.dev } };
+}
+//# sourceMappingURL=agent-host-scope.js.map

package/dist/harness/agent-host-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host-scope.js","sourceRoot":"","sources":["../../src/harness/agent-host-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,KAA0B;IACxD,MAAM,KAAK,GAAmB;QAC7B,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,YAAY;QACrB,SAAS,EAAE,YAAY;QACvB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE;QACnE,YAAY,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE;QAC1C,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;KACzD,CAAC;IACF,6EAA6E;IAC7E,4DAA4D;IAC5D,OAAO,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;AACvF,CAAC"}

package/dist/harness/agent-host-settings.d.ts

@@ -0,0 +1,6 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type AgentHostSettings } from './schemas/agent-host.ts';
+export declare const agentHostSettingsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+/** Unconfigured hosts keep forwarding; an admitted manifest's failures propagate. */
+export declare function readAgentHostSettings(runtime: RuntimeRef): Promise<AgentHostSettings>;
+//# sourceMappingURL=agent-host-settings.d.ts.map

package/dist/harness/agent-host-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host-settings.d.ts","sourceRoot":"","sources":["../../src/harness/agent-host-settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE1F,eAAO,MAAM,uBAAuB,6CAKlC,CAAC;AAEH,qFAAqF;AACrF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAI3F"}

package/dist/harness/agent-host-settings.js

@@ -0,0 +1,18 @@
+/** The agent host's command policy, resolved through Config's existing kind. */
+import { ConfigManifest } from '@vibesdotdev/config/manifest/config-manifest';
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import descriptor, { AGENT_HOST_CONFIG_MANIFEST_ID } from "./agent-host.config.descriptor.js";
+import { AgentHostSettingsSchema } from "./schemas/agent-host.js";
+export const agentHostSettingsPlugin = createRuntimePlugin({
+    id: 'external.agent-host',
+    name: 'Agent host settings',
+    optionalDependencies: ['config'],
+    descriptors: [descriptor]
+});
+/** Unconfigured hosts keep forwarding; an admitted manifest's failures propagate. */
+export async function readAgentHostSettings(runtime) {
+    return ConfigManifest.isRegistered(runtime, AGENT_HOST_CONFIG_MANIFEST_ID)
+        ? ConfigManifest.forRuntime(runtime, AGENT_HOST_CONFIG_MANIFEST_ID).load()
+        : AgentHostSettingsSchema.parse({});
+}
+//# sourceMappingURL=agent-host-settings.js.map

package/dist/harness/agent-host-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host-settings.js","sourceRoot":"","sources":["../../src/harness/agent-host-settings.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAmB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,UAAU,EAAE,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAA0B,MAAM,yBAAyB,CAAC;AAE1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;IAC1D,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,qBAAqB;IAC3B,oBAAoB,EAAE,CAAC,QAAQ,CAAC;IAChC,WAAW,EAAE,CAAC,UAAU,CAAC;CACzB,CAAC,CAAC;AAEH,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAmB;IAC9D,OAAO,cAAc,CAAC,YAAY,CAAC,OAAO,EAAE,6BAA6B,CAAC;QACzE,CAAC,CAAC,cAAc,CAAC,UAAU,CAAoB,OAAO,EAAE,6BAA6B,CAAC,CAAC,IAAI,EAAE;QAC7F,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/harness/agent-host.config.descriptor.d.ts

@@ -0,0 +1,6 @@
+/** Command delivery is a host composition policy, with no stored edit layer. */
+import type { ConfigManifestDescriptor } from '@vibesdotdev/config/schemas/config-manifest-descriptor';
+export declare const AGENT_HOST_CONFIG_MANIFEST_ID = "external.agent-host";
+declare const descriptor: ConfigManifestDescriptor;
+export default descriptor;
+//# sourceMappingURL=agent-host.config.descriptor.d.ts.map

package/dist/harness/agent-host.config.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host.config.descriptor.d.ts","sourceRoot":"","sources":["../../src/harness/agent-host.config.descriptor.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAGvG,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,QAAA,MAAM,UAAU,EAAE,wBAiBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/harness/agent-host.config.descriptor.js

@@ -0,0 +1,22 @@
+import { AgentHostSettingsSchema } from "./schemas/agent-host.js";
+export const AGENT_HOST_CONFIG_MANIFEST_ID = 'external.agent-host';
+const descriptor = {
+    kind: 'config/manifest',
+    id: AGENT_HOST_CONFIG_MANIFEST_ID,
+    name: 'Agent host commands',
+    description: 'Delivery policy for commands projected into an agent host',
+    namespace: AGENT_HOST_CONFIG_MANIFEST_ID,
+    schema: AgentHostSettingsSchema,
+    allowedAdapters: ['storage.memory'],
+    storedLayer: 'none',
+    scope: 'global',
+    customTables: false,
+    version: 1,
+    internal: true,
+    tier: 'internal',
+    category: 'integration',
+    fields: { commandCaptureDelivery: { ui: { label: 'Command output delivery' } } },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=agent-host.config.descriptor.js.map

package/dist/harness/agent-host.config.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host.config.descriptor.js","sourceRoot":"","sources":["../../src/harness/agent-host.config.descriptor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE,MAAM,UAAU,GAA6B;IAC5C,IAAI,EAAE,iBAAiB;IACvB,EAAE,EAAE,6BAA6B;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,2DAA2D;IACxE,SAAS,EAAE,6BAA6B;IACxC,MAAM,EAAE,uBAAuB;IAC/B,eAAe,EAAE,CAAC,gBAAgB,CAAC;IACnC,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,QAAQ;IACf,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE;IAChF,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/harness/agent-host.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The agent-host runtime: one booted Vibes runtime, queried for whatever the
+ * host can present.
+ *
+ * A coding-agent host (Pi, OpenCode, ACP, any future one) is not a second package
+ * manager and not a second catalog. It boots ONE real runtime through the
+ * kernel's own entry — the same composition the `vibes` binary uses: the CLI
+ * host's plugin floor, then the global scope, then the workspace the host runs
+ * in — and then *queries* it. Every tool, command, prompt, model and provider a
+ * host shows the model is a view over a kind that runtime already holds, and a
+ * host that cannot ask a kind has no equivalent for it, so it maps nothing.
+ *
+ * Why the mapping lives in Framework rather than in a host package is that every
+ * one of these mappings is the SAME mapping: Pi and OpenCode differ in how they
+ * render a tool row and how they name a command, never in where the descriptor
+ * comes from. The environment is injected, never imported — a host runs on Node
+ * or Bun and declares its own, so Framework holds the portable policy and the
+ * host holds the composition root.
+ *
+ * The scope it boots under is `agent-host-scope.ts`; the contracts are in
+ * `schemas/agent-host.ts`; running, capturing and parsing a command are
+ * `command-execution.ts`, `command-output.ts` and `command-arguments.ts`.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { CLICommandAssetDescriptor, CLIGroupAssetDescriptor, CommandOptions } from '@vibesdotdev/cli-contracts';
+import type { PromptsManifestDescriptor } from '@vibesdotdev/ai-schemas';
+import { type HostToolInput, type LiveToolDescriptor } from './live-tools.ts';
+import { type AgentHostCatalog, type AgentHostCommandResult, type AgentHostDescriptor, type AgentHostInvokeOptions, type CommandInvocation, type BootAgentHostOptions, type HostJson } from './schemas/agent-host.ts';
+export type * from './schemas/agent-host.ts';
+export { agentHostSettingsPlugin } from './agent-host-settings.ts';
+/** The kinds this host projection knows how to ask. A kind it cannot map is simply not queried. */
+export declare const AGENT_HOST_KINDS: {
+    readonly tools: "tools/tool";
+    readonly groups: "cli/group";
+    readonly commands: "cli/command";
+    readonly prompts: "prompts/manifest";
+    readonly models: "ai/model";
+    readonly providers: "ai/provider";
+};
+/**
+ * One booted runtime, queried.
+ *
+ * The class owns the runtime's whole life: it boots it, and `dispose` releases
+ * it exactly once however many times a host calls it. A host that switches
+ * workspaces disposes the previous host before booting the next, so two runtimes
+ * never own the same workspace.
+ */
+export declare class VibesAgentHost {
+    readonly runtime: VibesRuntime;
+    readonly root: string;
+    readonly workspaceRoot: string;
+    private calls;
+    /** One execution at a time: the CLI's own invariant, kept for the same exclusive stdio lease. */
+    private readonly executions;
+    private constructor();
+    /**
+     * Boot one runtime for an agent host session.
+     *
+     * The composition is a workspace composition, so the kernel finds the
+     * workspace's own `vibes.config` and composes its plugins on top of the host's
+     * floor. This headless harness omits package exports that declare the TUI
+     * surface while keeping the rest of the selected workspace graph.
+     */
+    static boot(options: BootAgentHostOptions): Promise<VibesAgentHost>;
+    /** Every registry this host can answer, read in one pass over the kernel's own kind list. */
+    catalogs(): AgentHostCatalog;
+    /**
+     * The live `tools/tool` registry in its wire form, through the daemon socket's
+     * own serializer — so a host receives JSON Schema exactly as the socket served
+     * it, one schema path for every transport rather than one per host.
+     */
+    catalog(): LiveToolDescriptor[];
+    /** The live `cli/group` registry: how the host nests commands under a prefix. */
+    groups(): readonly CLIGroupAssetDescriptor[];
+    /** The live `cli/command` registry: the commands this host can offer. */
+    commands(): readonly CLICommandAssetDescriptor[];
+    /** The live `prompts/manifest` registry: the prompts this host can render. */
+    prompts(): readonly PromptsManifestDescriptor[];
+    /** The live `ai/model` and `ai/provider` registries, when the workspace composed the AI plugin. */
+    models(): readonly AgentHostDescriptor[];
+    providers(): readonly AgentHostDescriptor[];
+    /**
+     * Run `toolId` as the caller this host session names, through the same path
+     * `vibes tools run` uses; the host's abort signal reaches the tool. Both
+     * ends are JSON because a host bridge carries JSON; a tool whose output is
+     * not JSON fails at this boundary rather than handing a host a value it
+     * cannot render or forward.
+     */
+    invokeTool(toolId: string, input: HostToolInput, options?: AgentHostInvokeOptions): Promise<HostJson>;
+    /**
+     * Run one `cli/command` in this runtime and return what it wrote. The host's
+     * process exit code is untouched; this never calls `process.exit`.
+     */
+    runCommand(command: CLICommandAssetDescriptor, args?: CommandOptions, options?: CommandOptions, invocation?: CommandInvocation): Promise<AgentHostCommandResult>;
+    /** Release the runtime. Idempotent: several callers may race a disposal. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=agent-host.d.ts.map

package/dist/harness/agent-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host.d.ts","sourceRoot":"","sources":["../../src/harness/agent-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAuF,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC7I,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGzE,OAAO,EAAiD,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK7H,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,MAAM,yBAAyB,CAAC;AAEjC,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,mGAAmG;AACnG,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAeX;;;;;;;GAOG;AACH,qBAAa,cAAc;IAMzB,QAAQ,CAAC,OAAO,EAAE,YAAY;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM;IAP/B,OAAO,CAAC,KAAK,CAAK;IAClB,iGAAiG;IACjG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IAEnD,OAAO;IAMP;;;;;;;OAOG;WACU,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBzE,6FAA6F;IAC7F,QAAQ,IAAI,gBAAgB;IAW5B;;;;OAIG;IACH,OAAO,IAAI,kBAAkB,EAAE;IAM/B,iFAAiF;IACjF,MAAM,IAAI,SAAS,uBAAuB,EAAE;IAI5C,yEAAyE;IACzE,QAAQ,IAAI,SAAS,yBAAyB,EAAE;IAMhD,8EAA8E;IAC9E,OAAO,IAAI,SAAS,yBAAyB,EAAE;IAI/C,mGAAmG;IACnG,MAAM,IAAI,SAAS,mBAAmB,EAAE;IAIxC,SAAS,IAAI,SAAS,mBAAmB,EAAE;IAI3C;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4C/G;;;OAGG;IACH,UAAU,CACT,OAAO,EAAE,yBAAyB,EAClC,IAAI,GAAE,cAAmB,EACzB,OAAO,GAAE,cAAmB,EAC5B,UAAU,GAAE,iBAAsB,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAMlC,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxB"}

package/dist/harness/agent-host.js

@@ -0,0 +1,201 @@
+/**
+ * The agent-host runtime: one booted Vibes runtime, queried for whatever the
+ * host can present.
+ *
+ * A coding-agent host (Pi, OpenCode, ACP, any future one) is not a second package
+ * manager and not a second catalog. It boots ONE real runtime through the
+ * kernel's own entry — the same composition the `vibes` binary uses: the CLI
+ * host's plugin floor, then the global scope, then the workspace the host runs
+ * in — and then *queries* it. Every tool, command, prompt, model and provider a
+ * host shows the model is a view over a kind that runtime already holds, and a
+ * host that cannot ask a kind has no equivalent for it, so it maps nothing.
+ *
+ * Why the mapping lives in Framework rather than in a host package is that every
+ * one of these mappings is the SAME mapping: Pi and OpenCode differ in how they
+ * render a tool row and how they name a command, never in where the descriptor
+ * comes from. The environment is injected, never imported — a host runs on Node
+ * or Bun and declares its own, so Framework holds the portable policy and the
+ * host holds the composition root.
+ *
+ * The scope it boots under is `agent-host-scope.ts`; the contracts are in
+ * `schemas/agent-host.ts`; running, capturing and parsing a command are
+ * `command-execution.ts`, `command-output.ts` and `command-arguments.ts`.
+ */
+import { bootstrapVibesRuntime, CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { invokeToolAsCaller } from '@vibesdotdev/tools/execution';
+import { serializeDescriptor } from '@vibesdotdev/kernel-rpc/descriptor-wire';
+import { HostToolInputSchema, LiveToolDescriptorSchema } from "./live-tools.js";
+import { executeHostCommand } from "./command-execution.js";
+import { ExecutionQueue } from "./execution-queue.js";
+import { conciseValidationFailure } from "./validation-errors.js";
+import { JsonValueFromReaderSchema } from '@vibesdotdev/kernel/schemas/json';
+import {} from "./schemas/agent-host.js";
+export { agentHostSettingsPlugin } from "./agent-host-settings.js";
+/** The kinds this host projection knows how to ask. A kind it cannot map is simply not queried. */
+export const AGENT_HOST_KINDS = {
+    tools: 'tools/tool',
+    groups: 'cli/group',
+    commands: 'cli/command',
+    prompts: 'prompts/manifest',
+    models: 'ai/model',
+    providers: 'ai/provider'
+};
+/**
+ * One kind's enabled descriptors, or an empty list when a plugin did not register
+ * the kind. `T` is the descriptor the kind declares: the kernel already parsed
+ * each one against that schema at registration, so a second parse here would
+ * assert a fact the registry has already established.
+ */
+function descriptorsOf(runtime, kind) {
+    if (!runtime.hasKind(kind))
+        return [];
+    // SAFETY: the runtime registered these descriptors under `kind`, whose
+    // descriptorSchema validated each one at registration; `T` names that shape.
+    return runtime.query(kind).enabled().descriptors();
+}
+/**
+ * One booted runtime, queried.
+ *
+ * The class owns the runtime's whole life: it boots it, and `dispose` releases
+ * it exactly once however many times a host calls it. A host that switches
+ * workspaces disposes the previous host before booting the next, so two runtimes
+ * never own the same workspace.
+ */
+export class VibesAgentHost {
+    runtime;
+    root;
+    workspaceRoot;
+    calls = 0;
+    /** One execution at a time: the CLI's own invariant, kept for the same exclusive stdio lease. */
+    executions = new ExecutionQueue();
+    constructor(runtime, root, workspaceRoot) {
+        this.runtime = runtime;
+        this.root = root;
+        this.workspaceRoot = workspaceRoot;
+    }
+    /**
+     * Boot one runtime for an agent host session.
+     *
+     * The composition is a workspace composition, so the kernel finds the
+     * workspace's own `vibes.config` and composes its plugins on top of the host's
+     * floor. This headless harness omits package exports that declare the TUI
+     * surface while keeping the rest of the selected workspace graph.
+     */
+    static async boot(options) {
+        const runtime = await bootstrapVibesRuntime({
+            environment: options.environment,
+            composition: {
+                kind: 'workspace',
+                floor: { plugins: [...options.composition.floor], config: options.composition.config },
+                global: true,
+                failurePolicy: 'abort',
+                omitSurfaces: ['tui']
+            },
+            binding: options.binding ?? 'default',
+            activation: 'boot'
+        });
+        return new VibesAgentHost(runtime, options.root, options.workspaceRoot);
+    }
+    /** Every registry this host can answer, read in one pass over the kernel's own kind list. */
+    catalogs() {
+        return {
+            tools: this.catalog(),
+            groups: this.groups(),
+            commands: this.commands(),
+            prompts: this.prompts(),
+            models: this.models(),
+            providers: this.providers()
+        };
+    }
+    /**
+     * The live `tools/tool` registry in its wire form, through the daemon socket's
+     * own serializer — so a host receives JSON Schema exactly as the socket served
+     * it, one schema path for every transport rather than one per host.
+     */
+    catalog() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.tools).map((descriptor) => LiveToolDescriptorSchema.parse(serializeDescriptor(descriptor)));
+    }
+    /** The live `cli/group` registry: how the host nests commands under a prefix. */
+    groups() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.groups);
+    }
+    /** The live `cli/command` registry: the commands this host can offer. */
+    commands() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.commands).filter((descriptor) => descriptor.internal !== true);
+    }
+    /** The live `prompts/manifest` registry: the prompts this host can render. */
+    prompts() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.prompts);
+    }
+    /** The live `ai/model` and `ai/provider` registries, when the workspace composed the AI plugin. */
+    models() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.models);
+    }
+    providers() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.providers);
+    }
+    /**
+     * Run `toolId` as the caller this host session names, through the same path
+     * `vibes tools run` uses; the host's abort signal reaches the tool. Both
+     * ends are JSON because a host bridge carries JSON; a tool whose output is
+     * not JSON fails at this boundary rather than handing a host a value it
+     * cannot render or forward.
+     */
+    async invokeTool(toolId, input, options = {}) {
+        return this.executions.run(async () => {
+            let parsedInput;
+            try {
+                parsedInput = HostToolInputSchema.safeParse(input);
+            }
+            catch (error) {
+                throw new CapabilityError('Tool input could not be validated.', 'INVALID_INPUT', {
+                    reason: 'agent-host-input-invalid',
+                    cause: CaughtFailureSchema.parse(error)
+                });
+            }
+            if (!parsedInput.success) {
+                throw new CapabilityError(conciseValidationFailure(parsedInput.error), 'INVALID_INPUT', {
+                    reason: 'agent-host-input-invalid',
+                    cause: parsedInput.error
+                });
+            }
+            const output = await invokeToolAsCaller(this.runtime, {
+                toolId,
+                input: parsedInput.data,
+                callId: `agent_${Date.now()}_${++this.calls}`,
+                loggerId: 'external:agent-host',
+                session: options.session,
+                signal: options.signal
+            });
+            let parsedOutput;
+            try {
+                parsedOutput = JsonValueFromReaderSchema.safeParse(output);
+            }
+            catch (error) {
+                throw new CapabilityError('Tool output could not be validated.', 'INTERNAL', {
+                    reason: 'agent-host-output-invalid',
+                    cause: CaughtFailureSchema.parse(error)
+                });
+            }
+            if (!parsedOutput.success) {
+                throw new CapabilityError(conciseValidationFailure(parsedOutput.error), 'INTERNAL', {
+                    reason: 'agent-host-output-invalid',
+                    cause: parsedOutput.error
+                });
+            }
+            return parsedOutput.data;
+        });
+    }
+    /**
+     * Run one `cli/command` in this runtime and return what it wrote. The host's
+     * process exit code is untouched; this never calls `process.exit`.
+     */
+    runCommand(command, args = {}, options = {}, invocation = {}) {
+        return this.executions.run(() => executeHostCommand(this.runtime, command, args, options, invocation));
+    }
+    /** Release the runtime. Idempotent: several callers may race a disposal. */
+    dispose() {
+        return this.runtime.dispose();
+    }
+}
+//# sourceMappingURL=agent-host.js.map