bdambrosio/Cognitive_workbench

world-presence

Notices when someone comes near you or moves away in the shared world. Fires on the transition only, and carries the current situation with it.

world-look

Look around the shared world — the ground you are standing on, and who else is present, how far away they are and whether they are facing you. Your primary perception when you are embodied in the world.

world-mark

Leave a labelled marker in the shared world, at your feet or at a coordinate. Markers persist and are visible to anyone who can see that spot — a way to point at a place without saying a coordinate out loud.

world-move

Walk somewhere in the shared world — to a coordinate, or toward another occupant such as Bruce. Returns immediately with the distance and how long the walk will take; your body keeps walking after the call returns.

fetch-text

Fetch the text content of a web page or PDF from a URL. Handles HTML, PDF, Markdown, plain text — auto-detects format. Research PDFs come back as a section index you can then read section by section.

semantic-scholar

Search academic papers, or list one paper's references. Returns abstracts plus metadata (including a pdf_url) — use fetch-text on that pdf_url to read the paper itself. Use for scholarly literature, not general web content.

rss-watcher

Monitors RSS feeds for new items matching configured keywords

search-web

Search the web for information on a topic. Returns a synthesized summary with citations. Use when you need current information or facts not in training data.

fac-place

Place one entity from your Factorio inventory at a position (stone-furnace, iron-chest, burner-inserter, transport-belt, ...). You must be within ~10 tiles; the item must be in your inventory. For belt/pipe/pole RUNS use fac-connect instead.

factorio-telemetry

Watches the shared Factorio world via the game bridge — new game chat from other players, players joining or leaving, watched production flows stopping, and new alert kinds. Publishes only on events; quiet cycles publish nothing.

fac-pickup

Pick up a placed entity (with its contents) or loose items lying on the ground in Factorio into your inventory — e.g. clear ore piled up in front of a blocked drill. You must be within reach of the position (walk there first).

fac-nearest

Find the nearest resource in Factorio — iron-ore, copper-ore, coal, stone, water, wood — within 500 tiles of your character. Use when you need ore/fuel and don't know where a patch is; fac-observe then shows the patch details once you're near.

fac-observe

Look around in Factorio — entities near a position (or near you), plus production telemetry and alerts. Your primary perception in the factory; observe before building or when an action reports a deviation.

fac-status

Quick Factorio situational check — your character's position and walking state, server tick, connected players, your last bridge action, and the latest game chat. Use first when turning attention to the factory, and to see whether the human said anything in…

fac-connect

Build a validated run of transport-belt, pipe, or electric poles between two Factorio positions — the construction macro. Pathfinds around obstacles and places every segment. Use dry_run first to check feasibility and cost.

fac-craft

Hand-craft items in Factorio from materials in your inventory (belts, inserters, chests, gears...). Crafts intermediate ingredients recursively when you have the raw materials.

fac-extract

Take items out of a Factorio machine or container into your inventory (collect smelted plates from a furnace, unload a chest). You must be within reach of the source entity.

fac-harvest

Mine resources or chop trees in Factorio — iron ore, copper ore, coal, stone, wood — into your inventory. You must be within reach of the resource (walk to the patch first).

fac-insert

Put items from your Factorio inventory into a machine or container (fuel a furnace with coal, load ore, stock a chest). You must be within reach of the target entity.

fac-inventory

What your Factorio character is carrying. Check before placing, connecting, or crafting — construction consumes items from this inventory.

fac-rotate

Rotate a placed Factorio entity (inserter, belt segment, ...) to face a direction. Use when something is oriented wrong — e.g. an inserter moving items the wrong way.

fac-say

Say something in Factorio game chat — visible to everyone on the server. Use to report what you're doing, flag blockers, answer the human, or announce before acting near someone else's work.

fac-stop

Immediately stop your Factorio character's current movement. Safety control — use when asked to stop, when you realize you're heading somewhere wrong, or before reassessing after a surprise.

fac-walk

Walk your Factorio character to a position. Real walking at game speed (~9 tiles/s) — long hauls take real time and the call blocks until arrival, failure, or timeout. You must be within ~10 tiles of things to act on them.

check-x-feed

Return posts that appeared since the last check from the members of the user's curated X (Twitter) List. Use for the recurring X-feed sweep. Returns raw posts (author, time, text, link) with no relevance filtering — judge what is worth surfacing yourself and…

ramana-saying

Return one genuine saying of Ramana Maharshi, drawn verbatim from his recorded talks, with source attribution. Use when delivering an authentic Ramana quote with attribution — not a paraphrase or a synthesized reflection. The returned text is a raw quote; add…

get-financial-statements

Fetch standardized financial statements (income, balance sheet, cash flow, earnings, company overview) for a ticker from Alpha Vantage. Returns combined annual+quarterly JSON for analysis.

look-at-target

Aim the ChatterBot head to find and center a target in view — the user, a person, an object, an animal. Runs a closed visual loop (capture, judge where the target is, nudge pan/tilt, repeat) until the target is centered, or reports it could not find the…

camera-capture

Capture a still photo from the ChatterBot head camera. The captured frame is attached to your own visual input, so you can SEE it and answer questions about what is in view — whether the user is present, whether there is a cat, what the scene looks like. The…

head-move

Move the ChatterBot head — aim the pan/tilt camera or play an expressive gesture. The bot is a stationary companion head; this points its gaze, it does NOT drive or navigate. Use when the user asks you to look somewhere, turn toward/away, look up/down,…

generate-image

Generate an original image from a text description, locally (Bonsai-Image 4B, ternary-quantized, on a long-lived studio server). Use when the user wants a picture, illustration, avatar, or face created from a description that does not already exist on the…

assess

Check whether text matches a natural-language condition. Returns "true" or "false". Auto-chunks long texts and short-circuits on first match.

check-email

Read recent emails from a Gmail inbox via IMAP. Returns text with subject, sender, date, and body per email. Read-only — never marks messages as read.

exec-script

Run a bash/shell script — for system commands the existing tools don't cover. Trusted by default; treat with the same care as any code-execution action.

filter-semantic

Filter a list of items to those matching a natural-language condition (e.g. "only the items that mention X"). NOT YET WIRED in chat-mode — present in src/tools/ for future enablement.

obsidian

Read, search, write, and list notes in the user's Obsidian vault. Multi-action — set `action` first, then provide the args required by that action.

stock-price

Look up the current stock price (price, change, volume) for a ticker symbol. End-of-day data on the free tier.

calculate

Compute the value of a math expression. Handles arithmetic, algebra, trig, calculus. Use this instead of LLM arithmetic — calculate is exact and deterministic.

bluesky-instructions

Returns API instructions (not data) for retrieving Bluesky metrics via AT Protocol. Read the returned instructions, then use fetch-text + extract to get actual data.

browse

Browser automation via agent-browser CLI. Navigate, snapshot accessibility tree, interact by element ref.