@namzu/sdk 45.1.0 → 48.0.0

package/dist/registry/toolset/catalog.js

@@ -1,234 +0,0 @@
-import { toolWireSchema } from '../tool/schema.js';
-const DEFAULT_HOST_SOURCE = {
-    id: 'host-tools',
-    kind: 'host_tool',
-    name: 'Host tools',
-    description: 'Tools executed by the host runtime.',
-};
-const DEFAULT_HOST_TOOLSET = {
-    id: 'host-tools',
-    sourceId: DEFAULT_HOST_SOURCE.id,
-    name: 'Host tools',
-    defaultPolicy: {
-        enabled: true,
-        loading: 'eager',
-    },
-};
-export class ToolCatalog {
-    sources = new Map();
-    toolsets = new Map();
-    tools = new Map();
-    registerSource(source) {
-        this.sources.set(source.id, source);
-    }
-    registerToolset(toolset) {
-        if (!this.sources.has(toolset.sourceId)) {
-            throw new Error(`Toolset "${toolset.id}" references unknown source "${toolset.sourceId}"`);
-        }
-        this.toolsets.set(toolset.id, toolset);
-    }
-    registerTool(tool) {
-        if (!this.sources.has(tool.sourceId)) {
-            throw new Error(`Tool "${tool.name}" references unknown source "${tool.sourceId}"`);
-        }
-        if (!this.toolsets.has(tool.toolsetId)) {
-            throw new Error(`Tool "${tool.name}" references unknown toolset "${tool.toolsetId}"`);
-        }
-        if (tool.definition && tool.definition.name !== tool.name) {
-            throw new Error(`Tool "${tool.name}" definition name mismatch: received "${tool.definition.name}"`);
-        }
-        if (tool.llmSchema && tool.llmSchema.function.name !== tool.name) {
-            throw new Error(`Tool "${tool.name}" LLM schema name mismatch: received "${tool.llmSchema.function.name}"`);
-        }
-        if (tool.definition?.enforceModelInput && !tool.definition.modelInputSchema) {
-            throw new Error(`Tool "${tool.name}" enables enforceModelInput but does not define modelInputSchema.`);
-        }
-        if (tool.definition?.enforceModelInput && tool.llmSchema) {
-            throw new Error(`Tool "${tool.name}" cannot combine an explicit llmSchema with enforceModelInput. Put the provider-safe schema on definition.modelInputSchema so enforcement and schema precedence stay paired.`);
-        }
-        this.tools.set(tool.name, tool);
-    }
-    getSource(id) {
-        return this.sources.get(id);
-    }
-    getToolset(id) {
-        return this.toolsets.get(id);
-    }
-    getTool(name) {
-        return this.tools.get(name);
-    }
-    listSources() {
-        return [...this.sources.values()];
-    }
-    listToolsets() {
-        return [...this.toolsets.values()];
-    }
-    listTools() {
-        return [...this.tools.values()];
-    }
-    snapshot() {
-        return {
-            sources: this.listSources(),
-            toolsets: this.listToolsets(),
-            tools: this.listTools(),
-        };
-    }
-    getToolsByLoading(loading) {
-        const wanted = new Set(loading);
-        return this.listTools().filter((tool) => wanted.has(resolveToolLoading(tool.policy)));
-    }
-    searchTools(query, options = {}) {
-        const normalized = query.trim().toLowerCase();
-        const terms = normalized.split(/\s+/).filter(Boolean);
-        const loading = options.loading ? new Set(options.loading) : null;
-        const results = [];
-        for (const tool of this.listTools()) {
-            if (loading && !loading.has(resolveToolLoading(tool.policy)))
-                continue;
-            if (tool.policy.enabled === false)
-                continue;
-            const source = this.sources.get(tool.sourceId);
-            const toolset = this.toolsets.get(tool.toolsetId);
-            if (!source || !toolset)
-                continue;
-            const scored = scoreToolSearch({
-                terms,
-                tool,
-                source,
-                toolset,
-            });
-            if (scored.score <= 0)
-                continue;
-            results.push({
-                tool,
-                source,
-                toolset,
-                score: scored.score,
-                matched: scored.matched,
-            });
-        }
-        results.sort((a, b) => b.score - a.score || a.tool.name.localeCompare(b.tool.name));
-        return results.slice(0, options.limit ?? 5);
-    }
-    toLLMTools(options = {}) {
-        const loading = options.loading ?? ['eager'];
-        return this.getToolsByLoading(loading)
-            .filter((tool) => tool.policy.enabled !== false)
-            .map((tool) => tool.llmSchema ?? toolDefinitionToLLMTool(tool.definition))
-            .filter((tool) => Boolean(tool));
-    }
-}
-export function createToolCatalogFromRegistry(registry, options = {}) {
-    const source = options.source ?? DEFAULT_HOST_SOURCE;
-    const toolset = {
-        ...DEFAULT_HOST_TOOLSET,
-        ...options.toolset,
-        sourceId: options.toolset?.sourceId ?? source.id,
-    };
-    const catalog = new ToolCatalog();
-    catalog.registerSource(source);
-    catalog.registerToolset(toolset);
-    for (const definition of registry.getAll()) {
-        const availability = registry.getAvailability(definition.name);
-        catalog.registerTool(toolDefinitionToCatalogEntry(definition, {
-            availability,
-            sourceId: source.id,
-            toolsetId: toolset.id,
-            toolsetPolicy: toolset.defaultPolicy,
-        }));
-    }
-    return catalog;
-}
-export function toolDefinitionToCatalogEntry(definition, input) {
-    const loading = loadingFromAvailability(input.availability ?? 'active');
-    return {
-        name: definition.name,
-        description: definition.description,
-        sourceId: input.sourceId,
-        toolsetId: input.toolsetId,
-        definition,
-        permissions: definition.permissions,
-        category: definition.category,
-        policy: {
-            ...input.toolsetPolicy,
-            enabled: input.toolsetPolicy?.enabled === false ? false : loading !== 'suspended',
-            loading,
-        },
-    };
-}
-export function loadingFromAvailability(availability) {
-    switch (availability) {
-        case 'deferred':
-            return 'deferred';
-        case 'suspended':
-            return 'suspended';
-        default:
-            return 'eager';
-    }
-}
-function resolveToolLoading(policy) {
-    if (policy.enabled === false)
-        return 'disabled';
-    return policy.loading ?? 'eager';
-}
-function toolDefinitionToLLMTool(definition) {
-    if (!definition)
-        return null;
-    return {
-        type: 'function',
-        function: {
-            name: definition.name,
-            description: definition.description,
-            // Through `toolWireSchema`, not a second inline conversion. The
-            // options were already identical, so this was not a different
-            // rendering — it was the same rendering without the guarantees:
-            // no `$schema` stripping (that key rides in the tools block, which
-            // sits at position 0 inside the prompt-cache prefix), no portability
-            // normalisation, no memoization, and no freeze. Two paths that agree
-            // today are two paths that can disagree tomorrow, and a tool reaching
-            // the wire through the catalog rather than the registry is not a
-            // different tool.
-            parameters: toolWireSchema(definition),
-        },
-    };
-}
-function scoreToolSearch(input) {
-    const terms = input.terms.length > 0 ? input.terms : [''];
-    const matched = new Set();
-    let score = 0;
-    for (const term of terms) {
-        if (!term)
-            continue;
-        const toolName = input.tool.name.toLowerCase();
-        const description = input.tool.description.toLowerCase();
-        const sourceText = `${input.source.name} ${input.source.description ?? ''} ${input.source.kind}`.toLowerCase();
-        const toolsetText = `${input.toolset.name} ${input.toolset.description ?? ''}`.toLowerCase();
-        if (toolName === term) {
-            score += 12;
-            matched.add('name');
-        }
-        else if (toolName.includes(term)) {
-            score += 8;
-            matched.add('name');
-        }
-        if (description.includes(term)) {
-            score += 5;
-            matched.add('description');
-        }
-        if (sourceText.includes(term)) {
-            score += 3;
-            matched.add('source');
-        }
-        if (toolsetText.includes(term)) {
-            score += 2;
-            matched.add('toolset');
-        }
-    }
-    if (input.tool.policy.preferred && score > 0)
-        score += 1;
-    return {
-        score,
-        matched: [...matched],
-    };
-}
-//# sourceMappingURL=catalog.js.map

