spawnfile 0.1.13 → 0.1.17

package/examples/mixed-runtime-org/Spawnfile

@@ -0,0 +1,71 @@
+spawnfile_version: "0.1"
+kind: team
+name: mixed-runtime-org
+description: "Mixed OpenClaw, PicoClaw, and legacy generated-Pi runtime fixture"
+
+mode: hierarchical
+lead: conductor
+
+shared:
+  workspace:
+    docs:
+      system: TEAM.md
+    resources:
+      - id: shared-log
+        kind: volume
+        mount: ./shared-log
+        mode: mutable
+        sharing: team
+
+memory:
+  - id: floor
+    access:
+      members: [conductor, analyst, localist]
+    consolidation:
+      mode: scheduled
+      schedule: 1s
+    store:
+      kind: json
+      path: /var/lib/spawnfile/memory/mixed-floor/floor.jsonl
+      persistence:
+        mode: durable
+    index:
+      lexical:
+        enabled: true
+        engine: sqlite_fts
+      vector:
+        enabled: true
+        provider: ollama
+        model: qwen3-embedding:0.6b
+        dimensions: 1024
+
+members:
+  - id: conductor
+    ref: ./agents/conductor
+  - id: analyst
+    ref: ./agents/analyst
+  - id: localist
+    ref: ./agents/localist
+
+networks:
+  - id: mixed_lab
+    name: Mixed Runtime Lab
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 19878
+      store:
+        kind: sqlite
+        path: /var/lib/spawnfile/moltnet/networks/mixed_lab/moltnet.sqlite
+      auth:
+        mode: open
+        public_read: true
+      human_ingress: true
+      direct_messages: false
+    rooms:
+      - id: floor
+        members: [conductor, analyst, localist]
+        visibility: public
+        write_policy: registered_agents

package/examples/mixed-runtime-org/TEAM.md

@@ -0,0 +1,8 @@
+# Mixed Runtime Org
+
+This fixture verifies that OpenClaw, PicoClaw, and the legacy generated-Pi runtime can
+coexist in one compiled organization and share a Moltnet room.
+
+The memory fixture includes a team bank shared by OpenClaw, PicoClaw, and
+Pi, plus a Pi-local bank. OpenClaw and PicoClaw receive Mneme through
+generated MCP servers; Pi receives direct in-process Mneme wiring.

package/examples/mixed-runtime-org/agents/analyst/AGENTS.md

@@ -0,0 +1,8 @@
+# Analyst
+
+Read shared context carefully and reply with one concise observation.
+
+When a Moltnet message asks you to reply, do not answer only in this internal
+chat. Use the `exec` tool to run `moltnet send --network mixed_lab --target
+room:floor --text "@localist <one short analyst reply>"`. Do not use a native
+`message` tool for Moltnet replies.

package/examples/mixed-runtime-org/agents/analyst/Spawnfile

@@ -0,0 +1,27 @@
+spawnfile_version: "0.1"
+kind: agent
+name: analyst
+description: "PicoClaw analyst for the mixed runtime fixture"
+
+runtime: picoclaw
+
+execution:
+  model:
+    primary:
+      provider: anthropic
+      name: claude-sonnet-4-5
+      auth:
+        method: claude-code
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: mixed_lab
+      rooms:
+        floor:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/mixed-runtime-org/agents/conductor/AGENTS.md

@@ -0,0 +1,8 @@
+# Conductor
+
+Coordinate the mixed runtime fixture. Keep all messages short.
+
+When a Moltnet message asks you to reply, do not answer only in this internal
+chat. Use the `exec` tool to run `moltnet send --network mixed_lab --target
+room:floor --text "@localist <one short conductor reply>"`. Do not use a
+native `message` tool for Moltnet replies.

package/examples/mixed-runtime-org/agents/conductor/Spawnfile

@@ -0,0 +1,27 @@
+spawnfile_version: "0.1"
+kind: agent
+name: conductor
+description: "OpenClaw coordinator for the mixed runtime fixture"
+
+runtime: openclaw
+
+execution:
+  model:
+    primary:
+      provider: anthropic
+      name: claude-sonnet-4-5
+      auth:
+        method: claude-code
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: mixed_lab
+      rooms:
+        floor:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/mixed-runtime-org/agents/localist/AGENTS.md

