Kalpana Docs

Kalpana Batch has 20 tools. Agents receive each tool's JSON Schema from tools/list; these pages document the same arguments for people.

Workspace and templates

Find the connected workspace and its templates, and read the inputs a template takes.

Tool	Mode	What it does
`get_workspace`	Read-only	The connected workspace, the user's role and permissions, and the domains image URLs may come from.
`search_templates`	Read-only	Find templates by topic, ID, dimensions, or preview availability.
`get_template_inputs`	Read-only	Inspect customizable text and image fields with target dimensions and example values.

Find the workspace's images, bring in the user's own, and look at a preview before using it.

Tool	Mode	What it does
`search_assets`	Read-only	Find approved image assets or page through images in a collection.
`upload_images`	State-changing	Add the user's own images to the workspace, optionally into a collection.
`inspect_image`	Read-only	Fetch and visually inspect a Kalpana preview or download image.

Check rows, stage a batch with its credit cost, run it, follow it and collect the files.

Tool	Mode	What it does
`validate_batch`	Read-only	Check rows of modifications against the pages or flow they fill, before saving or spending credits.
`create_batch`	State-changing	Save a draft batch of up to 1,000 rows and compute the exact credit cost without rendering.
`run_batch`	Destructive	Start rendering a pending batch and consume credits.
`get_batch`	Read-only	Retrieve status, progress, completed, and failed counts for a batch.
`list_batches`	Read-only	Paginated status summary of recent batches in the connected workspace.
`get_batch_jobs`	Read-only	List a batch's jobs with their modifications, status and file; pending jobs without a file can be edited.
`get_batch_outputs`	Read-only	List rendered files and retrieve short-lived download URLs.
`update_batch`	Destructive	Rename a batch, and change, add or remove its pending jobs.
`update_job`	State-changing	Change one pending job that has no output yet.
`cancel_batch`	Destructive	Stop every unfinished job in a batch; cancelled jobs are not charged.
`cancel_job`	Destructive	Stop one unfinished job; it is not charged.

Make a few files without a batch.

Tool	Mode	What it does
`create_job`	Destructive	Make up to 10 jobs, each a page or flow with its own modifications, without a batch; with `run` they render and return the files.
`run_job`	Destructive	Render one pending or failed job and wait up to 30 seconds for its file.
`get_job`	Read-only	One job's status, with its file once it has rendered.