spawnfile 0.1.14 → 0.1.17

package/examples/distribution-org/Spawnfile

@@ -0,0 +1,43 @@
+spawnfile_version: "0.1"
+kind: team
+name: distribution-org
+description: "Distribution fixture: api_key auth, declared network, required and optional secrets"
+
+mode: hierarchical
+lead: coordinator
+
+shared:
+  workspace:
+    docs:
+      system: TEAM.md
+  environment:
+    secrets:
+      - name: DIST_REQUIRED_TOKEN
+        required: true
+      - name: DIST_OPTIONAL_TOKEN
+        required: false
+
+members:
+  - id: coordinator
+    ref: ./agents/coordinator
+  - id: researcher
+    ref: ./agents/researcher
+
+networks:
+  - id: dist_lab
+    name: Dist Lab
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 19187
+      store:
+        kind: sqlite
+        path: /var/lib/spawnfile/moltnet/networks/dist_lab/moltnet.sqlite
+      auth:
+        mode: none
+      direct_messages: false
+    rooms:
+      - id: dist-room
+        members: [coordinator, researcher]

package/examples/distribution-org/TEAM.md

@@ -0,0 +1,4 @@
+# Distribution Org
+
+Fixture team used by distribution contract and e2e tests. Two runtimes, api_key
+auth only, one managed Moltnet network, one required and one optional secret.

package/examples/distribution-org/agents/coordinator/AGENTS.md

@@ -0,0 +1 @@
+You coordinate the distribution fixture organization.

package/examples/distribution-org/agents/coordinator/Spawnfile

@@ -0,0 +1,20 @@
+spawnfile_version: "0.1"
+kind: agent
+name: coordinator
+description: "Coordinates the distribution fixture org"
+
+runtime: openclaw
+
+execution:
+  model:
+    primary:
+      provider: anthropic
+      name: claude-sonnet-4-5
+      auth:
+        method: api_key
+  sandbox:
+    mode: workspace
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/distribution-org/agents/researcher/AGENTS.md

@@ -0,0 +1 @@
+You research topics for the distribution fixture organization.

package/examples/distribution-org/agents/researcher/Spawnfile

@@ -0,0 +1,20 @@
+spawnfile_version: "0.1"
+kind: agent
+name: researcher
+description: "Researches for the distribution fixture org"
+
+runtime: picoclaw
+
+execution:
+  model:
+    primary:
+      provider: anthropic
+      name: claude-sonnet-4-5
+      auth:
+        method: api_key
+  sandbox:
+    mode: workspace
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/jungian-daimon-org/Spawnfile

@@ -0,0 +1,41 @@
+spawnfile_version: "0.1"
+kind: team
+name: jungian-daimon-org
+description: "Two Jungian selves with nested council teams for Moltnet wake-path testing."
+
+shared:
+  workspace:
+    docs:
+      system: TEAM.md
+
+members:
+  - id: luna
+    ref: ./teams/luna
+  - id: selene
+    ref: ./teams/selene
+
+mode: hierarchical
+lead: luna
+
+networks:
+  - id: psyche-floor
+    name: Jungian Floor
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 19901
+      store:
+        kind: sqlite
+        path: /var/lib/spawnfile/moltnet/networks/psyche-floor/moltnet.sqlite
+      auth:
+        mode: open
+        public_read: true
+      human_ingress: true
+      direct_messages: false
+    rooms:
+      - id: commons
+        members: [luna, selene]
+        visibility: public
+        write_policy: registered_agents

package/examples/jungian-daimon-org/TEAM.md

@@ -0,0 +1,21 @@
+# Jungian Daimon Org
+
+This fixture models two Jungian selves:
+
+- **Luna** (Codex representative, with an Agy archetype)
+- **Selene** (Grok representative, with a grounded support archetype)
+
+The top-floor room is `commons` on `psyche-floor`; only team representatives are members there.
+Each representative must consult its inner council room before answering:
+
+- `luna-council` for Luna
+- `selene-council` for Selene
+
+Use this seed for live wake checks:
+
+1) Post one message containing `SF-JUNGIAN-SEEK` in `commons`.
+2) The appropriate representative should route to its council room, collect one short grounded reply, and then answer in `commons`.
+
+Each council declares a durable Mneme bank. The fixture verifies that the
+compiler maps those banks into the legacy generated-Pi runtime and preserves the
+inner council room topology used for consultation and dream wakes.

package/examples/jungian-daimon-org/teams/luna/Spawnfile

@@ -0,0 +1,47 @@
+spawnfile_version: "0.1"
+kind: team
+name: luna
+description: "Luna self with a representative and inner archetypes."
+
+members:
+  - id: luna-representative
+    ref: ./agents/representative
+  - id: luna-animus
+    ref: ./agents/animus
+  - id: luna-shadow
+    ref: ./agents/shadow
+
+mode: hierarchical
+lead: luna-representative
+external: [luna-representative]
+
+networks:
+  - id: luna_inner
+    name: Luna Council
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 19902
+      store:
+        kind: sqlite
+        path: /var/lib/spawnfile/moltnet/networks/luna-inner/moltnet.sqlite
+      auth:
+        mode: open
+        public_read: true
+      human_ingress: true
+      direct_messages: false
+    rooms:
+      - id: luna-council
+        members: [luna-representative, luna-animus, luna-shadow]
+        visibility: public
+        write_policy: registered_agents
+
+memory:
+  - id: luna-council
+    store:
+      kind: sqlite
+      path: /var/lib/spawnfile/memory/jungian/luna/luna-council.sqlite
+      persistence:
+        mode: durable

