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

package/dist/hints/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/hints/model.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,qCAAqC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tools Module - Public Exports
+ *
+ * Exports types and schemas safe for any build context.
+ */
+export { default as toolsPlugin } from './tools.universal.plugin.ts';
+export { ToolAdapterDescriptorSchema, ToolAdapterSurfaceSchema, type ToolAdapterDescriptor, type ToolAdapterSurface } from './schemas/adapter.ts';
+export { ToolProviderDescriptorSchema, ToolProviderCapabilitiesSchema, type ToolProviderDescriptor, type ToolProviderCapabilities } from './schemas/provider.ts';
+export { ToolCapabilityTierSchema, ToolCapabilityEgressSchema, ToolCapabilitySchema, type ToolCapabilityTier, type ToolCapabilityEgress, type ToolCapability } from './schemas/runtime/descriptors.ts';
+export type { ToolAdapterInterface, ToolAdapterContext, AdapterExecutionContext, ToolAdapterGenerateOptions, ToolAdapterGenerateResult } from './interfaces/adapter.ts';
+export type { ToolProviderInterface, ToolProviderContext, ToolChangeEvent } from './interfaces/provider.ts';
+export type { ToolSummary, UnifiedTool, ToolBindingSelection, ToolCatalogClient, ToolsSvelteData, ToolsSvelteLoadResult, ToolsStateInitOptions } from './ui/svelte-views.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,4BAA4B,EAC5B,8BAA8B,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACN,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EACX,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACX,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,MAAM,0BAA0B,CAAC;AAOlC,YAAY,EACX,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Tools Module - Public Exports
+ *
+ * Exports types and schemas safe for any build context.
+ */
+export { default as toolsPlugin } from "./tools.universal.plugin.js";
+// Schemas
+export { ToolAdapterDescriptorSchema, ToolAdapterSurfaceSchema } from "./schemas/adapter.js";
+export { ToolProviderDescriptorSchema, ToolProviderCapabilitiesSchema } from "./schemas/provider.js";
+// Capability schemas (Tier-spec per VIBES-12)
+export { ToolCapabilityTierSchema, ToolCapabilityEgressSchema, ToolCapabilitySchema } from "./schemas/runtime/descriptors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAErE,UAAU;AACV,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EAGxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,4BAA4B,EAC5B,8BAA8B,EAG9B,MAAM,uBAAuB,CAAC;AAE/B,8CAA8C;AAC9C,OAAO,EACN,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EAIpB,MAAM,kCAAkC,CAAC"}

