Skip to main content

registry__search

Find artifacts across every workspace the caller can read. Use search when you know a name or topic but do not yet have an artifact ID.
  • Inputs: optional query, kind, strategy (fts, vector, hybrid, or group), embedding_kind, workspace_id, project_id, repo_id, filters, fields, limit, offset, and cursor. group requires a query and returns the top match with its typed neighbours.
  • Returns: {items, page} with artifact IDs, kinds, names, descriptions, and workspace IDs. Use page.next_cursor to continue a cursor-based search.
  • Effect: read only.
Use an ID from the response with registry__get_artifact to inspect one artifact. Use registry__get_relationships when you need the exact graph edges for an artifact you already know.