@dxos/introspect-tools 0.0.0 → 0.8.4-main.1c7ec43d41

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 ADDED
@@ -0,0 +1,8 @@
1
+ MIT License
2
+ Copyright (c) 2022 DXOS
3
+
4
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
5
+
6
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
7
+
8
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -11,11 +11,13 @@ import { trim as trim2 } from "@dxos/util";
11
11
  // src/schemas.ts
12
12
  import * as Schema from "effect/Schema";
13
13
  import { trim } from "@dxos/util";
14
+ var PickerAnnotationId = "@dxos/introspect-tools/picker";
15
+ var getPicker = (ast) => ast.annotations[PickerAnnotationId];
14
16
  var ListOptionsInput = Schema.Struct({
15
17
  limit: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive(), Schema.lessThanOrEqualTo(MAX_LIST_LIMIT))).annotations({
16
18
  title: "Limit",
17
19
  description: trim`
18
- Maximum number of items to return. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.
20
+ Maximum number of items. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.
19
21
  `
20
22
  }),
21
23
  compact: Schema.optional(Schema.Boolean).annotations({
@@ -31,11 +33,11 @@ var IncludeEnum = Schema.Literal("source", "jsdoc");
31
33
  var ListPackagesInput = Schema.Struct({
32
34
  name: Schema.optional(Schema.String).annotations({
33
35
  title: "Name filter",
34
- description: "Substring of the package name (case-insensitive)."
36
+ description: "Substring of the package name (case-insensitive).",
37
+ [PickerAnnotationId]: "package-name"
35
38
  }),
36
39
  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".'
40
+ title: "Path prefix"
39
41
  }),
40
42
  privateOnly: Schema.optional(Schema.Boolean).annotations({
41
43
  title: "Private only",
@@ -46,13 +48,15 @@ var ListPackagesInput = Schema.Struct({
46
48
  var GetPackageInput = Schema.Struct({
47
49
  name: Schema.String.annotations({
48
50
  title: "Package name",
49
- description: 'Exact package name, e.g. "@dxos/echo".'
51
+ description: 'Exact package name, e.g. "@dxos/echo".',
52
+ [PickerAnnotationId]: "package-name"
50
53
  })
51
54
  });
52
55
  var ListSymbolsInput = Schema.Struct({
53
56
  package: Schema.String.annotations({
54
57
  title: "Package",
55
- description: 'Exact package name, e.g. "@dxos/ai".'
58
+ description: 'Exact package name, e.g. "@dxos/ai".',
59
+ [PickerAnnotationId]: "package-name"
56
60
  }),
57
61
  kind: Schema.optional(SymbolKindEnum).annotations({
58
62
  title: "Kind",
@@ -82,6 +86,9 @@ var GetSymbolInput = Schema.Struct({
82
86
  })
83
87
  });
84
88
  var ListPluginsInput = Schema.Struct({
89
+ // No picker annotation — this is a free-form substring filter, not an
90
+ // exact-match selector. Picking from the list of known plugin ids would
91
+ // defeat the purpose of `list_plugins`.
85
92
  id: Schema.optional(Schema.String).annotations({
86
93
  title: "Plugin id",
87
94
  description: "Substring of the plugin id (case-insensitive). Omit to list every plugin."
@@ -91,7 +98,7 @@ var ListPluginsInput = Schema.Struct({
91
98
  var PluginIdFilter = Schema.Struct({
92
99
  id: Schema.optional(Schema.String).annotations({
93
100
  title: "Plugin id",
94
- description: 'Restrict to contributions from this plugin id (e.g. "org.dxos.plugin.markdown").'
101
+ [PickerAnnotationId]: "plugin-id"
95
102
  }),
96
103
  ...ListOptionsInput.fields
97
104
  });
@@ -195,7 +202,113 @@ var TOOL_METADATA = {
195
202
  }
196
203
  };
197
204
  var inputSchemaToZod = (struct) => effectFieldsToZod(struct);
205
+
206
+ // src/output-schemas.ts
207
+ import * as Schema2 from "effect/Schema";
208
+ var SymbolKindSchema = Schema2.Literal("function", "class", "interface", "type", "enum", "variable", "namespace", "unknown");
209
+ var SymbolIncludeSchema = Schema2.Literal("source", "jsdoc");
210
+ var SourceLocationSchema = Schema2.Struct({
211
+ file: Schema2.String,
212
+ line: Schema2.Number,
213
+ column: Schema2.Number
214
+ });
215
+ var PluginIdSchema = Schema2.String;
216
+ var PackageSchema = Schema2.Struct({
217
+ name: Schema2.String,
218
+ version: Schema2.String,
219
+ private: Schema2.Boolean,
220
+ /** Path relative to the monorepo root (no trailing slash). */
221
+ path: Schema2.String,
222
+ description: Schema2.optional(Schema2.String)
223
+ });
224
+ var PackageDetailSchema = Schema2.Struct({
225
+ ...PackageSchema.fields,
226
+ /** Workspace dependencies (other packages in the monorepo). */
227
+ workspaceDependencies: Schema2.Array(Schema2.String),
228
+ /** External (catalog or pinned) dependency names. */
229
+ externalDependencies: Schema2.Array(Schema2.String),
230
+ /** Resolved entry points (relative to package root). */
231
+ entryPoints: Schema2.Array(Schema2.String),
232
+ /** Number of exported symbols at the top level. */
233
+ exportCount: Schema2.Number
234
+ });
235
+ var SymbolMatchSchema = Schema2.Struct({
236
+ ref: Schema2.String,
237
+ package: Schema2.String,
238
+ name: Schema2.String,
239
+ kind: SymbolKindSchema,
240
+ /** One-line summary from JSDoc, if any. */
241
+ summary: Schema2.optional(Schema2.String)
242
+ });
243
+ var SymbolDetailSchema = Schema2.Struct({
244
+ ref: Schema2.String,
245
+ package: Schema2.String,
246
+ name: Schema2.String,
247
+ kind: SymbolKindSchema,
248
+ signature: Schema2.String,
249
+ jsdoc: Schema2.optional(Schema2.String),
250
+ summary: Schema2.optional(Schema2.String),
251
+ location: SourceLocationSchema,
252
+ /** Source text — only present when `include` requested it. */
253
+ source: Schema2.optional(Schema2.String)
254
+ });
255
+ var PluginSchema = Schema2.Struct({
256
+ /** e.g. `org.dxos.plugin.code`. */
257
+ id: PluginIdSchema,
258
+ /** npm package name, e.g. `@dxos/plugin-code`. */
259
+ package: Schema2.String,
260
+ name: Schema2.optional(Schema2.String),
261
+ description: Schema2.optional(Schema2.String),
262
+ icon: Schema2.optional(Schema2.String),
263
+ iconHue: Schema2.optional(Schema2.String),
264
+ /** Static tags read from `meta.tags` (e.g. `['labs']`). Empty array if absent. */
265
+ tags: Schema2.Array(Schema2.String),
266
+ /**
267
+ * Ids of other plugins this plugin depends on, derived from its package's
268
+ * `workspace:*` dependencies. Sorted for deterministic output. Empty array
269
+ * if the plugin's package has no dependencies on other plugin packages.
270
+ */
271
+ dependsOn: Schema2.Array(PluginIdSchema),
272
+ /** Source location of the `meta` declaration. */
273
+ metaLocation: SourceLocationSchema
274
+ });
275
+ var SurfaceSchema = Schema2.Struct({
276
+ pluginId: PluginIdSchema,
277
+ /** Surface id passed to `Surface.create({ id })`. */
278
+ id: Schema2.String,
279
+ /** One or more roles the surface answers to. */
280
+ role: Schema2.Array(Schema2.String),
281
+ location: SourceLocationSchema
282
+ });
283
+ var CapabilitySchema = Schema2.Struct({
284
+ pluginId: PluginIdSchema,
285
+ /** Identifier expression as written in source, e.g. `Capabilities.ReactSurface`. */
286
+ type: Schema2.String,
287
+ location: SourceLocationSchema
288
+ });
289
+ var OperationSchema = Schema2.Struct({
290
+ pluginId: PluginIdSchema,
291
+ /** Operation identifier expression. */
292
+ type: Schema2.String,
293
+ location: SourceLocationSchema
294
+ });
295
+ var SchemaSchema = Schema2.Struct({
296
+ pluginId: PluginIdSchema,
297
+ /** Identifier expression as written in `addSchemaModule`, e.g. `CodeProject.CodeProject`. */
298
+ name: Schema2.String,
299
+ /** Resolved typename (e.g. `org.dxos.type.codeProject`) when statically extractable. */
300
+ typename: Schema2.optional(Schema2.String),
301
+ location: SourceLocationSchema
302
+ });
303
+ var PluginDetailSchema = Schema2.Struct({
304
+ ...PluginSchema.fields,
305
+ surfaces: Schema2.Array(SurfaceSchema),
306
+ capabilities: Schema2.Array(CapabilitySchema),
307
+ operations: Schema2.Array(OperationSchema),
308
+ schemas: Schema2.Array(SchemaSchema)
309
+ });
198
310
  export {
311
+ CapabilitySchema,
199
312
  DEFAULT_LIST_LIMIT,
200
313
  FindSymbolInput,
201
314
  GetPackageInput,
@@ -209,7 +322,22 @@ export {
209
322
  ListSurfacesInput,
210
323
  ListSymbolsInput,
211
324
  MAX_LIST_LIMIT,
325
+ OperationSchema,
326
+ PackageDetailSchema,
327
+ PackageSchema,
328
+ PickerAnnotationId,
329
+ PluginDetailSchema,
330
+ PluginIdSchema,
331
+ PluginSchema,
332
+ SchemaSchema,
333
+ SourceLocationSchema,
334
+ SurfaceSchema,
335
+ SymbolDetailSchema,
336
+ SymbolIncludeSchema,
337
+ SymbolKindSchema,
338
+ SymbolMatchSchema,
212
339
  TOOL_METADATA,
340
+ getPicker,
213
341
  inputSchemaToZod
214
342
  };
215
343
  //# sourceMappingURL=index.mjs.map
@@ -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/schemas.ts", "../../../src/output-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';\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// 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", "//\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"],
5
+ "mappings": "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",
6
+ "names": ["DEFAULT_LIST_LIMIT", "MAX_LIST_LIMIT", "effectFieldsToZod", "trim", "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", "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", "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"]
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/schemas.ts":{"bytes":19124,"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/output-schemas.ts":{"bytes":16899,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":4750,"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":26862},"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},{"path":"effect/Schema","kind":"import-statement","external":true}],"exports":["CapabilitySchema","DEFAULT_LIST_LIMIT","FindSymbolInput","GetPackageInput","GetSymbolInput","ListCapabilitiesInput","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":4372},"src/schemas.ts":{"bytesInOutput":3575},"src/output-schemas.ts":{"bytesInOutput":3898}},"bytes":12698}}}
@@ -11,11 +11,13 @@ import { trim as trim2 } from "@dxos/util";
11
11
  // src/schemas.ts
12
12
  import * as Schema from "effect/Schema";
13
13
  import { trim } from "@dxos/util";
14
+ var PickerAnnotationId = "@dxos/introspect-tools/picker";
15
+ var getPicker = (ast) => ast.annotations[PickerAnnotationId];
14
16
  var ListOptionsInput = Schema.Struct({
15
17
  limit: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive(), Schema.lessThanOrEqualTo(MAX_LIST_LIMIT))).annotations({
16
18
  title: "Limit",
17
19
  description: trim`
18
- Maximum number of items to return. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.
20
+ Maximum number of items. Default ${DEFAULT_LIST_LIMIT}; max ${MAX_LIST_LIMIT}.
19
21
  `
20
22
  }),
21
23
  compact: Schema.optional(Schema.Boolean).annotations({
@@ -31,11 +33,11 @@ var IncludeEnum = Schema.Literal("source", "jsdoc");
31
33
  var ListPackagesInput = Schema.Struct({
32
34
  name: Schema.optional(Schema.String).annotations({
33
35
  title: "Name filter",
34
- description: "Substring of the package name (case-insensitive)."
36
+ description: "Substring of the package name (case-insensitive).",
37
+ [PickerAnnotationId]: "package-name"
35
38
  }),
36
39
  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".'
40
+ title: "Path prefix"
39
41
  }),
40
42
  privateOnly: Schema.optional(Schema.Boolean).annotations({
41
43
  title: "Private only",
@@ -46,13 +48,15 @@ var ListPackagesInput = Schema.Struct({
46
48
  var GetPackageInput = Schema.Struct({
47
49
  name: Schema.String.annotations({
48
50
  title: "Package name",
49
- description: 'Exact package name, e.g. "@dxos/echo".'
51
+ description: 'Exact package name, e.g. "@dxos/echo".',
52
+ [PickerAnnotationId]: "package-name"
50
53
  })
51
54
  });
52
55
  var ListSymbolsInput = Schema.Struct({
53
56
  package: Schema.String.annotations({
54
57
  title: "Package",
55
- description: 'Exact package name, e.g. "@dxos/ai".'
58
+ description: 'Exact package name, e.g. "@dxos/ai".',
59
+ [PickerAnnotationId]: "package-name"
56
60
  }),
57
61
  kind: Schema.optional(SymbolKindEnum).annotations({
58
62
  title: "Kind",
@@ -82,6 +86,9 @@ var GetSymbolInput = Schema.Struct({
82
86
  })
83
87
  });
84
88
  var ListPluginsInput = Schema.Struct({
89
+ // No picker annotation — this is a free-form substring filter, not an
90
+ // exact-match selector. Picking from the list of known plugin ids would
91
+ // defeat the purpose of `list_plugins`.
85
92
  id: Schema.optional(Schema.String).annotations({
86
93
  title: "Plugin id",
87
94
  description: "Substring of the plugin id (case-insensitive). Omit to list every plugin."
@@ -91,7 +98,7 @@ var ListPluginsInput = Schema.Struct({
91
98
  var PluginIdFilter = Schema.Struct({
92
99
  id: Schema.optional(Schema.String).annotations({
93
100
  title: "Plugin id",
94
- description: 'Restrict to contributions from this plugin id (e.g. "org.dxos.plugin.markdown").'
101
+ [PickerAnnotationId]: "plugin-id"
95
102
  }),
96
103
  ...ListOptionsInput.fields
97
104
  });
@@ -195,7 +202,113 @@ var TOOL_METADATA = {
195
202
  }
196
203
  };
197
204
  var inputSchemaToZod = (struct) => effectFieldsToZod(struct);
205
+
206
+ // src/output-schemas.ts
207
+ import * as Schema2 from "effect/Schema";
208
+ var SymbolKindSchema = Schema2.Literal("function", "class", "interface", "type", "enum", "variable", "namespace", "unknown");
209
+ var SymbolIncludeSchema = Schema2.Literal("source", "jsdoc");
210
+ var SourceLocationSchema = Schema2.Struct({
211
+ file: Schema2.String,
212
+ line: Schema2.Number,
213
+ column: Schema2.Number
214
+ });
215
+ var PluginIdSchema = Schema2.String;
216
+ var PackageSchema = Schema2.Struct({
217
+ name: Schema2.String,
218
+ version: Schema2.String,
219
+ private: Schema2.Boolean,
220
+ /** Path relative to the monorepo root (no trailing slash). */
221
+ path: Schema2.String,
222
+ description: Schema2.optional(Schema2.String)
223
+ });
224
+ var PackageDetailSchema = Schema2.Struct({
225
+ ...PackageSchema.fields,
226
+ /** Workspace dependencies (other packages in the monorepo). */
227
+ workspaceDependencies: Schema2.Array(Schema2.String),
228
+ /** External (catalog or pinned) dependency names. */
229
+ externalDependencies: Schema2.Array(Schema2.String),
230
+ /** Resolved entry points (relative to package root). */
231
+ entryPoints: Schema2.Array(Schema2.String),
232
+ /** Number of exported symbols at the top level. */
233
+ exportCount: Schema2.Number
234
+ });
235
+ var SymbolMatchSchema = Schema2.Struct({
236
+ ref: Schema2.String,
237
+ package: Schema2.String,
238
+ name: Schema2.String,
239
+ kind: SymbolKindSchema,
240
+ /** One-line summary from JSDoc, if any. */
241
+ summary: Schema2.optional(Schema2.String)
242
+ });
243
+ var SymbolDetailSchema = Schema2.Struct({
244
+ ref: Schema2.String,
245
+ package: Schema2.String,
246
+ name: Schema2.String,
247
+ kind: SymbolKindSchema,
248
+ signature: Schema2.String,
249
+ jsdoc: Schema2.optional(Schema2.String),
250
+ summary: Schema2.optional(Schema2.String),
251
+ location: SourceLocationSchema,
252
+ /** Source text — only present when `include` requested it. */
253
+ source: Schema2.optional(Schema2.String)
254
+ });
255
+ var PluginSchema = Schema2.Struct({
256
+ /** e.g. `org.dxos.plugin.code`. */
257
+ id: PluginIdSchema,
258
+ /** npm package name, e.g. `@dxos/plugin-code`. */
259
+ package: Schema2.String,
260
+ name: Schema2.optional(Schema2.String),
261
+ description: Schema2.optional(Schema2.String),
262
+ icon: Schema2.optional(Schema2.String),
263
+ iconHue: Schema2.optional(Schema2.String),
264
+ /** Static tags read from `meta.tags` (e.g. `['labs']`). Empty array if absent. */
265
+ tags: Schema2.Array(Schema2.String),
266
+ /**
267
+ * Ids of other plugins this plugin depends on, derived from its package's
268
+ * `workspace:*` dependencies. Sorted for deterministic output. Empty array
269
+ * if the plugin's package has no dependencies on other plugin packages.
270
+ */
271
+ dependsOn: Schema2.Array(PluginIdSchema),
272
+ /** Source location of the `meta` declaration. */
273
+ metaLocation: SourceLocationSchema
274
+ });
275
+ var SurfaceSchema = Schema2.Struct({
276
+ pluginId: PluginIdSchema,
277
+ /** Surface id passed to `Surface.create({ id })`. */
278
+ id: Schema2.String,
279
+ /** One or more roles the surface answers to. */
280
+ role: Schema2.Array(Schema2.String),
281
+ location: SourceLocationSchema
282
+ });
283
+ var CapabilitySchema = Schema2.Struct({
284
+ pluginId: PluginIdSchema,
285
+ /** Identifier expression as written in source, e.g. `Capabilities.ReactSurface`. */
286
+ type: Schema2.String,
287
+ location: SourceLocationSchema
288
+ });
289
+ var OperationSchema = Schema2.Struct({
290
+ pluginId: PluginIdSchema,
291
+ /** Operation identifier expression. */
292
+ type: Schema2.String,
293
+ location: SourceLocationSchema
294
+ });
295
+ var SchemaSchema = Schema2.Struct({
296
+ pluginId: PluginIdSchema,
297
+ /** Identifier expression as written in `addSchemaModule`, e.g. `CodeProject.CodeProject`. */
298
+ name: Schema2.String,
299
+ /** Resolved typename (e.g. `org.dxos.type.codeProject`) when statically extractable. */
300
+ typename: Schema2.optional(Schema2.String),
301
+ location: SourceLocationSchema
302
+ });
303
+ var PluginDetailSchema = Schema2.Struct({
304
+ ...PluginSchema.fields,
305
+ surfaces: Schema2.Array(SurfaceSchema),
306
+ capabilities: Schema2.Array(CapabilitySchema),
307
+ operations: Schema2.Array(OperationSchema),
308
+ schemas: Schema2.Array(SchemaSchema)
309
+ });
198
310
  export {
311
+ CapabilitySchema,
199
312
  DEFAULT_LIST_LIMIT,
200
313
  FindSymbolInput,
201
314
  GetPackageInput,
@@ -209,7 +322,22 @@ export {
209
322
  ListSurfacesInput,
210
323
  ListSymbolsInput,
211
324
  MAX_LIST_LIMIT,
325
+ OperationSchema,
326
+ PackageDetailSchema,
327
+ PackageSchema,
328
+ PickerAnnotationId,
329
+ PluginDetailSchema,
330
+ PluginIdSchema,
331
+ PluginSchema,
332
+ SchemaSchema,
333
+ SourceLocationSchema,
334
+ SurfaceSchema,
335
+ SymbolDetailSchema,
336
+ SymbolIncludeSchema,
337
+ SymbolKindSchema,
338
+ SymbolMatchSchema,
212
339
  TOOL_METADATA,
340
+ getPicker,
213
341
  inputSchemaToZod
214
342
  };
215
343
  //# sourceMappingURL=index.mjs.map