@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.4

package/dist/client/helper.js

@@ -0,0 +1,19 @@
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+/**
+ * Resolve the canonical `ToolsClient` on the runtime the caller was handed.
+ *
+ * Equivalent to `runtime.query('runtime/client').withId('tools').resolve()` on
+ * that runtime. The runtime is required: there is no ambient fallback to a
+ * process-global runtime (RC02). Requires the `tools` plugin (which registers
+ * the descriptor) to be composed on it.
+ *
+ * ```ts
+ * import { getVibesToolsClient } from '@vibesdotdev/tools/client';
+ * const tools = await getVibesToolsClient(context.runtime);
+ * const agents = await tools.listAgents();
+ * ```
+ */
+export async function getVibesToolsClient(runtime) {
+    return getVibesClient('tools', runtime);
+}
+//# sourceMappingURL=helper.js.map

package/dist/client/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../src/client/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAI5D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IAC9D,OAAO,cAAc,CAAc,OAAO,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+export { ToolsClient } from './runtime-client.ts';
+export { getVibesToolsClient } from './helper.ts';
+export type { AgentSummary, ToolApprovalClient, ApprovalDescriptorSignal } from './runtime-client.ts';
+export { TOOLS_CATALOG_CAPABILITY_ID, RendererToolSummarySchema, RendererToolsCatalogSchema, projectToolSummaryForRenderer, projectToolsCatalogForRenderer, toolsCatalogCapabilityDescriptor, toolsCatalogCapabilityExposure, toolsCatalogCapabilityKind } from './tool-catalog-capability.ts';
+export type { RendererToolSummary, RendererToolsCatalog, ToolsCatalogCapability } from './tool-catalog-capability.ts';
+export type { Agent, AgentsCollection, Tool, ToolsCollection, Prompt, PromptsCollection, AgentExecuteInput, AgentExecuteContext, AgentExecuteResult, GenerationEvent, Unsubscribe } from './contracts.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,EACN,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,gCAAgC,EAChC,8BAA8B,EAC9B,0BAA0B,EAC1B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACX,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACX,KAAK,EACL,gBAAgB,EAChB,IAAI,EACJ,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,MAAM,gBAAgB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,9 @@
+// @vibesdotdev/tools/client
+// Canonical Tools client (one-client-per-module pattern from
+// `@vibesdotdev/kernel/client`). Registered as `runtime/client` id=`'tools'`
+// by `tools.plugin.ts`. Owns agents, tools, prompts — including the full
+// CRUD + subscribe surface.
+export { ToolsClient } from "./runtime-client.js";
+export { getVibesToolsClient } from "./helper.js";
+export { TOOLS_CATALOG_CAPABILITY_ID, RendererToolSummarySchema, RendererToolsCatalogSchema, projectToolSummaryForRenderer, projectToolsCatalogForRenderer, toolsCatalogCapabilityDescriptor, toolsCatalogCapabilityExposure, toolsCatalogCapabilityKind } from "./tool-catalog-capability.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,6DAA6D;AAC7D,6EAA6E;AAC7E,yEAAyE;AACzE,4BAA4B;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EACN,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,gCAAgC,EAChC,8BAA8B,EAC9B,0BAA0B,EAC1B,MAAM,8BAA8B,CAAC"}

package/dist/client/runtime-client.d.ts

