From c88baa4b88480dfb8af68af37a6410ef4127b82a Mon Sep 17 00:00:00 2001 From: Diego Carlino Date: Tue, 7 Apr 2026 12:23:36 +0200 Subject: [PATCH] docs(discovery): clarify shared package boundary Spell out that /service and /tools are subpath exports of the same npm artifact so the import split is not mistaken for dependency isolation. Fix the Agent SDK helper comment to point dynamic tools at the correct entrypoint. --- docs/sdk/discovery.md | 2 ++ .../integrations/discovery/src/anthropic-agent-sdk.ts | 2 +- website/docs/src/content/docs/sdk/discovery.md | 2 ++ 3 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/sdk/discovery.md b/docs/sdk/discovery.md index 87a14b0..415bb76 100644 --- a/docs/sdk/discovery.md +++ b/docs/sdk/discovery.md @@ -40,6 +40,8 @@ Integrations (Claude Code plugin, OpenClaw plugin, VS Code extension, custom age Integrations compose these entrypoints: `@slop-ai/discovery/service` for provider scanning and connection orchestration, `@slop-ai/discovery/tools` when they need lifecycle or dynamic-tool helpers, and the root export when they need direct bridge primitives. +These are subpath entrypoints of the same published `@slop-ai/discovery` package, not separately published npm packages. They currently share one install-time dependency set even when a consumer only imports the root, `/service`, or `/tools` entrypoint. + ## Phase 1: Core Discovery Layer As of `v0.1`, the **core discovery layer** is shipped across TypeScript, Python, Go, and Rust. The TypeScript implementation remains the behavioral reference, but other SDKs do **not** need to copy its package topology. diff --git a/packages/typescript/integrations/discovery/src/anthropic-agent-sdk.ts b/packages/typescript/integrations/discovery/src/anthropic-agent-sdk.ts index d8a36ae..2cfe15b 100644 --- a/packages/typescript/integrations/discovery/src/anthropic-agent-sdk.ts +++ b/packages/typescript/integrations/discovery/src/anthropic-agent-sdk.ts @@ -17,7 +17,7 @@ import { createToolHandlers } from "./tools"; * * Returns lifecycle tools only (list_apps, connect_app, disconnect_app). * Dynamic affordance tools should be wired via MCP's tools/list_changed - * using `createDynamicTools()` from the main export. + * using `createDynamicTools()` from `@slop-ai/discovery/tools`. */ export function createSlopAgentTools(discovery: ReturnType) { const handlers = createToolHandlers(discovery); diff --git a/website/docs/src/content/docs/sdk/discovery.md b/website/docs/src/content/docs/sdk/discovery.md index e0e91d9..8a69021 100644 --- a/website/docs/src/content/docs/sdk/discovery.md +++ b/website/docs/src/content/docs/sdk/discovery.md @@ -42,6 +42,8 @@ Integrations (Claude Code plugin, OpenClaw plugin, VS Code extension, custom age Integrations compose these entrypoints: `@slop-ai/discovery/service` for provider scanning and connection orchestration, `@slop-ai/discovery/tools` when they need lifecycle or dynamic-tool helpers, and the root export when they need direct bridge primitives. +These are subpath entrypoints of the same published `@slop-ai/discovery` package, not separately published npm packages. They currently share one install-time dependency set even when a consumer only imports the root, `/service`, or `/tools` entrypoint. + ## Phase 1: Core Discovery Layer As of `v0.1`, the **core discovery layer** is shipped across TypeScript, Python, Go, and Rust. The TypeScript implementation remains the behavioral reference, but other SDKs do **not** need to copy its package topology.