@dxos/introspect-tools 0.8.4-main.fdfb99ef29 → 0.8.4-staging.60fe92afc8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
- "sources": ["../../../src/limits.ts", "../../../src/metadata.ts", "../../../src/schemas.ts"],
4
- "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\n// Shared list-pagination constants used by both the schema definitions\n// (`Schema.lessThanOrEqualTo(MAX_LIST_LIMIT)` on every list tool's `limit`\n// field) and by the server-side response shapers in @dxos/introspect-mcp.\n// Lives here so the contract surface (introspect-tools) doesn't have to\n// import from the runtime package.\n\n/** Default number of items returned by list-style tools when no `limit` is passed. */\nexport const DEFAULT_LIST_LIMIT = 30;\n\n/**\n * Hard ceiling on `limit`. A runaway tool call shouldn't be able to dump every\n * symbol in the monorepo (~thousands) into the model's context. Callers who\n * truly need everything should iterate via filters (pluginId, package, etc.).\n */\nexport const MAX_LIST_LIMIT = 200;\n\n/**\n * Per-call options every list-style tool accepts. Both fields are optional\n * — the defaults match `DEFAULT_LIST_LIMIT` items, full projection.\n */\nexport type ListOptions = {\n /** Override the default `DEFAULT_LIST_LIMIT`. Capped at `MAX_LIST_LIMIT`. */\n limit?: number;\n /**\n * Return only the most-essential identifying fields (ref/id/name) instead\n * of the full record. Use when discovering what exists before drilling in\n * with a `get_*` call. Roughly 1/4 the token cost.\n */\n compact?: boolean;\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// Static tool metadata + the Effect Schema → Zod adapter for the MCP SDK.\n//\n// Pure data + a stateless converter — no introspector, no Node-only deps,\n// no MCP SDK. The introspect-mcp server consumes this map at startup to\n// register each tool with a handler closing over its `Introspector`;\n// browser-side consumers (react-ui-introspect, etc.) consume the same map\n// to render forms / lists / docs from a single source of truth.\n\nimport * as Schema from 'effect/Schema';\nimport type { z } from 'zod';\n\nimport { effectFieldsToZod } from '@dxos/effect-zod';\nimport { trim } from '@dxos/util';\n\nimport {\n FindSymbolInput,\n GetPackageInput,\n GetSymbolInput,\n ListCapabilitiesInput,\n ListOperationsInput,\n ListPackagesInput,\n ListPluginsInput,\n ListSchemasInput,\n ListSurfacesInput,\n ListSymbolsInput,\n} from './schemas';\n\n/**\n * Pure metadata for a single MCP tool — what an MCP client needs to know\n * before invoking it: human-readable title, an LLM-targeted description,\n * and the Effect Schema input contract.\n */\nexport type ToolMetadata = {\n /** Human-readable title surfaced by Inspector / Composer. */\n title: string;\n\n /**\n * LLM-targeted description. Models read this to decide WHEN to call the\n * tool — write it for trigger accuracy, not for human reading. State both\n * what the tool does and the situations it's the right answer for.\n */\n description: string;\n\n /**\n * Effect Schema struct describing the tool's input. Server-side, the\n * MCP SDK requires zod, so the server converts to zod via\n * `inputSchemaToZod` at registration time. Browser consumers\n * (react-ui-form, etc.) use this directly.\n */\n inputSchema: Schema.Struct<any>;\n};\n\n/**\n * Static metadata for every tool the introspect-mcp server exposes. No\n * introspector or runtime state — safe to import from a browser bundle.\n *\n * Adding a tool means: (1) define its input schema in `./schemas.ts`,\n * (2) add an entry here, (3) add a matching handler in\n * `@dxos/introspect-mcp` that closes over a runtime `Introspector`.\n */\nexport const TOOL_METADATA: Record<string, ToolMetadata> = {\n list_packages: {\n title: 'List monorepo packages',\n description: trim`\n List packages in the DXOS monorepo. Use this to discover what packages exist before drilling into one.\n Supports filtering by name substring, path prefix (e.g. \"packages/plugins\"), or workspace-private only.\n Returns lightweight rows; call get_package for dependency and entry-point detail.\n `,\n inputSchema: ListPackagesInput,\n },\n get_package: {\n title: 'Get package detail',\n description: trim`\n Fetch the full record for a single package by its name (e.g. \"@dxos/echo\").\n Returns workspace and external dependencies, entry points, and metadata.\n Use after list_packages or when the user references a package directly.\n `,\n inputSchema: GetPackageInput,\n },\n list_symbols: {\n title: 'List all exported symbols of a package',\n description: trim`\n Enumerate every exported symbol declared by a single package (e.g. all exports of \"@dxos/echo-react\").\n Use this when the user wants to know what a specific package offers, or to browse a package after get_package.\n Returns lightweight rows with refs you can pass to get_symbol; capped at 30 — refine with \\`kind\\` or call get_symbol directly.\n `,\n inputSchema: ListSymbolsInput,\n },\n find_symbol: {\n title: 'Find an exported symbol by name',\n description: trim`\n Find an exported symbol (function, class, type, hook, schema) by name or partial name across all DXOS packages.\n Use this when the user references something by name and you need to locate which package owns it before reading more.\n Returns refs you can pass to get_symbol. Ranking: exact match, then prefix, then substring.\n `,\n inputSchema: FindSymbolInput,\n },\n get_symbol: {\n title: 'Get symbol detail',\n description: trim`\n Fetch detail for a single symbol by ref (e.g. \"@dxos/echo#Expando\").\n Default response is signature + JSDoc summary + source location.\n Pass include=[\"source\"] to expand the full declaration text, include=[\"jsdoc\"] for the full JSDoc body.\n `,\n inputSchema: GetSymbolInput,\n },\n list_plugins: {\n title: 'List Composer plugins',\n description: trim`\n List plugins detected in the monorepo. A plugin is a package whose src/meta.ts exports a \\`Plugin.Meta\\`.\n Use this to discover what plugins exist before drilling into surfaces / capabilities / operations / schemas.\n Filter by \\`id\\` substring (e.g. \"markdown\") to narrow the list.\n `,\n inputSchema: ListPluginsInput,\n },\n list_surfaces: {\n title: 'List surfaces',\n description: trim`\n List Surface.create({ id, role, ... }) contributions across the monorepo. Use this to discover available\n surface ids when wiring a new container, or to check whether a surface name is already taken.\n Filter by \\`id\\` (plugin id) to scope to a single plugin's surfaces.\n `,\n inputSchema: ListSurfacesInput,\n },\n list_capabilities: {\n title: 'List capability contributions',\n description: trim`\n List Capability.contributes(<key>, ...) calls across the monorepo. Use this to discover which capability\n keys are produced (or required) by which plugins. Filter by \\`id\\` (plugin id) to scope to a single plugin.\n `,\n inputSchema: ListCapabilitiesInput,\n },\n list_operations: {\n title: 'List operations',\n description: trim`\n List operations contributed by plugins. An *operation* is a serializable\n request (verb + payload) dispatched through the OperationInvoker —\n Composer's equivalent of an action / command. Most plugins contribute\n these via \\`Capabilities.OperationHandler\\`. Filter by \\`id\\` (plugin id)\n to scope to a single plugin.\n `,\n inputSchema: ListOperationsInput,\n },\n list_schemas: {\n title: 'List schemas',\n description: trim`\n List ECHO-registered types contributed by plugins (declared via addSchemaModule).\n Use this to discover what data types exist before reading their shape.\n Filter by \\`id\\` (plugin id, e.g. \"org.dxos.plugin.markdown\") to scope to a single plugin's schemas.\n `,\n inputSchema: ListSchemasInput,\n },\n};\n\n/**\n * Materialize a tool's `inputSchema` (Effect Struct) into the\n * `Record<string, z.ZodTypeAny>` shape the MCP SDK's `registerTool` requires.\n * Called once per tool at server startup; throws with a clear message if a\n * tool's input uses a schema pattern the converter doesn't support.\n */\nexport const inputSchemaToZod = (struct: Schema.Struct<any>): Record<string, z.ZodTypeAny> => effectFieldsToZod(struct);\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// Effect Schema input definitions for every MCP tool.\n//\n// These are the source of truth: `@dxos/introspect-mcp` converts them to zod\n// at registration time (the MCP SDK requires zod), and downstream consumers\n// like `react-ui-form` import them directly to render forms.\n//\n// Convention: every field's description goes on the OUTERMOST wrapper.\n// - Optional fields: `.annotations({ description })` on `Schema.optional(...)`.\n// - Required fields: `.annotations({ description })` on the primitive itself.\n\nimport * as Schema from 'effect/Schema';\n\nimport { trim } from '@dxos/util';\n\nimport { DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT } from './limits';\n\n/**\n * Pagination + projection options shared by every list-style tool. Spread its\n * `.fields` into a tool's `Schema.Struct({...})` so the same pair of knobs\n * appears on every list endpoint without copy-paste.\n *\n * The default behavior (no `limit`, no `compact`) matches the old hard-cap-of-30\n * shape, so callers that don't pass these args see no change.\n */\nexport const ListOptionsInput = Schema.Struct({\n limit: Schema.optional(\n Schema.Number.pipe(Schema.int(), Schema.positive(), Schema.lessThanOrEqualTo(MAX_LIST_LIMIT)),\n ).annotations({\n title: 'Limit',\n description: trim`\n Maximum number of items to return. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.\n `,\n }),\n compact: Schema.optional(Schema.Boolean).annotations({\n title: 'Compact',\n description: trim`\n If true, returns only the most-essential identifying fields for each item — about 1/4 the response size.\n Use when discovering what exists before drilling in.\n `,\n }),\n});\n\nconst SymbolKindEnum = Schema.Literal('function', 'class', 'interface', 'type', 'enum', 'variable', 'namespace');\n\nconst IncludeEnum = Schema.Literal('source', 'jsdoc');\n\n//\n// Packages\n//\n\nexport const ListPackagesInput = Schema.Struct({\n name: Schema.optional(Schema.String).annotations({\n title: 'Name filter',\n description: 'Substring of the package name (case-insensitive).',\n }),\n pathPrefix: Schema.optional(Schema.String).annotations({\n title: 'Path prefix',\n description: 'Restrict to packages whose path starts with this segment, e.g. \"packages/plugins\".',\n }),\n privateOnly: Schema.optional(Schema.Boolean).annotations({\n title: 'Private only',\n description: 'If true, only include workspace-private packages.',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const GetPackageInput = Schema.Struct({\n name: Schema.String.annotations({\n title: 'Package name',\n description: 'Exact package name, e.g. \"@dxos/echo\".',\n }),\n});\n\n//\n// Symbols\n//\n\nexport const ListSymbolsInput = Schema.Struct({\n package: Schema.String.annotations({\n title: 'Package',\n description: 'Exact package name, e.g. \"@dxos/ai\".',\n }),\n kind: Schema.optional(SymbolKindEnum).annotations({\n title: 'Kind',\n description: 'Optional filter on declaration kind.',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const FindSymbolInput = Schema.Struct({\n query: Schema.String.annotations({\n title: 'Query',\n description: 'Symbol name or partial name (case-insensitive).',\n }),\n kind: Schema.optional(SymbolKindEnum).annotations({\n title: 'Kind',\n description: 'Optional filter on declaration kind.',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const GetSymbolInput = Schema.Struct({\n ref: Schema.String.annotations({\n title: 'Symbol ref',\n description: 'Symbol ref in the form \"<package>#<name>\", e.g. \"@dxos/echo#Expando\".',\n }),\n include: Schema.optional(Schema.Array(IncludeEnum)).annotations({\n title: 'Include',\n description: 'Optional fields to expand; default returns signature + summary only.',\n }),\n});\n\n//\n// Plugins / surfaces / capabilities / operations / schemas\n//\n// Main's API exposes a single optional `id` filter on each of these — the\n// plugin id (e.g. \"org.dxos.plugin.markdown\"). `listPlugins` accepts a\n// `PluginFilter` object with `id` for substring matching.\n//\n\nexport const ListPluginsInput = Schema.Struct({\n id: Schema.optional(Schema.String).annotations({\n title: 'Plugin id',\n description: 'Substring of the plugin id (case-insensitive). Omit to list every plugin.',\n }),\n ...ListOptionsInput.fields,\n});\n\nconst PluginIdFilter = Schema.Struct({\n id: Schema.optional(Schema.String).annotations({\n title: 'Plugin id',\n description: 'Restrict to contributions from this plugin id (e.g. \"org.dxos.plugin.markdown\").',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const ListSurfacesInput = PluginIdFilter;\nexport const ListCapabilitiesInput = PluginIdFilter;\nexport const ListOperationsInput = PluginIdFilter;\nexport const ListSchemasInput = PluginIdFilter;\n\n//\n// Inferred TypeScript types — handy for downstream consumers.\n//\n\nexport type ListPackagesArgs = typeof ListPackagesInput.Type;\nexport type GetPackageArgs = typeof GetPackageInput.Type;\nexport type ListSymbolsArgs = typeof ListSymbolsInput.Type;\nexport type FindSymbolArgs = typeof FindSymbolInput.Type;\nexport type GetSymbolArgs = typeof GetSymbolInput.Type;\nexport type ListPluginsArgs = typeof ListPluginsInput.Type;\nexport type ListSurfacesArgs = typeof ListSurfacesInput.Type;\nexport type ListCapabilitiesArgs = typeof ListCapabilitiesInput.Type;\nexport type ListOperationsArgs = typeof ListOperationsInput.Type;\nexport type ListSchemasArgs = typeof ListSchemasInput.Type;\n"],
5
- "mappings": "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",
6
- "names": ["DEFAULT_LIST_LIMIT", "MAX_LIST_LIMIT", "effectFieldsToZod", "trim", "Schema", "trim", "ListOptionsInput", "Struct", "limit", "optional", "Number", "pipe", "int", "positive", "lessThanOrEqualTo", "MAX_LIST_LIMIT", "annotations", "title", "description", "trim", "DEFAULT_LIST_LIMIT", "compact", "Boolean", "SymbolKindEnum", "Literal", "IncludeEnum", "ListPackagesInput", "name", "String", "pathPrefix", "privateOnly", "fields", "GetPackageInput", "ListSymbolsInput", "package", "kind", "FindSymbolInput", "query", "GetSymbolInput", "ref", "include", "Array", "ListPluginsInput", "id", "PluginIdFilter", "ListSurfacesInput", "ListCapabilitiesInput", "ListOperationsInput", "ListSchemasInput", "TOOL_METADATA", "list_packages", "title", "description", "trim", "inputSchema", "ListPackagesInput", "get_package", "GetPackageInput", "list_symbols", "ListSymbolsInput", "find_symbol", "FindSymbolInput", "get_symbol", "GetSymbolInput", "list_plugins", "ListPluginsInput", "list_surfaces", "ListSurfacesInput", "list_capabilities", "ListCapabilitiesInput", "list_operations", "ListOperationsInput", "list_schemas", "ListSchemasInput", "inputSchemaToZod", "struct", "effectFieldsToZod"]
3
+ "sources": ["../../../src/limits.ts", "../../../src/metadata.ts", "../../../src/output-schemas.ts", "../../../src/schemas.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\n// Shared list-pagination constants used by both the schema definitions\n// (`Schema.lessThanOrEqualTo(MAX_LIST_LIMIT)` on every list tool's `limit`\n// field) and by the server-side response shapers in @dxos/introspect-mcp.\n// Lives here so the contract surface (introspect-tools) doesn't have to\n// import from the runtime package.\n\n/** Default number of items returned by list-style tools when no `limit` is passed. */\nexport const DEFAULT_LIST_LIMIT = 30;\n\n/**\n * Hard ceiling on `limit`. A runaway tool call shouldn't be able to dump every\n * symbol in the monorepo (~thousands) into the model's context. Callers who\n * truly need everything should iterate via filters (pluginId, package, etc.).\n */\nexport const MAX_LIST_LIMIT = 200;\n\n/**\n * Per-call options every list-style tool accepts. Both fields are optional\n * — the defaults match `DEFAULT_LIST_LIMIT` items, full projection.\n */\nexport type ListOptions = {\n /** Override the default `DEFAULT_LIST_LIMIT`. Capped at `MAX_LIST_LIMIT`. */\n limit?: number;\n /**\n * Return only the most-essential identifying fields (ref/id/name) instead\n * of the full record. Use when discovering what exists before drilling in\n * with a `get_*` call. Roughly 1/4 the token cost.\n */\n compact?: boolean;\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// Static tool metadata + the Effect Schema → Zod adapter for the MCP SDK.\n//\n// Pure data + a stateless converter — no introspector, no Node-only deps,\n// no MCP SDK. The introspect-mcp server consumes this map at startup to\n// register each tool with a handler closing over its `Introspector`;\n// browser-side consumers (react-ui-introspect, etc.) consume the same map\n// to render forms / lists / docs from a single source of truth.\n\nimport * as Schema from 'effect/Schema';\nimport type { z } from 'zod';\n\nimport { effectFieldsToZod } from '@dxos/effect-zod';\nimport { trim } from '@dxos/util';\n\nimport {\n CapabilitySchema,\n IdiomSchema,\n OperationSchema,\n PackageSchema,\n PluginSchema,\n SchemaSchema,\n SurfaceSchema,\n SymbolDetailSchema,\n SymbolMatchSchema,\n} from './output-schemas';\nimport {\n FindSymbolInput,\n GetPackageInput,\n GetSymbolInput,\n ListCapabilitiesInput,\n ListIdiomsInput,\n ListOperationsInput,\n ListPackagesInput,\n ListPluginsInput,\n ListSchemasInput,\n ListSurfacesInput,\n ListSymbolsInput,\n} from './schemas';\n\n/**\n * Pure metadata for a single MCP tool — what an MCP client needs to know\n * before invoking it: human-readable title, an LLM-targeted description,\n * and the Effect Schema input contract.\n */\nexport type ToolMetadata = {\n /** Human-readable title surfaced by Inspector / Composer. */\n title: string;\n\n /**\n * LLM-targeted description. Models read this to decide WHEN to call the\n * tool — write it for trigger accuracy, not for human reading. State both\n * what the tool does and the situations it's the right answer for.\n */\n description: string;\n\n /**\n * Effect Schema struct describing the tool's input. Server-side, the\n * MCP SDK requires zod, so the server converts to zod via\n * `inputSchemaToZod` at registration time. Browser consumers\n * (react-ui-form, etc.) use this directly.\n */\n inputSchema: Schema.Struct<any>;\n\n /**\n * Effect Schema struct describing the tool's success return shape.\n * MCP's `structuredContent` must be a JSON object, so each tool wraps\n * its item(s) under a stable top-level key (e.g. `{ packages: [...] }`,\n * `{ package: null | {...} }`). Consumers building Effect AI Tools can\n * pass this directly as `success` to `Tool.make`.\n */\n outputSchema: Schema.Struct<any>;\n};\n\n/**\n * Static metadata for every tool the introspect-mcp server exposes. No\n * introspector or runtime state — safe to import from a browser bundle.\n *\n * Adding a tool means: (1) define its input schema in `./schemas.ts`,\n * (2) add an entry here, (3) add a matching handler in\n * `@dxos/introspect-mcp` that closes over a runtime `Introspector`.\n */\nexport const TOOL_METADATA: Record<string, ToolMetadata> = {\n list_packages: {\n title: 'List monorepo packages',\n description: trim`\n List packages in the DXOS monorepo. Use this to discover what packages exist before drilling into one.\n Supports filtering by name substring, path prefix (e.g. \"packages/plugins\"), or workspace-private only.\n Returns lightweight rows; call get_package for dependency and entry-point detail.\n `,\n inputSchema: ListPackagesInput,\n outputSchema: Schema.Struct({ packages: Schema.Array(PackageSchema) }),\n },\n get_package: {\n title: 'Get package detail',\n description: trim`\n Fetch the full record for a single package by its name (e.g. \"@dxos/echo\").\n Returns workspace and external dependencies, entry points, and metadata.\n Use after list_packages or when the user references a package directly.\n `,\n inputSchema: GetPackageInput,\n outputSchema: Schema.Struct({ package: Schema.NullOr(PackageSchema) }),\n },\n list_symbols: {\n title: 'List all exported symbols of a package',\n description: trim`\n Enumerate every exported symbol declared by a single package (e.g. all exports of \"@dxos/echo-react\").\n Use this when the user wants to know what a specific package offers, or to browse a package after get_package.\n Returns lightweight rows with refs you can pass to get_symbol; capped at 30 — refine with \\`kind\\` or call get_symbol directly.\n `,\n inputSchema: ListSymbolsInput,\n outputSchema: Schema.Struct({ symbols: Schema.Array(SymbolMatchSchema) }),\n },\n find_symbol: {\n title: 'Find an exported symbol by name',\n description: trim`\n Find an exported symbol (function, class, type, hook, schema) by name or partial name across all DXOS packages.\n Use this when the user references something by name and you need to locate which package owns it before reading more.\n Returns refs you can pass to get_symbol. Ranking: exact match, then prefix, then substring.\n `,\n inputSchema: FindSymbolInput,\n outputSchema: Schema.Struct({ matches: Schema.Array(SymbolMatchSchema) }),\n },\n get_symbol: {\n title: 'Get symbol detail',\n description: trim`\n Fetch detail for a single symbol by ref (e.g. \"@dxos/echo#Expando\").\n Default response is signature + JSDoc summary + source location.\n Pass include=[\"source\"] to expand the full declaration text, include=[\"jsdoc\"] for the full JSDoc body.\n `,\n inputSchema: GetSymbolInput,\n outputSchema: Schema.Struct({ symbol: Schema.NullOr(SymbolDetailSchema) }),\n },\n list_plugins: {\n title: 'List Composer plugins',\n description: trim`\n List plugins detected in the monorepo. A plugin is a package whose src/meta.ts exports a \\`Plugin.Meta\\`.\n Use this to discover what plugins exist before drilling into surfaces / capabilities / operations / schemas.\n Filter by \\`id\\` substring (e.g. \"markdown\") to narrow the list.\n `,\n inputSchema: ListPluginsInput,\n outputSchema: Schema.Struct({ plugins: Schema.Array(PluginSchema) }),\n },\n list_surfaces: {\n title: 'List surfaces',\n description: trim`\n List Surface.create({ id, role, ... }) contributions across the monorepo. Use this to discover available\n surface ids when wiring a new container, or to check whether a surface name is already taken.\n Filter by \\`id\\` (plugin id) to scope to a single plugin's surfaces.\n `,\n inputSchema: ListSurfacesInput,\n outputSchema: Schema.Struct({ surfaces: Schema.Array(SurfaceSchema) }),\n },\n list_capabilities: {\n title: 'List capability contributions',\n description: trim`\n List Capability.contributes(<key>, ...) calls across the monorepo. Use this to discover which capability\n keys are produced (or required) by which plugins. Filter by \\`id\\` (plugin id) to scope to a single plugin.\n `,\n inputSchema: ListCapabilitiesInput,\n outputSchema: Schema.Struct({ capabilities: Schema.Array(CapabilitySchema) }),\n },\n list_operations: {\n title: 'List operations',\n description: trim`\n List operations contributed by plugins. An *operation* is a serializable\n request (verb + payload) dispatched through the OperationInvoker —\n Composer's equivalent of an action / command. Most plugins contribute\n these via \\`Capabilities.OperationHandler\\`. Filter by \\`id\\` (plugin id)\n to scope to a single plugin.\n `,\n inputSchema: ListOperationsInput,\n outputSchema: Schema.Struct({ operations: Schema.Array(OperationSchema) }),\n },\n list_schemas: {\n title: 'List schemas',\n description: trim`\n List ECHO-registered types contributed by plugins (declared via addSchemaModule).\n Use this to discover what data types exist before reading their shape.\n Filter by \\`id\\` (plugin id, e.g. \"org.dxos.plugin.markdown\") to scope to a single plugin's schemas.\n `,\n inputSchema: ListSchemasInput,\n outputSchema: Schema.Struct({ schemas: Schema.Array(SchemaSchema) }),\n },\n list_idioms: {\n title: 'List idioms',\n description: trim`\n List idioms catalogued across the monorepo. An *idiom* is a JSDoc-tagged\n reference example (\\`@idiom <slug>\\`) that pins the canonical way to use a\n symbol — applicability, anti-pattern, and links to related idioms. Use this\n to discover how a feature is meant to be used, or to find a worked example\n before writing new code. Filter by \\`slug\\` substring or by \\`hostKind\\`\n (\\`symbol\\`, \\`story\\`, \\`test\\`).\n `,\n inputSchema: ListIdiomsInput,\n outputSchema: Schema.Struct({ idioms: Schema.Array(IdiomSchema) }),\n },\n};\n\n/**\n * Materialize a tool's `inputSchema` (Effect Struct) into the\n * `Record<string, z.ZodTypeAny>` shape the MCP SDK's `registerTool` requires.\n * Called once per tool at server startup; throws with a clear message if a\n * tool's input uses a schema pattern the converter doesn't support.\n */\nexport const inputSchemaToZod = (struct: Schema.Struct<any>): Record<string, z.ZodTypeAny> => effectFieldsToZod(struct);\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// Effect Schema definitions for every introspect tool *result* (output) shape.\n//\n// These are the source of truth for the data returned by `@dxos/introspect`.\n// `@dxos/introspect/src/types.ts` re-derives its TypeScript types from these\n// schemas, and downstream consumers that can't depend on `@dxos/introspect`\n// (browser/worker contexts — `@dxos/introspect` pulls Node-only `ts-morph`\n// and `glob`) import the schemas directly.\n\nimport * as Schema from 'effect/Schema';\n\n//\n// Primitives\n//\n\nexport const SymbolKindSchema = Schema.Literal(\n 'function',\n 'class',\n 'interface',\n 'type',\n 'enum',\n 'variable',\n 'namespace',\n 'unknown',\n);\nexport type SymbolKind = typeof SymbolKindSchema.Type;\n\nexport const SymbolIncludeSchema = Schema.Literal('source', 'jsdoc');\nexport type SymbolInclude = typeof SymbolIncludeSchema.Type;\n\nexport const SourceLocationSchema = Schema.Struct({\n file: Schema.String,\n line: Schema.Number,\n column: Schema.Number,\n});\nexport type SourceLocation = typeof SourceLocationSchema.Type;\n\nexport const PluginIdSchema = Schema.String;\nexport type PluginId = typeof PluginIdSchema.Type;\n\n//\n// Packages\n//\n\nexport const PackageSchema = Schema.Struct({\n name: Schema.String,\n version: Schema.String,\n private: Schema.Boolean,\n /** Path relative to the monorepo root (no trailing slash). */\n path: Schema.String,\n description: Schema.optional(Schema.String),\n});\nexport type Package = typeof PackageSchema.Type;\n\nexport const PackageDetailSchema = Schema.Struct({\n ...PackageSchema.fields,\n /** Workspace dependencies (other packages in the monorepo). */\n workspaceDependencies: Schema.Array(Schema.String),\n /** External (catalog or pinned) dependency names. */\n externalDependencies: Schema.Array(Schema.String),\n /** Resolved entry points (relative to package root). */\n entryPoints: Schema.Array(Schema.String),\n /** Number of exported symbols at the top level. */\n exportCount: Schema.Number,\n});\nexport type PackageDetail = typeof PackageDetailSchema.Type;\n\n//\n// Symbols\n//\n\nexport const SymbolMatchSchema = Schema.Struct({\n ref: Schema.String,\n package: Schema.String,\n name: Schema.String,\n kind: SymbolKindSchema,\n /** One-line summary from JSDoc, if any. */\n summary: Schema.optional(Schema.String),\n});\nexport type SymbolMatch = typeof SymbolMatchSchema.Type;\n\nexport const SymbolDetailSchema = Schema.Struct({\n ref: Schema.String,\n package: Schema.String,\n name: Schema.String,\n kind: SymbolKindSchema,\n signature: Schema.String,\n jsdoc: Schema.optional(Schema.String),\n summary: Schema.optional(Schema.String),\n location: SourceLocationSchema,\n /** Source text — only present when `include` requested it. */\n source: Schema.optional(Schema.String),\n});\nexport type SymbolDetail = typeof SymbolDetailSchema.Type;\n\n//\n// Plugins / surfaces / capabilities / operations / schemas\n//\n\nexport const PluginSchema = Schema.Struct({\n /** e.g. `org.dxos.plugin.code`. */\n id: PluginIdSchema,\n /** npm package name, e.g. `@dxos/plugin-code`. */\n package: Schema.String,\n name: Schema.optional(Schema.String),\n description: Schema.optional(Schema.String),\n icon: Schema.optional(Schema.String),\n iconHue: Schema.optional(Schema.String),\n /** Static tags read from `meta.tags` (e.g. `['labs']`). Empty array if absent. */\n tags: Schema.Array(Schema.String),\n /**\n * Ids of other plugins this plugin depends on, derived from its package's\n * `workspace:*` dependencies. Sorted for deterministic output. Empty array\n * if the plugin's package has no dependencies on other plugin packages.\n */\n dependsOn: Schema.Array(PluginIdSchema),\n /** Source location of the `meta` declaration. */\n metaLocation: SourceLocationSchema,\n});\nexport type Plugin = typeof PluginSchema.Type;\n\nexport const SurfaceSchema = Schema.Struct({\n pluginId: PluginIdSchema,\n /** Surface id passed to `Surface.create({ id })`. */\n id: Schema.String,\n /** One or more roles the surface answers to. */\n role: Schema.Array(Schema.String),\n location: SourceLocationSchema,\n});\nexport type Surface = typeof SurfaceSchema.Type;\n\nexport const CapabilitySchema = Schema.Struct({\n pluginId: PluginIdSchema,\n /** Identifier expression as written in source, e.g. `Capabilities.ReactSurface`. */\n type: Schema.String,\n location: SourceLocationSchema,\n});\nexport type Capability = typeof CapabilitySchema.Type;\n\nexport const OperationSchema = Schema.Struct({\n pluginId: PluginIdSchema,\n /** Operation identifier expression. */\n type: Schema.String,\n location: SourceLocationSchema,\n});\nexport type Operation = typeof OperationSchema.Type;\n\nexport const SchemaSchema = Schema.Struct({\n pluginId: PluginIdSchema,\n /** Identifier expression as written in `addSchemaModule`, e.g. `CodeProject.CodeProject`. */\n name: Schema.String,\n /** Resolved typename (e.g. `org.dxos.type.codeProject`) when statically extractable. */\n typename: Schema.optional(Schema.String),\n location: SourceLocationSchema,\n});\nexport type SchemaContribution = typeof SchemaSchema.Type;\n\nexport const PluginDetailSchema = Schema.Struct({\n ...PluginSchema.fields,\n surfaces: Schema.Array(SurfaceSchema),\n capabilities: Schema.Array(CapabilitySchema),\n operations: Schema.Array(OperationSchema),\n schemas: Schema.Array(SchemaSchema),\n});\nexport type PluginDetail = typeof PluginDetailSchema.Type;\n\n//\n// Idioms\n//\n\nexport const IdiomHostKindSchema = Schema.Literal('story', 'test', 'symbol');\nexport type IdiomHostKind = typeof IdiomHostKindSchema.Type;\n\nexport const IdiomHostSchema = Schema.Struct({\n /** Path relative to the scan root. */\n file: Schema.String,\n /** 1-indexed line where the JSDoc opens. */\n line: Schema.Number,\n /** Best-effort name of the export immediately following the JSDoc. */\n symbol: Schema.optional(Schema.String),\n /** Detected host kind based on file location and symbol shape. */\n kind: IdiomHostKindSchema,\n});\nexport type IdiomHost = typeof IdiomHostSchema.Type;\n\nexport const IdiomSchema = Schema.Struct({\n /** Globally unique AT Protocol NSID (https://atproto.com/specs/nsid). */\n slug: Schema.String,\n /** Leading JSDoc paragraph (rationale). */\n summary: Schema.optional(Schema.String),\n /** Applicability (required field per IDIOMS.md). */\n applies: Schema.String,\n /** Anti-pattern this replaces. */\n insteadOf: Schema.optional(Schema.String),\n /** Raw {@link …} targets named under `uses:`. */\n uses: Schema.Array(Schema.String),\n /** Slugs of related idioms. */\n related: Schema.Array(Schema.String),\n host: IdiomHostSchema,\n});\nexport type Idiom = typeof IdiomSchema.Type;\n\n//\n// Sidecar file format\n//\n\n/**\n * Shape of the `plugins.json` sidecar stored in R2 / written by the cache\n * upload script. Uses plain mutable arrays so callers can work with standard\n * JSON.parse output without readonly friction.\n */\nexport type PluginsFile = {\n version: 1;\n plugins: Plugin[];\n surfaces: Surface[];\n capabilities: Capability[];\n operations: Operation[];\n schemas: SchemaContribution[];\n idioms?: Idiom[];\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// Effect Schema input definitions for every MCP tool.\n//\n// These are the source of truth: `@dxos/introspect-mcp` converts them to zod\n// at registration time (the MCP SDK requires zod), and downstream consumers\n// like `react-ui-form` import them directly to render forms.\n//\n// Convention: every field's description goes on the OUTERMOST wrapper.\n// - Optional fields: `.annotations({ description })` on `Schema.optional(...)`.\n// - Required fields: `.annotations({ description })` on the primitive itself.\n\nimport * as Schema from 'effect/Schema';\nimport * as SchemaAST from 'effect/SchemaAST';\n\nimport { trim } from '@dxos/util';\n\nimport { DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT } from './limits';\n\n/**\n * Annotation key for fields whose value should be picked from a known\n * enumeration that the MCP server can produce on demand. Consumers\n * (e.g. `@dxos/react-ui-introspect`'s ToolForm) read this annotation off\n * the field's AST and render a Combobox over the matching list.\n *\n * The kind names a domain rather than a specific tool — e.g. `plugin-id`\n * means \"any tool that emits plugin ids works\" — so adding a new tool\n * doesn't require new picker plumbing.\n */\nexport const PickerAnnotationId = '@dxos/introspect-tools/picker';\n\nexport type PickerKind = 'plugin-id' | 'package-name';\n\nexport const getPicker = (ast: SchemaAST.AST): PickerKind | undefined =>\n (ast.annotations as Record<string, unknown>)[PickerAnnotationId] as PickerKind | undefined;\n\n/**\n * Pagination + projection options shared by every list-style tool. Spread its\n * `.fields` into a tool's `Schema.Struct({...})` so the same pair of knobs\n * appears on every list endpoint without copy-paste.\n *\n * The default behavior (no `limit`, no `compact`) matches the old hard-cap-of-30\n * shape, so callers that don't pass these args see no change.\n */\nexport const ListOptionsInput = Schema.Struct({\n limit: Schema.optional(\n Schema.Number.pipe(Schema.int(), Schema.positive(), Schema.lessThanOrEqualTo(MAX_LIST_LIMIT)),\n ).annotations({\n title: 'Limit',\n description: trim`\n Maximum number of items. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.\n `,\n }),\n compact: Schema.optional(Schema.Boolean).annotations({\n title: 'Compact',\n description: trim`\n If true, returns only the most-essential identifying fields for each item — about 1/4 the response size.\n Use when discovering what exists before drilling in.\n `,\n }),\n});\n\nconst SymbolKindEnum = Schema.Literal('function', 'class', 'interface', 'type', 'enum', 'variable', 'namespace');\n\nconst IncludeEnum = Schema.Literal('source', 'jsdoc');\n\n//\n// Packages\n//\n\nexport const ListPackagesInput = Schema.Struct({\n name: Schema.optional(Schema.String).annotations({\n title: 'Name filter',\n description: 'Substring of the package name (case-insensitive).',\n [PickerAnnotationId]: 'package-name' satisfies PickerKind,\n }),\n pathPrefix: Schema.optional(Schema.String).annotations({\n title: 'Path prefix',\n }),\n privateOnly: Schema.optional(Schema.Boolean).annotations({\n title: 'Private only',\n description: 'If true, only include workspace-private packages.',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const GetPackageInput = Schema.Struct({\n name: Schema.String.annotations({\n title: 'Package name',\n description: 'Exact package name, e.g. \"@dxos/echo\".',\n [PickerAnnotationId]: 'package-name' satisfies PickerKind,\n }),\n});\n\n//\n// Symbols\n//\n\nexport const ListSymbolsInput = Schema.Struct({\n package: Schema.String.annotations({\n title: 'Package',\n description: 'Exact package name, e.g. \"@dxos/ai\".',\n [PickerAnnotationId]: 'package-name' satisfies PickerKind,\n }),\n kind: Schema.optional(SymbolKindEnum).annotations({\n title: 'Kind',\n description: 'Optional filter on declaration kind.',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const FindSymbolInput = Schema.Struct({\n query: Schema.String.annotations({\n title: 'Query',\n description: 'Symbol name or partial name (case-insensitive).',\n }),\n kind: Schema.optional(SymbolKindEnum).annotations({\n title: 'Kind',\n description: 'Optional filter on declaration kind.',\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const GetSymbolInput = Schema.Struct({\n ref: Schema.String.annotations({\n title: 'Symbol ref',\n description: 'Symbol ref in the form \"<package>#<name>\", e.g. \"@dxos/echo#Expando\".',\n }),\n include: Schema.optional(Schema.Array(IncludeEnum)).annotations({\n title: 'Include',\n description: 'Optional fields to expand; default returns signature + summary only.',\n }),\n});\n\n//\n// Plugins / surfaces / capabilities / operations / schemas\n//\n// Main's API exposes a single optional `id` filter on each of these — the\n// plugin id (e.g. \"org.dxos.plugin.markdown\"). `listPlugins` accepts a\n// `PluginFilter` object with `id` for substring matching.\n//\n\nexport const ListPluginsInput = Schema.Struct({\n // No picker annotation — this is a free-form substring filter, not an\n // exact-match selector. Picking from the list of known plugin ids would\n // defeat the purpose of `list_plugins`.\n id: Schema.optional(Schema.String).annotations({\n title: 'Plugin id',\n description: 'Substring of the plugin id (case-insensitive). Omit to list every plugin.',\n }),\n ...ListOptionsInput.fields,\n});\n\nconst PluginIdFilter = Schema.Struct({\n id: Schema.optional(Schema.String).annotations({\n title: 'Plugin id',\n [PickerAnnotationId]: 'plugin-id' satisfies PickerKind,\n }),\n ...ListOptionsInput.fields,\n});\n\nexport const ListSurfacesInput = PluginIdFilter;\nexport const ListCapabilitiesInput = PluginIdFilter;\nexport const ListOperationsInput = PluginIdFilter;\nexport const ListSchemasInput = PluginIdFilter;\n\n//\n// Idioms\n//\n\nconst IdiomHostKindEnum = Schema.Literal('story', 'test', 'symbol');\n\nexport const ListIdiomsInput = Schema.Struct({\n slug: Schema.optional(Schema.String).annotations({\n title: 'Slug filter',\n description: 'Substring of the idiom slug (case-insensitive). Omit to list every idiom.',\n }),\n hostKind: Schema.optional(IdiomHostKindEnum).annotations({\n title: 'Host kind',\n description: 'Filter idioms by their host site: `symbol` (production code), `story`, or `test`.',\n }),\n ...ListOptionsInput.fields,\n});\n\n//\n// Inferred TypeScript types — handy for downstream consumers.\n//\n\nexport type ListPackagesArgs = typeof ListPackagesInput.Type;\nexport type GetPackageArgs = typeof GetPackageInput.Type;\nexport type ListSymbolsArgs = typeof ListSymbolsInput.Type;\nexport type FindSymbolArgs = typeof FindSymbolInput.Type;\nexport type GetSymbolArgs = typeof GetSymbolInput.Type;\nexport type ListPluginsArgs = typeof ListPluginsInput.Type;\nexport type ListSurfacesArgs = typeof ListSurfacesInput.Type;\nexport type ListCapabilitiesArgs = typeof ListCapabilitiesInput.Type;\nexport type ListOperationsArgs = typeof ListOperationsInput.Type;\nexport type ListSchemasArgs = typeof ListSchemasInput.Type;\nexport type ListIdiomsArgs = typeof ListIdiomsInput.Type;\n"],
5
+ "mappings": "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",
6
+ "names": ["DEFAULT_LIST_LIMIT", "MAX_LIST_LIMIT", "Schema", "effectFieldsToZod", "trim", "Schema", "SymbolKindSchema", "Literal", "SymbolIncludeSchema", "SourceLocationSchema", "Struct", "file", "String", "line", "Number", "column", "PluginIdSchema", "PackageSchema", "name", "version", "private", "Boolean", "path", "description", "optional", "PackageDetailSchema", "fields", "workspaceDependencies", "Array", "externalDependencies", "entryPoints", "exportCount", "SymbolMatchSchema", "ref", "package", "kind", "summary", "SymbolDetailSchema", "signature", "jsdoc", "location", "source", "PluginSchema", "id", "icon", "iconHue", "tags", "dependsOn", "metaLocation", "SurfaceSchema", "pluginId", "role", "CapabilitySchema", "type", "OperationSchema", "SchemaSchema", "typename", "PluginDetailSchema", "surfaces", "capabilities", "operations", "schemas", "IdiomHostKindSchema", "IdiomHostSchema", "symbol", "IdiomSchema", "slug", "applies", "insteadOf", "uses", "related", "host", "Schema", "trim", "PickerAnnotationId", "getPicker", "ast", "annotations", "ListOptionsInput", "Struct", "limit", "optional", "Number", "pipe", "int", "positive", "lessThanOrEqualTo", "MAX_LIST_LIMIT", "title", "description", "trim", "DEFAULT_LIST_LIMIT", "compact", "Boolean", "SymbolKindEnum", "Literal", "IncludeEnum", "ListPackagesInput", "name", "String", "pathPrefix", "privateOnly", "fields", "GetPackageInput", "ListSymbolsInput", "package", "kind", "FindSymbolInput", "query", "GetSymbolInput", "ref", "include", "Array", "ListPluginsInput", "id", "PluginIdFilter", "ListSurfacesInput", "ListCapabilitiesInput", "ListOperationsInput", "ListSchemasInput", "IdiomHostKindEnum", "ListIdiomsInput", "slug", "hostKind", "TOOL_METADATA", "list_packages", "title", "description", "trim", "inputSchema", "ListPackagesInput", "outputSchema", "Struct", "packages", "Array", "PackageSchema", "get_package", "GetPackageInput", "package", "NullOr", "list_symbols", "ListSymbolsInput", "symbols", "SymbolMatchSchema", "find_symbol", "FindSymbolInput", "matches", "get_symbol", "GetSymbolInput", "symbol", "SymbolDetailSchema", "list_plugins", "ListPluginsInput", "plugins", "PluginSchema", "list_surfaces", "ListSurfacesInput", "surfaces", "SurfaceSchema", "list_capabilities", "ListCapabilitiesInput", "capabilities", "CapabilitySchema", "list_operations", "ListOperationsInput", "operations", "OperationSchema", "list_schemas", "ListSchemasInput", "schemas", "SchemaSchema", "list_idioms", "ListIdiomsInput", "idioms", "IdiomSchema", "inputSchemaToZod", "struct", "effectFieldsToZod"]
7
7
  }