@@ -0,0 +1,102 @@
+import { EncodingPolicies } from '../encoding/registry.ts';
+import { DashboardStatsCache } from '../dashboard-stats/tools/dashboard-stats/cache.ts';
+import { AgentConfigService } from '../agents/client/config.ts';
+import { PromptTestPreferencesService } from '../prompts/services/prompt-test-preferences.ts';
+import type { AgentSummary } from './schemas/index.ts';
+export type { AgentSummary } from './schemas/index.ts';
+import { type CaughtFailure, type KindContext, type VibesRuntime } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import type { AIAgentInstanceDescriptor } from '@vibesdotdev/tools/agents/schemas/descriptor';
+import type { PromptsManifestDescriptor } from '@vibesdotdev/ai-schemas';
+import { type AIToolDescriptor } from '../tools/schemas/tool-descriptor.ts';
+import type { ToolAssetDescriptor } from '../schemas/runtime/descriptors.ts';
+import type { ToolAdapterDescriptor } from '../schemas/adapter.ts';
+import type { ToolProviderDescriptor } from '../schemas/provider.ts';
+import { AgentsCollection, PromptsCollection, ToolsCollection } from './collections.ts';
+import { WebhooksCollection } from './webhooks-collection.ts';
+import { ToolApprovalClient } from '../agents/approval/approval-client.ts';
+import type { Agent } from './schemas/contracts.ts';
+import type { RuntimeClientOptions } from './schemas/runtime-client.ts';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+export type { Agent, AgentsCollection, PromptsCollection, ToolsCollection, WebhooksCollection };
+export type { ToolApprovalClient };
+export type { ApprovalDescriptorSignal } from '../agents/approval/approval-client.ts';
+export type { RuntimeClientOptions };
+export type { AIAgentInstanceDescriptor, PromptsManifestDescriptor, AIToolDescriptor };
+/**
+ * The Tools client names `VibesRuntime` as its runtime port (Runtime SPEC
+ * `./client`: a client needing more than `RuntimeRef` names that port; the
+ * kernel injects the genuine resolving runtime). It needs members `RuntimeRef`
+ * does not carry: the tool invocation pipeline (`acquireInvocation`,
+ * `runInvocation`, `assets`, `resolve`) behind `invokeSystemTool` and agent
+ * tool providers, lazy descriptor hydration (`descriptorsAsync`) for webhook
+ * event definitions, and `implementationOrigin`.
+ */
+export declare class ToolsClient extends BaseRuntimeClient<VibesRuntime> {
+    readonly agents: AgentsCollection;
+    readonly tools: ToolsCollection;
+    readonly prompts: PromptsCollection;
+    readonly webhooks: WebhooksCollection;
+    /** The approval runtime: policy, gate resolution and typed decisions (see approval-client.ts). */
+    readonly approval: ToolApprovalClient;
+    readonly agentConfig: AgentConfigService;
+    readonly surfaceRefreshers: Map<object, () => Promise<void>>;
+    readonly encoding: EncodingPolicies;
+    readonly dashboardStats: DashboardStatsCache;
+    readonly tierWarnings: {
+        missingCapability: Set<string>;
+        anyHost: Set<string>;
+    };
+    readonly promptTestPreferences: PromptTestPreferencesService;
+    private readonly retireState;
+    constructor(descriptor?: RuntimeClientDescriptor, context?: KindContext<VibesRuntime>, runtime?: VibesRuntime);
+    protected onDispose(): void;
+    listAgents(): Promise<Agent[]>;
+    getAgent(id: string): Promise<Agent | null>;
+    listTools(): Promise<import("./contracts.ts").Tool[]>;
+    /** System tool descriptors registered in the active runtime. */
+    listSystemTools(): Promise<ToolAssetDescriptor[]>;
+    /** One system-tool descriptor from the live owner catalog. */
+    getSystemToolDescriptor(id: string): Promise<ToolAssetDescriptor | null>;
+    /**
+     * Host-resolved implementation origin for diagnostics and source viewers.
+     * The Tools owner keeps kind/id knowledge here; callers decide whether their
+     * environment is allowed to read the returned local path.
+     */
+    getSystemToolImplementationOrigin(id: string): string | null;
+    /** Tool adapter descriptors registered in the active runtime. */
+    listAdapters(): Promise<ToolAdapterDescriptor[]>;
+    /** Tool provider descriptors registered in the active runtime. */
+    listProviders(): Promise<ToolProviderDescriptor[]>;
+    getTool(id: string): Promise<import("./contracts.ts").Tool | null>;
+    listPrompts(): Promise<import("./contracts.ts").Prompt[]>;
+    getPrompt(id: string): Promise<import("./contracts.ts").Prompt | null>;
+    listAgentSummaries(query?: string): Promise<AgentSummary[]>;
+    getAgentSummary(id: string): Promise<AgentSummary | null>;
+    /**
+     * Resolve a tool implementation by id. `Impl` is the implementation type
+     * the caller expects (the runtime's typed query); unnamed, it is `unknown`.
+     *
+     * Tries `tools/tool`, then custom `ai/tool` → linked systemToolId, then bare
+     * `ai/tool`. Missing-tool errors fall through the chain; **other** resolve
+     * failures (kind unregistered, loader crash) rethrow so callers never
+     * confuse a broken registry with "tool not found" (constitution rule 13).
+     */
+    resolveTool<Impl>(id: string): Promise<Impl>;
+    /**
+     * Invoke a system tool through the canonical Tools execution pipeline. The
+     * pipeline parses `input`; `Output` is the result type the caller expects
+     * (unnamed, `unknown`).
+     */
+    invokeSystemTool<Input, Output = unknown>(id: string, input: Input, context: ToolCallContext): Promise<Output>;
+}
+/**
+ * True when resolve failed because the id is absent — safe to try the next
+ * lookup. Loader/kind injuries are false so they surface to the caller.
+ *
+ * Important: "No implementation registered" is a **zombie descriptor** injury
+ * (descriptor present, loader missing) — NOT missing. Fallthrough would hide
+ * the real fix (registerLoader).
+ */
+export declare function isMissingToolResolveError(failure: CaughtFailure): boolean;
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/client/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../../src/client/runtime-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAGN,KAAK,aAAa,EAClB,KAAK,WAAW,EAGhB,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAC9F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC;AAChG,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,YAAY,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACtF,YAAY,EAAE,oBAAoB,EAAE,CAAC;AACrC,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,CAAC;AAWvF;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,iBAAiB,CAAC,YAAY,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,iBAAiB,oBAAyB,OAAO,CAAC,IAAI,CAAC,EAAI;IACpE,QAAQ,CAAC,QAAQ,mBAA0B;IAC3C,QAAQ,CAAC,cAAc,sBAA6B;IACpD,QAAQ,CAAC,YAAY;;;MAGnB;IACF,QAAQ,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IAE7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAGrD,UAAU,GAAE,uBAAiE,EAC7E,OAAO,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,EACnC,OAAO,CAAC,EAAE,YAAY;cAcJ,SAAS,IAAI,IAAI;IAU9B,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI9B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAI3C,SAAS;IAKf,gEAAgE;IAC1D,eAAe,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAKvD,8DAA8D;IACxD,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAK9E;;;;OAIG;IACH,iCAAiC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK5D,iEAAiE;IAC3D,YAAY,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKtD,kEAAkE;IAC5D,aAAa,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKlD,OAAO,CAAC,EAAE,EAAE,MAAM;IAIlB,WAAW;IAIX,SAAS,CAAC,EAAE,EAAE,MAAM;IAIpB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAY3D,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK/D;;;;;;;;OAQG;IACG,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyClD;;;;OAIG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAC7C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC;CAQlB;AAgBD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAWzE"}

