@dxos/introspect-tools 0.8.4-main.fdfb99ef29 → 0.9.0
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.
- package/LICENSE +102 -5
- package/dist/lib/browser/index.mjs +258 -42
- package/dist/lib/browser/index.mjs.map +4 -4
- package/dist/lib/browser/meta.json +1 -1
- package/dist/lib/node-esm/index.mjs +258 -42
- package/dist/lib/node-esm/index.mjs.map +4 -4
- package/dist/lib/node-esm/meta.json +1 -1
- package/dist/types/src/index.d.ts +2 -1
- package/dist/types/src/index.d.ts.map +1 -1
- package/dist/types/src/metadata.d.ts +8 -0
- package/dist/types/src/metadata.d.ts.map +1 -1
- package/dist/types/src/metadata.test.d.ts +2 -0
- package/dist/types/src/metadata.test.d.ts.map +1 -0
- package/dist/types/src/output-schemas.d.ts +250 -0
- package/dist/types/src/output-schemas.d.ts.map +1 -0
- package/dist/types/src/schemas.d.ts +21 -0
- package/dist/types/src/schemas.d.ts.map +1 -1
- package/dist/types/tsconfig.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/src/index.ts +42 -0
- package/src/metadata.test.ts +55 -0
- package/src/metadata.ts +44 -0
- package/src/output-schemas.ts +223 -0
- package/src/schemas.ts +45 -3
|
@@ -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": ";;;AAWO,IAAMA,qBAAqB;AAO3B,IAAMC,iBAAiB;;;
|
|
6
|
-
"names": ["DEFAULT_LIST_LIMIT", "MAX_LIST_LIMIT", "effectFieldsToZod", "trim", "Schema", "trim", "ListOptionsInput", "Struct", "limit", "optional", "Number", "pipe", "int", "positive", "lessThanOrEqualTo", "MAX_LIST_LIMIT", "
|
|
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":
|
|
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/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":33164},"dist/lib/node-esm/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":15927}}}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT, type ListOptions } from './limits';
|
|
2
2
|
export { TOOL_METADATA, inputSchemaToZod, type ToolMetadata } from './metadata';
|
|
3
|
-
export {
|
|
3
|
+
export { CapabilitySchema, IdiomHostKindSchema, IdiomHostSchema, IdiomSchema, OperationSchema, PackageDetailSchema, PackageSchema, PluginDetailSchema, PluginIdSchema, PluginSchema, SchemaSchema, SourceLocationSchema, SurfaceSchema, SymbolDetailSchema, SymbolIncludeSchema, SymbolKindSchema, SymbolMatchSchema, type Capability, type Idiom, type IdiomHost, type IdiomHostKind, type Operation, type Package, type PackageDetail, type Plugin, type PluginDetail, type PluginId, type PluginsFile, type SchemaContribution, type SourceLocation, type Surface, type SymbolDetail, type SymbolInclude, type SymbolKind, type SymbolMatch, } from './output-schemas';
|
|
4
|
+
export { FindSymbolInput, GetPackageInput, GetSymbolInput, ListCapabilitiesInput, ListIdiomsInput, ListOperationsInput, ListOptionsInput, ListPackagesInput, ListPluginsInput, ListSchemasInput, ListSurfacesInput, ListSymbolsInput, PickerAnnotationId, getPicker, type FindSymbolArgs, type GetPackageArgs, type GetSymbolArgs, type ListCapabilitiesArgs, type ListIdiomsArgs, type ListOperationsArgs, type ListPackagesArgs, type ListPluginsArgs, type ListSchemasArgs, type ListSurfacesArgs, type ListSymbolsArgs, type PickerKind, } from './schemas';
|
|
4
5
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC"}
|
|
@@ -21,6 +21,14 @@ export type ToolMetadata = {
|
|
|
21
21
|
* (react-ui-form, etc.) use this directly.
|
|
22
22
|
*/
|
|
23
23
|
inputSchema: Schema.Struct<any>;
|
|
24
|
+
/**
|
|
25
|
+
* Effect Schema struct describing the tool's success return shape.
|
|
26
|
+
* MCP's `structuredContent` must be a JSON object, so each tool wraps
|
|
27
|
+
* its item(s) under a stable top-level key (e.g. `{ packages: [...] }`,
|
|
28
|
+
* `{ package: null | {...} }`). Consumers building Effect AI Tools can
|
|
29
|
+
* pass this directly as `success` to `Tool.make`.
|
|
30
|
+
*/
|
|
31
|
+
outputSchema: Schema.Struct<any>;
|
|
24
32
|
};
|
|
25
33
|
/**
|
|
26
34
|
* Static metadata for every tool the introspect-mcp server exposes. No
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/metadata.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/metadata.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8B7B;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAmHtD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,WAAY,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAA8B,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metadata.test.d.ts","sourceRoot":"","sources":["../../../src/metadata.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,250 @@
|
|
|
1
|
+
import * as Schema from 'effect/Schema';
|
|
2
|
+
export declare const SymbolKindSchema: Schema.Literal<["function", "class", "interface", "type", "enum", "variable", "namespace", "unknown"]>;
|
|
3
|
+
export type SymbolKind = typeof SymbolKindSchema.Type;
|
|
4
|
+
export declare const SymbolIncludeSchema: Schema.Literal<["source", "jsdoc"]>;
|
|
5
|
+
export type SymbolInclude = typeof SymbolIncludeSchema.Type;
|
|
6
|
+
export declare const SourceLocationSchema: Schema.Struct<{
|
|
7
|
+
file: typeof Schema.String;
|
|
8
|
+
line: typeof Schema.Number;
|
|
9
|
+
column: typeof Schema.Number;
|
|
10
|
+
}>;
|
|
11
|
+
export type SourceLocation = typeof SourceLocationSchema.Type;
|
|
12
|
+
export declare const PluginIdSchema: typeof Schema.String;
|
|
13
|
+
export type PluginId = typeof PluginIdSchema.Type;
|
|
14
|
+
export declare const PackageSchema: Schema.Struct<{
|
|
15
|
+
name: typeof Schema.String;
|
|
16
|
+
version: typeof Schema.String;
|
|
17
|
+
private: typeof Schema.Boolean;
|
|
18
|
+
/** Path relative to the monorepo root (no trailing slash). */
|
|
19
|
+
path: typeof Schema.String;
|
|
20
|
+
description: Schema.optional<typeof Schema.String>;
|
|
21
|
+
}>;
|
|
22
|
+
export type Package = typeof PackageSchema.Type;
|
|
23
|
+
export declare const PackageDetailSchema: Schema.Struct<{
|
|
24
|
+
name: typeof Schema.String;
|
|
25
|
+
version: typeof Schema.String;
|
|
26
|
+
private: typeof Schema.Boolean;
|
|
27
|
+
path: typeof Schema.String;
|
|
28
|
+
description: Schema.optional<typeof Schema.String>;
|
|
29
|
+
/** Workspace dependencies (other packages in the monorepo). */
|
|
30
|
+
workspaceDependencies: Schema.Array$<typeof Schema.String>;
|
|
31
|
+
/** External (catalog or pinned) dependency names. */
|
|
32
|
+
externalDependencies: Schema.Array$<typeof Schema.String>;
|
|
33
|
+
/** Resolved entry points (relative to package root). */
|
|
34
|
+
entryPoints: Schema.Array$<typeof Schema.String>;
|
|
35
|
+
/** Number of exported symbols at the top level. */
|
|
36
|
+
exportCount: typeof Schema.Number;
|
|
37
|
+
}>;
|
|
38
|
+
export type PackageDetail = typeof PackageDetailSchema.Type;
|
|
39
|
+
export declare const SymbolMatchSchema: Schema.Struct<{
|
|
40
|
+
ref: typeof Schema.String;
|
|
41
|
+
package: typeof Schema.String;
|
|
42
|
+
name: typeof Schema.String;
|
|
43
|
+
kind: Schema.Literal<["function", "class", "interface", "type", "enum", "variable", "namespace", "unknown"]>;
|
|
44
|
+
/** One-line summary from JSDoc, if any. */
|
|
45
|
+
summary: Schema.optional<typeof Schema.String>;
|
|
46
|
+
}>;
|
|
47
|
+
export type SymbolMatch = typeof SymbolMatchSchema.Type;
|
|
48
|
+
export declare const SymbolDetailSchema: Schema.Struct<{
|
|
49
|
+
ref: typeof Schema.String;
|
|
50
|
+
package: typeof Schema.String;
|
|
51
|
+
name: typeof Schema.String;
|
|
52
|
+
kind: Schema.Literal<["function", "class", "interface", "type", "enum", "variable", "namespace", "unknown"]>;
|
|
53
|
+
signature: typeof Schema.String;
|
|
54
|
+
jsdoc: Schema.optional<typeof Schema.String>;
|
|
55
|
+
summary: Schema.optional<typeof Schema.String>;
|
|
56
|
+
location: Schema.Struct<{
|
|
57
|
+
file: typeof Schema.String;
|
|
58
|
+
line: typeof Schema.Number;
|
|
59
|
+
column: typeof Schema.Number;
|
|
60
|
+
}>;
|
|
61
|
+
/** Source text — only present when `include` requested it. */
|
|
62
|
+
source: Schema.optional<typeof Schema.String>;
|
|
63
|
+
}>;
|
|
64
|
+
export type SymbolDetail = typeof SymbolDetailSchema.Type;
|
|
65
|
+
export declare const PluginSchema: Schema.Struct<{
|
|
66
|
+
/** e.g. `org.dxos.plugin.code`. */
|
|
67
|
+
id: typeof Schema.String;
|
|
68
|
+
/** npm package name, e.g. `@dxos/plugin-code`. */
|
|
69
|
+
package: typeof Schema.String;
|
|
70
|
+
name: Schema.optional<typeof Schema.String>;
|
|
71
|
+
description: Schema.optional<typeof Schema.String>;
|
|
72
|
+
icon: Schema.optional<typeof Schema.String>;
|
|
73
|
+
iconHue: Schema.optional<typeof Schema.String>;
|
|
74
|
+
/** Static tags read from `meta.tags` (e.g. `['labs']`). Empty array if absent. */
|
|
75
|
+
tags: Schema.Array$<typeof Schema.String>;
|
|
76
|
+
/**
|
|
77
|
+
* Ids of other plugins this plugin depends on, derived from its package's
|
|
78
|
+
* `workspace:*` dependencies. Sorted for deterministic output. Empty array
|
|
79
|
+
* if the plugin's package has no dependencies on other plugin packages.
|
|
80
|
+
*/
|
|
81
|
+
dependsOn: Schema.Array$<typeof Schema.String>;
|
|
82
|
+
/** Source location of the `meta` declaration. */
|
|
83
|
+
metaLocation: Schema.Struct<{
|
|
84
|
+
file: typeof Schema.String;
|
|
85
|
+
line: typeof Schema.Number;
|
|
86
|
+
column: typeof Schema.Number;
|
|
87
|
+
}>;
|
|
88
|
+
}>;
|
|
89
|
+
export type Plugin = typeof PluginSchema.Type;
|
|
90
|
+
export declare const SurfaceSchema: Schema.Struct<{
|
|
91
|
+
pluginId: typeof Schema.String;
|
|
92
|
+
/** Surface id passed to `Surface.create({ id })`. */
|
|
93
|
+
id: typeof Schema.String;
|
|
94
|
+
/** One or more roles the surface answers to. */
|
|
95
|
+
role: Schema.Array$<typeof Schema.String>;
|
|
96
|
+
location: Schema.Struct<{
|
|
97
|
+
file: typeof Schema.String;
|
|
98
|
+
line: typeof Schema.Number;
|
|
99
|
+
column: typeof Schema.Number;
|
|
100
|
+
}>;
|
|
101
|
+
}>;
|
|
102
|
+
export type Surface = typeof SurfaceSchema.Type;
|
|
103
|
+
export declare const CapabilitySchema: Schema.Struct<{
|
|
104
|
+
pluginId: typeof Schema.String;
|
|
105
|
+
/** Identifier expression as written in source, e.g. `Capabilities.ReactSurface`. */
|
|
106
|
+
type: typeof Schema.String;
|
|
107
|
+
location: Schema.Struct<{
|
|
108
|
+
file: typeof Schema.String;
|
|
109
|
+
line: typeof Schema.Number;
|
|
110
|
+
column: typeof Schema.Number;
|
|
111
|
+
}>;
|
|
112
|
+
}>;
|
|
113
|
+
export type Capability = typeof CapabilitySchema.Type;
|
|
114
|
+
export declare const OperationSchema: Schema.Struct<{
|
|
115
|
+
pluginId: typeof Schema.String;
|
|
116
|
+
/** Operation identifier expression. */
|
|
117
|
+
type: typeof Schema.String;
|
|
118
|
+
location: Schema.Struct<{
|
|
119
|
+
file: typeof Schema.String;
|
|
120
|
+
line: typeof Schema.Number;
|
|
121
|
+
column: typeof Schema.Number;
|
|
122
|
+
}>;
|
|
123
|
+
}>;
|
|
124
|
+
export type Operation = typeof OperationSchema.Type;
|
|
125
|
+
export declare const SchemaSchema: Schema.Struct<{
|
|
126
|
+
pluginId: typeof Schema.String;
|
|
127
|
+
/** Identifier expression as written in `addSchemaModule`, e.g. `CodeProject.CodeProject`. */
|
|
128
|
+
name: typeof Schema.String;
|
|
129
|
+
/** Resolved typename (e.g. `org.dxos.type.codeProject`) when statically extractable. */
|
|
130
|
+
typename: Schema.optional<typeof Schema.String>;
|
|
131
|
+
location: Schema.Struct<{
|
|
132
|
+
file: typeof Schema.String;
|
|
133
|
+
line: typeof Schema.Number;
|
|
134
|
+
column: typeof Schema.Number;
|
|
135
|
+
}>;
|
|
136
|
+
}>;
|
|
137
|
+
export type SchemaContribution = typeof SchemaSchema.Type;
|
|
138
|
+
export declare const PluginDetailSchema: Schema.Struct<{
|
|
139
|
+
id: typeof Schema.String;
|
|
140
|
+
package: typeof Schema.String;
|
|
141
|
+
name: Schema.optional<typeof Schema.String>;
|
|
142
|
+
description: Schema.optional<typeof Schema.String>;
|
|
143
|
+
icon: Schema.optional<typeof Schema.String>;
|
|
144
|
+
iconHue: Schema.optional<typeof Schema.String>;
|
|
145
|
+
tags: Schema.Array$<typeof Schema.String>;
|
|
146
|
+
dependsOn: Schema.Array$<typeof Schema.String>;
|
|
147
|
+
metaLocation: Schema.Struct<{
|
|
148
|
+
file: typeof Schema.String;
|
|
149
|
+
line: typeof Schema.Number;
|
|
150
|
+
column: typeof Schema.Number;
|
|
151
|
+
}>;
|
|
152
|
+
surfaces: Schema.Array$<Schema.Struct<{
|
|
153
|
+
pluginId: typeof Schema.String;
|
|
154
|
+
/** Surface id passed to `Surface.create({ id })`. */
|
|
155
|
+
id: typeof Schema.String;
|
|
156
|
+
/** One or more roles the surface answers to. */
|
|
157
|
+
role: Schema.Array$<typeof Schema.String>;
|
|
158
|
+
location: Schema.Struct<{
|
|
159
|
+
file: typeof Schema.String;
|
|
160
|
+
line: typeof Schema.Number;
|
|
161
|
+
column: typeof Schema.Number;
|
|
162
|
+
}>;
|
|
163
|
+
}>>;
|
|
164
|
+
capabilities: Schema.Array$<Schema.Struct<{
|
|
165
|
+
pluginId: typeof Schema.String;
|
|
166
|
+
/** Identifier expression as written in source, e.g. `Capabilities.ReactSurface`. */
|
|
167
|
+
type: typeof Schema.String;
|
|
168
|
+
location: Schema.Struct<{
|
|
169
|
+
file: typeof Schema.String;
|
|
170
|
+
line: typeof Schema.Number;
|
|
171
|
+
column: typeof Schema.Number;
|
|
172
|
+
}>;
|
|
173
|
+
}>>;
|
|
174
|
+
operations: Schema.Array$<Schema.Struct<{
|
|
175
|
+
pluginId: typeof Schema.String;
|
|
176
|
+
/** Operation identifier expression. */
|
|
177
|
+
type: typeof Schema.String;
|
|
178
|
+
location: Schema.Struct<{
|
|
179
|
+
file: typeof Schema.String;
|
|
180
|
+
line: typeof Schema.Number;
|
|
181
|
+
column: typeof Schema.Number;
|
|
182
|
+
}>;
|
|
183
|
+
}>>;
|
|
184
|
+
schemas: Schema.Array$<Schema.Struct<{
|
|
185
|
+
pluginId: typeof Schema.String;
|
|
186
|
+
/** Identifier expression as written in `addSchemaModule`, e.g. `CodeProject.CodeProject`. */
|
|
187
|
+
name: typeof Schema.String;
|
|
188
|
+
/** Resolved typename (e.g. `org.dxos.type.codeProject`) when statically extractable. */
|
|
189
|
+
typename: Schema.optional<typeof Schema.String>;
|
|
190
|
+
location: Schema.Struct<{
|
|
191
|
+
file: typeof Schema.String;
|
|
192
|
+
line: typeof Schema.Number;
|
|
193
|
+
column: typeof Schema.Number;
|
|
194
|
+
}>;
|
|
195
|
+
}>>;
|
|
196
|
+
}>;
|
|
197
|
+
export type PluginDetail = typeof PluginDetailSchema.Type;
|
|
198
|
+
export declare const IdiomHostKindSchema: Schema.Literal<["story", "test", "symbol"]>;
|
|
199
|
+
export type IdiomHostKind = typeof IdiomHostKindSchema.Type;
|
|
200
|
+
export declare const IdiomHostSchema: Schema.Struct<{
|
|
201
|
+
/** Path relative to the scan root. */
|
|
202
|
+
file: typeof Schema.String;
|
|
203
|
+
/** 1-indexed line where the JSDoc opens. */
|
|
204
|
+
line: typeof Schema.Number;
|
|
205
|
+
/** Best-effort name of the export immediately following the JSDoc. */
|
|
206
|
+
symbol: Schema.optional<typeof Schema.String>;
|
|
207
|
+
/** Detected host kind based on file location and symbol shape. */
|
|
208
|
+
kind: Schema.Literal<["story", "test", "symbol"]>;
|
|
209
|
+
}>;
|
|
210
|
+
export type IdiomHost = typeof IdiomHostSchema.Type;
|
|
211
|
+
export declare const IdiomSchema: Schema.Struct<{
|
|
212
|
+
/** Globally unique AT Protocol NSID (https://atproto.com/specs/nsid). */
|
|
213
|
+
slug: typeof Schema.String;
|
|
214
|
+
/** Leading JSDoc paragraph (rationale). */
|
|
215
|
+
summary: Schema.optional<typeof Schema.String>;
|
|
216
|
+
/** Applicability (required field per IDIOMS.md). */
|
|
217
|
+
applies: typeof Schema.String;
|
|
218
|
+
/** Anti-pattern this replaces. */
|
|
219
|
+
insteadOf: Schema.optional<typeof Schema.String>;
|
|
220
|
+
/** Raw {@link …} targets named under `uses:`. */
|
|
221
|
+
uses: Schema.Array$<typeof Schema.String>;
|
|
222
|
+
/** Slugs of related idioms. */
|
|
223
|
+
related: Schema.Array$<typeof Schema.String>;
|
|
224
|
+
host: Schema.Struct<{
|
|
225
|
+
/** Path relative to the scan root. */
|
|
226
|
+
file: typeof Schema.String;
|
|
227
|
+
/** 1-indexed line where the JSDoc opens. */
|
|
228
|
+
line: typeof Schema.Number;
|
|
229
|
+
/** Best-effort name of the export immediately following the JSDoc. */
|
|
230
|
+
symbol: Schema.optional<typeof Schema.String>;
|
|
231
|
+
/** Detected host kind based on file location and symbol shape. */
|
|
232
|
+
kind: Schema.Literal<["story", "test", "symbol"]>;
|
|
233
|
+
}>;
|
|
234
|
+
}>;
|
|
235
|
+
export type Idiom = typeof IdiomSchema.Type;
|
|
236
|
+
/**
|
|
237
|
+
* Shape of the `plugins.json` sidecar stored in R2 / written by the cache
|
|
238
|
+
* upload script. Uses plain mutable arrays so callers can work with standard
|
|
239
|
+
* JSON.parse output without readonly friction.
|
|
240
|
+
*/
|
|
241
|
+
export type PluginsFile = {
|
|
242
|
+
version: 1;
|
|
243
|
+
plugins: Plugin[];
|
|
244
|
+
surfaces: Surface[];
|
|
245
|
+
capabilities: Capability[];
|
|
246
|
+
operations: Operation[];
|
|
247
|
+
schemas: SchemaContribution[];
|
|
248
|
+
idioms?: Idiom[];
|
|
249
|
+
};
|
|
250
|
+
//# sourceMappingURL=output-schemas.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"output-schemas.d.ts","sourceRoot":"","sources":["../../../src/output-schemas.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,18 @@
|
|
|
1
1
|
import * as Schema from 'effect/Schema';
|
|
2
|
+
import * as SchemaAST from 'effect/SchemaAST';
|
|
3
|
+
/**
|
|
4
|
+
* Annotation key for fields whose value should be picked from a known
|
|
5
|
+
* enumeration that the MCP server can produce on demand. Consumers
|
|
6
|
+
* (e.g. `@dxos/react-ui-introspect`'s ToolForm) read this annotation off
|
|
7
|
+
* the field's AST and render a Combobox over the matching list.
|
|
8
|
+
*
|
|
9
|
+
* The kind names a domain rather than a specific tool — e.g. `plugin-id`
|
|
10
|
+
* means "any tool that emits plugin ids works" — so adding a new tool
|
|
11
|
+
* doesn't require new picker plumbing.
|
|
12
|
+
*/
|
|
13
|
+
export declare const PickerAnnotationId = "@dxos/introspect-tools/picker";
|
|
14
|
+
export type PickerKind = 'plugin-id' | 'package-name';
|
|
15
|
+
export declare const getPicker: (ast: SchemaAST.AST) => PickerKind | undefined;
|
|
2
16
|
/**
|
|
3
17
|
* Pagination + projection options shared by every list-style tool. Spread its
|
|
4
18
|
* `.fields` into a tool's `Schema.Struct({...})` so the same pair of knobs
|
|
@@ -62,6 +76,12 @@ export declare const ListSchemasInput: Schema.Struct<{
|
|
|
62
76
|
compact: Schema.optional<typeof Schema.Boolean>;
|
|
63
77
|
id: Schema.optional<typeof Schema.String>;
|
|
64
78
|
}>;
|
|
79
|
+
export declare const ListIdiomsInput: Schema.Struct<{
|
|
80
|
+
limit: Schema.optional<Schema.filter<Schema.filter<Schema.filter<typeof Schema.Number>>>>;
|
|
81
|
+
compact: Schema.optional<typeof Schema.Boolean>;
|
|
82
|
+
slug: Schema.optional<typeof Schema.String>;
|
|
83
|
+
hostKind: Schema.optional<Schema.Literal<["story", "test", "symbol"]>>;
|
|
84
|
+
}>;
|
|
65
85
|
export type ListPackagesArgs = typeof ListPackagesInput.Type;
|
|
66
86
|
export type GetPackageArgs = typeof GetPackageInput.Type;
|
|
67
87
|
export type ListSymbolsArgs = typeof ListSymbolsInput.Type;
|
|
@@ -72,4 +92,5 @@ export type ListSurfacesArgs = typeof ListSurfacesInput.Type;
|
|
|
72
92
|
export type ListCapabilitiesArgs = typeof ListCapabilitiesInput.Type;
|
|
73
93
|
export type ListOperationsArgs = typeof ListOperationsInput.Type;
|
|
74
94
|
export type ListSchemasArgs = typeof ListSchemasInput.Type;
|
|
95
|
+
export type ListIdiomsArgs = typeof ListIdiomsInput.Type;
|
|
75
96
|
//# sourceMappingURL=schemas.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/schemas.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/schemas.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAM9C;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,kCAAkC,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;AAEtD,eAAO,MAAM,SAAS,QAAS,SAAS,CAAC,GAAG,KAAG,UAAU,GAAG,SACgC,CAAC;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;EAgB3B,CAAC;AAUH,eAAO,MAAM,iBAAiB;;;;;;EAc5B,CAAC;AAEH,eAAO,MAAM,eAAe;;EAM1B,CAAC;AAMH,eAAO,MAAM,gBAAgB;;;;;EAW3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;EAU1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;EASzB,CAAC;AAUH,eAAO,MAAM,gBAAgB;;;;EAS3B,CAAC;AAUH,eAAO,MAAM,iBAAiB;;;;EAAiB,CAAC;AAChD,eAAO,MAAM,qBAAqB;;;;EAAiB,CAAC;AACpD,eAAO,MAAM,mBAAmB;;;;EAAiB,CAAC;AAClD,eAAO,MAAM,gBAAgB;;;;EAAiB,CAAC;AAQ/C,eAAO,MAAM,eAAe;;;;;EAU1B,CAAC;AAMH,MAAM,MAAM,gBAAgB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAC7D,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AACrE,MAAM,MAAM,kBAAkB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC"}
|