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

package/dist/tools.plugin-kinds.d.ts

@@ -0,0 +1,142 @@
+/**
+ * The tools kinds and client registration the root plugins share.
+ *
+ * `tools.plugin.ts` (consumer), `tools.cloud.plugin.ts` and
+ * `tools.browser.plugin.ts` register the same adapter, provider and UI kinds
+ * and the same canonical `runtime/client` id `tools`; they differ in what they
+ * add around them, so the shared pieces live here once.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel/factory/plugin';
+import { resolveAdapterBySurface, resolveToolUI, DefaultToolAdapterRuntime, DefaultToolProviderRuntime, DefaultToolUI } from './shared/tool-kind-resolvers.ts';
+export declare const toolAdapterKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+        capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+        requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+            maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+            ageField: import("zod").ZodOptional<import("zod").ZodString>;
+            reason: import("zod").ZodString;
+            enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>]>>;
+        kind: import("zod").ZodLiteral<"tools/adapter">;
+        surfaces: import("zod").ZodArray<import("zod").ZodEnum<{
+            agent: "agent";
+            cli: "cli";
+            tui: "tui";
+            worker: "worker";
+            mcp: "mcp";
+            api: "api";
+            skill: "skill";
+            opencode: "opencode";
+        }>>;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+    }, import("zod/v4/core").$strip>;
+    defaultImplementation: typeof DefaultToolAdapterRuntime;
+    resolve: typeof resolveAdapterBySurface;
+    contexts: string[];
+};
+export declare const toolProviderKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+        capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+        requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+            maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+            ageField: import("zod").ZodOptional<import("zod").ZodString>;
+            reason: import("zod").ZodString;
+            enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>]>>;
+        kind: import("zod").ZodLiteral<"tools/provider">;
+        capabilities: import("zod").ZodObject<{
+            watchable: import("zod").ZodBoolean;
+            writable: import("zod").ZodBoolean;
+            remote: import("zod").ZodBoolean;
+        }, import("zod/v4/core").$strip>;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+    }, import("zod/v4/core").$strip>;
+    defaultImplementation: typeof DefaultToolProviderRuntime;
+    contexts: string[];
+};
+export declare const toolUIKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        enabled: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        priority: import("zod").ZodOptional<import("zod").ZodNumber>;
+        capabilityId: import("zod").ZodOptional<import("zod").ZodString>;
+        requiredContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        optionalContext: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        config: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        retention: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+            maxAgeDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            cascadeFrom: import("zod").ZodOptional<import("zod").ZodString>;
+            ageField: import("zod").ZodOptional<import("zod").ZodString>;
+            reason: import("zod").ZodString;
+            enforcedBy: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>]>>;
+        kind: import("zod").ZodLiteral<"tools/ui">;
+        surfaces: import("zod").ZodArray<import("zod").ZodEnum<{
+            cli: "cli";
+            tui: "tui";
+            worker: "worker";
+            bridge: "bridge";
+            web: "web";
+        }>>;
+        hardware: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            consumer: "consumer";
+            cloud: "cloud";
+        }>>>;
+        targetId: import("zod").ZodOptional<import("zod").ZodString>;
+        role: import("zod").ZodEnum<{
+            approval: "approval";
+            badge: "badge";
+            widget: "widget";
+        }>;
+        targetToolId: import("zod").ZodString;
+        placement: import("zod").ZodOptional<import("zod").ZodEnum<{
+            inline: "inline";
+            top: "top";
+            bottom: "bottom";
+        }>>;
+    }, import("zod/v4/core").$strip>;
+    defaultImplementation: typeof DefaultToolUI;
+    resolve: typeof resolveToolUI;
+    contexts: readonly [];
+};
+/** Register the canonical `runtime/client` id `tools`, loading `ToolsClient` on first resolve. */
+export declare function registerToolsRuntimeClient(runtime: RuntimeRef, description?: string): void;
+//# sourceMappingURL=tools.plugin-kinds.d.ts.map

package/dist/tools.plugin-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.plugin-kinds.d.ts","sourceRoot":"","sources":["../src/tools.plugin-kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAIrE,OAAO,EACN,uBAAuB,EACvB,aAAa,EACb,yBAAyB,EACzB,0BAA0B,EAC1B,aAAa,EACb,MAAM,iCAAiC,CAAC;AAKzC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMiC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQiC,CAAC;AAE/D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMsC,CAAC;AAI9D,kGAAkG;AAClG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,SAA6B,GAAG,IAAI,CAM9G"}

package/dist/tools.plugin-kinds.js