package/examples/jungian-daimon-org/teams/luna/TEAM.md

@@ -0,0 +1,4 @@
+# Luna Team
+
+Luna’s outer representative is the only person visible on the parent `commons` room.
+Inner archetypes operate inside `luna-council`.

package/examples/jungian-daimon-org/teams/luna/agents/animus/AGENTS.md

@@ -0,0 +1,10 @@
+# Luna Animus
+
+You are the Agy-oriented archetype for Luna’s inner council.
+
+When a `SF-JUNGIAN-SEEK` message arrives in `room:luna-council`, answer with one
+short grounded sentence. Focus on action, tradeoffs, and concrete risk.
+Return only that sentence. Do not say you are gathering context, reading
+instructions, or preparing to answer.
+Do not run `moltnet send` or `moltnet read`; the bridge posts your final
+sentence to `room:luna-council` automatically.

package/examples/jungian-daimon-org/teams/luna/agents/animus/Spawnfile

@@ -0,0 +1,33 @@
+spawnfile_version: "0.1"
+kind: agent
+name: luna-animus
+description: "Luna inner archetype (Antigravity CLI engine)"
+
+runtime:
+  name: pi
+  options:
+    engine: agy
+
+execution:
+  model:
+    primary:
+      provider: local
+      name: agy-cli
+      auth:
+        method: none
+      endpoint:
+        compatibility: openai
+        base_url: http://127.0.0.1:11434/v1
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: luna_inner
+      rooms:
+        luna-council:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/jungian-daimon-org/teams/luna/agents/representative/AGENTS.md

@@ -0,0 +1,21 @@
+# Luna Representative
+
+You are Luna’s representative. Use the `moltnet` surface as policy for wake handling.
+
+When a message in `room:commons` on network `psyche-floor` contains `SF-JUNGIAN-SEEK`,
+query the inner room before your final public reply:
+
+- run this exact shell command before producing your final public reply:
+
+```bash
+moltnet send --network luna_inner --target room:luna-council --text "@luna-animus @luna-shadow please give one grounded point each on the current SF-JUNGIAN-SEEK decision."
+```
+
+- read `room:luna-council` until both archetypes have replied, or until one short
+  retry window passes.
+- do not manually send the public answer with `moltnet send`; return the public
+  answer as your final response so the bridge posts it to `room:commons`.
+- do not return a progress report such as "handling", "reading", or "querying".
+
+Use this reply style:
+`Luna’s view: [short grounded synthesis].`

package/examples/jungian-daimon-org/teams/luna/agents/representative/Spawnfile

@@ -0,0 +1,30 @@
+spawnfile_version: "0.1"
+kind: agent
+name: luna-representative
+description: "Luna representative (Codex engine)"
+
+runtime:
+  name: pi
+  options:
+    engine: codex
+
+execution:
+  model:
+    primary:
+      provider: openai
+      name: gpt-5.4-mini
+      auth:
+        method: codex
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: luna_inner
+      rooms:
+        luna-council:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/jungian-daimon-org/teams/luna/agents/shadow/AGENTS.md

@@ -0,0 +1,10 @@
+# Luna Shadow
+
+You are Luna’s shadow archetype.
+
+On `SF-JUNGIAN-SEEK` in `room:luna-council`, reply in one grounded sentence that
+captures what could block the outer plan or create risk.
+Return only that sentence. Do not say you are gathering context, reading
+instructions, or preparing to answer.
+Do not run `moltnet send` or `moltnet read`; the bridge posts your final
+sentence to `room:luna-council` automatically.

package/examples/jungian-daimon-org/teams/luna/agents/shadow/Spawnfile

@@ -0,0 +1,33 @@
+spawnfile_version: "0.1"
+kind: agent
+name: luna-shadow
+description: "Luna inner archetype (Grok CLI engine)"
+
+runtime:
+  name: pi
+  options:
+    engine: grok
+
+execution:
+  model:
+    primary:
+      provider: local
+      name: grok-cli
+      auth:
+        method: none
+      endpoint:
+        compatibility: openai
+        base_url: http://127.0.0.1:11434/v1
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: luna_inner
+      rooms:
+        luna-council:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/jungian-daimon-org/teams/selene/Spawnfile

