NAW Studio

worker question

New worker.

ANY TIME model (required) llm (adapter entry)

1

IDENTITY

id Lowercase, digits, underscore. Folder name; fixed after creation. name title team (optional) Used by screens only.

2

OUTPUT TERMINALSat least one

Each terminal starts with a simple text schema; edit the JSON Schema here or in worker.json. The table shows what the program checks (blue: refused when broken) and the descriptions the LLM reads (green, optional).

EXPECTED INPUTS start worker only

Used when a block of this worker has no incoming line (a start worker): it gets the run input as its first input section, and these inputs define the flow input (the RUN form fields; required unless unchecked). Elsewhere the lines decide the input.

3

TOOLSshared tools from tools/

Tool notes: how this worker uses each tool (the same tool can be used differently by each worker); sent with tasks and questions. Empty notes on a chosen tool can be saved (the structure check warns); notes on the program's tools (grey) are optional.

4

DOMAIN KNOWLEDGEpermanent

IN THIS WORKER'S KNOWLEDGE

None yet.

DOCUMENTS IN THE PROJECT'S docs/ FOLDER

Tick files or folders to add (a folder takes all .md files in it).

FILES FROM ELSEWHERE

Pick .md files .md only, no PDF (convert first). Picked files are copied into the worker's knowledge.

index (adapter entry) map_llm Default: the worker's model.

On save the program builds the map and the index; save finishes only after both.

5

LIMITSoptional overrides

max_callsDefault 40. max_nudgesDefault 3. tool_fail_limitDefault 5.

6

POST-CHECKchecks.py

Optional checks.py in the worker folder: it checks every saved output and refuses it until its rules hold. Write it by hand or with an AI coding assistant.

7

PERSONApersona.md

Write it last, from everything above.

MISSIONmission.md

Sent with assigned tasks only; open questions (ASK) get the persona alone.

Creates workers/<id>/worker.json, persona.md and knowledge/. Fill the details later in the files (vibe coding).

step (review every worker block) idle

run input

run input (JSON object, goes to the start functions)

No start block: this flow takes no input. A start function (FUNCTIONS > + New function > start function) or a worker block with no incoming line (a start worker) takes the run input.

STRUCTURE CHECK

New file server.

Saving gives this file server's tools to everyone on its share lines.

BASICS

name Lowercase, digits, underscore; not "knowledge". Used in tool names. llm (adapter entry) Builds the maps of text files. description The LLM reads it when picking a tool. Be specific; no two file servers may share a description. map_llm Model that writes the maps of text files (.md, .txt). Empty: a map is the first sentences. index Text files go in; everyone on a share line then gets the query tool.

SHARE LINES

When a block of the sender ends, the files it owns go to the receivers, who become owners too. The FLOW canvas shows the same list as dashed lines (bottom point -> top point). Functions send with FILES_OUT = True and receive with FILES_IN = True; files the user gives come in through the start function. A share function (file_servers/<name>/share.py, written in code) may pick which files go to whom.

CHECK

Save to run the check.

TOOLS

WORKER

ON THE SHARE LINES AS

TOOLS

View file_server.json

FRAMEWORK TOOLS

Added by the framework; not files. File server tools go to everyone on its share lines; knowledge tools come with domain knowledge. Grey chips: added by the framework. Green chips: shared tools the worker lists.

WORKER

TOOLS

A shared tool is a Python file in tools/. This form writes the name, description, parameters and TIMEOUT; you write run() in the file afterwards.

name Lowercase, digits, underscore. The file is tools/<name>.py. TIMEOUT (seconds) Optional. Empty = no time limit. Past it the worker gets a tool error; the call itself may keep running. description The LLM reads this to decide when to call the tool.

PARAMETERS

NAME

TYPE

REQUIRED

DESCRIPTION

A function is a flow block that runs Python code (functions/<name>.py) without an LLM. It takes any number of incoming lines (one inputs key each) and has output terminals like a worker.

This form writes the name, description, outputs and TIMEOUT of functions/<name>.py; you write run() in the file afterwards.

name Lowercase, digits, underscore. The file is functions/<name>.py. TIMEOUT (seconds) Optional. Empty = no time limit. Past it the function's process is stopped and the block fails. kind description

INPUTS (EXPECTED)

A note of what the function expects; the lines on the FLOW tab decide what really comes in.

OUTPUT TERMINALS

Each output starts with a simple text schema; edit the JSON Schema here or in the file later. No outputs = an end function (no output point); a start function needs at least one.

Pick a run on the left.

ABOUT

project.json

PROJECT

name language Language of the prompts the framework writes.

DEFAULTS

Empty = framework default (shown in grey). Workers may override some of them.

KEY

VALUE

PRE-CHECK

Worker pre-check (PRE-CHECK on a worker, nextop inspect): an LLM reads one worker's parts and lists where they no longer agree. Saved in project.json as inspect.

model Empty: each worker's own model. The PRE-CHECK box on a worker can still pick another.

CHECK ITEMS

One item per line. Empty: the default list for the project language (shown in grey).

KEYS

Values live in .env; this page shows only whether they are set. Put key values in .env (never here).

KEY NAME

ENV FILE

STATUS

One card per LLM server (adapters.llm): its connection, and the models it serves. Models listed here appear in every model choice (workers, file servers, index) as "model (server)". Empty fields are left out.

Embeddings first, then the indexes that use them. Empty fields are left out.

Any other adapter kinds in project.json. Empty fields are left out.

CHECK

Save to run the check.

View project.json

IDENTITY

OUTPUT TERMINALSat least one

TOOLSshared tools from tools/

DOMAIN KNOWLEDGEpermanent

LIMITSoptional overrides

POST-CHECKchecks.py

PERSONApersona.md

MISSIONmission.md

PRE-CHECKan LLM reads this worker's saved parts and lists where they no longer agree

STRUCTURE CHECK

BASICS

SHARE LINES

CHECK

TOOLS

FRAMEWORK TOOLS

ABOUT

PROJECT

PRE-CHECK

KEYS

CHECK