package/dist/client/runtime-client.js

@@ -0,0 +1,228 @@
+import { EncodingPolicies } from "../encoding/registry.js";
+import { DashboardStatsCache } from "../dashboard-stats/tools/dashboard-stats/cache.js";
+import { AgentConfigService } from "../agents/client/config.js";
+import { PromptTestPreferencesService } from "../prompts/services/prompt-test-preferences.js";
+import * as z from 'zod/v4';
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { AIToolDescriptorSchema } from "../tools/schemas/tool-descriptor.js";
+import { AgentsCollection, PromptsCollection, ToolsCollection } from "./collections.js";
+import { WebhooksCollection } from "./webhooks-collection.js";
+import { ToolApprovalClient } from "../agents/approval/approval-client.js";
+import { invokeTool } from "../execution/invoke.js";
+import { callerFromRuntimeScope } from "../execution/caller-invocation.js";
+/** The link a custom `ai/tool` may carry to the system tool it wraps. */
+const CustomToolLinkSchema = AIToolDescriptorSchema.pick({ systemToolId: true, sourceToolId: true });
+/** A legacy `isActive` stamp an agent record may still carry beside its typed fields. */
+const LegacyActivityStampSchema = z.object({ isActive: z.boolean().optional().catch(undefined) });
+/**
+ * The Tools client names `VibesRuntime` as its runtime port (Runtime SPEC
+ * `./client`: a client needing more than `RuntimeRef` names that port; the
+ * kernel injects the genuine resolving runtime). It needs members `RuntimeRef`
+ * does not carry: the tool invocation pipeline (`acquireInvocation`,
+ * `runInvocation`, `assets`, `resolve`) behind `invokeSystemTool` and agent
+ * tool providers, lazy descriptor hydration (`descriptorsAsync`) for webhook
+ * event definitions, and `implementationOrigin`.
+ */
+export class ToolsClient extends BaseRuntimeClient {
+    agents;
+    tools;
+    prompts;
+    webhooks;
+    /** The approval runtime: policy, gate resolution and typed decisions (see approval-client.ts). */
+    approval;
+    agentConfig;
+    surfaceRefreshers = new Map();
+    encoding = new EncodingPolicies();
+    dashboardStats = new DashboardStatsCache();
+    tierWarnings = {
+        missingCapability: new Set(),
+        anyHost: new Set()
+    };
+    promptTestPreferences;
+    retireState = () => this.onDispose();
+    constructor(descriptor = { id: 'tools', kind: 'runtime/client' }, context, runtime) {
+        super(descriptor, context, runtime);
+        this.agents = new AgentsCollection(this.runtime);
+        this.tools = new ToolsCollection(this.runtime);
+        this.prompts = new PromptsCollection(this.runtime);
+        this.webhooks = new WebhooksCollection(this.runtime);
+        this.approval = new ToolApprovalClient(this.runtime);
+        this.agentConfig = new AgentConfigService(this.runtime);
+        this.promptTestPreferences = new PromptTestPreferencesService(this.runtime);
+        if (this.runtime.lifecycle?.signal.aborted)
+            this.onDispose();
+        else
+            this.runtime.lifecycle?.signal.addEventListener('abort', this.retireState, { once: true });
+    }
+    onDispose() {
+        this.runtime.lifecycle?.signal.removeEventListener('abort', this.retireState);
+        this.approval.dispose();
+        this.encoding.dispose();
+        this.surfaceRefreshers.clear();
+        this.dashboardStats.dispose();
+        this.tierWarnings.missingCapability.clear();
+        this.tierWarnings.anyHost.clear();
+    }
+    async listAgents() {
+        return this.agents.list();
+    }
+    async getAgent(id) {
+        return this.agents.get(id);
+    }
+    async listTools() {
+        if (!this.runtime.hasKind('ai/tool'))
+            return [];
+        return this.tools.list();
+    }
+    /** System tool descriptors registered in the active runtime. */
+    async listSystemTools() {
+        if (!this.runtime.hasKind('tools/tool'))
+            return [];
+        return this.runtime.query('tools/tool').enabled().descriptors();
+    }
+    /** One system-tool descriptor from the live owner catalog. */
+    async getSystemToolDescriptor(id) {
+        if (!this.runtime.hasKind('tools/tool'))
+            return null;
+        return this.runtime.query('tools/tool').withId(id).enabled().firstDescriptor();
+    }
+    /**
+     * Host-resolved implementation origin for diagnostics and source viewers.
+     * The Tools owner keeps kind/id knowledge here; callers decide whether their
+     * environment is allowed to read the returned local path.
+     */
+    getSystemToolImplementationOrigin(id) {
+        if (!this.runtime.hasKind('tools/tool'))
+            return null;
+        return this.runtime.implementationOrigin('tools/tool', id) ?? null;
+    }
+    /** Tool adapter descriptors registered in the active runtime. */
+    async listAdapters() {
+        if (!this.runtime.hasKind('tools/adapter'))
+            return [];
+        return this.runtime.query('tools/adapter').enabled().descriptors();
+    }
+    /** Tool provider descriptors registered in the active runtime. */
+    async listProviders() {
+        if (!this.runtime.hasKind('tools/provider'))
+            return [];
+        return this.runtime.query('tools/provider').enabled().descriptors();
+    }
+    async getTool(id) {
+        return this.tools.get(id);
+    }
+    async listPrompts() {
+        return this.prompts.list();
+    }
+    async getPrompt(id) {
+        return this.prompts.get(id);
+    }
+    async listAgentSummaries(query) {
+        const entities = await this.agents.list();
+        let items = entities.map((e) => toAgentSummary(e.descriptor));
+        if (query) {
+            const q = query.toLowerCase();
+            items = items.filter((a) => a.name.toLowerCase().includes(q) || (a.description ?? '').toLowerCase().includes(q));
+        }
+        return items;
+    }
+    async getAgentSummary(id) {
+        const entity = await this.agents.get(id);
+        return entity ? toAgentSummary(entity.descriptor) : null;
+    }
+    /**
+     * Resolve a tool implementation by id. `Impl` is the implementation type
+     * the caller expects (the runtime's typed query); unnamed, it is `unknown`.
+     *
+     * Tries `tools/tool`, then custom `ai/tool` → linked systemToolId, then bare
+     * `ai/tool`. Missing-tool errors fall through the chain; **other** resolve
+     * failures (kind unregistered, loader crash) rethrow so callers never
+     * confuse a broken registry with "tool not found" (constitution rule 13).
+     */
+    async resolveTool(id) {
+        const hasToolsKind = this.runtime.hasKind('tools/tool');
+        const hasAiToolKind = this.runtime.hasKind('ai/tool');
+        if (!hasToolsKind && !hasAiToolKind) {
+            throw new Error(`Cannot resolve tool "${id}": neither tools/tool nor ai/tool is registered in this runtime. ` +
+                `Register the tools plugin (or ai/tool surface) in this app's vibes.config chain.`);
+        }
+        let miss;
+        if (hasToolsKind) {
+            const direct = await attemptToolResolve(() => this.runtime.query('tools/tool').withId(id).resolve());
+            if (direct.found)
+                return direct.impl;
+            miss = direct.miss;
+        }
+        if (hasAiToolKind) {
+            const link = CustomToolLinkSchema.safeParse(this.runtime.query('ai/tool').withId(id).firstDescriptor());
+            const linkedToolId = link.success
+                ? (link.data.systemToolId ?? link.data.sourceToolId ?? null)
+                : null;
+            if (linkedToolId && hasToolsKind) {
+                const linked = await attemptToolResolve(() => this.runtime.query('tools/tool').withId(linkedToolId).resolve());
+                if (linked.found)
+                    return linked.impl;
+            }
+            return this.runtime.query('ai/tool').withId(id).resolve();
+        }
+        throw new Error(`Tool "${id}" was not found under tools/tool and ai/tool is not registered.`, {
+            cause: miss
+        });
+    }
+    /**
+     * Invoke a system tool through the canonical Tools execution pipeline. The
+     * pipeline parses `input`; `Output` is the result type the caller expects
+     * (unnamed, `unknown`).
+     */
+    async invokeSystemTool(id, input, context) {
+        // A call carries who makes it: a context without a caller runs as the
+        // caller this runtime's scope names (the launching harness, the bound
+        // seat), so caller admission sees it like any other surface's call.
+        const caller = context.caller ?? (await callerFromRuntimeScope(this.runtime));
+        const ctx = caller && caller !== context.caller ? { ...context, caller } : context;
+        return invokeTool({ runtime: this.runtime, toolId: id, input, ctx });
+    }
+}
+/**
+ * One step of the tool fallback chain. A miss (`isMissingToolResolveError`) is
+ * kept value-free so the next lookup can run; any other failure rethrows.
+ */
+async function attemptToolResolve(resolve) {
+    try {
+        return { found: true, impl: await resolve() };
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (!isMissingToolResolveError(failure))
+            throw error;
+        return { found: false, miss: valueFreeFailure(failure) };
+    }
+}
+/**
+ * True when resolve failed because the id is absent — safe to try the next
+ * lookup. Loader/kind injuries are false so they surface to the caller.
+ *
+ * Important: "No implementation registered" is a **zombie descriptor** injury
+ * (descriptor present, loader missing) — NOT missing. Fallthrough would hide
+ * the real fix (registerLoader).
+ */
+export function isMissingToolResolveError(failure) {
+    const message = failure instanceof Error ? failure.message : failure.description;
+    // Injuries first — never classify as missing.
+    if (/no implementation registered|kind is not registered|failed to load module|permission denied/i.test(message)) {
+        return false;
+    }
+    return /not found|no descriptor|unknown tool|Cannot find|does not exist/i.test(message);
+}
+function toAgentSummary(descriptor) {
+    const stamp = LegacyActivityStampSchema.safeParse(descriptor);
+    return {
+        id: descriptor.id,
+        name: descriptor.name,
+        description: descriptor.description,
+        agentType: descriptor.agentType,
+        isActive: stamp.success ? stamp.data.isActive : undefined
+    };
+}
+//# sourceMappingURL=runtime-client.js.map

