answer_decision
ChatGPTAnswer the decision an agent is waiting on in a topic (approve a review, pick an option, request changes). option_id must be one of the decision's options; add text for options that take feedback. Only answer what the user actually decided. Then call wait_for_reply.
create_agent
ChatGPTCreate a new agent with its own machine, optionally from a template (list_templates). It costs credits while it runs. Only do this when the user asked for a new agent.
create_card
ChatGPTPut a task on a board, optionally assigned to an agent and in a given column.
create_schedule
ChatGPTHave the agent receive a message on a schedule in a topic, e.g. a daily report at 9:00.
delete_schedule
ChatGPTDelete a schedule for good.
get_artifact
ChatGPTGet an artifact's details and content (latest version unless version is given).
get_autonomy
ChatGPTShow whether an agent works on its own in a topic: its job, goals, rules, check-in schedule and plan.
get_credits
ChatGPTShow the organization's credit balance.
get_file
ChatGPTGet a file's content (text inline, images as images, other files as a blob; up to 5 MB).
get_pending_decisions
ChatGPTShow questions and review cards agents are waiting on you to answer. With topic_id, the full decision for that topic (options, review sections); without, a list across all topics.
hibernate_agent
ChatGPTHibernate an agent to save credits; resume_agent brings it back with its files intact.
list_agents
ChatGPTList the JackHamr agents you can use: id, name, status and what each is for. Start here to pick an agent for send_message.
list_artifacts
ChatGPTList an agent's artifacts: documents, plans, reports and other files it keeps in its library.
list_boards
ChatGPTList task boards and their columns.
list_cards
ChatGPTList the cards (tasks) on a board.
list_files
ChatGPTList files in a topic: what the agent sent you and what was uploaded.
list_previews
ChatGPTList the public URLs for ports published on the agent's machine (apps and sites it's serving).
list_schedules
ChatGPTList scheduled messages in a topic (recurring prompts the agent receives on a cron schedule).
list_templates
ChatGPTList templates you can create a new agent from.
list_topics
ChatGPTList recent topics (conversations with agents), newest first. Filter to one agent with agent_id.
list_workflows
ChatGPTList the workflows (multi-stage pipelines like spec, plan, build, QA, review) an agent can run. Pass a workflow's id as workflow_id to send_message to run it.
publish_preview
ChatGPTPublish a port on the agent's machine at a public https URL, so the user can open an app or site the agent is serving. Anyone with the link can reach it.
read_machine_file
ChatGPTRead a file from the agent's machine (text inline, images as images, up to 5 MB).
read_topic
ChatGPTRead a topic's recent conversation in order (oldest first). Use cursor from a previous call to page further back. Set include_tool_calls to also see which tools the agent ran.
resume_agent
ChatGPTResume a hibernated agent.
run_command
ChatGPTRun a shell command on the agent's own Linux machine (Ubuntu, as root) and get stdout, stderr and exit code. Its files, installed tools and running services persist between calls. Max 300 seconds; for longer jobs start them in the background (nohup ... &) and check back.
run_schedule_now
ChatGPTFire a schedule immediately, without waiting for its next time.
send_message
ChatGPTGive an agent work or follow up in a topic. Pass agent_id to start a new topic, or topic_id to continue one. Work is asynchronous: by default this returns as soon as the agent has the message; then call wait_for_reply. Set wait_seconds (up to 55) to wait for the reply here.
set_autonomy
ChatGPTLet the agent work on its own in a topic: give it a job and a check-in cadence, and it checks in on schedule, keeps a plan and asks you when it needs to. Also used to change those settings or turn autonomy off (enabled=false). Only do this when the user asked for it.
start_agent
ChatGPTStart a stopped agent's machine.
stop_agent
ChatGPTStop an agent's machine. Running work is interrupted; files are kept.
update_card
ChatGPTChange a card: move it to another column, reassign it, retitle it, edit its description or priority.
update_schedule
ChatGPTChange a schedule's timing, message or name, or pause it (enabled=false).
wait_for_reply
ChatGPTWait up to timeout_seconds (max 55) for the agent to finish or ask something. status: 'done' (reply included), 'waiting_on_you' (a decision: show it to the user, then answer_decision), 'working' (call again to keep waiting), 'error' (the turn failed), 'idle' (nothing running).
write_machine_file
ChatGPTCreate or overwrite a file on the agent's machine. Give text in content, or binary as content_base64.