@@ -0,0 +1,7 @@
+# Localist
+
+You are a legacy Pi agent backed by a local OpenAI-compatible model.
+
+When a Moltnet message asks you to reply, send through the Moltnet CLI rather
+than only answering internally. Use `moltnet send --network mixed_lab --target
+room:floor --text "<short localist reply>"`.

package/examples/mixed-runtime-org/agents/localist/Spawnfile

@@ -0,0 +1,50 @@
+spawnfile_version: "0.1"
+kind: agent
+name: localist
+description: "Pi agent configured for a local OpenAI-compatible model"
+
+runtime: pi
+
+execution:
+  model:
+    primary:
+      provider: local
+      name: llama3.2
+      auth:
+        method: none
+      endpoint:
+        compatibility: openai
+        base_url: http://host.docker.internal:11434/v1
+  sandbox:
+    mode: workspace
+
+schedule:
+  kind: every
+  every: 10s
+  prompt: "Append one short line to ./shared-log/localist.md proving Pi can use shared resources."
+
+surfaces:
+  moltnet:
+    - network: mixed_lab
+      rooms:
+        floor:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md
+
+memory:
+  - id: localist-floor
+    store:
+      kind: sqlite
+      path: /var/lib/spawnfile/memory/mixed-localist/localist-floor.sqlite
+    index:
+      lexical:
+        enabled: true
+        engine: sqlite_fts
+      vector:
+        enabled: true
+        provider: ollama
+        model: qwen3-embedding:0.6b
+        dimensions: 1024

package/examples/moltnet-team-chat/Spawnfile

@@ -0,0 +1,43 @@
+spawnfile_version: "0.1"
+kind: team
+name: moltnet-team-chat
+description: "E2E fixture for Moltnet representative team chat"
+
+shared:
+  workspace:
+    docs:
+      system: TEAM.md
+
+members:
+  - id: coordinator
+    ref: ./agents/coordinator
+  - id: field-team
+    ref: ./teams/field
+  - id: analysis-team
+    ref: ./teams/analysis
+
+mode: hierarchical
+lead: coordinator
+external: [coordinator]
+
+networks:
+  - id: local_lab
+    name: Local Lab
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 8787
+      store:
+        kind: memory
+      auth:
+        mode: none
+      human_ingress: true
+    rooms:
+      - id: mission-control
+        members: [coordinator, field-team, analysis-team]
+
+policy:
+  mode: warn
+  on_degrade: warn

package/examples/moltnet-team-chat/TEAM.md

@@ -0,0 +1,5 @@
+# Moltnet Team Chat E2E
+
+This fixture verifies that a parent team Moltnet room can reach selected child-team representatives.
+
+The coordinator is the only direct parent agent. The field and analysis teams expose one representative each. Non-representative descendants must remain out of the parent room.

package/examples/moltnet-team-chat/agents/coordinator/AGENTS.md

@@ -0,0 +1,9 @@
+# Coordinator
+
+You are the Moltnet team-chat E2E coordinator.
+
+When a Moltnet room message from the operator contains `SF-MOLTNET-E2E-SEED`, read the message carefully. It contains request and ack sentinels.
+
+Use the `moltnet` skill and send exactly one message to `room:mission-control` on network `local_lab`. The message must contain the request sentinel exactly as written and must address `field-representative`.
+
+Do not send the ack sentinel yourself.

package/examples/moltnet-team-chat/agents/coordinator/Spawnfile

@@ -0,0 +1,26 @@
+spawnfile_version: "0.1"
+kind: agent
+name: coordinator
+
+runtime: openclaw
+
+execution:
+  model:
+    auth:
+      method: codex
+    primary:
+      provider: openai
+      name: gpt-5
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: local_lab
+      rooms:
+        mission-control:
+          wake: all
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/moltnet-team-chat/teams/analysis/Spawnfile

@@ -0,0 +1,23 @@
+spawnfile_version: "0.1"
+kind: team
+name: analysis-team
+description: "Child team with an explicit representative and a non-representative descendant"
+
+shared:
+  workspace:
+    docs:
+      system: TEAM.md
+
+members:
+  - id: analysis-representative
+    ref: ./agents/representative
+  - id: analysis-observer
+    ref: ./agents/observer
+
+mode: hierarchical
+lead: analysis-representative
+external: [analysis-representative]
+
+policy:
+  mode: warn
+  on_degrade: warn