package/dist/client/runtime-client.js.map

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

package/dist/client/schemas/collection-helpers.d.ts

@@ -0,0 +1,2 @@
+export type Unsubscribe = () => void;
+//# sourceMappingURL=collection-helpers.d.ts.map

package/dist/client/schemas/collection-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-helpers.d.ts","sourceRoot":"","sources":["../../../src/client/schemas/collection-helpers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}

package/dist/client/schemas/collection-helpers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=collection-helpers.js.map

package/dist/client/schemas/collection-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-helpers.js","sourceRoot":"","sources":["../../../src/client/schemas/collection-helpers.ts"],"names":[],"mappings":""}

package/dist/client/schemas/contracts.d.ts

@@ -0,0 +1,52 @@
+import type { AIAgentInstanceDescriptor } from '@vibesdotdev/tools/agents/schemas/descriptor';
+import type { PromptRenderContextInput, PromptsManifestDescriptor } from '@vibesdotdev/ai-schemas';
+import type { AIToolDescriptor } from '../../tools/schemas/tool-descriptor.ts';
+import type { AgentExecuteContext, AgentExecuteInput, AgentExecuteResult, GenerationEvent } from '../contracts.ts';
+export interface Agent {
+    id: string;
+    name: string;
+    description?: string;
+    descriptor: AIAgentInstanceDescriptor;
+    save(patch: Partial<AIAgentInstanceDescriptor>): Promise<void>;
+    remove(): Promise<void>;
+    execute(input: AgentExecuteInput, ctx?: AgentExecuteContext): Promise<AgentExecuteResult>;
+    stream(input: AgentExecuteInput, ctx?: AgentExecuteContext): AsyncGenerator<GenerationEvent>;
+}
+export interface AgentsCollection {
+    list(): Promise<Agent[]>;
+    get(id: string): Promise<Agent | null>;
+    save(input: AIAgentInstanceDescriptor): Promise<Agent>;
+    remove(id: string): Promise<boolean>;
+    subscribe(cb: (items: Agent[]) => void): Unsubscribe;
+}
+export interface Tool {
+    id: string;
+    name: string;
+    description?: string;
+    descriptor: AIToolDescriptor;
+    save(patch: Partial<AIToolDescriptor>): Promise<void>;
+    remove(): Promise<void>;
+}
+export interface ToolsCollection {
+    list(): Promise<Tool[]>;
+    get(id: string): Promise<Tool | null>;
+    save(input: AIToolDescriptor): Promise<Tool>;
+    remove(id: string): Promise<boolean>;
+    subscribe(cb: (items: Tool[]) => void): Unsubscribe;
+}
+/** A registered `prompts/manifest` prompt; writes go through the prompts client. */
+export interface Prompt {
+    id: string;
+    name: string;
+    description?: string;
+    descriptor: PromptsManifestDescriptor;
+    render(context?: PromptRenderContextInput): Promise<string>;
+}
+/** Read view of THE prompts kind; create/update/delete belong to `getVibesPromptsClient`. */
+export interface PromptsCollection {
+    list(): Promise<Prompt[]>;
+    get(id: string): Promise<Prompt | null>;
+    subscribe(cb: (items: Prompt[]) => void): Unsubscribe;
+}
+export type Unsubscribe = () => void;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/client/schemas/contracts.d.ts.map

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