@@ -1 +1 @@
1
- {"inputs":{"src/limits.ts":{"bytes":3000,"imports":[],"format":"esm"},"src/schemas.ts":{"bytes":16540,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"src/limits.ts","kind":"import-statement","original":"./limits"}],"format":"esm"},"src/metadata.ts":{"bytes":17520,"imports":[{"path":"@dxos/effect-zod","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"src/schemas.ts","kind":"import-statement","original":"./schemas"}],"format":"esm"},"src/index.ts":{"bytes":2842,"imports":[{"path":"src/limits.ts","kind":"import-statement","original":"./limits"},{"path":"src/metadata.ts","kind":"import-statement","original":"./metadata"},{"path":"src/schemas.ts","kind":"import-statement","original":"./schemas"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":17625},"dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/effect-zod","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["DEFAULT_LIST_LIMIT","FindSymbolInput","GetPackageInput","GetSymbolInput","ListCapabilitiesInput","ListOperationsInput","ListOptionsInput","ListPackagesInput","ListPluginsInput","ListSchemasInput","ListSurfacesInput","ListSymbolsInput","MAX_LIST_LIMIT","TOOL_METADATA","inputSchemaToZod"],"entryPoint":"src/index.ts","inputs":{"src/limits.ts":{"bytesInOutput":55},"src/index.ts":{"bytesInOutput":0},"src/metadata.ts":{"bytesInOutput":4372},"src/schemas.ts":{"bytesInOutput":3311}},"bytes":8197}}}
1
+ {"inputs":{"src/limits.ts":{"bytes":3000,"imports":[],"format":"esm"},"src/output-schemas.ts":{"bytes":21343,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true}],"format":"esm"},"src/schemas.ts":{"bytes":21017,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"src/limits.ts","kind":"import-statement","original":"./limits"}],"format":"esm"},"src/metadata.ts":{"bytes":24055,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/effect-zod","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"src/output-schemas.ts","kind":"import-statement","original":"./output-schemas"},{"path":"src/schemas.ts","kind":"import-statement","original":"./schemas"}],"format":"esm"},"src/index.ts":{"bytes":5222,"imports":[{"path":"src/limits.ts","kind":"import-statement","original":"./limits"},{"path":"src/metadata.ts","kind":"import-statement","original":"./metadata"},{"path":"src/output-schemas.ts","kind":"import-statement","original":"./output-schemas"},{"path":"src/schemas.ts","kind":"import-statement","original":"./schemas"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":33164},"dist/lib/browser/index.mjs":{"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/effect-zod","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["CapabilitySchema","DEFAULT_LIST_LIMIT","FindSymbolInput","GetPackageInput","GetSymbolInput","IdiomHostKindSchema","IdiomHostSchema","IdiomSchema","ListCapabilitiesInput","ListIdiomsInput","ListOperationsInput","ListOptionsInput","ListPackagesInput","ListPluginsInput","ListSchemasInput","ListSurfacesInput","ListSymbolsInput","MAX_LIST_LIMIT","OperationSchema","PackageDetailSchema","PackageSchema","PickerAnnotationId","PluginDetailSchema","PluginIdSchema","PluginSchema","SchemaSchema","SourceLocationSchema","SurfaceSchema","SymbolDetailSchema","SymbolIncludeSchema","SymbolKindSchema","SymbolMatchSchema","TOOL_METADATA","getPicker","inputSchemaToZod"],"entryPoint":"src/index.ts","inputs":{"src/limits.ts":{"bytesInOutput":55},"src/index.ts":{"bytesInOutput":0},"src/metadata.ts":{"bytesInOutput":5952},"src/output-schemas.ts":{"bytesInOutput":4863},"src/schemas.ts":{"bytesInOutput":4124}},"bytes":15868}}}
@@ -5,20 +5,154 @@ var DEFAULT_LIST_LIMIT = 30;
5
5
  var MAX_LIST_LIMIT = 200;
