Tools Reference

Overview of the built-in DataGrout tool surface.

All first-party tools use this naming pattern:

data-grout@{version}/{suite}.{tool}@{tool_version}

Example: data-grout@1/discovery.discover@1

Shared Concepts

cache_ref reuses a prior result without re-sending the full payload.
Many tools accept either inline payload data or a cache_ref.
discovery.perform can execute discovered tools and saved skills, including direct calls by skill_id.
Some workflows support inline computed inputs through "$compute" for safe first-party compositions.

Tool Suites

Discovery

Find, plan, and execute tools by intent rather than memorizing names.

Tool	Purpose
`discovery.summary@1`	Lightweight overview of available capabilities
`discovery.discover@1`	Semantic search across tools and integrations
`discovery.plan@1`	Generate a verified multi-step workflow from a goal
`discovery.guide@1`	Interactive narrowing toward the right tool or plan
`discovery.perform@1`	Execute a discovered tool or saved skill

See Discovery Tools.

Data

Pure JSON and list operations. No LLM premium.

Tool	Purpose
`data.get@1`	Access nested values by path
`data.pick@1` / `data.omit@1`	Keep or remove keys
`data.take@1` / `data.drop@1`	Slice lists
`data.keys@1` / `data.count@1`	Inspect structure size and shape
`data.flatten@1`	Flatten nested maps
`data.merge@1`	Merge maps
`data.filter@1`	Declarative filtering
`data.sort@1`	Value or field sorting
`data.unique@1`	Deduplicate values or records
`data.aggregate@1`	Summaries like sum, mean, count, min, max
`data.map@1`	Fan out a tool call over a list

See Data Tools.

Frame

Columnar operations on lists of records. No LLM premium.

Tool	Purpose
`frame.select@1`	Keep, rename, or drop columns
`frame.filter@1`	Row filtering
`frame.sort@1`	Multi-field sorting
`frame.group@1`	Group and aggregate
`frame.pivot@1`	Reshape long data to wide data
`frame.slice@1`	Paginate or take top-N rows
`frame.join@1`	Join record lists on shared keys
`frame.pluck@1`	Pull a single field out as a list

See Frame Tools.

Math

Deterministic numeric generation, statistics, and modeling.

Tool	Purpose
`math.range@1` / `math.linspace@1` / `math.sequence@1`	Generate numeric series
`math.sample@1` / `math.interpolate@1`	Sampling and interpolation utilities
`math.describe@1` / `math.window@1`	Descriptive stats and rolling analysis
`math.correlate@1` / `math.trend@1`	Relationship and trend analysis
`math.normalize@1` / `math.outliers@1` / `math.rank@1`	Cleanup, normalization, and ranking

See Math Tools.

Prism

AI-assisted transformation, analysis, rendering, and visualization.

Tool	Purpose
`prism.refract@1`	Natural-language data transformation
`prism.analyze@1`	Structured reasoning over payloads
`prism.focus@1`	Focused extraction or type-bridging tasks
`prism.chart@1`	Chart generation
`prism.render@1`	Render markdown, HTML, or text output
`prism.export@1`	Export data into other formats
`prism.paginate@1`	Navigate large result sets

See Prism Tools.

Logic

Persistent symbolic memory and reusable constraints.

Tool	Purpose
`logic.hydrate@1`	Build context for a goal from saved facts
`logic.remember@1` / `logic.assert@1`	Store facts
`logic.query@1`	Query facts via natural language, patterns, or raw logic
`logic.constrain@1`	Add reusable rules and guardrails
`logic.forget@1`	Remove outdated facts
`logic.reflect@1`	Summarize what is known
`logic.worlds@1`	List or manage isolated namespaces
`logic.export@1` / `logic.import@1`	Move knowledge in and out
`logic.tabulate@1`	Return facts in table-friendly form

See Logic Tools.

Flow And Inspect