package/dist/interfaces/adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tool Adapter Interface
+ */
+import type { RuntimeRef, VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolDescriptor } from '../kinds/tool.ts';
+import type { ToolExecutionInput, ToolExecutionResult, ToolJsonValue } from '../kinds/schemas/tool.ts';
+import type { ToolAdapterDescriptor } from '../schemas/adapter.ts';
+import type { AdapterExecutionContext, ToolAdapterGenerateOptions, ToolAdapterGenerateResult } from './schemas/adapter.ts';
+export type { ToolAdapterDescriptor as ToolAdapter } from '../schemas/adapter.ts';
+export type { AdapterExecutionContext, ToolAdapterGenerateOptions, ToolAdapterGenerateResult };
+export type ToolAdapterContext = AdapterExecutionContext;
+export interface FormattedToolDescriptor {
+    readonly skillName?: string;
+    readonly content?: string;
+    readonly references?: Record<string, string>;
+    readonly [key: string]: ToolJsonValue | Record<string, string> | undefined;
+}
+export interface ToolAdapterInterface {
+    readonly id: string;
+    readonly descriptor: ToolAdapterDescriptor;
+    /** Format `tool` for this adapter's surface; diagnostics go to the handed runtime's Logging. */
+    formatDescriptor(tool: ToolDescriptor, runtime: RuntimeRef): FormattedToolDescriptor | ToolJsonValue;
+    execute(tool: ToolDescriptor, input: ToolExecutionInput, context: AdapterExecutionContext): Promise<ToolExecutionResult>;
+    /**
+     * Optional codegen entry. When present, external pack codegen invokes this
+     * with {@link ToolAdapterGenerateOptions} instead of adapter-specific forks.
+     */
+    generate?(runtime: VibesRuntime, options: ToolAdapterGenerateOptions): Promise<ToolAdapterGenerateResult>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/interfaces/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/interfaces/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,qBAAqB,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAClF,YAAY,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC3E;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,gGAAgG;IAChG,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,GAAG,uBAAuB,GAAG,aAAa,CAAC;IACrG,OAAO,CACN,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACtC"}

package/dist/interfaces/adapter.js

@@ -0,0 +1,5 @@
+/**
+ * Tool Adapter Interface
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/interfaces/adapter.js.map

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

package/dist/interfaces/provider.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tool Provider Interface — public framework contract.
+ * Implementations resolve via runtime loaders (*.impl.*); never imported here.
+ */
+export type { ToolProviderInterface, ToolProviderContext, ToolChangeEvent, ToolProviderScanReport } from './schemas/provider.ts';
+//# sourceMappingURL=provider.d.ts.map

package/dist/interfaces/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/interfaces/provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACX,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,MAAM,uBAAuB,CAAC"}

package/dist/interfaces/provider.js

@@ -0,0 +1,6 @@
+/**
+ * Tool Provider Interface — public framework contract.
+ * Implementations resolve via runtime loaders (*.impl.*); never imported here.
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/interfaces/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/interfaces/provider.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/interfaces/schemas/adapter.d.ts

@@ -0,0 +1,56 @@
+import type { ToolDescriptor } from '../../kinds/tool.ts';
+import type { RuntimeScope } from '@vibesdotdev/kernel/schemas/scope';
+import type { VibesRuntime, RuntimeRef } from '@vibesdotdev/kernel';
+import type { ToolAdapterDescriptor } from '../../schemas/adapter.ts';
+import type { ToolExecutionInput, ToolExecutionResult, ToolJsonValue } from '../../kinds/schemas/tool.ts';
+export type AdapterContextValue = ToolJsonValue | RuntimeScope | VibesRuntime | undefined;
+export interface AdapterExecutionContext {
+    readonly toolCallId: string;
+    readonly toolId: string;
+    readonly runtime: VibesRuntime;
+    readonly scope: RuntimeScope;
+    readonly workspacePath?: string;
+    readonly [key: string]: AdapterContextValue;
+}
+export interface ToolAdapterGenerateOptions {
+    projectDir?: string;
+    outputDir?: string;
+    filter?: {
+        categories?: string[];
+        tags?: string[];
+        ids?: string[];
+    };
+    /** Filter used only by adapters that project individual tools. */
+    toolFilter?: {
+        categories?: string[];
+        tags?: string[];
+        ids?: string[];
+    };
+    /** External host identifier used to select target-scoped aggregate skills. */
+    targetId?: string;
+    dryRun?: boolean;
+    global?: boolean;
+    /**
+     * Opt in to projecting each registered tool into a generated SKILL.md.
+     * OFF unless strictly `true` — tool→skill projection is retired
+     * (docs/architecture/CONTEXT-ENGINEERING.md §"Retired: projecting every
+     * tool into a skill"). A tool's usage instructions belong in its
+     * `mcpDescription`, not a second generated copy of its JSON Schema.
+     */
+    includeTools?: boolean;
+}
+export interface ToolAdapterGenerateResult {
+    success: boolean;
+    message: string;
+    outputPath?: string;
+    generatedCount: number;
+    skippedCount?: number;
+}
+export interface ToolAdapterInterface {
+    readonly id: string;
+    readonly descriptor: ToolAdapterDescriptor;
+    formatDescriptor?(tool: ToolDescriptor, runtime: RuntimeRef): ToolJsonValue | Record<string, ToolJsonValue>;
+    execute(tool: ToolDescriptor, input: ToolExecutionInput, context: AdapterExecutionContext): Promise<ToolExecutionResult>;
+    generate?(runtime: VibesRuntime, options: ToolAdapterGenerateOptions): Promise<ToolAdapterGenerateResult>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/interfaces/schemas/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC5C;AAED,MAAM,WAAW,0BAA0B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;KACf,CAAC;IACF,kEAAkE;IAClE,UAAU,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;KACf,CAAC;IACF,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,gBAAgB,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5G,OAAO,CACN,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,QAAQ,CAAC,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACtC"}

package/dist/interfaces/schemas/adapter.js

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

package/dist/interfaces/schemas/adapter.js.map

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

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

@@ -0,0 +1,3 @@
+export * from './adapter.ts';
+export type { ToolProviderInterface, ToolProviderContext, ToolChangeEvent, ToolProviderScanReport } from './provider.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAI7B,YAAY,EACX,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,MAAM,eAAe,CAAC"}

package/dist/interfaces/schemas/index.js

@@ -0,0 +1,2 @@
+export * from "./adapter.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/interfaces/schemas/provider.d.ts

@@ -0,0 +1,57 @@
+import type { ToolDescriptor } from '../../kinds/tool.ts';
+import type { ToolProviderDescriptor } from '../../schemas/provider.ts';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export type ToolChangeEvent = {
+    type: 'added';
+    tool: ToolDescriptor;
+} | {
+    type: 'updated';
+    tool: ToolDescriptor;
+} | {
+    type: 'removed';
+    toolId: string;
+};
+/**
+ * Honesty report from a provider scan/load (rule 13).
+ * Optional on providers that can partially fail while still returning tools.
+ */
+export type ToolProviderScanReport = {
+    scannedFiles: number;
+    toolIds: string[];
+    failures: string[];
+    /**
+     * Absolute directories scanned this load (operator debug / tools scan --json).
+     * Optional — older providers omit it.
+     */
+    scannedPaths?: string[];
+};
+export interface ToolProviderInterface {
+    readonly id: string;
+    readonly descriptor: ToolProviderDescriptor;
+    loadTools(): Promise<ToolDescriptor[]>;
+    watch(callback: (event: ToolChangeEvent) => void): () => void;
+    /**
+     * Absolute source module path for a tool id discovered by this provider.
+     * Used by local catalog bootstrap / scan --load to register loaders without
+     * static imports of provider implementation modules (constitution: framework
+     * code resolves providers via runtime, never sibling *.impl.* paths).
+     */
+    getToolSourcePath?(toolId: string): string | undefined;
+    /** Last loadTools scan stats when the provider tracks partial failures. */
+    getLastScanReport?(): ToolProviderScanReport | undefined;
+}
+export type ProviderContextValue = string | number | boolean | null | undefined | ProviderContextValue[] | {
+    [key: string]: ProviderContextValue;
+};
+export interface ToolProviderContext {
+    /** The local runtime handed by the provider's host; never serialized as provider configuration. */
+    runtime?: VibesRuntime;
+    registry?: ProviderContextValue;
+    config?: Record<string, ProviderContextValue>;
+    apiClient?: ProviderContextValue;
+    db?: ProviderContextValue;
+    /** The bound workspace root, injected under the context id the `tools/provider` kind requires. */
+    'runtime/workspace-path'?: string;
+    [key: string]: ProviderContextValue | VibesRuntime;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/interfaces/schemas/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schemas/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D;;;;;OAKG;IACH,iBAAiB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,2EAA2E;IAC3E,iBAAiB,CAAC,IAAI,sBAAsB,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,MAAM,oBAAoB,GAC7B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,oBAAoB,EAAE,GACtB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAA;CAAE,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IACnC,mGAAmG;IACnG,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,EAAE,CAAC,EAAE,oBAAoB,CAAC;IAC1B,kGAAkG;IAClG,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,YAAY,CAAC;CACnD"}

package/dist/interfaces/schemas/provider.js

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

package/dist/interfaces/schemas/provider.js.map

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

package/dist/kinds/fetch-scan-cache.kind.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Fetch Scan Cache Kind Definition
+ *
+ * Implements kind 'tools/fetch-scan-cache' to decouple HTTP fetch from knowledge scan-cache.
+ */
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+export declare const FetchScanCacheDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodLiteral<"tools/fetch-scan-cache">;
+    version: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FetchScanCacheDescriptor = z.infer<typeof FetchScanCacheDescriptorSchema>;
+export declare const CachedScanSchema: z.ZodObject<{
+    requestId: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    finalUrl: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    pageTitle: z.ZodOptional<z.ZodString>;
+    pageText: z.ZodOptional<z.ZodString>;
+    pageTextTruncated: z.ZodOptional<z.ZodBoolean>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        href: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    analysisText: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    scannedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CachedScan = z.infer<typeof CachedScanSchema>;
+export declare const CreatedKnowledgeItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+export type CreatedKnowledgeItem = z.infer<typeof CreatedKnowledgeItemSchema>;
+export interface FetchScanCacheInterface {
+    lookupScan(url: string, context: {
+        runtime: VibesRuntime;
+        jwt?: string;
+        projectId?: string;
+    }, options: {
+        method: string;
+        forceRefresh?: boolean;
+        headers?: Record<string, string>;
+    }): Promise<CachedScan | null>;
+    persistScan(url: string, scan: {
+        finalUrl: string;
+        statusCode: number;
+        pageText: string;
+        mimeType: string;
+    }, context: {
+        runtime: VibesRuntime;
+        jwt?: string;
+        projectId?: string;
+    }, options: {
+        method: string;
+        headers?: Record<string, string>;
+    }): Promise<void>;
+    createKnowledgeItemFromScan(input: {
+        title: string;
+        content: string;
+        url: string;
+        knowledgeBaseId?: string;
+        projectId?: string;
+    }, context: {
+        runtime: VibesRuntime;
+        jwt?: string;
+    }): Promise<CreatedKnowledgeItem | null>;
+}
+export declare class DefaultFetchScanCacheImplementation implements FetchScanCacheInterface {
+    readonly id: string;
+    constructor(descriptor: RuntimeDescriptor, _context: KindContext);
+    private getKnowledgeOrigin;
+    lookupScan(url: string, context: {
+        runtime: VibesRuntime;
+        jwt?: string;
+        projectId?: string;
+    }, options: {
+        method: string;
+        forceRefresh?: boolean;
+        headers?: Record<string, string>;
+    }): Promise<CachedScan | null>;
+    persistScan(url: string, scan: {
+        finalUrl: string;
+        statusCode: number;
+        pageText: string;
+        mimeType: string;
+    }, context: {
+        runtime: VibesRuntime;
+        jwt?: string;
+        projectId?: string;
+    }, options: {
+        method: string;
+        headers?: Record<string, string>;
+    }): Promise<void>;
+    createKnowledgeItemFromScan(input: {
+        title: string;
+        content: string;
+        url: string;
+        knowledgeBaseId?: string;
+        projectId?: string;
+    }, context: {
+        runtime: VibesRuntime;
+        jwt?: string;
+    }): Promise<CreatedKnowledgeItem | null>;
+}
+export declare const fetchScanCacheDescriptor: {
+    readonly id: "fetch-scan-cache";
+    readonly kind: "tools/fetch-scan-cache";
+    readonly description: "Default HTTP fetch scan cache";
+};
+export declare const fetchScanCacheKind: {
+    id: string;
+    descriptorSchema: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodLiteral<"tools/fetch-scan-cache">;
+        version: z.ZodDefault<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    defaultImplementation: typeof DefaultFetchScanCacheImplementation;
+    contexts: readonly [];
+};
+//# sourceMappingURL=fetch-scan-cache.kind.d.ts.map

package/dist/kinds/fetch-scan-cache.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-scan-cache.kind.d.ts","sourceRoot":"","sources":["../../src/kinds/fetch-scan-cache.kind.ts"],"names":[],"mappings":"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"}

package/dist/kinds/fetch-scan-cache.kind.js

@@ -0,0 +1,236 @@
+/**
+ * Fetch Scan Cache Kind Definition
+ *
+ * Implements kind 'tools/fetch-scan-cache' to decouple HTTP fetch from knowledge scan-cache.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+export const FetchScanCacheDescriptorSchema = z.object({
+    id: z.string(),
+    kind: z.literal('tools/fetch-scan-cache'),
+    version: z.string().default('1.0.0'),
+    description: z.string().optional()
+});
+export const CachedScanSchema = z.object({
+    requestId: z.string().optional(),
+    url: z.string(),
+    finalUrl: z.string().optional(),
+    statusCode: z.number().optional(),
+    pageTitle: z.string().optional(),
+    pageText: z.string().optional(),
+    pageTextTruncated: z.boolean().optional(),
+    links: z.array(z.object({ href: z.string(), text: z.string() })).optional(),
+    analysisText: z.string().optional(),
+    mimeType: z.string().optional(),
+    scannedAt: z.string().optional()
+});
+export const CreatedKnowledgeItemSchema = z.object({
+    id: z.string(),
+    title: z.string()
+});
+const ScanLookupEnvelopeSchema = z.object({
+    hit: z.boolean().optional(),
+    scan: CachedScanSchema.optional()
+});
+const CreateItemEnvelopeSchema = z.object({
+    id: z.string(),
+    title: z.string().optional()
+});
+async function tryResolveKnowledgeOrigin(runtime) {
+    if (!runtime.hasKind('infra/service')) {
+        return {
+            ok: false,
+            failure: new CapabilityError('Service infra/service is not registered.', 'NOT_FOUND', {
+                reason: 'not-registered',
+                details: { id: 'infra/service' }
+            })
+        };
+    }
+    try {
+        const selected = await runtime
+            .query('infra/service')
+            .withId('knowledge')
+            .select();
+        if (!selected) {
+            return {
+                ok: false,
+                failure: new CapabilityError('Service knowledge is not declared.', 'NOT_FOUND', {
+                    reason: 'record-absent',
+                    details: { id: 'knowledge' }
+                })
+            };
+        }
+        const origin = await selected.impl.origin('primary');
+        return { ok: true, value: origin.replace(/\/$/, '') };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+async function tryFetchJson(url, init, schema) {
+    try {
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            return {
+                ok: false,
+                failure: new CapabilityError(`HTTP ${response.status}`, 'UNAVAILABLE', {
+                    reason: 'http-status',
+                    details: { status: response.status }
+                })
+            };
+        }
+        const text = await response.text();
+        if (!text) {
+            return {
+                ok: false,
+                failure: new CapabilityError('Empty response body', 'INVALID_INPUT', {
+                    reason: 'empty-body'
+                })
+            };
+        }
+        // SAFETY: JSON.parse parses untrusted text into unknown, then schema validates it
+        const raw = JSON.parse(text);
+        const parsed = schema.safeParse(raw);
+        if (!parsed.success) {
+            return {
+                ok: false,
+                failure: new CapabilityError('Invalid response shape', 'INVALID_INPUT', {
+                    reason: 'schema-mismatch'
+                })
+            };
+        }
+        return { ok: true, value: parsed.data };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+async function tryPost(url, init) {
+    try {
+        await fetch(url, init);
+        return { ok: true, value: undefined };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+export class DefaultFetchScanCacheImplementation {
+    id;
+    constructor(descriptor, _context) {
+        this.id = descriptor.id ?? 'fetch-scan-cache';
+    }
+    async getKnowledgeOrigin(runtime) {
+        const result = await tryResolveKnowledgeOrigin(runtime);
+        if (!result.ok)
+            return null;
+        return result.value;
+    }
+    async lookupScan(url, context, options) {
+        if (options.forceRefresh)
+            return null;
+        const jwt = context.jwt?.trim();
+        if (!jwt)
+            return null;
+        const origin = await this.getKnowledgeOrigin(context.runtime);
+        if (!origin)
+            return null;
+        const lookupUrl = new URL('/api/ingest/scans/lookup', `${origin}/`);
+        lookupUrl.searchParams.set('url', url);
+        lookupUrl.searchParams.set('method', options.method ?? 'GET');
+        lookupUrl.searchParams.set('freshnessMs', String(24 * 60 * 60 * 1000));
+        const response = await tryFetchJson(lookupUrl, {
+            method: 'GET',
+            headers: { accept: 'application/json', authorization: `Bearer ${jwt}` }
+        }, ScanLookupEnvelopeSchema);
+        if (!response.ok)
+            return null;
+        if (response.value.hit === true && response.value.scan) {
+            return response.value.scan;
+        }
+        return null;
+    }
+    async persistScan(url, scan, context, options) {
+        const jwt = context.jwt?.trim();
+        if (!jwt)
+            return;
+        const origin = await this.getKnowledgeOrigin(context.runtime);
+        if (!origin)
+            return;
+        const persistUrl = new URL('/api/ingest/scans/persist', `${origin}/`);
+        const body = {
+            url,
+            method: options.method ?? 'GET',
+            requestHeaders: options.headers ?? undefined,
+            projectId: context.projectId,
+            statusCode: scan.statusCode,
+            mimeType: scan.mimeType,
+            payload: scan
+        };
+        await tryPost(persistUrl, {
+            method: 'POST',
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                authorization: `Bearer ${jwt}`
+            },
+            body: JSON.stringify(body)
+        });
+    }
+    async createKnowledgeItemFromScan(input, context) {
+        const jwt = context.jwt?.trim();
+        if (!jwt)
+            return null;
+        const content = input.content?.trim();
+        if (!content)
+            return null;
+        const origin = await this.getKnowledgeOrigin(context.runtime);
+        if (!origin) {
+            throw new CapabilityError('Knowledge scan cache is not installed.', 'NOT_FOUND', {
+                reason: 'scan-cache-absent'
+            });
+        }
+        const body = {
+            contentText: content,
+            contentType: 'reference'
+        };
+        if (input.title) {
+            body.title = input.title;
+        }
+        if (input.knowledgeBaseId) {
+            body.knowledgeBaseId = input.knowledgeBaseId;
+        }
+        if (input.projectId) {
+            body.projectId = input.projectId;
+        }
+        if (input.url) {
+            body.url = input.url;
+        }
+        const response = await tryFetchJson(new URL('/api/items', `${origin}/`), {
+            method: 'POST',
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                authorization: `Bearer ${jwt}`
+            },
+            body: JSON.stringify(body)
+        }, CreateItemEnvelopeSchema);
+        if (!response.ok)
+            return null;
+        return {
+            id: response.value.id,
+            title: response.value.title ?? input.title
+        };
+    }
+}
+export const fetchScanCacheDescriptor = {
+    id: 'fetch-scan-cache',
+    kind: 'tools/fetch-scan-cache',
+    description: 'Default HTTP fetch scan cache'
+};
+export const fetchScanCacheKind = {
+    id: 'tools/fetch-scan-cache',
+    descriptorSchema: FetchScanCacheDescriptorSchema,
+    defaultImplementation: DefaultFetchScanCacheImplementation,
+    contexts: []
+};
+//# sourceMappingURL=fetch-scan-cache.kind.js.map