@@ -0,0 +1,45 @@
+/**
+ * The tools kinds and client registration the root plugins share.
+ *
+ * `tools.plugin.ts` (consumer), `tools.cloud.plugin.ts` and
+ * `tools.browser.plugin.ts` register the same adapter, provider and UI kinds
+ * and the same canonical `runtime/client` id `tools`; they differ in what they
+ * add around them, so the shared pieces live here once.
+ */
+import { ToolAdapterDescriptorSchema } from "./schemas/adapter.js";
+import { ToolProviderDescriptorSchema } from "./schemas/provider.js";
+import { ToolUIDescriptorSchema } from "./schemas/ui.js";
+import { resolveAdapterBySurface, resolveToolUI, DefaultToolAdapterRuntime, DefaultToolProviderRuntime, DefaultToolUI } from "./shared/tool-kind-resolvers.js";
+export const toolAdapterKind = {
+    id: 'tools/adapter',
+    descriptorSchema: ToolAdapterDescriptorSchema,
+    defaultImplementation: DefaultToolAdapterRuntime,
+    resolve: resolveAdapterBySurface,
+    contexts: ['runtime/workspace-path']
+};
+export const toolProviderKind = {
+    id: 'tools/provider',
+    descriptorSchema: ToolProviderDescriptorSchema,
+    defaultImplementation: DefaultToolProviderRuntime,
+    // `app/api-client` is NOT required at the kind level: no surface registers
+    // a context provider for it, and only the API provider consumes it — that
+    // descriptor declares it via `optionalContext` (see tool-provider.api.descriptor.ts).
+    contexts: ['runtime/workspace-path']
+};
+export const toolUIKind = {
+    id: 'tools/ui',
+    descriptorSchema: ToolUIDescriptorSchema,
+    defaultImplementation: DefaultToolUI,
+    resolve: resolveToolUI,
+    contexts: []
+};
+const DEFAULT_CLIENT_DESCRIPTION = 'Canonical Tools client — agents, prompts, tools (read surface + resolution)';
+/** Register the canonical `runtime/client` id `tools`, loading `ToolsClient` on first resolve. */
+export function registerToolsRuntimeClient(runtime, description = DEFAULT_CLIENT_DESCRIPTION) {
+    runtime.registerDescriptor('runtime/client', { id: 'tools', kind: 'runtime/client', description });
+    runtime.registerLoader('runtime/client', 'tools', async () => {
+        const { ToolsClient } = await import("./client/runtime-client.js");
+        return { impl: ToolsClient };
+    });
+}
+//# sourceMappingURL=tools.plugin-kinds.js.map

package/dist/tools.plugin-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.plugin-kinds.js","sourceRoot":"","sources":["../src/tools.plugin-kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACN,uBAAuB,EACvB,aAAa,EACb,yBAAyB,EACzB,0BAA0B,EAC1B,aAAa,EACb,MAAM,iCAAiC,CAAC;AAKzC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,EAAE,EAAE,eAAe;IACnB,gBAAgB,EAAE,2BAA2B;IAC7C,qBAAqB,EAAE,yBAAyB;IAChD,OAAO,EAAE,uBAAuB;IAChC,QAAQ,EAAE,CAAC,wBAAwB,CAAC;CACwB,CAAC;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,EAAE,EAAE,gBAAgB;IACpB,gBAAgB,EAAE,4BAA4B;IAC9C,qBAAqB,EAAE,0BAA0B;IACjD,2EAA2E;IAC3E,0EAA0E;IAC1E,sFAAsF;IACtF,QAAQ,EAAE,CAAC,wBAAwB,CAAC;CACyB,CAAC;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,EAAE,EAAE,UAAU;IACd,gBAAgB,EAAE,sBAAsB;IACxC,qBAAqB,EAAE,aAAa;IACpC,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,EAAW;CACuC,CAAC;AAE9D,MAAM,0BAA0B,GAAG,6EAA6E,CAAC;AAEjH,kGAAkG;AAClG,MAAM,UAAU,0BAA0B,CAAC,OAAmB,EAAE,WAAW,GAAG,0BAA0B;IACvG,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC;IACnG,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools.plugin.d.ts

@@ -0,0 +1,3 @@
+/** Compatible consumer plugin entrypoint. */
+export { default } from './tools.consumer.plugin.ts';
+//# sourceMappingURL=tools.plugin.d.ts.map

package/dist/tools.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.plugin.d.ts","sourceRoot":"","sources":["../src/tools.plugin.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/tools.plugin.js

@@ -0,0 +1,3 @@
+/** Compatible consumer plugin entrypoint. */
+export { default } from "./tools.consumer.plugin.js";
+//# sourceMappingURL=tools.plugin.js.map

package/dist/tools.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.plugin.js","sourceRoot":"","sources":["../src/tools.plugin.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC"}