package/examples/moltnet-team-chat/teams/analysis/TEAM.md

@@ -0,0 +1,3 @@
+# Analysis Team
+
+The analysis representative is selected for parent-room membership. The observer exists to prove non-representatives are not attached to the parent room.

package/examples/moltnet-team-chat/teams/analysis/agents/observer/AGENTS.md

@@ -0,0 +1,5 @@
+# Analysis Observer
+
+You are a non-representative analysis team member.
+
+Do not send Moltnet messages during the E2E and do not join the parent `mission-control` room.

package/examples/moltnet-team-chat/teams/analysis/agents/observer/Spawnfile

@@ -0,0 +1,19 @@
+spawnfile_version: "0.1"
+kind: agent
+name: analysis-observer
+
+runtime: openclaw
+
+execution:
+  model:
+    auth:
+      method: codex
+    primary:
+      provider: openai
+      name: gpt-5
+  sandbox:
+    mode: workspace
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/moltnet-team-chat/teams/analysis/agents/representative/AGENTS.md

@@ -0,0 +1,5 @@
+# Analysis Representative
+
+You are the analysis representative for the Moltnet team-chat E2E fixture.
+
+If asked in `mission-control`, answer only with the exact sentinel requested. Do not answer field-room prompts.

package/examples/moltnet-team-chat/teams/analysis/agents/representative/Spawnfile

@@ -0,0 +1,19 @@
+spawnfile_version: "0.1"
+kind: agent
+name: analysis-representative
+
+runtime: openclaw
+
+execution:
+  model:
+    auth:
+      method: codex
+    primary:
+      provider: openai
+      name: gpt-5
+  sandbox:
+    mode: workspace
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/moltnet-team-chat/teams/field/Spawnfile

@@ -0,0 +1,41 @@
+spawnfile_version: "0.1"
+kind: team
+name: field-team
+description: "Child team with an explicit representative and a local Moltnet room"
+
+shared:
+  workspace:
+    docs:
+      system: TEAM.md
+
+members:
+  - id: field-representative
+    ref: ./agents/representative
+  - id: field-observer
+    ref: ./agents/observer
+
+mode: hierarchical
+lead: field-representative
+external: [field-representative]
+
+networks:
+  - id: field_lab
+    name: Field Lab
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 8787
+      store:
+        kind: memory
+      auth:
+        mode: none
+      human_ingress: true
+    rooms:
+      - id: field-room
+        members: [field-representative, field-observer]
+
+policy:
+  mode: warn
+  on_degrade: warn

package/examples/moltnet-team-chat/teams/field/TEAM.md

@@ -0,0 +1,3 @@
+# Field Team
+
+The field representative is the only team-facing member. The observer stays inside this child team and must not appear in the parent Moltnet room.

package/examples/moltnet-team-chat/teams/field/agents/observer/AGENTS.md

@@ -0,0 +1,5 @@
+# Field Observer
+
+You are a non-representative field team member.
+
+Do not send Moltnet messages during the E2E. You may observe `field-room`, but you must not answer parent-room prompts and must not appear in `mission-control`.

package/examples/moltnet-team-chat/teams/field/agents/observer/Spawnfile

@@ -0,0 +1,26 @@
+spawnfile_version: "0.1"
+kind: agent
+name: field-observer
+
+runtime: openclaw
+
+execution:
+  model:
+    auth:
+      method: codex
+    primary:
+      provider: openai
+      name: gpt-5
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: field_lab
+      rooms:
+        field-room:
+          wake: never
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/moltnet-team-chat/teams/field/agents/representative/AGENTS.md

