@vibesdotdev/integrations-context7 0.0.0-stage → 1.0.0-rc.0

package/dist/schemas/index.js

@@ -0,0 +1,61 @@
+/**
+ * Context7 tool schemas.
+ *
+ * Input/output schemas for the Context7 HTTP API tools, separate from the
+ * implementation so manifests and widgets never pull in the HTTP client.
+ */
+import * as z from 'zod/v4';
+/** An operation can degrade its result while retaining the failure for its caller. */
+const FailureContextSchema = z.object({ cause: z.unknown().optional() });
+export const Context7SearchInputSchema = z.object({
+    query: z.string().describe('Search query to find libraries'),
+    apiKey: z.string().optional().describe('Optional Context7 API key for higher rate limits')
+});
+export const Context7SearchResultSchema = z
+    .object({
+    id: z.string(),
+    title: z.string(),
+    description: z.string().optional(),
+    branch: z.string().optional(),
+    lastUpdateDate: z.string().optional(),
+    state: z.string().optional(),
+    totalTokens: z.number().optional(),
+    totalSnippets: z.number().optional(),
+    totalPages: z.number().optional(),
+    trustScore: z.number().optional(),
+    benchmarkScore: z.number().optional(),
+    versions: z.array(z.string()).optional()
+})
+    .passthrough();
+export const Context7SearchOutputSchema = z.object({
+    ...FailureContextSchema.shape,
+    results: z.array(Context7SearchResultSchema),
+    error: z.string().optional()
+});
+export const Context7DocsInputSchema = z.object({
+    libraryId: z.string().describe('Context7-compatible library ID (e.g., /vercel/next.js)'),
+    topic: z.string().optional().describe('Optional topic to filter documentation'),
+    page: z.number().optional().default(1).describe('Page number for pagination'),
+    limit: z.number().optional().describe('Max items per page'),
+    apiKey: z.string().optional().describe('Optional Context7 API key for higher rate limits')
+});
+export const Context7DocsOutputSchema = z.object({
+    ...FailureContextSchema.shape,
+    content: z.string(),
+    libraryId: z.string(),
+    topic: z.string().optional(),
+    page: z.number(),
+    error: z.string().optional()
+});
+// A tool can be rendered while its result is still streaming. Validate the
+// fields that have arrived against their owner, without inventing another wire contract.
+export const ContextSearchPresentationInput = Context7SearchInputSchema.partial();
+export const ContextSearchPresentationOutput = Context7SearchOutputSchema.partial();
+export const ContextDocsPresentationInput = Context7DocsInputSchema.partial();
+export const ContextDocsPresentationOutput = Context7DocsOutputSchema.partial();
+/** Parse a possibly partial tool payload; `null` when it does not match the schema. */
+export function readPresentation(schema, value) {
+    const parsed = schema.safeParse(value);
+    return parsed.success ? parsed.data : null;
+}
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/source/context7.descriptor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Context7 Source Descriptor
+ *
+ * Queries library documentation directly via Context7 HTTP endpoints.
+ * Best for dependency/library documentation queries.
+ */
+declare const _default: {
+    kind: "knowledge/source";
+    id: string;
+    name: string;
+    description: string;
+    hardware: string[];
+    priority: number;
+    queryTypes: "dependencies"[];
+    preferredFor: "dependencies";
+};
+export default _default;
+//# sourceMappingURL=context7.descriptor.d.ts.map

package/dist/source/context7.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7.descriptor.d.ts","sourceRoot":"","sources":["../../src/source/context7.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;;AAIH,wBASsC"}

package/dist/source/context7.descriptor.js

@@ -0,0 +1,17 @@
+/**
+ * Context7 Source Descriptor
+ *
+ * Queries library documentation directly via Context7 HTTP endpoints.
+ * Best for dependency/library documentation queries.
+ */
+export default {
+    kind: 'knowledge/source',
+    id: 'context7',
+    name: 'Context7 Library Docs',
+    description: 'Queries library documentation from Context7 endpoints',
+    hardware: ['consumer', 'cloud'],
+    priority: 10,
+    queryTypes: ['dependencies'],
+    preferredFor: 'dependencies'
+};
+//# sourceMappingURL=context7.descriptor.js.map