6
6
 
7
7
  // src/metadata.ts
8
+ import * as Schema3 from "effect/Schema";
8
9
  import { effectFieldsToZod } from "@dxos/effect-zod";
9
10
  import { trim as trim2 } from "@dxos/util";
10
11
 
11
- // src/schemas.ts
12
+ // src/output-schemas.ts
12
13
  import * as Schema from "effect/Schema";
14
+ var SymbolKindSchema = Schema.Literal("function", "class", "interface", "type", "enum", "variable", "namespace", "unknown");
15
+ var SymbolIncludeSchema = Schema.Literal("source", "jsdoc");
16
+ var SourceLocationSchema = Schema.Struct({
17
+ file: Schema.String,
18
+ line: Schema.Number,
19
+ column: Schema.Number
20
+ });
21
+ var PluginIdSchema = Schema.String;
22
+ var PackageSchema = Schema.Struct({
23
+ name: Schema.String,
24
+ version: Schema.String,
25
+ private: Schema.Boolean,
26
+ /** Path relative to the monorepo root (no trailing slash). */
27
+ path: Schema.String,
28
+ description: Schema.optional(Schema.String)
29
+ });
30
+ var PackageDetailSchema = Schema.Struct({
31
+ ...PackageSchema.fields,
32
+ /** Workspace dependencies (other packages in the monorepo). */
33
+ workspaceDependencies: Schema.Array(Schema.String),
34
+ /** External (catalog or pinned) dependency names. */
35
+ externalDependencies: Schema.Array(Schema.String),
36
+ /** Resolved entry points (relative to package root). */
37
+ entryPoints: Schema.Array(Schema.String),
38
+ /** Number of exported symbols at the top level. */
39
+ exportCount: Schema.Number
40
+ });
41
+ var SymbolMatchSchema = Schema.Struct({
42
+ ref: Schema.String,
43
+ package: Schema.String,
44
+ name: Schema.String,
45
+ kind: SymbolKindSchema,
46
+ /** One-line summary from JSDoc, if any. */
47
+ summary: Schema.optional(Schema.String)
48
+ });
49
+ var SymbolDetailSchema = Schema.Struct({
50
+ ref: Schema.String,
51
+ package: Schema.String,
52
+ name: Schema.String,
53
+ kind: SymbolKindSchema,
54
+ signature: Schema.String,
55
+ jsdoc: Schema.optional(Schema.String),
56
+ summary: Schema.optional(Schema.String),
57
+ location: SourceLocationSchema,
58
+ /** Source text — only present when `include` requested it. */
59
+ source: Schema.optional(Schema.String)
60
+ });
61
+ var PluginSchema = Schema.Struct({
62
+ /** e.g. `org.dxos.plugin.code`. */
63
+ id: PluginIdSchema,
64
+ /** npm package name, e.g. `@dxos/plugin-code`. */
65
+ package: Schema.String,
66
+ name: Schema.optional(Schema.String),
67
+ description: Schema.optional(Schema.String),
68
+ icon: Schema.optional(Schema.String),
69
+ iconHue: Schema.optional(Schema.String),
70
+ /** Static tags read from `meta.tags` (e.g. `['labs']`). Empty array if absent. */
71
+ tags: Schema.Array(Schema.String),
72
+ /**
73
+ * Ids of other plugins this plugin depends on, derived from its package's
74
+ * `workspace:*` dependencies. Sorted for deterministic output. Empty array
75
+ * if the plugin's package has no dependencies on other plugin packages.
76
+ */
77
+ dependsOn: Schema.Array(PluginIdSchema),
78
+ /** Source location of the `meta` declaration. */
79
+ metaLocation: SourceLocationSchema
80
+ });
81
+ var SurfaceSchema = Schema.Struct({
82
+ pluginId: PluginIdSchema,
83
+ /** Surface id passed to `Surface.create({ id })`. */
84
+ id: Schema.String,
85
+ /** One or more roles the surface answers to. */
86
+ role: Schema.Array(Schema.String),
87
+ location: SourceLocationSchema
88
+ });
89
+ var CapabilitySchema = Schema.Struct({
90
+ pluginId: PluginIdSchema,
91
+ /** Identifier expression as written in source, e.g. `Capabilities.ReactSurface`. */
92
+ type: Schema.String,
93
+ location: SourceLocationSchema
94
+ });
95
+ var OperationSchema = Schema.Struct({
96
+ pluginId: PluginIdSchema,
97
+ /** Operation identifier expression. */
98
+ type: Schema.String,
99
+ location: SourceLocationSchema
100
+ });
101
+ var SchemaSchema = Schema.Struct({
102
+ pluginId: PluginIdSchema,
103
+ /** Identifier expression as written in `addSchemaModule`, e.g. `CodeProject.CodeProject`. */
104
+ name: Schema.String,
105
+ /** Resolved typename (e.g. `org.dxos.type.codeProject`) when statically extractable. */
106
+ typename: Schema.optional(Schema.String),
107
+ location: SourceLocationSchema
108
+ });
109
+ var PluginDetailSchema = Schema.Struct({
110
+ ...PluginSchema.fields,
111
+ surfaces: Schema.Array(SurfaceSchema),
112
+ capabilities: Schema.Array(CapabilitySchema),
113
+ operations: Schema.Array(OperationSchema),
114
+ schemas: Schema.Array(SchemaSchema)
115
+ });
116
+ var IdiomHostKindSchema = Schema.Literal("story", "test", "symbol");
117
+ var IdiomHostSchema = Schema.Struct({
118
+ /** Path relative to the scan root. */
119
+ file: Schema.String,
120
+ /** 1-indexed line where the JSDoc opens. */
121
+ line: Schema.Number,
122
+ /** Best-effort name of the export immediately following the JSDoc. */
123
+ symbol: Schema.optional(Schema.String),
124
+ /** Detected host kind based on file location and symbol shape. */
125
+ kind: IdiomHostKindSchema
126
+ });
127
+ var IdiomSchema = Schema.Struct({
128
+ /** Globally unique AT Protocol NSID (https://atproto.com/specs/nsid). */
129
+ slug: Schema.String,
130
+ /** Leading JSDoc paragraph (rationale). */
131
+ summary: Schema.optional(Schema.String),
132
+ /** Applicability (required field per IDIOMS.md). */
133
+ applies: Schema.String,
134
+ /** Anti-pattern this replaces. */
135
+ insteadOf: Schema.optional(Schema.String),
136
+ /** Raw {@link …} targets named under `uses:`. */
137
+ uses: Schema.Array(Schema.String),
138
+ /** Slugs of related idioms. */
139
+ related: Schema.Array(Schema.String),
140
+ host: IdiomHostSchema
141
+ });
142
+
143
+ // src/schemas.ts
144
+ import * as Schema2 from "effect/Schema";
13
145
  import { trim } from "@dxos/util";