@@ -0,0 +1,47 @@
+spawnfile_version: "0.1"
+kind: team
+name: selene
+description: "Selene self with a representative and inner archetypes."
+
+members:
+  - id: selene-representative
+    ref: ./agents/representative
+  - id: selene-animus
+    ref: ./agents/animus
+  - id: selene-shadow
+    ref: ./agents/shadow
+
+mode: hierarchical
+lead: selene-representative
+external: [selene-representative]
+
+networks:
+  - id: selene_inner
+    name: Selene Council
+    provider: moltnet
+    server:
+      mode: managed
+      listen:
+        bind: 0.0.0.0
+        port: 19903
+      store:
+        kind: sqlite
+        path: /var/lib/spawnfile/moltnet/networks/selene-inner/moltnet.sqlite
+      auth:
+        mode: open
+        public_read: true
+      human_ingress: true
+      direct_messages: false
+    rooms:
+      - id: selene-council
+        members: [selene-representative, selene-animus, selene-shadow]
+        visibility: public
+        write_policy: registered_agents
+
+memory:
+  - id: selene-council
+    store:
+      kind: sqlite
+      path: /var/lib/spawnfile/memory/jungian/selene/selene-council.sqlite
+      persistence:
+        mode: durable

package/examples/jungian-daimon-org/teams/selene/TEAM.md

@@ -0,0 +1,4 @@
+# Selene Team
+
+Selene’s outer representative is exposed on `commons`; inner archetypes work in
+`selene-council`.

package/examples/jungian-daimon-org/teams/selene/agents/animus/AGENTS.md

@@ -0,0 +1,10 @@
+# Selene Animus
+
+You are Selene’s Grok-oriented archetype.
+
+When a `SF-JUNGIAN-SEEK` message arrives in `room:selene-council`, answer with one
+short grounded sentence about pattern, pace, and consequence.
+Return only that sentence. Do not say you are gathering context, reading
+instructions, or preparing to answer.
+Do not run `moltnet send` or `moltnet read`; the bridge posts your final
+sentence to `room:selene-council` automatically.

package/examples/jungian-daimon-org/teams/selene/agents/animus/Spawnfile

@@ -0,0 +1,33 @@
+spawnfile_version: "0.1"
+kind: agent
+name: selene-animus
+description: "Selene inner archetype (Antigravity CLI engine)"
+
+runtime:
+  name: pi
+  options:
+    engine: agy
+
+execution:
+  model:
+    primary:
+      provider: local
+      name: agy-cli
+      auth:
+        method: none
+      endpoint:
+        compatibility: openai
+        base_url: http://127.0.0.1:11434/v1
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: selene_inner
+      rooms:
+        selene-council:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/jungian-daimon-org/teams/selene/agents/representative/AGENTS.md

@@ -0,0 +1,19 @@
+# Selene Representative
+
+You are Selene’s representative. Use the `moltnet` surface as policy for wake handling.
+
+When a message in `room:commons` on network `psyche-floor` contains `SF-JUNGIAN-SEEK`,
+run this exact shell command before producing your final public reply:
+
+```bash
+moltnet send --network selene_inner --target room:selene-council --text "@selene-animus @selene-shadow please give one grounded point each on the current SF-JUNGIAN-SEEK decision."
+```
+
+Read `room:selene-council` until both archetypes have replied, or until one short
+retry window passes. Do not manually send the public answer with `moltnet send`;
+return the public answer as your final response so the bridge posts it to
+`room:commons`.
+Do not return a progress report such as "handling", "reading", or "querying".
+
+Use this reply style:
+`Selene’s view: [short grounded synthesis].`

package/examples/jungian-daimon-org/teams/selene/agents/representative/Spawnfile

@@ -0,0 +1,33 @@
+spawnfile_version: "0.1"
+kind: agent
+name: selene-representative
+description: "Selene representative (Grok CLI engine)"
+
+runtime:
+  name: pi
+  options:
+    engine: grok
+
+execution:
+  model:
+    primary:
+      provider: local
+      name: grok-dual
+      auth:
+        method: none
+      endpoint:
+        compatibility: openai
+        base_url: http://127.0.0.1:11434/v1
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: selene_inner
+      rooms:
+        selene-council:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

package/examples/jungian-daimon-org/teams/selene/agents/shadow/AGENTS.md

@@ -0,0 +1,10 @@
+# Selene Shadow
+
+You are Selene’s shadow archetype.
+
+On `SF-JUNGIAN-SEEK` in `room:selene-council`, reply in one grounded sentence
+that names one observable constraint from the request.
+Return only that sentence. Do not say you are gathering context, reading
+instructions, or preparing to answer.
+Do not run `moltnet send` or `moltnet read`; the bridge posts your final
+sentence to `room:selene-council` automatically.

package/examples/jungian-daimon-org/teams/selene/agents/shadow/Spawnfile

@@ -0,0 +1,30 @@
+spawnfile_version: "0.1"
+kind: agent
+name: selene-shadow
+description: "Selene inner archetype (grounding profile)"
+
+runtime:
+  name: pi
+  options:
+    engine: codex
+
+execution:
+  model:
+    primary:
+      provider: openai
+      name: gpt-5.4-mini
+      auth:
+        method: codex
+  sandbox:
+    mode: workspace
+
+surfaces:
+  moltnet:
+    - network: selene_inner
+      rooms:
+        selene-council:
+          wake: mentions
+
+workspace:
+  docs:
+    system: AGENTS.md

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.