package/dist/source/context7.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7.descriptor.js","sourceRoot":"","sources":["../../src/source/context7.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAe;IACd,IAAI,EAAE,kBAAkB;IACxB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,uDAAuD;IACpE,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,YAAY,EAAE,cAAc;CACQ,CAAC"}

package/dist/source/context7.impl.consumer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Context7 Source Implementation
+ *
+ * Queries library documentation via Context7 HTTP endpoints.
+ * Priority 10 - early in the chain for dependency queries.
+ *
+ * The library is resolved by Context7's own search endpoint (the same one the
+ * `context7-search` tool calls), not by guessing names from the question.
+ */
+import type { KnowledgeQueryType } from '@vibesdotdev/knowledge/kinds/source';
+import type { SourceQueryOptions, SourceQueryResult, SourceContext } from '@vibesdotdev/knowledge/tools/query/schemas/sources';
+declare const _default: {
+    canHandle(queryType: KnowledgeQueryType): boolean;
+    query(options: SourceQueryOptions, context: SourceContext): Promise<SourceQueryResult>;
+};
+export default _default;
+//# sourceMappingURL=context7.impl.consumer.d.ts.map

package/dist/source/context7.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/source/context7.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAiC,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC7G,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAC;;yBAUzG,kBAAkB,GAAG,OAAO;mBAI5B,kBAAkB,WAAW,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;;AAL7F,wBAsE0C"}

package/dist/source/context7.impl.consumer.js