14
- var ListOptionsInput = Schema.Struct({
15
- limit: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive(), Schema.lessThanOrEqualTo(MAX_LIST_LIMIT))).annotations({
146
+ var PickerAnnotationId = "@dxos/introspect-tools/picker";
147
+ var getPicker = (ast) => ast.annotations[PickerAnnotationId];
148
+ var ListOptionsInput = Schema2.Struct({
149
+ limit: Schema2.optional(Schema2.Number.pipe(Schema2.int(), Schema2.positive(), Schema2.lessThanOrEqualTo(MAX_LIST_LIMIT))).annotations({
16
150
  title: "Limit",
17
151
  description: trim`
18
- Maximum number of items to return. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.
152
+ Maximum number of items. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.
19
153
  `
20
154
  }),
21
- compact: Schema.optional(Schema.Boolean).annotations({
155
+ compact: Schema2.optional(Schema2.Boolean).annotations({
22
156
  title: "Compact",
23
157
  description: trim`
24
158
  If true, returns only the most-essential identifying fields for each item — about 1/4 the response size.
@@ -26,72 +160,77 @@ var ListOptionsInput = Schema.Struct({
26
160
  `
27
161
  })
28
162
  });
29
- var SymbolKindEnum = Schema.Literal("function", "class", "interface", "type", "enum", "variable", "namespace");
30
- var IncludeEnum = Schema.Literal("source", "jsdoc");
31
- var ListPackagesInput = Schema.Struct({
32
- name: Schema.optional(Schema.String).annotations({
163
+ var SymbolKindEnum = Schema2.Literal("function", "class", "interface", "type", "enum", "variable", "namespace");
164
+ var IncludeEnum = Schema2.Literal("source", "jsdoc");
165
+ var ListPackagesInput = Schema2.Struct({
166
+ name: Schema2.optional(Schema2.String).annotations({
33
167
  title: "Name filter",
34
- description: "Substring of the package name (case-insensitive)."
168
+ description: "Substring of the package name (case-insensitive).",
169
+ [PickerAnnotationId]: "package-name"
35
170
  }),
36
- pathPrefix: Schema.optional(Schema.String).annotations({
37
- title: "Path prefix",
38
- description: 'Restrict to packages whose path starts with this segment, e.g. "packages/plugins".'
171
+ pathPrefix: Schema2.optional(Schema2.String).annotations({
172
+ title: "Path prefix"
39
173
  }),
40
- privateOnly: Schema.optional(Schema.Boolean).annotations({
174
+ privateOnly: Schema2.optional(Schema2.Boolean).annotations({
41
175
  title: "Private only",
42
176
  description: "If true, only include workspace-private packages."
43
177
  }),
44
178
  ...ListOptionsInput.fields
45
179
  });
46
- var GetPackageInput = Schema.Struct({
47
- name: Schema.String.annotations({
180
+ var GetPackageInput = Schema2.Struct({
181
+ name: Schema2.String.annotations({
48
182
  title: "Package name",
49
- description: 'Exact package name, e.g. "@dxos/echo".'
183
+ description: 'Exact package name, e.g. "@dxos/echo".',
184
+ [PickerAnnotationId]: "package-name"
50
185
  })
51
186
  });
52
- var ListSymbolsInput = Schema.Struct({
53
- package: Schema.String.annotations({
187
+ var ListSymbolsInput = Schema2.Struct({
188
+ package: Schema2.String.annotations({
54
189
  title: "Package",
55
- description: 'Exact package name, e.g. "@dxos/ai".'
190
+ description: 'Exact package name, e.g. "@dxos/ai".',
191
+ [PickerAnnotationId]: "package-name"
56
192
  }),
57
- kind: Schema.optional(SymbolKindEnum).annotations({
193
+ kind: Schema2.optional(SymbolKindEnum).annotations({
58
194
  title: "Kind",
59
195
  description: "Optional filter on declaration kind."
60
196
  }),
61
197
  ...ListOptionsInput.fields
62
198
  });
63
- var FindSymbolInput = Schema.Struct({
64
- query: Schema.String.annotations({
199
+ var FindSymbolInput = Schema2.Struct({
200
+ query: Schema2.String.annotations({
65
201
  title: "Query",
66
202
  description: "Symbol name or partial name (case-insensitive)."
67
203
  }),
68
- kind: Schema.optional(SymbolKindEnum).annotations({
204
+ kind: Schema2.optional(SymbolKindEnum).annotations({
69
205
  title: "Kind",
70
206
  description: "Optional filter on declaration kind."
71
207
  }),
72
208
  ...ListOptionsInput.fields
73
209
  });
74
- var GetSymbolInput = Schema.Struct({
75
- ref: Schema.String.annotations({
210
+ var GetSymbolInput = Schema2.Struct({
211
+ ref: Schema2.String.annotations({
76
212
  title: "Symbol ref",
77
213
  description: 'Symbol ref in the form "<package>#<name>", e.g. "@dxos/echo#Expando".'
78
214
  }),
79
- include: Schema.optional(Schema.Array(IncludeEnum)).annotations({
215
+ include: Schema2.optional(Schema2.Array(IncludeEnum)).annotations({
80
216
  title: "Include",
81
217
  description: "Optional fields to expand; default returns signature + summary only."
82
218
  })
83
219
  });
84
- var ListPluginsInput = Schema.Struct({
85
- id: Schema.optional(Schema.String).annotations({
220
+ var ListPluginsInput = Schema2.Struct({
221
+ // No picker annotation — this is a free-form substring filter, not an
222
+ // exact-match selector. Picking from the list of known plugin ids would
223
+ // defeat the purpose of `list_plugins`.
224
+ id: Schema2.optional(Schema2.String).annotations({
86
225
  title: "Plugin id",
87
226
  description: "Substring of the plugin id (case-insensitive). Omit to list every plugin."
88
227
  }),
89
228
  ...ListOptionsInput.fields
90
229
  });
91
- var PluginIdFilter = Schema.Struct({
92
- id: Schema.optional(Schema.String).annotations({
230
+ var PluginIdFilter = Schema2.Struct({
231
+ id: Schema2.optional(Schema2.String).annotations({
93
232
  title: "Plugin id",
94
- description: 'Restrict to contributions from this plugin id (e.g. "org.dxos.plugin.markdown").'
233
+ [PickerAnnotationId]: "plugin-id"
95
234
  }),
96
235
  ...ListOptionsInput.fields
97
236
  });
@@ -99,6 +238,18 @@ var ListSurfacesInput = PluginIdFilter;
99
238
  var ListCapabilitiesInput = PluginIdFilter;
100
239
  var ListOperationsInput = PluginIdFilter;
101
240
  var ListSchemasInput = PluginIdFilter;
241
+ var IdiomHostKindEnum = Schema2.Literal("story", "test", "symbol");
242
+ var ListIdiomsInput = Schema2.Struct({
243
+ slug: Schema2.optional(Schema2.String).annotations({
244
+ title: "Slug filter",
245
+ description: "Substring of the idiom slug (case-insensitive). Omit to list every idiom."
246
+ }),
247
+ hostKind: Schema2.optional(IdiomHostKindEnum).annotations({
248
+ title: "Host kind",
249
+ description: "Filter idioms by their host site: `symbol` (production code), `story`, or `test`."
250
+ }),
251
+ ...ListOptionsInput.fields
252
+ });
102
253
 
103
254
  // src/metadata.ts
104
255
  var TOOL_METADATA = {
@@ -109,7 +260,10 @@ var TOOL_METADATA = {
109
260
  Supports filtering by name substring, path prefix (e.g. "packages/plugins"), or workspace-private only.
110
261
  Returns lightweight rows; call get_package for dependency and entry-point detail.
111
262
  `,
112
- inputSchema: ListPackagesInput
263
+ inputSchema: ListPackagesInput,
264
+ outputSchema: Schema3.Struct({
265
+ packages: Schema3.Array(PackageSchema)
266
+ })
113
267
  },
114
268
  get_package: {
115
269
  title: "Get package detail",
@@ -118,7 +272,10 @@ var TOOL_METADATA = {
118
272
  Returns workspace and external dependencies, entry points, and metadata.
119
273
  Use after list_packages or when the user references a package directly.
120
274
  `,
121
- inputSchema: GetPackageInput
275
+ inputSchema: GetPackageInput,
276
+ outputSchema: Schema3.Struct({
277
+ package: Schema3.NullOr(PackageSchema)
278
+ })
122
279
  },
123
280
  list_symbols: {
124
281
  title: "List all exported symbols of a package",
@@ -127,7 +284,10 @@ var TOOL_METADATA = {
127
284
  Use this when the user wants to know what a specific package offers, or to browse a package after get_package.
128
285
  Returns lightweight rows with refs you can pass to get_symbol; capped at 30 — refine with \`kind\` or call get_symbol directly.
129
286
  `,
130
- inputSchema: ListSymbolsInput
287
+ inputSchema: ListSymbolsInput,
288
+ outputSchema: Schema3.Struct({
289
+ symbols: Schema3.Array(SymbolMatchSchema)
290
+ })
131
291
  },
132
292
  find_symbol: {
133
293
  title: "Find an exported symbol by name",
@@ -136,7 +296,10 @@ var TOOL_METADATA = {
136
296
  Use this when the user references something by name and you need to locate which package owns it before reading more.
137
297
  Returns refs you can pass to get_symbol. Ranking: exact match, then prefix, then substring.
138
298
  `,
139
- inputSchema: FindSymbolInput
299
+ inputSchema: FindSymbolInput,
300
+ outputSchema: Schema3.Struct({
301
+ matches: Schema3.Array(SymbolMatchSchema)
302
+ })
140
303
  },
141
304
  get_symbol: {
142
305
  title: "Get symbol detail",
@@ -145,7 +308,10 @@ var TOOL_METADATA = {
145
308
  Default response is signature + JSDoc summary + source location.
146
309
  Pass include=["source"] to expand the full declaration text, include=["jsdoc"] for the full JSDoc body.
147
310
  `,
148
- inputSchema: GetSymbolInput
311
+ inputSchema: GetSymbolInput,
312
+ outputSchema: Schema3.Struct({
313
+ symbol: Schema3.NullOr(SymbolDetailSchema)
314
+ })
149
315
  },
150
316
  list_plugins: {
151
317
  title: "List Composer plugins",
@@ -154,7 +320,10 @@ var TOOL_METADATA = {
154
320
  Use this to discover what plugins exist before drilling into surfaces / capabilities / operations / schemas.
155
321
  Filter by \`id\` substring (e.g. "markdown") to narrow the list.
156
322
  `,
157
- inputSchema: ListPluginsInput
323
+ inputSchema: ListPluginsInput,
324
+ outputSchema: Schema3.Struct({
325
+ plugins: Schema3.Array(PluginSchema)
326
+ })
158
327
  },
159
328
  list_surfaces: {
160
329
  title: "List surfaces",
@@ -163,7 +332,10 @@ var TOOL_METADATA = {
163
332
  surface ids when wiring a new container, or to check whether a surface name is already taken.
164
333
  Filter by \`id\` (plugin id) to scope to a single plugin's surfaces.
165
334
  `,
166
- inputSchema: ListSurfacesInput
335
+ inputSchema: ListSurfacesInput,
336
+ outputSchema: Schema3.Struct({
337
+ surfaces: Schema3.Array(SurfaceSchema)
338
+ })
167
339
  },
168
340
  list_capabilities: {
169
341
  title: "List capability contributions",
@@ -171,7 +343,10 @@ var TOOL_METADATA = {
171
343
  List Capability.contributes(<key>, ...) calls across the monorepo. Use this to discover which capability
172
344
  keys are produced (or required) by which plugins. Filter by \`id\` (plugin id) to scope to a single plugin.
173
345
  `,
174
- inputSchema: ListCapabilitiesInput
346
+ inputSchema: ListCapabilitiesInput,
347
+ outputSchema: Schema3.Struct({
348
+ capabilities: Schema3.Array(CapabilitySchema)
349
+ })
175
350
  },
176
351
  list_operations: {
177
352
  title: "List operations",
@@ -182,7 +357,10 @@ var TOOL_METADATA = {
182
357
  these via \`Capabilities.OperationHandler\`. Filter by \`id\` (plugin id)
183
358
  to scope to a single plugin.
184
359
  `,
185
- inputSchema: ListOperationsInput
360
+ inputSchema: ListOperationsInput,
361
+ outputSchema: Schema3.Struct({
362
+ operations: Schema3.Array(OperationSchema)
363
+ })
186
364
  },
187
365
  list_schemas: {
188
366
  title: "List schemas",
@@ -191,16 +369,39 @@ var TOOL_METADATA = {
191
369
  Use this to discover what data types exist before reading their shape.
192
370
  Filter by \`id\` (plugin id, e.g. "org.dxos.plugin.markdown") to scope to a single plugin's schemas.
193
371
  `,
194
- inputSchema: ListSchemasInput
372
+ inputSchema: ListSchemasInput,
373
+ outputSchema: Schema3.Struct({
374
+ schemas: Schema3.Array(SchemaSchema)
375
+ })
376
+ },
377
+ list_idioms: {
378
+ title: "List idioms",
379
+ description: trim2`
380
+ List idioms catalogued across the monorepo. An *idiom* is a JSDoc-tagged
381
+ reference example (\`@idiom <slug>\`) that pins the canonical way to use a
382
+ symbol — applicability, anti-pattern, and links to related idioms. Use this
383
+ to discover how a feature is meant to be used, or to find a worked example
384
+ before writing new code. Filter by \`slug\` substring or by \`hostKind\`
385
+ (\`symbol\`, \`story\`, \`test\`).
386
+ `,
387
+ inputSchema: ListIdiomsInput,
388
+ outputSchema: Schema3.Struct({
389
+ idioms: Schema3.Array(IdiomSchema)
390
+ })
195
391
  }
196
392
  };
197
393
  var inputSchemaToZod = (struct) => effectFieldsToZod(struct);
198
394
  export {
395
+ CapabilitySchema,
199
396
  DEFAULT_LIST_LIMIT,
200
397
  FindSymbolInput,
201
398
  GetPackageInput,
202
399
  GetSymbolInput,
400
+ IdiomHostKindSchema,
401
+ IdiomHostSchema,
402
+ IdiomSchema,
203
403
  ListCapabilitiesInput,
404
+ ListIdiomsInput,
204
405
  ListOperationsInput,
205
406
  ListOptionsInput,
206
407
  ListPackagesInput,
@@ -209,7 +410,22 @@ export {
209
410
  ListSurfacesInput,
210
411
  ListSymbolsInput,
211
412
  MAX_LIST_LIMIT,
413
+ OperationSchema,
414
+ PackageDetailSchema,
415
+ PackageSchema,
416
+ PickerAnnotationId,
417
+ PluginDetailSchema,
418
+ PluginIdSchema,
419
+ PluginSchema,
420
+ SchemaSchema,
421
+ SourceLocationSchema,
422
+ SurfaceSchema,
423
+ SymbolDetailSchema,
424
+ SymbolIncludeSchema,
425
+ SymbolKindSchema,
426
+ SymbolMatchSchema,
212
427
  TOOL_METADATA,
428
+ getPicker,
213
429
  inputSchemaToZod
214
430
  };
215
431
  //# sourceMappingURL=index.mjs.map