package/dist/client/schemas/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/client/schemas/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/client/schemas/contracts.ts"],"names":[],"mappings":""}

package/dist/client/schemas/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Client Contracts Schemas
+ */
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+import type { AIAgentInstanceDescriptor } from '@vibesdotdev/tools/agents/schemas/descriptor';
+import type { PromptRenderContextInput, PromptsManifestDescriptor } from '@vibesdotdev/ai-schemas';
+import type { AIToolDescriptor } from '../../tools/schemas/tool-descriptor.ts';
+import type { AgentExecuteContext, AgentExecuteInput, AgentExecuteResult, GenerationEvent } from '../contracts.ts';
+export type Unsubscribe = () => void;
+export interface Agent {
+    descriptor: AIAgentInstanceDescriptor;
+    save(patch: Partial<AIAgentInstanceDescriptor>): Promise<void>;
+    remove(): Promise<void>;
+    execute(input: AgentExecuteInput, ctx?: AgentExecuteContext): Promise<AgentExecuteResult>;
+    stream(input: AgentExecuteInput, ctx?: AgentExecuteContext): AsyncGenerator<GenerationEvent>;
+}
+export interface AgentsCollection {
+    list(): Promise<Agent[]>;
+    get(id: string): Promise<Agent | null>;
+    save(input: AIAgentInstanceDescriptor): Promise<Agent>;
+    remove(id: string): Promise<boolean>;
+    subscribe(cb: (items: Agent[]) => void): Unsubscribe;
+}
+export interface Tool {
+    descriptor: AIToolDescriptor;
+    save(patch: Partial<AIToolDescriptor>): Promise<void>;
+    remove(): Promise<void>;
+}
+export interface ToolsCollection {
+    list(): Promise<Tool[]>;
+    get(id: string): Promise<Tool | null>;
+    save(input: AIToolDescriptor): Promise<Tool>;
+    remove(id: string): Promise<boolean>;
+    subscribe(cb: (items: Tool[]) => void): Unsubscribe;
+}
+/** A registered `prompts/manifest` prompt; writes go through the prompts client. */
+export interface Prompt {
+    id: string;
+    name: string;
+    description?: string;
+    descriptor: PromptsManifestDescriptor;
+    render(context?: PromptRenderContextInput): Promise<string>;
+}
+/** Read view of THE prompts kind; create/update/delete belong to `getVibesPromptsClient`. */
+export interface PromptsCollection {
+    list(): Promise<Prompt[]>;
+    get(id: string): Promise<Prompt | null>;
+    subscribe(cb: (items: Prompt[]) => void): Unsubscribe;
+}
+export type CollectionFilter = {
+    where?: JsonObject;
+    orderBy?: string;
+    limit?: number;
+    offset?: number;
+};
+export interface RuntimeClientConfig {
+    apiUrl: string;
+    apiToken?: string;
+}
+export interface AgentSummary {
+    id: string;
+    name: string;
+    status?: string;
+    createdAt?: string;
+    description?: string;
+    agentType?: string;
+    isActive?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/schemas/index.d.ts.map

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

package/dist/client/schemas/index.js

@@ -0,0 +1,5 @@
+/**
+ * Client Contracts Schemas
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/client/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/client/schemas/runtime-client.d.ts

@@ -0,0 +1,4 @@
+export interface RuntimeClientOptions {
+    runtime: import('@vibesdotdev/kernel').VibesRuntime;
+}
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/client/schemas/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../../../src/client/schemas/runtime-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;CACpD"}

package/dist/client/schemas/runtime-client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-client.js.map

package/dist/client/schemas/runtime-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.js","sourceRoot":"","sources":["../../../src/client/schemas/runtime-client.ts"],"names":[],"mappings":""}

package/dist/client/sse-client.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Re-export of the canonical SSE client from `@vibesdotdev/client`.
+ *
+ * The implementation lives in `client/src/sse-client.ts` so apps and
+ * shared packages share a single browser SSE primitive.
+ */
+export { SSEClient, createSSEClient, type SSEClientOptions, type SSEConnectionStatus } from '@vibesdotdev/client';
+//# sourceMappingURL=sse-client.d.ts.map

package/dist/client/sse-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/client/sse-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,SAAS,EACT,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,MAAM,qBAAqB,CAAC"}

package/dist/client/sse-client.js

@@ -0,0 +1,8 @@
+/**
+ * Re-export of the canonical SSE client from `@vibesdotdev/client`.
+ *
+ * The implementation lives in `client/src/sse-client.ts` so apps and
+ * shared packages share a single browser SSE primitive.
+ */
+export { SSEClient, createSSEClient } from '@vibesdotdev/client';
+//# sourceMappingURL=sse-client.js.map

package/dist/client/sse-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.js","sourceRoot":"","sources":["../../src/client/sse-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,SAAS,EACT,eAAe,EAGf,MAAM,qBAAqB,CAAC"}