Workflow orchestration plus execution review.

Tool	Purpose
`flow.into@1`	Execute a named skill or inline workflow
`flow.route@1`	Conditional branching
`flow.request-approval@1`	Human approval checkpoint
`flow.request-feedback@1`	Collect missing input mid-workflow
`inspect.execution-history@1`	Review recent runs
`inspect.execution-details@1`	Retrieve detailed execution context
`inspect.ctc-executions@1`	Review certified executions for a skill

See Flow and Inspect Tools.

Warden

Safety and adversarial-content review.

Tool	Purpose
`warden.canary@1`	Protocol-integrity checks
`warden.intent@1`	Intent and authority analysis
`warden.adjudicate@1`	Rule-backed threat evaluation
`warden.ensemble@1`	Combined multi-stage verdict

See Warden Tools.

Invariant

Semantic code analysis and alignment checking.

Tool	Purpose
`invariant.code_lens@1`	Extract structural and semantic code facts
`invariant.code_query@1`	Query stored code facts
`invariant.diff_analyzer@1`	Compare changes against the intended goal

See Invariant Tools.

Toolsmith

Create, refine, browse, and invoke reusable saved skills.

Tool	Purpose
`toolsmith.forge@1`	Create a new saved skill from a goal
`toolsmith.temper@1`	Refine or fork an existing skill
`toolsmith.catalog@1`	Browse saved skills and invocation hints
`toolsmith.invoke@1`	Run a saved catalog skill directly by `skill_id`

See Toolsmith Tools.

Ephemerals

Working-memory visibility for active cached results.

Tool	Purpose
`ephemerals.list@1`	List active cached datasets
`ephemerals.inspect@1`	Inspect schema, preview rows, and expiry

See Ephemerals Tools.

Tasks

Durable handles for background work.

Tool	Purpose
`tasks.status@1`	Poll current task state
`tasks.wait@1`	Reattach briefly and wait for progress
`tasks.list@1`	Review recent background work
`tasks.result@1`	Fetch the finished result
`tasks.cancel@1`	Cancel stale work

See Tasks Tools.

Deliverables

Persistent work products such as reports, exports, charts, and packaged data.

Tool	Purpose
`deliverables.list@1`	Search or browse saved deliverables
`deliverables.get@1`	Retrieve a deliverable by ref
`deliverables.register@1`	Save a new deliverable

See Deliverables Tools.

Scheduler And Governor

Recurring execution and session-level operating state.

Tool	Purpose
`scheduler.create@1` / `scheduler.list@1` / `scheduler.cancel@1`	Manage scheduled work
`governor.enable@1` / `governor.status@1` / `governor.disable@1`	Control session-level awareness and monitoring

See Scheduler Tools.

Latent

Conceptual expansion, angular navigation, and boundary discovery.

Tool	Purpose
`latent.expand@1`	Expand a concept in depth, breadth, or bridge mode
`latent.orient@1`	Navigate to a specific angular position in a concept’s latent neighbourhood
`latent.horizon@1`	Find the boundary of a neighbourhood and optionally expand beyond it

Flux

Outcome review and quality signals.

Tool	Purpose
`flux.feedback@1`	Record qualitative feedback
`flux.scorecard@1`	Generate a structured evaluation snapshot
`flux.track@1`	Record custom events related to usage or outcomes

See Flux Tools.

Naming Notes

First-party tools use data-grout@1/{suite}.{tool}@{version}.
Integration tools use {integration}@{version}/{tool}@{version}.
Some clients require simplified function names; DataGrout can serve compatible aliases automatically.

See Tool Naming and Compatibility.

Error Shape

Tools return structured errors such as:

{
  "error": {
    "code": "tool_not_found",
    "message": "Tool 'salesforce@1/nonexistent@1' not found"
  }
}

Common codes include tool_not_found, invalid_arguments, upstream_error, timeout, rate_limit, and policy_violation.