package/dist/registry/toolset/catalog.js.map

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

package/src/registry/toolset/catalog.ts

@@ -1,308 +0,0 @@
-import type { ToolRegistryContract } from '../../types/tool/index.js'
-import type { LLMToolSchema, ToolAvailability, ToolDefinition } from '../../types/tool/index.js'
-import type {
-	ToolCatalogEntry,
-	ToolCatalogSearchResult,
-	ToolCatalogSnapshot,
-	ToolLoadingMode,
-	ToolSource,
-	ToolsetDefinition,
-	ToolsetPolicy,
-} from '../../types/toolset/index.js'
-import { toolWireSchema } from '../tool/schema.js'
-
-export interface ToolCatalogSearchOptions {
-	readonly loading?: readonly ToolLoadingMode[]
-	readonly limit?: number
-}
-
-export interface ToolCatalogFromRegistryOptions {
-	readonly source?: ToolSource
-	readonly toolset?: Omit<ToolsetDefinition, 'sourceId'> & {
-		readonly sourceId?: string
-	}
-}
-
-const DEFAULT_HOST_SOURCE: ToolSource = {
-	id: 'host-tools',
-	kind: 'host_tool',
-	name: 'Host tools',
-	description: 'Tools executed by the host runtime.',
-}
-
-const DEFAULT_HOST_TOOLSET: ToolsetDefinition = {
-	id: 'host-tools',
-	sourceId: DEFAULT_HOST_SOURCE.id,
-	name: 'Host tools',
-	defaultPolicy: {
-		enabled: true,
-		loading: 'eager',
-	},
-}
-
-export class ToolCatalog {
-	private sources = new Map<string, ToolSource>()
-	private toolsets = new Map<string, ToolsetDefinition>()
-	private tools = new Map<string, ToolCatalogEntry>()
-
-	registerSource(source: ToolSource): void {
-		this.sources.set(source.id, source)
-	}
-
-	registerToolset(toolset: ToolsetDefinition): void {
-		if (!this.sources.has(toolset.sourceId)) {
-			throw new Error(`Toolset "${toolset.id}" references unknown source "${toolset.sourceId}"`)
-		}
-		this.toolsets.set(toolset.id, toolset)
-	}
-
-	registerTool(tool: ToolCatalogEntry): void {
-		if (!this.sources.has(tool.sourceId)) {
-			throw new Error(`Tool "${tool.name}" references unknown source "${tool.sourceId}"`)
-		}
-		if (!this.toolsets.has(tool.toolsetId)) {
-			throw new Error(`Tool "${tool.name}" references unknown toolset "${tool.toolsetId}"`)
-		}
-		if (tool.definition && tool.definition.name !== tool.name) {
-			throw new Error(
-				`Tool "${tool.name}" definition name mismatch: received "${tool.definition.name}"`,
-			)
-		}
-		if (tool.llmSchema && tool.llmSchema.function.name !== tool.name) {
-			throw new Error(
-				`Tool "${tool.name}" LLM schema name mismatch: received "${tool.llmSchema.function.name}"`,
-			)
-		}
-		if (tool.definition?.enforceModelInput && !tool.definition.modelInputSchema) {
-			throw new Error(
-				`Tool "${tool.name}" enables enforceModelInput but does not define modelInputSchema.`,
-			)
-		}
-		if (tool.definition?.enforceModelInput && tool.llmSchema) {
-			throw new Error(
-				`Tool "${tool.name}" cannot combine an explicit llmSchema with enforceModelInput. Put the provider-safe schema on definition.modelInputSchema so enforcement and schema precedence stay paired.`,
-			)
-		}
-		this.tools.set(tool.name, tool)
-	}
-
-	getSource(id: string): ToolSource | undefined {
-		return this.sources.get(id)
-	}
-
-	getToolset(id: string): ToolsetDefinition | undefined {
-		return this.toolsets.get(id)
-	}
-
-	getTool(name: string): ToolCatalogEntry | undefined {
-		return this.tools.get(name)
-	}
-
-	listSources(): ToolSource[] {
-		return [...this.sources.values()]
-	}
-
-	listToolsets(): ToolsetDefinition[] {
-		return [...this.toolsets.values()]
-	}
-
-	listTools(): ToolCatalogEntry[] {
-		return [...this.tools.values()]
-	}
-
-	snapshot(): ToolCatalogSnapshot {
-		return {
-			sources: this.listSources(),
-			toolsets: this.listToolsets(),
-			tools: this.listTools(),
-		}
-	}
-
-	getToolsByLoading(loading: readonly ToolLoadingMode[]): ToolCatalogEntry[] {
-		const wanted = new Set(loading)
-		return this.listTools().filter((tool) => wanted.has(resolveToolLoading(tool.policy)))
-	}
-
-	searchTools(query: string, options: ToolCatalogSearchOptions = {}): ToolCatalogSearchResult[] {
-		const normalized = query.trim().toLowerCase()
-		const terms = normalized.split(/\s+/).filter(Boolean)
-		const loading = options.loading ? new Set(options.loading) : null
-		const results: ToolCatalogSearchResult[] = []
-
-		for (const tool of this.listTools()) {
-			if (loading && !loading.has(resolveToolLoading(tool.policy))) continue
-			if (tool.policy.enabled === false) continue
-
-			const source = this.sources.get(tool.sourceId)
-			const toolset = this.toolsets.get(tool.toolsetId)
-			if (!source || !toolset) continue
-
-			const scored = scoreToolSearch({
-				terms,
-				tool,
-				source,
-				toolset,
-			})
-			if (scored.score <= 0) continue
-
-			results.push({
-				tool,
-				source,
-				toolset,
-				score: scored.score,
-				matched: scored.matched,
-			})
-		}
-
-		results.sort((a, b) => b.score - a.score || a.tool.name.localeCompare(b.tool.name))
-		return results.slice(0, options.limit ?? 5)
-	}
-
-	toLLMTools(options: { readonly loading?: readonly ToolLoadingMode[] } = {}): LLMToolSchema[] {
-		const loading = options.loading ?? ['eager']
-		return this.getToolsByLoading(loading)
-			.filter((tool) => tool.policy.enabled !== false)
-			.map((tool) => tool.llmSchema ?? toolDefinitionToLLMTool(tool.definition))
-			.filter((tool): tool is LLMToolSchema => Boolean(tool))
-	}
-}
-
-export function createToolCatalogFromRegistry(
-	registry: ToolRegistryContract,
-	options: ToolCatalogFromRegistryOptions = {},
-): ToolCatalog {
-	const source = options.source ?? DEFAULT_HOST_SOURCE
-	const toolset: ToolsetDefinition = {
-		...DEFAULT_HOST_TOOLSET,
-		...options.toolset,
-		sourceId: options.toolset?.sourceId ?? source.id,
-	}
-	const catalog = new ToolCatalog()
-	catalog.registerSource(source)
-	catalog.registerToolset(toolset)
-
-	for (const definition of registry.getAll()) {
-		const availability = registry.getAvailability(definition.name)
-		catalog.registerTool(
-			toolDefinitionToCatalogEntry(definition, {
-				availability,
-				sourceId: source.id,
-				toolsetId: toolset.id,
-				toolsetPolicy: toolset.defaultPolicy,
-			}),
-		)
-	}
-
-	return catalog
-}
-
-export function toolDefinitionToCatalogEntry(
-	definition: ToolDefinition,
-	input: {
-		readonly availability?: ToolAvailability
-		readonly sourceId: string
-		readonly toolsetId: string
-		readonly toolsetPolicy?: ToolsetPolicy
-	},
-): ToolCatalogEntry {
-	const loading = loadingFromAvailability(input.availability ?? 'active')
-	return {
-		name: definition.name,
-		description: definition.description,
-		sourceId: input.sourceId,
-		toolsetId: input.toolsetId,
-		definition,
-		permissions: definition.permissions,
-		category: definition.category,
-		policy: {
-			...input.toolsetPolicy,
-			enabled: input.toolsetPolicy?.enabled === false ? false : loading !== 'suspended',
-			loading,
-		},
-	}
-}
-
-export function loadingFromAvailability(availability: ToolAvailability): ToolLoadingMode {
-	switch (availability) {
-		case 'deferred':
-			return 'deferred'
-		case 'suspended':
-			return 'suspended'
-		default:
-			return 'eager'
-	}
-}
-
-function resolveToolLoading(policy: ToolsetPolicy): ToolLoadingMode {
-	if (policy.enabled === false) return 'disabled'
-	return policy.loading ?? 'eager'
-}
-
-function toolDefinitionToLLMTool(definition: ToolDefinition | undefined): LLMToolSchema | null {
-	if (!definition) return null
-	return {
-		type: 'function',
-		function: {
-			name: definition.name,
-			description: definition.description,
-			// Through `toolWireSchema`, not a second inline conversion. The
-			// options were already identical, so this was not a different
-			// rendering — it was the same rendering without the guarantees:
-			// no `$schema` stripping (that key rides in the tools block, which
-			// sits at position 0 inside the prompt-cache prefix), no portability
-			// normalisation, no memoization, and no freeze. Two paths that agree
-			// today are two paths that can disagree tomorrow, and a tool reaching
-			// the wire through the catalog rather than the registry is not a
-			// different tool.
-			parameters: toolWireSchema(definition),
-		},
-	}
-}
-
-function scoreToolSearch(input: {
-	readonly terms: readonly string[]
-	readonly tool: ToolCatalogEntry
-	readonly source: ToolSource
-	readonly toolset: ToolsetDefinition
-}): { score: number; matched: string[] } {
-	const terms = input.terms.length > 0 ? input.terms : ['']
-	const matched = new Set<string>()
-	let score = 0
-
-	for (const term of terms) {
-		if (!term) continue
-
-		const toolName = input.tool.name.toLowerCase()
-		const description = input.tool.description.toLowerCase()
-		const sourceText =
-			`${input.source.name} ${input.source.description ?? ''} ${input.source.kind}`.toLowerCase()
-		const toolsetText = `${input.toolset.name} ${input.toolset.description ?? ''}`.toLowerCase()
-
-		if (toolName === term) {
-			score += 12
-			matched.add('name')
-		} else if (toolName.includes(term)) {
-			score += 8
-			matched.add('name')
-		}
-		if (description.includes(term)) {
-			score += 5
-			matched.add('description')
-		}
-		if (sourceText.includes(term)) {
-			score += 3
-			matched.add('source')
-		}
-		if (toolsetText.includes(term)) {
-			score += 2
-			matched.add('toolset')
-		}
-	}
-
-	if (input.tool.policy.preferred && score > 0) score += 1
-
-	return {
-		score,
-		matched: [...matched],
-	}
-}