← Tines 3BCONTENT HISTORY
WHAT CHANGED
Update to Tines 3B
Snapshot Nov 17, 2026 · 12:11 UTC · version 1.0.3
Collection source: downloaded plugin package.
First saved snapshot
No earlier snapshot is available to establish a change.
Save Tines 3B and check future changes in Following.
Up to 3 plugins free · no card required.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"description": "Build and modify Tines 3B workflows from a workflow or space Git checkout, the 3B MCP server, the 3B CLI, or the in-product editor. Use whenever an agent works with workflow.toml, step directories, config.toml, Dockerfiles, workflow routes, links, triggers, connectors, step tests, or needs to create, inspect, run, debug, commit, or publish a 3B workflow.",
"included_files": [
{
"relative_path": "agents/openai.yaml",
"size_in_bytes": 194
},
{
"relative_path": "assets/templates/agent/Dockerfile",
"size_in_bytes": 410
},
{
"relative_path": "assets/templates/agent/agent.ts",
"size_in_bytes": 3845
},
{
"relative_path": "assets/templates/agent/config.toml",
"size_in_bytes": 31
},
{
"relative_path": "assets/templates/agent/model.json",
"size_in_bytes": 240
},
{
"relative_path": "assets/templates/agent/package.json",
"size_in_bytes": 157
},
{
"relative_path": "assets/templates/agent/runtime/config.ts",
"size_in_bytes": 2209
},
{
"relative_path": "assets/templates/agent/runtime/contextLimit.ts",
"size_in_bytes": 624
},
{
"relative_path": "assets/templates/agent/runtime/effort.ts",
"size_in_bytes": 1264
},
{
"relative_path": "assets/templates/agent/runtime/events.ts",
"size_in_bytes": 2233
},
{
"relative_path": "assets/templates/agent/runtime/loop.ts",
"size_in_bytes": 3754
},
{
"relative_path": "assets/templates/agent/runtime/model.ts",
"size_in_bytes": 3452
},
{
"relative_path": "assets/templates/agent/runtime/request.ts",
"size_in_bytes": 2269
},
{
"relative_path": "assets/templates/agent/runtime/response.ts",
"size_in_bytes": 2268
},
{
"relative_path": "assets/templates/agent/runtime/selfLoop.ts",
"size_in_bytes": 593
},
{
"relative_path": "assets/templates/agent/runtime/streamResponse.ts",
"size_in_bytes": 4701
},
{
"relative_path": "assets/templates/agent/runtime/tools.ts",
"size_in_bytes": 672
},
{
"relative_path": "assets/templates/agent/runtime/transcript.ts",
"size_in_bytes": 3655
},
{
"relative_path": "assets/templates/agent/system.md",
"size_in_bytes": 29
},
{
"relative_path": "assets/templates/agent/tools/getTime.ts",
"size_in_bytes": 667
},
{
"relative_path": "assets/templates/python/Dockerfile",
"size_in_bytes": 408
},
{
"relative_path": "assets/templates/python/config.toml",
"size_in_bytes": 0
},
{
"relative_path": "assets/templates/python/script.py",
"size_in_bytes": 14
},
{
"relative_path": "assets/templates/react/App.tsx",
"size_in_bytes": 60
},
{
"relative_path": "assets/templates/react/Dockerfile",
"size_in_bytes": 580
},
{
"relative_path": "assets/templates/react/config.toml",
"size_in_bytes": 14
},
{
"relative_path": "assets/templates/react/globals.css",
"size_in_bytes": 68
},
{
"relative_path": "assets/templates/react/mount.tsx",
"size_in_bytes": 135
},
{
"relative_path": "assets/templates/react/package.json",
"size_in_bytes": 189
},
{
"relative_path": "assets/templates/react/render.ts",
"size_in_bytes": 953
},
{
"relative_path": "assets/templates/shell/Dockerfile",
"size_in_bytes": 256
},
{
"relative_path": "assets/templates/shell/config.toml",
"size_in_bytes": 0
},
{
"relative_path": "assets/templates/shell/script.sh",
"size_in_bytes": 12
},
{
"relative_path": "assets/templates/typescript/Dockerfile",
"size_in_bytes": 560
},
{
"relative_path": "assets/templates/typescript/config.toml",
"size_in_bytes": 0
},
{
"relative_path": "assets/templates/typescript/script.ts",
"size_in_bytes": 21
},
{
"relative_path": "references/connectors.md",
"size_in_bytes": 5281
},
{
"relative_path": "references/dockerfile.md",
"size_in_bytes": 1173
},
{
"relative_path": "references/interfaces.md",
"size_in_bytes": 2454
},
{
"relative_path": "references/routes.md",
"size_in_bytes": 8482
},
{
"relative_path": "references/testing.md",
"size_in_bytes": 4235
},
{
"relative_path": "references/tunnels.md",
"size_in_bytes": 1089
},
{
"relative_path": "references/volumes.md",
"size_in_bytes": 3020
}
],
"name": "building-workflows",
"skill_md_contents": "---\nname: building-workflows\ndescription: Build and modify Tines 3B workflows from a workflow or space Git checkout, the 3B MCP server, the 3B CLI, or the in-product editor. Use whenever an agent works with workflow.toml, step directories, config.toml, Dockerfiles, workflow routes, links, triggers, connectors, step tests, or needs to create, inspect, run, debug, commit, or publish a 3B workflow.\nlicense: Apache-2.0\ncompatibility: Tines 3B\n---\n\n# Build 3B workflows\n\n- Read [references/interfaces.md](references/interfaces.md) when choosing or using an editing interface.\n- Read [references/testing.md](references/testing.md) before running a step or creating, updating, or running step tests.\n- Read [references/routes.md](references/routes.md) before adding or changing a step with `route`: authentication modes, `api.json`, identity and consent headers, cookies, long-running requests, and route URLs.\n- Read [references/connectors.md](references/connectors.md) before searching for, attaching, or calling a connector, or when a visitor-mode connector answers `403`.\n- Read [references/tunnels.md](references/tunnels.md) when a step must reach a private network or on-premises service.\n- Read [references/dockerfile.md](references/dockerfile.md) before changing a step’s Dockerfile, dependencies, build layers, or cache mounts.\n- Read [references/volumes.md](references/volumes.md) before a step writes to a volume: concurrency, draft storage set-up, and publish semantics.\n\n## Layout\n\n```text\nREADME.md\n<Step name>/\n README.md\n config.toml\n Dockerfile\n ...\n```\n\nWithin a workflow checkout, each top-level directory is a uniquely named step. Keep a `README.md` at the root and in every step describing purpose, trigger, and behavior; the UI already displays the workflow or step name, so do not repeat it as the opening heading.\n\nA cloned 3B space adds one directory per workflow:\n\n```text\n<Workflow name>/\n workflow.toml\n README.md\n <Step name>/\n ...\n```\n\n`workflow.toml` identifies an existing workflow. Preserve its `id`, and never copy it into another workflow directory. In a 3B-hosted space clone, pushing a new top-level directory without `workflow.toml` creates that workflow as a draft from a non-`main` branch or in Live from `main`; 3B writes the identity file back.\n\n## Step templates\n\nTemplates map to `shell` → `script.sh`, `python` → `script.py`, `typescript` → `script.ts` on Bun, `react` → `App.tsx` with React and Tailwind, and `agent` → `agent.ts`. React templates set `output = true`.\n\nCopy the closest template available through the current interface. Default to TypeScript for data processing when the user has not requested another language. In a Git checkout without interface-provided templates, copy the matching directory from [assets/templates](assets/templates) into the workflow and rename it for the step. A step may contain and import additional source files; the template entry point is the command the runtime invokes. A step builds from its own folder only, so it can’t import files from the workflow root or another step: copy a shared helper into each step that uses it. Add Python dependencies to `requirements.txt` and TypeScript or React dependencies to `package.json`; preserve the template’s install and cache layers instead of adding ad hoc installs to the Dockerfile.\n\nFor React, default to one step for one application. Do not place the UI downstream of a data step: render it immediately and fetch data from route steps. For multi-page applications, use `BrowserRouter` with `basename={window.__ROUTE_PATH__}` and relative route paths; the template computes the branch-aware base path. Use Tailwind’s built-in palette and spacing scale, and avoid adding browser dependencies without a concrete need. Render a descriptive `<title>` for every page.\n\n## `config.toml`\n\nAll fields are optional at runtime, and a missing `color` defaults to `sky`. Set a color in authored steps, and omit unused fields rather than writing empty values.\n\n```toml\ncolor = \"sky\"\noutput = true\nroute = \"/document-summary\"\nroute_auth = \"space\"\nroute_type = \"api\"\ntitle = \"Document summary\"\ncron = \"0 * * * *\"\nemail_address = \"support\"\ntimeout = 60\nretry_seconds = [1, 2, 3]\nlinks = [\"Store result\", \"Notify\"]\nconnectors = [{ name = \"slack\", type = \"slack\" }]\npinned = true\n```\n\n- Colors: `pink`, `purple`, `teal`, `green`, `orange`, `red`, or `sky`.\n- `output`: makes stdout the HTTP response, which must be a complete HTTP response with a 200–599 status, `\\r\\n` line endings, and a `\\r\\n\\r\\n` separator before the body. Without a reachable output step, 3B returns `202 Accepted` with no body.\n- `route`: assigns an HTTP path. Live routes must be unique among workflows that share an edge host. `/` is that host’s catch-all and should be used only for an explicitly requested homepage.\n- `route_auth`: defaults to `space`.\n- `route_type`: exposes the route on the Links page as `webpage`, `api`, `webhook`, or `other`.\n- `title`: names a route exposed on the Links page; set it whenever `route_type` is present.\n- `cron`: schedules the published step; drafts do not run schedules.\n- `email_address`: gives the step an inbound email trigger; the raw message becomes stdin.\n- `timeout`: accepts 1–300 seconds and defaults to 45.\n- `retry_seconds`: accepts at most 10 whole-second delays from 1–1,800. Each value schedules another whole-step attempt after a runtime command exits nonzero, so `[1, 2, 3]` permits four attempts. It does not retry builds, step tests, timeouts, out-of-memory failures, or missing commands. Use it only when replaying side effects is safe.\n- `links`: names downstream step directories. Do not list the same target twice.\n- `connectors`: is managed by connector tooling, never by hand.\n- `pinned`: places a typed route first on the Links page; the UI normally manages it.\n\n## Process and link semantics\n\nEach step is an isolated process. Its raw stdout becomes stdin for every linked downstream step. Fan-out runs in parallel. With multiple upstream steps, the most recent successful upstream output is used.\n\nTriggers compose with links. A step with `route` can also be a downstream target or link to itself. An external invocation supplies a complete HTTP request on stdin, while a linked invocation supplies the upstream step’s raw stdout, so code reached both ways must handle both input shapes.\n\nZero-byte stdout suppresses downstream execution. A step reports failure only through a nonzero exit status. Do not catch an error, log it, and continue unless success is intentional. 3B retains at most 10 KiB of stderr as its diagnostic output; stdout is the workflow data channel.\n\nA step with no trigger receives empty stdin. A route step receives a complete RFC 7230 HTTP request. An email step receives the raw RFC 822 message.\n\n## Other runtime contracts\n\n`email_address` is a lowercase local-part of letters, digits, and internal dashes, up to 64 characters; it must begin and end with a letter or digit and be unique in the deployment’s configured inbound-email scope. The full address is deployment-specific.\n\nEach running step is limited to 1 vCPU, 2 GiB of memory with no swap, and 25,000,000 bytes per second of network ingress and egress independently, each with a 1 MiB burst. Stream or batch large data and split resource-intensive work across steps. An out-of-memory execution is killed; do not retry the same workload unchanged. `/tmp` and the working directory are memory-backed and count toward that limit, and the figures a process reads from the system are not the step’s limits; `workflow-volume-design` describes how volume reads and writes are costed.\n\n## Connectors\n\nUse a connector whenever a step needs authenticated access to another service: write ordinary requests without `Authorization` headers, API keys, or credential placeholders, then attach the connector to the step through the current interface’s connector tooling, and detach it the same way. Never ask a user to paste a key, token, password, username, or other credential into chat. If a credential appears anyway, do not put it in files or commands; use a connector and tell the user to rotate the exposed credential. If a connector cannot support the required authentication, explain the limitation. Do not build credential-entry forms or routes as a workaround: workflow request bodies are retained as execution inputs.\n\n## Volumes\n\nVolumes are named POSIX directories mounted below `/storage`. Names contain 1–63 lowercase letters, digits, dashes, or underscores and begin with a letter or digit. Declare each mount with its own `VOLUME` instruction: a list such as `VOLUME [\"notes\", \"drafts\"]` is rejected.\n\n- `VOLUME [\"state:ro\"]` mounts `state` read-only.\n- `VOLUME [\"state\"]` allows overlapping writers. When overlapping runs change the same file, only the first to publish is saved.\n- `VOLUME [\"scratch:scope=run\"]` gives one workflow run isolated writable storage shared by steps in that run.\n\nIn Live, a volume belongs to the space and is selected by name, so workflows in the same space share a named volume. Draft branches have isolated files that are discarded with the draft. For any named volume or filesystem-backed state, use `workflow-volume-design` before choosing mounts or file layout.\n\nNever store passwords, API keys, OAuth tokens, private keys, or reusable session credentials in volumes, even when the user requests it.\n"
}SHA-256 of public snapshot: 191c52ed6a625a5af3757176f7bf3287a9003861d206e4fe0957571d140b7082