docs: update examples with ecosystem integration

[khaliqgant]

Adds example 06 (WritebackConsumer), docker prereqs, shared type imports.

---

[devin-ai-integration]

Devin Review found 1 potential issue.

View 5 additional findings in Devin Review.

[devin-ai-integration]

🔴 seed.sh curl requests don't match the server's API contract — no files get seeded

The three curl -X PUT commands in seed.sh fail silently because they violate three requirements of the PUT /v1/workspaces/{id}/fs/file endpoint:

1. Missing X-Correlation-Id header — the server rejects requests without this header with 400 (internal/httpapi/server.go:232-235).
2. Missing If-Match header — the write handler requires it (internal/httpapi/server.go:1455-1459), returning 412 without it. The SDK sends "If-Match": input.baseRevision (e.g. "*" for create-or-overwrite) at packages/sdk/typescript/src/client.ts:321.
3. Wrong body format — the handler expects a JSON body with {"contentType":…, "content":…, "encoding":…, "semantics":…} (internal/httpapi/server.go:1476-1483), but the script sends raw content with Content-Type: application/octet-stream.

Since curl returns exit code 0 for HTTP 4xx errors (no --fail flag), set -e doesn't catch the failures. The script prints a token and appears to succeed, but ws_demo contains no files. Every curl example in docker/README.md will get 404s.

Example fix for one of the PUT requests

curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/docs/welcome.md" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Correlation-Id: seed-welcome" \
  -H "If-Match: *" \
  -d '{"contentType":"text/markdown","content":"# Welcome\nYour relayfile workspace is running."}'

Suggested change

	curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/docs/welcome.md" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/octet-stream" \
	-d '# Welcome
	Your relayfile workspace is running.
	Write files here and agents will see them instantly.'
	curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/github/repos/demo/pulls/1/metadata.json" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/octet-stream" \
	-d '{"number":1,"title":"Add quickstart","state":"open","author":"dev"}'
	curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/config/agents.json" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/octet-stream" \
	-d '{"agents":[{"name":"dev-agent","scopes":["fs:read","fs:write"]}]}'
	curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/docs/welcome.md" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/json" \
	-H "X-Correlation-Id: seed-welcome" \
	-H "If-Match: *" \
	-d '{"contentType":"text/markdown","content":"# Welcome\nYour relayfile workspace is running.\nWrite files here and agents will see them instantly."}'
	curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/github/repos/demo/pulls/1/metadata.json" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/json" \
	-H "X-Correlation-Id: seed-pr" \
	-H "If-Match: *" \
	-d '{"contentType":"application/json","content":"{\"number\":1,\"title\":\"Add quickstart\",\"state\":\"open\",\"author\":\"dev\"}"}'
	curl -sS -X PUT "$RELAYFILE/v1/workspaces/$WS/fs/file?path=/config/agents.json" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/json" \
	-H "X-Correlation-Id: seed-config" \
	-H "If-Match: *" \
	-d '{"contentType":"application/json","content":"{\"agents\":[{\"name\":\"dev-agent\",\"scopes\":[\"fs:read\",\"fs:write\"]}]}"}'

---

Was this helpful? React with 👍 or 👎 to provide feedback.