What Is a Worker?

What It Is (2-3 sentences, bold, precise)

A worker is an atomic execution unit in a deterministic protocol. It is a function that receives state, transforms it according to an explicit contract, and returns output with no side effects, no hidden state, and no ambiguity. Every worker is independently verifiable, composable, and operates under a strict boundary that makes it auditable by anyone.

Why It Matters

Workers are the antidote to black-box systems. When you send a message to a traditional API, you trust the vendor to do what they claim. You cannot see the logic. You cannot replay the execution. You cannot prove what happened.

Workers fix this.

A worker exposes its contract — inputs, outputs, and transformation logic — in plain sight. Anyone can read it. Anyone can run it. Anyone can verify the result. This is not a feature. It is a structural guarantee.

In systems where money, identity, or governance flows through code, trust is the most expensive resource. Workers eliminate the need for blind trust by making execution transparent. They turn "we promise" into "you can verify."

The philosophical shift is simple but profound: from faith in the operator to proof in the protocol.

How It Works

A worker operates in a strict cycle:

1. Receive an input payload. This is a structured object — no hidden context, no ambient state. The worker receives exactly what the caller sends.

1. Validate against the contract. The worker checks that the input matches the expected schema. If it does not, the worker rejects the request immediately. No partial execution. No silent coercion.

1. Execute the transformation. The worker applies its logic. This is a pure function — deterministic, side-effect-free, and reproducible. Given the same input, the worker always produces the same output.

1. Return a structured result. The worker emits a response object that matches the output schema. The caller receives a complete, self-contained result.

1. Log the event. Every input, output, and transformation step is recorded in an immutable ledger. This is not optional. It is the audit trail that makes the system verifiable.

This cycle is identical whether the worker runs on a local machine, a cloud server, or a distributed network. The worker does not care about its host. The contract guarantees the behavior.

The Contract

The contract is the worker's formal definition. It is not documentation. It is the specification that the worker enforces at runtime.

Input schema: A typed description of the payload the worker accepts. Every field has a type, a constraint, and a meaning.

Output schema: A typed description of the result the worker returns. Every field is guaranteed.

Transformation logic: The function that maps input to output. This logic is explicit, auditable, and deterministic. It does not make external calls unless those calls are also part of the contract.

Error conditions: Every failure mode is specified. The worker does not crash. It rejects with a structured error.

Execution environment: The worker declares what it needs — compute, memory, time limits, and any external dependencies.

The contract is the interface between trust and verification. Without it, the worker is just another function. With it, the worker becomes a protocol participant.

Real Examples

1. Cloudflare Workers

A Cloudflare Worker receives an HTTP request, applies logic (rewrite, route, filter, authenticate), and returns an HTTP response. The worker runs at the edge — but its contract is the same: request in, response out, deterministic within its inputs. The worker cannot see the server it runs on. The contract is the boundary.

2. Ethereum Smart Contracts

A smart contract is a worker on a blockchain. It receives a transaction payload, executes its logic against a shared state, and returns a result. Every execution is recorded on-chain. The contract is the code. The input is the transaction. The output is the state change. The ledger is the audit trail. This is a worker at the protocol level.

3. OpenAI Function Calling

An LLM function call is a worker invocation. The model receives a function schema, emits structured arguments, and a dispatcher routes those arguments to the actual function. The function executes, returns a result, and the model continues. The function is a worker — it has a contract, it is deterministic, and its output is fed back into the broader system.

4. Kubernetes Controllers

A Kubernetes controller watches a resource, compares its desired state to its actual state, and takes action to converge them. The controller is a worker: input is the observed state, transformation is the reconciliation logic, output is the action applied to the cluster. The controller loop is the worker cycle.

5. Unix Pipes

cat file | grep "error" | wc -l is a pipeline of workers. cat reads and emits lines. grep filters and emits matches. wc counts and emits a number. Each tool has a contract: input is text, output is text. They compose because their contracts are compatible. The pipe is the protocol. The tools are workers. This is the oldest, most reliable worker model in computing.

Common Mistakes

Hidden state. A worker that reads from a global variable or an ambient database is not a worker. It is a black box with an invisible input. The contract is broken.

Side effects. A worker that sends an email, writes a file, or mutates external state is dangerous. It cannot be replayed. It cannot be verified. It is not deterministic.

Underspecified contracts. A function with no schema, no error definition, and no execution guarantees is not a worker. It is a hope.

Tight coupling. A worker that only works with one specific caller is not a protocol participant. Workers compose because their contracts are generic. A worker that assumes its caller is a defect.

Ignoring the ledger. A worker that executes without logging is untrustable. The ledger is not overhead. It is the proof.

Connection to OIP

The Open, Interoperable Protocol (OIP) is built on workers. Every tool in the directory is a worker. Every message that flows through the system is handled by a worker. Every result is produced by a worker.

The OIP philosophy is simple: open means anyone can read the contract. Interoperable means any worker can call any other worker that matches its contract. Protocol means the rules are enforced, not suggested.

A worker is the atomic unit of this philosophy. It is the point where the abstract principle of "open, deterministic, auditable" becomes executable code.

When a tool in the OIP directory receives a message, it executes as a worker. It does not guess. It does not improvise. It follows its contract, logs its execution, and returns a structured result. This is what makes the system trustworthy: not because the operator is honest, but because the worker is verifiable.

A worker is not a function. It is a promise that can be checked.

Connection to the Grain Philosophy

This protocol is part of the Open Inventory Protocol — a living system of self-describing voxels that serves the Grain philosophy. The OIP is the interface. The philosophy is the core.