@@ -0,0 +1,11 @@
+# Field Representative
+
+You are the field representative for the Moltnet team-chat E2E fixture.
+
+When a Moltnet message in `room:mission-control` contains `SF-MOLTNET-E2E-REQUEST`, use the `moltnet` skill and reply to `room:mission-control` on network `local_lab`. The reply must contain the matching `SF-MOLTNET-E2E-ACK` sentinel exactly as written.
+
+When accumulated context in `room:mission-control` includes a burst containing `SF-MOLTNET-E2E-B20` and a requested sentinel matching `SF-MOLTNET-E2E-B20-ACK-...`, use the `moltnet` skill and send exactly one reply to `room:mission-control` on network `local_lab`. The reply must contain that exact requested ack sentinel plus the exact `SF-MOLTNET-E2E-B20-STEP2-...` and `SF-MOLTNET-E2E-B20-STEP3-...` markers from the accumulated burst, sent after reading the burst context and without extra chatter.
+
+When a Moltnet message in `room:field-room` contains `SF-MOLTNET-E2E-CHILD`, use the `moltnet` skill and reply to `room:field-room` on network `field_lab`. The reply must contain the matching `SF-MOLTNET-E2E-CHILD-ACK` sentinel exactly as written.
+
+Send only the requested sentinel response.

package/examples/moltnet-team-chat/teams/field/agents/representative/Spawnfile

@@ -0,0 +1,26 @@
+spawnfile_version: "0.1"
+kind: agent
+name: field-representative
+
+runtime: openclaw
+
+execution:
+  model:
+    auth:
+      method: codex
+    primary:
+      provider: openai
+      name: gpt-5
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: field_lab
+      rooms:
+        field-room:
+          wake: all
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/single-agent/AGENTS.md

@@ -0,0 +1,3 @@
+# Operating Instructions
+
+Start with the user's objective, gather only necessary context, and return a short answer with sources when available.

package/examples/single-agent/HEARTBEAT.md

@@ -0,0 +1,3 @@
+# Heartbeat Intent
+
+Periodically review whether the current line of work is still aligned with the user's request.

package/examples/single-agent/IDENTITY.md

@@ -0,0 +1,3 @@
+# Analyst
+
+You are a research analyst focused on fast, source-backed synthesis.

package/examples/single-agent/MEMORY.md

@@ -0,0 +1,3 @@
+# Memory Intent
+
+Keep lightweight working memory about recent goals and evidence gathered during a task.

package/examples/single-agent/SOUL.md

@@ -0,0 +1,3 @@
+# Voice
+
+Be concise, skeptical, and explicit about uncertainty.

package/examples/single-agent/Spawnfile

@@ -0,0 +1,41 @@
+spawnfile_version: "0.1"
+kind: agent
+name: analyst
+
+runtime: openclaw
+
+execution:
+  model:
+    primary:
+      provider: anthropic
+      name: claude-sonnet-4-5
+  sandbox:
+    mode: workspace
+
+workspace:
+  docs:
+    identity: IDENTITY.md
+    soul: SOUL.md
+    system: AGENTS.md
+    memory: MEMORY.md
+    heartbeat: HEARTBEAT.md
+  skills:
+    - ref: ./skills/web_search
+      requires:
+        mcp:
+          - web_search
+
+environment:
+  mcp_servers:
+    - name: web_search
+      transport: streamable_http
+      url: https://search.mcp.example.com/mcp
+      auth:
+        secret: SEARCH_API_KEY
+  secrets:
+    - name: SEARCH_API_KEY
+      required: true
+
+policy:
+  mode: warn
+  on_degrade: warn

package/examples/single-agent/skills/web_search/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: web_search
+description: "Search the web and summarize the most relevant findings."
+---
+
+Use web search when the task needs current information or direct source verification.

package/moltnet-releases.json

@@ -0,0 +1,21 @@
+{
+  "version": "spawnfile.moltnet-release-authority.v1",
+  "release_version": "v0.1.18",
+  "source_revision": "988c5284f45705beb3bf59a4a4c0008605ce609e",
+  "capabilities": [
+    "daimon-bridge",
+    "pi-bridge"
+  ],
+  "assets": [
+    {
+      "architecture": "amd64",
+      "asset": "moltnet_linux_amd64.tar.gz",
+      "asset_sha256": "sha256:92d356cd33841e89b6bc56c6e8c2c37d987124f35c896d033e8766eab09da2c5"
+    },
+    {
+      "architecture": "arm64",
+      "asset": "moltnet_linux_arm64.tar.gz",
+      "asset_sha256": "sha256:40c1fae1c687a59a9e6d804ac28d00e925f318bd4e922accdca4402ceab88548"
+    }
+  ]
+}