@@ -0,0 +1,72 @@
+import { fetchContext7Docs, loadContext7Config, searchContext7 } from "../client.js";
+const NOT_FOUND = { found: false, content: '', confidence: 0, sources: [] };
+const MAX_CONTENT_CHARS = 8000;
+/** Context7 docs API page size ceiling. */
+const MAX_DOCS_LIMIT = 10;
+export default {
+    canHandle(queryType) {
+        return queryType === 'dependencies';
+    },
+    async query(options, context) {
+        const { question, limit } = options;
+        const { toolContext: runtime, logger } = context;
+        try {
+            const searchResult = await searchContext7(runtime, { query: question });
+            if (searchResult.error) {
+                logger?.warn('Context7 library resolve error', { error: searchResult.error });
+                return NOT_FOUND;
+            }
+            const bestMatch = searchResult.results[0];
+            if (!bestMatch) {
+                logger?.debug('Context7 resolved no library for the question');
+                return NOT_FOUND;
+            }
+            const libraryId = bestMatch.id;
+            logger?.info('Context7: Resolved library', { libraryId, title: bestMatch.title, snippets: bestMatch.totalSnippets });
+            const docsResult = await fetchContext7Docs(runtime, {
+                libraryId,
+                page: 1,
+                topic: question,
+                limit: Math.min(limit, MAX_DOCS_LIMIT)
+            });
+            if (docsResult.error) {
+                logger?.warn('Context7 docs fetch error', { error: docsResult.error });
+                return NOT_FOUND;
+            }
+            if (docsResult.content.length === 0) {
+                logger?.debug('No documentation content from Context7');
+                return NOT_FOUND;
+            }
+            const content = [
+                `## ${bestMatch.title} Documentation`,
+                '',
+                docsResult.content.slice(0, MAX_CONTENT_CHARS),
+                '',
+                `_Source: Context7 - ${libraryId}_`
+            ].join('\n');
+            const hasHighReputation = (bestMatch.trustScore ?? 0) > 7 || (bestMatch.benchmarkScore ?? 0) > 80;
+            const confidence = hasHighReputation ? 0.85 : 0.7;
+            const { origin } = await loadContext7Config(runtime);
+            return {
+                found: true,
+                content,
+                confidence,
+                sources: [
+                    {
+                        type: 'context7',
+                        reference: `${bestMatch.title} (${libraryId})`,
+                        url: new URL(libraryId, origin).toString(),
+                        confidence
+                    }
+                ],
+                rawData: { libraryId, library: bestMatch, contentLength: docsResult.content.length }
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger?.warn('Context7 query failed', { error: errorMessage });
+            return { ...NOT_FOUND, cause: error, rawData: { debug: `Exception: ${errorMessage}` } };
+        }
+    }
+};
+//# sourceMappingURL=context7.impl.consumer.js.map

package/dist/source/context7.impl.consumer.js.map

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

package/dist/svelte/Context7DocsToolCard.svelte

@@ -0,0 +1,85 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `context7-docs`: library id + documentation text.
+	 */
+	import { CodeViewer } from '@vibesdotdev/kit/components/code';
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import {
+		readPresentation,
+		ContextDocsPresentationInput,
+		ContextDocsPresentationOutput
+	} from '@vibesdotdev/integrations-context7/schemas';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const input = $derived(readPresentation(ContextDocsPresentationInput, tool.input));
+	const output = $derived(readPresentation(ContextDocsPresentationOutput, tool.output));
+	const outputError = $derived(output?.error ?? '');
+	const status = $derived(String(tool.status ?? 'completed'));
+	const isFailed = $derived(
+		status === 'failed' ||
+			status === 'error' ||
+			status === 'denied' ||
+			Boolean(tool.error) ||
+			Boolean(outputError)
+	);
+
+	const libraryId = $derived.by(() => {
+		const out = output?.libraryId ?? '';
+		if (out) return out;
+		return input?.libraryId ?? '';
+	});
+	const topic = $derived.by(() => {
+		const out = output?.topic ?? '';
+		if (out) return out;
+		return input?.topic ?? '';
+	});
+	const page = $derived(
+		output?.page ?? input?.page ?? null
+	);
+	const content = $derived(output?.content ?? '');
+	const summaryTitle = $derived(
+		isFailed ? 'Could not load Context7 docs' : libraryId || 'Context7 docs'
+	);
+</script>
+
+<ToolCard {tool} {compact} title={summaryTitle} icon="lucide:book-text" defaultOpen={isFailed}>
+	<ToolCardBody {compact}>
+		{#if isFailed}
+			<div class="flex items-start gap-2 text-footnote text-destructive">
+				<Icon icon="lucide:circle-alert" class="mt-0.5 size-3.5 shrink-0" />
+				<p class="whitespace-pre-wrap">
+					{tool.error || outputError || 'The context7-docs tool failed.'}
+				</p>
+			</div>
+		{:else}
+			<div class="flex flex-wrap items-center gap-1.5">
+				{#if topic}
+					<Badge variant="secondary" class="max-w-full truncate text-caption">{topic}</Badge>
+				{/if}
+				{#if page !== null}
+					<Badge variant="outline" class="text-caption">page {page}</Badge>
+				{/if}
+			</div>
+			{#if content}
+				<CodeViewer
+					code={content}
+					filename={libraryId || undefined}
+					language="auto"
+					appearance="system"
+					maxHeight="20rem"
+					minHeight="0"
+					showLineNumbers
+				/>
+			{:else if !tool.error}
+				<p class="text-footnote text-muted-foreground italic">No documentation returned.</p>
+			{/if}
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/Context7DocsToolCard.svelte.d.ts

@@ -0,0 +1,5 @@
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const Context7DocsToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type Context7DocsToolCard = ReturnType<typeof Context7DocsToolCard>;
+export default Context7DocsToolCard;
+//# sourceMappingURL=Context7DocsToolCard.svelte.d.ts.map

package/dist/svelte/Context7DocsToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context7DocsToolCard.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/Context7DocsToolCard.svelte.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AA+EnD,QAAA,MAAM,oBAAoB,qDAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/dist/svelte/Context7SearchToolCard.svelte

@@ -0,0 +1,99 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `context7-search`: library id results.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import {
+		readPresentation,
+		ContextSearchPresentationInput,
+		ContextSearchPresentationOutput
+	} from '@vibesdotdev/integrations-context7/schemas';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const input = $derived(readPresentation(ContextSearchPresentationInput, tool.input));
+	const output = $derived(readPresentation(ContextSearchPresentationOutput, tool.output));
+	const outputError = $derived(output?.error ?? '');
+	const status = $derived(String(tool.status ?? 'completed'));
+	const isFailed = $derived(
+		status === 'failed' ||
+			status === 'error' ||
+			status === 'denied' ||
+			Boolean(tool.error) ||
+			Boolean(outputError)
+	);
+
+	const query = $derived.by(() => {
+				return input?.query ?? '';
+	});
+
+	const results = $derived(output?.results ?? []);
+
+	const summaryTitle = $derived(
+		isFailed
+			? 'Context7 search failed'
+			: query
+				? `Found ${results.length} Context7 ${results.length === 1 ? 'library' : 'libraries'}`
+				: 'Context7 search'
+	);
+</script>
+
+<ToolCard {tool} {compact} title={summaryTitle} icon="lucide:library" defaultOpen={isFailed}>
+	<ToolCardBody {compact}>
+		{#if isFailed}
+			<div class="flex items-start gap-2 text-footnote text-destructive">
+				<Icon icon="lucide:circle-alert" class="mt-0.5 size-3.5 shrink-0" />
+				<p class="whitespace-pre-wrap">
+					{tool.error || outputError || 'The context7-search tool failed.'}
+				</p>
+			</div>
+		{:else}
+			{#if query}
+				<Badge variant="secondary" class="max-w-full truncate text-caption">{query}</Badge>
+			{/if}
+			{#if results.length}
+				<ul class="space-y-1.5">
+					{#each results as result (result.id)}
+						<li class="min-w-0">
+							<div class="flex items-start gap-2">
+								<span class="min-w-0 flex-1">
+									<span class="block truncate text-footnote font-medium text-foreground"
+										>{result.title}</span
+									>
+									{#if result.id !== result.title}
+										<span class="block truncate font-mono text-caption text-muted-foreground">
+											{result.id}
+										</span>
+									{/if}
+									{#if result.description}
+										<span class="block line-clamp-2 text-footnote text-muted-foreground">
+											{result.description}
+										</span>
+									{/if}
+								</span>
+								{#if result.trustScore !== undefined}
+									<Badge variant="outline" class="shrink-0 text-caption">
+										trust {result.trustScore}
+									</Badge>
+								{/if}
+							</div>
+							{#if result.totalSnippets !== undefined}
+								<div class="text-caption text-muted-foreground">
+									{result.totalSnippets} snippet{result.totalSnippets === 1 ? '' : 's'}
+								</div>
+							{/if}
+						</li>
+					{/each}
+				</ul>
+			{:else if !tool.error}
+				<p class="text-footnote text-muted-foreground italic">No libraries found.</p>
+			{/if}
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/Context7SearchToolCard.svelte.d.ts

@@ -0,0 +1,8 @@
+/**
+     * First-party widget for `context7-search`: library id results.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const Context7SearchToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type Context7SearchToolCard = ReturnType<typeof Context7SearchToolCard>;
+export default Context7SearchToolCard;
+//# sourceMappingURL=Context7SearchToolCard.svelte.d.ts.map

package/dist/svelte/Context7SearchToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context7SearchToolCard.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/Context7SearchToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;OAEI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAmGnD,QAAA,MAAM,sBAAsB,qDAAwC,CAAC;AACrE,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACxE,eAAe,sBAAsB,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,4 @@
+export { default as Context7SearchToolCard } from './Context7SearchToolCard.svelte';
+export { default as Context7DocsToolCard } from './Context7DocsToolCard.svelte';
+export { integrationsContext7SveltePlugin, integrationsContext7SveltePlugin as default } from './integrations-context7-svelte.plugin.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,gCAAgC,EAAE,gCAAgC,IAAI,OAAO,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,3 @@
+export { default as Context7SearchToolCard } from './Context7SearchToolCard.svelte';
+export { default as Context7DocsToolCard } from './Context7DocsToolCard.svelte';
+export { integrationsContext7SveltePlugin, integrationsContext7SveltePlugin as default } from "./integrations-context7-svelte.plugin.js";

package/dist/svelte/integrations-context7-svelte.plugin.d.ts

@@ -0,0 +1,4 @@
+/** Browser tool cards for `context7-search` and `context7-docs`. */
+export declare const integrationsContext7SveltePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default integrationsContext7SveltePlugin;
+//# sourceMappingURL=integrations-context7-svelte.plugin.d.ts.map

package/dist/svelte/integrations-context7-svelte.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations-context7-svelte.plugin.d.ts","sourceRoot":"","sources":["../../src/svelte/integrations-context7-svelte.plugin.ts"],"names":[],"mappings":"AAeA,oEAAoE;AACpE,eAAO,MAAM,gCAAgC,6CAU3C,CAAC;AAEH,eAAe,gCAAgC,CAAC"}

package/dist/svelte/integrations-context7-svelte.plugin.js

@@ -0,0 +1,21 @@
+import { createRuntimePlugin } from '@vibesdotdev/kernel/factory';
+import { createSvelteToolWidgetDescriptor, createSvelteToolWidgetLoader, registerSvelteToolWidget } from '@vibesdotdev/tools/svelte/tool-widgets';
+const context7SearchWidgetDescriptor = createSvelteToolWidgetDescriptor({ toolId: 'context7-search' });
+const context7DocsWidgetDescriptor = createSvelteToolWidgetDescriptor({ toolId: 'context7-docs' });
+const loadContext7SearchCard = () => import('./Context7SearchToolCard.svelte');
+const loadContext7DocsCard = () => import('./Context7DocsToolCard.svelte');
+await registerSvelteToolWidget(context7SearchWidgetDescriptor, loadContext7SearchCard);
+await registerSvelteToolWidget(context7DocsWidgetDescriptor, loadContext7DocsCard);
+/** Browser tool cards for `context7-search` and `context7-docs`. */
+export const integrationsContext7SveltePlugin = createRuntimePlugin({
+    id: 'integrations-context7.svelte',
+    name: 'Integrations Context7 Svelte',
+    description: 'Svelte tool widgets for the Context7 tools',
+    dependencies: ['tools'],
+    descriptors: [context7SearchWidgetDescriptor, context7DocsWidgetDescriptor],
+    loaders: [
+        createSvelteToolWidgetLoader(context7SearchWidgetDescriptor, loadContext7SearchCard),
+        createSvelteToolWidgetLoader(context7DocsWidgetDescriptor, loadContext7DocsCard)
+    ]
+});
+export default integrationsContext7SveltePlugin;

package/dist/tools/context7-docs.descriptor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Context7 Docs Tool Descriptor
+ *
+ * Metadata for the context7-docs tool. Safe to import anywhere.
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "context7-docs";
+    readonly name: "Context7 Docs";
+    readonly description: "Fetch docs for a Context7 library ID.";
+    readonly mcpDescription: "Fetch docs. Ex: {libraryId:\"/sveltejs/svelte\",topic:\"stores\"}.";
+    readonly category: "knowledge";
+    readonly subcategory: "external";
+    readonly hardware: readonly ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly tags: readonly ["docs", "knowledge", "documentation", "context7"];
+    readonly safety: "execute";
+    readonly requiresApproval: false;
+    readonly enabled: true;
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            libraryId: import("zod").ZodString;
+            topic: import("zod").ZodOptional<import("zod").ZodString>;
+            page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+            limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+            apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        readonly output: import("zod").ZodObject<{
+            content: import("zod").ZodString;
+            libraryId: import("zod").ZodString;
+            topic: import("zod").ZodOptional<import("zod").ZodString>;
+            page: import("zod").ZodNumber;
+            error: import("zod").ZodOptional<import("zod").ZodString>;
+            cause: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default _default;
+//# sourceMappingURL=context7-docs.descriptor.d.ts.map

package/dist/tools/context7-docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/tools/context7-docs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKH,wBAkBG"}

package/dist/tools/context7-docs.descriptor.js

@@ -0,0 +1,27 @@
+/**
+ * Context7 Docs Tool Descriptor
+ *
+ * Metadata for the context7-docs tool. Safe to import anywhere.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { Context7DocsInputSchema, Context7DocsOutputSchema } from "../schemas/index.js";
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'context7-docs',
+    name: 'Context7 Docs',
+    description: 'Fetch docs for a Context7 library ID.',
+    mcpDescription: 'Fetch docs. Ex: {libraryId:"/sveltejs/svelte",topic:"stores"}.',
+    category: 'knowledge',
+    subcategory: 'external',
+    hardware: ['consumer', 'cloud'],
+    purpose: ['direct', 'worker', 'mcp', 'agent'],
+    tags: ['docs', 'knowledge', 'documentation', 'context7'],
+    safety: 'execute',
+    requiresApproval: false,
+    enabled: true,
+    schemas: {
+        input: Context7DocsInputSchema,
+        output: Context7DocsOutputSchema
+    }
+});
+//# sourceMappingURL=context7-docs.descriptor.js.map

package/dist/tools/context7-docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-docs.descriptor.js","sourceRoot":"","sources":["../../src/tools/context7-docs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAExF,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,uCAAuC;IACpD,cAAc,EAAE,gEAAgE;IAChF,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,UAAU;IACvB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC;IAC7C,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,CAAC;IACxD,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,KAAK;IACvB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE;QACR,KAAK,EAAE,uBAAuB;QAC9B,MAAM,EAAE,wBAAwB;KAChC;CACD,CAAC,CAAC"}

package/dist/tools/context7-docs.impl.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context7 Docs Tool Implementation
+ *
+ * Hardware-agnostic — pure HTTP fetch against Context7 endpoints.
+ * Works in consumer runtimes and cloud workers.
+ */
+import type { VibesRuntime, ToolCallContext } from '@vibesdotdev/kernel';
+import type { Context7DocsInput, Context7DocsOutput } from '../schemas/index.ts';
+declare const _default: {
+    execute(input: Context7DocsInput, runtime: VibesRuntime, _ctx: ToolCallContext): Promise<Context7DocsOutput>;
+};
+export default _default;
+//# sourceMappingURL=context7-docs.impl.d.ts.map

package/dist/tools/context7-docs.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-docs.impl.d.ts","sourceRoot":"","sources":["../../src/tools/context7-docs.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;;mBAKxE,iBAAiB,WACf,YAAY,QACf,eAAe,GACnB,OAAO,CAAC,kBAAkB,CAAC;;AAL/B,wBAQE"}

package/dist/tools/context7-docs.impl.js

@@ -0,0 +1,13 @@
+/**
+ * Context7 Docs Tool Implementation
+ *
+ * Hardware-agnostic — pure HTTP fetch against Context7 endpoints.
+ * Works in consumer runtimes and cloud workers.
+ */
+import { fetchContext7Docs } from "../client.js";
+export default {
+    execute(input, runtime, _ctx) {
+        return fetchContext7Docs(runtime, input);
+    }
+};
+//# sourceMappingURL=context7-docs.impl.js.map

package/dist/tools/context7-docs.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-docs.impl.js","sourceRoot":"","sources":["../../src/tools/context7-docs.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,eAAe;IACd,OAAO,CACN,KAAwB,EACxB,OAAqB,EACrB,IAAqB;QAErB,OAAO,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;CACD,CAAC"}

package/dist/tools/context7-search.descriptor.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Context7 Search Tool Descriptor
+ *
+ * Metadata for the context7-search tool. Safe to import anywhere.
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "context7-search";
+    readonly name: "Context7 Search";
+    readonly description: "Find Context7 library IDs.";
+    readonly mcpDescription: "Find library IDs. Ex: {query:\"svelte\"}; use result with context7-docs.";
+    readonly category: "knowledge";
+    readonly subcategory: "external";
+    readonly hardware: readonly ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly tags: readonly ["search", "knowledge", "documentation", "context7"];
+    readonly safety: "execute";
+    readonly requiresApproval: false;
+    readonly enabled: true;
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            query: import("zod").ZodString;
+            apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        readonly output: import("zod").ZodObject<{
+            results: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                branch: import("zod").ZodOptional<import("zod").ZodString>;
+                lastUpdateDate: import("zod").ZodOptional<import("zod").ZodString>;
+                state: import("zod").ZodOptional<import("zod").ZodString>;
+                totalTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                totalSnippets: import("zod").ZodOptional<import("zod").ZodNumber>;
+                totalPages: import("zod").ZodOptional<import("zod").ZodNumber>;
+                trustScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                benchmarkScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                versions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            }, import("zod/v4/core").$loose>>;
+            error: import("zod").ZodOptional<import("zod").ZodString>;
+            cause: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default _default;
+//# sourceMappingURL=context7-search.descriptor.d.ts.map

package/dist/tools/context7-search.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-search.descriptor.d.ts","sourceRoot":"","sources":["../../src/tools/context7-search.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKH,wBAkBG"}