@ifsoul/core 0.3.0 → 0.4.0

package/specs/v0.2/examples/memory-event-plan-proposal.json

@@ -1,82 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "memory-event",
-  "memoryId": "event-plan-proposal",
-  "characterId": "character-mira",
-  "recordedAt": "2026-01-01T08:03:00Z",
-  "scope": {
-    "audience": "private",
-    "participantIds": ["participant-mira"],
-    "export": "allowed"
-  },
-  "provenance": {
-    "sources": [
-      {
-        "sourceType": "plan-proposal",
-        "sourceId": "plan-day-1"
-      }
-    ]
-  },
-  "eventType": "plan-proposed",
-  "summary": "A proposed plan included inspection and tending. A proposal is not accepted work or an observed effect.",
-  "participantIds": ["participant-mira"],
-  "environmentId": "garden",
-  "sessionId": "garden-session-1",
-  "recordedPayload": {
-    "schemaVersion": "draft-0.2.0",
-    "kind": "plan-proposal",
-    "binding": {
-      "environmentId": "garden",
-      "sessionId": "garden-session-1",
-      "characterId": "character-mira",
-      "embodimentId": "gardener-1"
-    },
-    "correlationId": "daily-cycle-1",
-    "planId": "plan-day-1",
-    "requestId": "daily-request-1",
-    "contextReportId": "briefing-day-1",
-    "contextRevision": "context-100",
-    "environmentRevision": "garden-profile-1",
-    "createdAt": "2026-01-01T08:00:00Z",
-    "expiresAt": "2026-01-01T08:05:00Z",
-    "horizon": {
-      "basis": "world-ticks",
-      "timelineId": "garden-day-1",
-      "fromTick": 100,
-      "toTick": 600
-    },
-    "tasks": [
-      {
-        "taskId": "task-inspect",
-        "intentId": "inspect-area",
-        "arguments": {
-          "area": {
-            "type": "entity-ref",
-            "entityId": "herb-area"
-          }
-        },
-        "priority": "normal",
-        "dependsOnTaskIds": [],
-        "explanation": "Inspect before deciding whether further care is possible."
-      },
-      {
-        "taskId": "task-tend",
-        "intentId": "tend-plot",
-        "arguments": {
-          "plot": {
-            "type": "entity-ref",
-            "entityId": "plot-1"
-          },
-          "amount": {
-            "type": "quantity",
-            "value": 100,
-            "unit": "ml"
-          }
-        },
-        "priority": "low",
-        "dependsOnTaskIds": ["task-inspect"],
-        "explanation": "A conditional care proposal; the host can reject it when water is unavailable."
-      }
-    ]
-  }
-}

package/specs/v0.2/examples/memory-event-proposed.json

@@ -1,53 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "memory-event",
-  "memoryId": "event-plan-proposed",
-  "characterId": "character-mira",
-  "recordedAt": "2026-01-01T08:03:00Z",
-  "scope": {
-    "audience": "private",
-    "participantIds": ["participant-mira"],
-    "export": "allowed"
-  },
-  "provenance": {
-    "sources": [
-      {
-        "sourceType": "plan-decision",
-        "sourceId": "decision-day-1"
-      }
-    ]
-  },
-  "eventType": "plan-decision-observed",
-  "summary": "Inspection was accepted and watering was rejected. Acceptance is not achievement.",
-  "participantIds": ["participant-mira"],
-  "environmentId": "garden",
-  "sessionId": "garden-session-1",
-  "recordedPayload": {
-    "schemaVersion": "draft-0.2.0",
-    "kind": "plan-decision",
-    "binding": {
-      "environmentId": "garden",
-      "sessionId": "garden-session-1",
-      "characterId": "character-mira",
-      "embodimentId": "gardener-1"
-    },
-    "correlationId": "daily-cycle-1",
-    "planId": "plan-day-1",
-    "decisionId": "decision-day-1",
-    "requestId": "daily-request-1",
-    "contextRevision": "context-100",
-    "recordedAt": "2026-01-01T08:00:00Z",
-    "status": "partially-accepted",
-    "taskDecisions": [
-      {
-        "taskId": "task-inspect",
-        "decision": "accepted"
-      },
-      {
-        "taskId": "task-tend",
-        "decision": "rejected",
-        "reason": "The existing host facility reports no available water."
-      }
-    ]
-  }
-}

package/specs/v0.2/examples/memory-fact.json

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "memory-fact",
-  "memoryId": "fact-inspection",
-  "characterId": "character-mira",
-  "recordedAt": "2026-01-01T08:03:00Z",
-  "scope": {
-    "audience": "private",
-    "participantIds": ["participant-mira"],
-    "export": "allowed"
-  },
-  "provenance": {
-    "sources": [
-      {
-        "sourceType": "memory",
-        "sourceId": "event-inspection"
-      }
-    ]
-  },
-  "claim": "The host reported that two herb beds were inspected during this session.",
-  "sourceMemoryIds": ["event-inspection"],
-  "confidence": 0.9
-}

package/specs/v0.2/examples/memory-relationship.json

@@ -1,25 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "memory-relationship",
-  "memoryId": "relationship-visitor",
-  "characterId": "character-mira",
-  "recordedAt": "2026-01-01T08:03:00Z",
-  "scope": {
-    "audience": "private",
-    "participantIds": ["participant-mira"],
-    "export": "allowed"
-  },
-  "provenance": {
-    "sources": [
-      {
-        "sourceType": "conversation",
-        "sourceId": "visitor-hello"
-      }
-    ]
-  },
-  "subjectParticipantId": "participant-mira",
-  "objectParticipantId": "participant-visitor",
-  "relation": "acquaintance",
-  "description": "Mira recalls a synthetic visitor who asked about the garden.",
-  "sourceMemoryIds": ["event-visitor-question"]
-}

package/specs/v0.2/examples/memory-working-context.json

@@ -1,24 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "working-context",
-  "memoryId": "working-garden",
-  "characterId": "character-mira",
-  "recordedAt": "2026-01-01T08:03:00Z",
-  "scope": {
-    "audience": "private",
-    "participantIds": ["participant-mira"],
-    "export": "allowed"
-  },
-  "provenance": {
-    "sources": [
-      {
-        "sourceType": "memory",
-        "sourceId": "event-inspection"
-      }
-    ]
-  },
-  "summary": "Inspection was reported complete; actual watering was not reported.",
-  "activeTopics": ["Finding an authorized source of water."],
-  "relevantMemoryIds": ["event-inspection"],
-  "expiresAt": "2026-01-02T08:00:00Z"
-}

package/specs/v0.2/examples/plan-cancel-request.json

@@ -1,16 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "plan-cancel-request",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "correlationId": "daily-cycle-1",
-  "planId": "plan-day-1",
-  "cancellationId": "cancel-inspect-1",
-  "taskIds": ["task-inspect"],
-  "requestedAt": "2026-01-01T08:00:45Z",
-  "reason": "The host operator requested a stop."
-}

package/specs/v0.2/examples/plan-cancel-result.json

@@ -1,21 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "plan-cancel-result",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "correlationId": "daily-cycle-1",
-  "planId": "plan-day-1",
-  "cancellationId": "cancel-inspect-1",
-  "recordedAt": "2026-01-01T08:01:01Z",
-  "taskResults": [
-    {
-      "taskId": "task-inspect",
-      "status": "already-finished",
-      "reason": "The host completed inspection before cancellation could be confirmed."
-    }
-  ]
-}

package/specs/v0.2/examples/plan-daily.json

@@ -1,57 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "plan-proposal",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "correlationId": "daily-cycle-1",
-  "planId": "plan-day-1",
-  "requestId": "daily-request-1",
-  "contextReportId": "briefing-day-1",
-  "contextRevision": "context-100",
-  "environmentRevision": "garden-profile-1",
-  "createdAt": "2026-01-01T08:00:00Z",
-  "expiresAt": "2026-01-01T08:05:00Z",
-  "horizon": {
-    "basis": "world-ticks",
-    "timelineId": "garden-day-1",
-    "fromTick": 100,
-    "toTick": 600
-  },
-  "tasks": [
-    {
-      "taskId": "task-inspect",
-      "intentId": "inspect-area",
-      "arguments": {
-        "area": {
-          "type": "entity-ref",
-          "entityId": "herb-area"
-        }
-      },
-      "priority": "normal",
-      "dependsOnTaskIds": [],
-      "explanation": "Inspect before deciding whether further care is possible."
-    },
-    {
-      "taskId": "task-tend",
-      "intentId": "tend-plot",
-      "arguments": {
-        "plot": {
-          "type": "entity-ref",
-          "entityId": "plot-1"
-        },
-        "amount": {
-          "type": "quantity",
-          "value": 100,
-          "unit": "ml"
-        }
-      },
-      "priority": "low",
-      "dependsOnTaskIds": ["task-inspect"],
-      "explanation": "A conditional care proposal; the host can reject it when water is unavailable."
-    }
-  ]
-}

package/specs/v0.2/examples/plan-partial-decision.json

@@ -1,28 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "plan-decision",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "correlationId": "daily-cycle-1",
-  "planId": "plan-day-1",
-  "decisionId": "decision-day-1",
-  "requestId": "daily-request-1",
-  "contextRevision": "context-100",
-  "recordedAt": "2026-01-01T08:00:00Z",
-  "status": "partially-accepted",
-  "taskDecisions": [
-    {
-      "taskId": "task-inspect",
-      "decision": "accepted"
-    },
-    {
-      "taskId": "task-tend",
-      "decision": "rejected",
-      "reason": "The existing host facility reports no available water."
-    }
-  ]
-}

package/specs/v0.2/examples/portable-memory.jsonl

@@ -1,9 +0,0 @@
-{"schemaVersion":"draft-0.2.0","kind":"intent-checkpoint","memoryId":"checkpoint-initial","characterId":"character-mira","recordedAt":"2026-01-01T08:00:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"authored","sourceId":"template-mira-v2"}]},"intents":[{"portableIntentId":"learn-herb-care","description":"Learn to care for herbs when an environment supports it.","desiredOutcome":"Understand appropriate care through permitted experiences.","status":"pending","sourceMemoryIds":[]}]}
-{"schemaVersion":"draft-0.2.0","kind":"memory-event","memoryId":"event-inspection","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"host-report","sourceId":"outcome-inspect-1"}]},"eventType":"host-reported-outcome","summary":"The host reported completed inspection. This does not claim the rejected watering task happened.","participantIds":["participant-mira"],"environmentId":"garden","sessionId":"garden-session-1","worldTime":{"timelineId":"garden-day-1","tick":110},"recordedPayload":{"schemaVersion":"draft-0.2.0","kind":"task-report","binding":{"environmentId":"garden","sessionId":"garden-session-1","characterId":"character-mira","embodimentId":"gardener-1"},"correlationId":"daily-cycle-1","planId":"plan-day-1","reportId":"outcome-inspect-1","taskId":"task-inspect","contextRevision":"context-102","recordedAt":"2026-01-01T08:01:00Z","status":"succeeded","summary":"The host reports inspection completed.","observedEffects":["Two herb beds were inspected by the existing host facility."]}}
-{"schemaVersion":"draft-0.2.0","kind":"memory-event","memoryId":"event-visitor-question","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"conversation","sourceId":"visitor-hello"}]},"eventType":"received-conversation","summary":"A synthetic visitor asked Mira how the garden was doing.","participantIds":["participant-mira","participant-visitor"],"environmentId":"garden","sessionId":"garden-session-1","recordedPayload":{"messageId":"visitor-hello","participantId":"participant-visitor","recordedAt":"2026-01-01T08:02:00Z","modality":"speech","content":"How is the garden today?"}}
-{"schemaVersion":"draft-0.2.0","kind":"memory-event","memoryId":"event-plan-proposal","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"plan-proposal","sourceId":"plan-day-1"}]},"eventType":"plan-proposed","summary":"A proposed plan included inspection and tending. A proposal is not accepted work or an observed effect.","participantIds":["participant-mira"],"environmentId":"garden","sessionId":"garden-session-1","recordedPayload":{"schemaVersion":"draft-0.2.0","kind":"plan-proposal","binding":{"environmentId":"garden","sessionId":"garden-session-1","characterId":"character-mira","embodimentId":"gardener-1"},"correlationId":"daily-cycle-1","planId":"plan-day-1","requestId":"daily-request-1","contextReportId":"briefing-day-1","contextRevision":"context-100","environmentRevision":"garden-profile-1","createdAt":"2026-01-01T08:00:00Z","expiresAt":"2026-01-01T08:05:00Z","horizon":{"basis":"world-ticks","timelineId":"garden-day-1","fromTick":100,"toTick":600},"tasks":[{"taskId":"task-inspect","intentId":"inspect-area","arguments":{"area":{"type":"entity-ref","entityId":"herb-area"}},"priority":"normal","dependsOnTaskIds":[],"explanation":"Inspect before deciding whether further care is possible."},{"taskId":"task-tend","intentId":"tend-plot","arguments":{"plot":{"type":"entity-ref","entityId":"plot-1"},"amount":{"type":"quantity","value":100,"unit":"ml"}},"priority":"low","dependsOnTaskIds":["task-inspect"],"explanation":"A conditional care proposal; the host can reject it when water is unavailable."}]}}
-{"schemaVersion":"draft-0.2.0","kind":"memory-event","memoryId":"event-plan-proposed","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"plan-decision","sourceId":"decision-day-1"}]},"eventType":"plan-decision-observed","summary":"Inspection was accepted and watering was rejected. Acceptance is not achievement.","participantIds":["participant-mira"],"environmentId":"garden","sessionId":"garden-session-1","recordedPayload":{"schemaVersion":"draft-0.2.0","kind":"plan-decision","binding":{"environmentId":"garden","sessionId":"garden-session-1","characterId":"character-mira","embodimentId":"gardener-1"},"correlationId":"daily-cycle-1","planId":"plan-day-1","decisionId":"decision-day-1","requestId":"daily-request-1","contextRevision":"context-100","recordedAt":"2026-01-01T08:00:00Z","status":"partially-accepted","taskDecisions":[{"taskId":"task-inspect","decision":"accepted"},{"taskId":"task-tend","decision":"rejected","reason":"The existing host facility reports no available water."}]}}
-{"schemaVersion":"draft-0.2.0","kind":"working-context","memoryId":"working-garden","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"memory","sourceId":"event-inspection"}]},"summary":"Inspection was reported complete; actual watering was not reported.","activeTopics":["Finding an authorized source of water."],"relevantMemoryIds":["event-inspection"],"expiresAt":"2026-01-02T08:00:00Z"}
-{"schemaVersion":"draft-0.2.0","kind":"memory-episode","memoryId":"episode-garden","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"memory","sourceId":"event-inspection"}]},"summary":"Mira received the host report of an inspection.","sourceMemoryIds":["event-inspection"],"period":{"basis":"world-ticks","timelineId":"garden-day-1","fromTick":100,"toTick":110}}
-{"schemaVersion":"draft-0.2.0","kind":"memory-fact","memoryId":"fact-inspection","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"memory","sourceId":"event-inspection"}]},"claim":"The host reported that two herb beds were inspected during this session.","sourceMemoryIds":["event-inspection"],"confidence":0.9}
-{"schemaVersion":"draft-0.2.0","kind":"memory-relationship","memoryId":"relationship-visitor","characterId":"character-mira","recordedAt":"2026-01-01T08:03:00Z","scope":{"audience":"private","participantIds":["participant-mira"],"export":"allowed"},"provenance":{"sources":[{"sourceType":"conversation","sourceId":"visitor-hello"}]},"subjectParticipantId":"participant-mira","objectParticipantId":"participant-visitor","relation":"acquaintance","description":"Mira recalls a synthetic visitor who asked about the garden.","sourceMemoryIds":["event-visitor-question"]}

package/specs/v0.2/examples/task-outcome.json

@@ -1,21 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "task-report",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "correlationId": "daily-cycle-1",
-  "planId": "plan-day-1",
-  "reportId": "outcome-inspect-1",
-  "taskId": "task-inspect",
-  "contextRevision": "context-102",
-  "recordedAt": "2026-01-01T08:01:00Z",
-  "status": "succeeded",
-  "summary": "The host reports inspection completed.",
-  "observedEffects": [
-    "Two herb beds were inspected by the existing host facility."
-  ]
-}

package/specs/v0.2/examples/task-progress.json

@@ -1,19 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "task-report",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "correlationId": "daily-cycle-1",
-  "planId": "plan-day-1",
-  "reportId": "progress-inspect-1",
-  "taskId": "task-inspect",
-  "contextRevision": "context-101",
-  "recordedAt": "2026-01-01T08:00:30Z",
-  "status": "running",
-  "summary": "The host NPC state machine is carrying out inspection.",
-  "observedEffects": []
-}

package/specs/world-adapter/README.md

@@ -1,114 +0,0 @@
-# WorldAdapter and authorization contracts
-
-Historical v0.1 contract. The [v0.2 design](../v0.2/README.md) uses host-owned
-planning/dialogue profiles. Do not interpret this legacy action vocabulary as
-authorization to implement NPC locomotion, combat or pathfinding in IfSoul bridges.
-
-WorldAdapter is a planned transport-independent boundary: negotiate versions,
-obtain capabilities, perceive an actor's available world, submit an action, and
-receive authoritative results/events. No adapter methods, transport, engine,
-network endpoint, or game integration are implemented by these schemas.
-
-| Envelope            | Required fields beyond `schemaVersion`, `kind`                                                                                     |
-| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| Capability set      | `adapterId`, `worldId`, `sessionId`, `actorId`, `capabilityRevision`, `supportedSchemaVersions`, `capabilities`                    |
-| Perception          | `observationId`, `adapterId`, `worldId`, `sessionId`, `observerId`, `observedAt`, `worldTime`, `observations`                      |
-| Action              | `actionId`, `worldId`, `sessionId`, `actorId`, `capabilityId`, `capabilityRevision`, `arguments`, `requestedAt`, `deadlineAt`      |
-| Action Result       | `resultId`, `actionId`, `adapterId`, `worldId`, `sessionId`, `actorId`, `recordedAt`, `worldTime`, `status`, `execution`, `events` |
-| World Event         | `eventId`, `adapterId`, `worldId`, `sessionId`, `sourceSequence`, `recordedAt`, `worldTime`, `scope`, `type`, `payload`            |
-| Permission Policy   | `policyId`, `revision`, `worldId`, `sessionId`, `rules`                                                                            |
-| Permission Decision | `decisionId`, `policyId`, `policyRevision`, `worldId`, `sessionId`, `subjectId`, `resource`, `action`, `decision`, `evaluatedAt`   |
-
-## Capabilities, observations, and permission
-
-A capability describes what an adapter can attempt, not what a particular actor
-may do. Each entry contains `capabilityId`, `description`, `argumentsSchema`,
-`requiredPermissions`, `semantics`, and `idempotency`. `semantics.preconditions`
-and `semantics.possibleEffects` are human-readable descriptions, not executable
-code or proof that effects occurred. Capability IDs MUST be unique in a set.
-`capabilityRevision` identifies the exact set; a request using an obsolete or
-unsupported revision is rejected rather than reinterpreted.
-
-The consumer and adapter MUST select an explicitly shared schema version before
-exchanging actions. The bootstrap supports only `draft-0.1.0`; the supported
-version list is not a range parser or an implemented handshake. Identities MUST
-match the bound world, session, and actor; matching IDs from another context do
-not confer access.
-
-Perception is an explicitly limited observation: `observations` contains
-`subjectId`, `scope`, and open `payload` objects. Missing observations mean
-unknown, not false. Optional `availableCapabilityIds` is an advisory subset, not
-an authorization grant. Optional `worldRevision` can be carried back as the
-action's `observedWorldRevision`; the game decides whether it is still usable.
-World state can change after observation. An adapter MAY reject stale or newly
-invalid actions even when runtime previously allowed them.
-
-A Permission Policy is a synthetic declarative baseline. Rules match exact
-`subjectId`, `resource`, and `action` in the policy's world/session; no wildcard,
-inheritance, or free-text matching is defined. Each has a unique `ruleId` and
-`effect: "grant" | "revoke"`. Any matching revoke denies; otherwise a matching
-grant allows; no match denies. Revocation is represented in a new policy revision,
-not deletion of audit history. `resource` and `action` are opaque IDs resolved by
-trusted policy; a resource named in a payload cannot create authority.
-
-`requiredPermissions` lists prerequisites to check, not grants. Runtime MUST
-check authorization for the proposed operation, including current policy and
-scope; the adapter MUST independently check current game restrictions. An empty
-prerequisite list never bypasses those checks. A Permission Decision records an
-`allow` or `deny` for a policy revision at `evaluatedAt`; it is evidence, not a
-bearer token, and may already be stale. Neither an instance, model tool call,
-capability advertisement, observation, nor memory event can grant permissions.
-
-## Execution, deadlines, and retries
-
-Action arguments MUST validate against the selected capability's separately
-validated JSON Schema. The adapter checks deadline and current preconditions
-before starting; expiry before starting yields rejection. Once execution might
-have started, a timeout or cancellation MUST NOT be treated as proof of failure.
-`deadlineAt` requests a bound on starting/waiting; it does not roll back the world.
-This draft has no cancellation message; a future transport must distinguish
-cancelling a wait from confirmed prevention of execution.
-
-| `status`   | `execution`                | Meaning                                                                                      |
-| ---------- | -------------------------- | -------------------------------------------------------------------------------------------- |
-| `success`  | `completed`                | The requested operation completed; no `error`                                                |
-| `rejected` | `not-started`              | Validation, authorization, deadline, or current-world rejection; requires `error`, no events |
-| `failed`   | `not-started` or `partial` | Authoritative execution failure; requires `error`; no events when not started                |
-| `unknown`  | `unknown`                  | Execution cannot be determined; requires `error.retry: "reconcile-first"`                    |
-
-`events` contains only actual reported effects of this action, never predicted
-or unrelated events. Empty events do not prove no effect. Correlation across all
-nested events MUST match the result's world/session/adapter/action; unique event
-IDs, source-local `sourceSequence`, and optional `worldRevision` need semantic
-checks. Only the adapter/game is authoritative about execution. A `resultId`
-identifies one reported result; the same action can later have a distinct
-reconciled result. Consumers deduplicate facts by event ID and retain provenance.
-
-Errors contain `code`, safe human-readable `message`, and `retry`, plus optional
-`retryAfterMs`. Retry values mean `never`, `after-correction`, `same-request`, or
-`reconcile-first`; they are guidance subject to current authorization and
-idempotency. A not-started operation can be retried when the cause is corrected.
-A failed partial operation requires reconciliation before another attempt,
-regardless of a generic retry hint.
-
-For `idempotency: "none"`, automatic resubmission after possible execution is
-forbidden. For `action-id`, the adapter promises duplicate submissions with the
-same action ID and identical arguments/context will not execute again for the
-**bound session**; it MUST retain reconciliation information throughout that
-session and reject changed input under that ID. No guarantee survives an
-unnegotiated session change. The baseline has no persistent deduplication store.
-Retrying an unknown result requires querying/reconciling with the authoritative
-adapter first; if that is unavailable, preserve unknown and require an explicit
-recovery decision. Neither a fresh action ID nor repeated transport delivery
-guarantees exactly-once execution.
-
-World events are source facts with access scope; an observer's Memory Event
-records only what that observer was allowed to receive. Tick order applies only
-to one timeline, and event sequence only to one adapter/world/session stream.
-
-Positive examples: [capabilities](examples/capability.json),
-[perception](examples/perception.json), [policy](examples/permission-policy.json),
-[decision](examples/permission-decision.json), [action](examples/action.json),
-[success](examples/action-result.json), [unknown result](examples/action-result-unknown.json),
-[world event](examples/world-event.json). The unknown result is an alternative
-transport outcome for the example action, not a second execution.

package/specs/world-adapter/examples/action-result-unknown.json

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": "draft-0.1.0",
-  "kind": "action-result",
-  "resultId": "result-water-unknown",
-  "actionId": "action-water-1",
-  "adapterId": "synthetic-garden",
-  "worldId": "garden",
-  "sessionId": "session-1",
-  "actorId": "actor-mira",
-  "recordedAt": "2026-01-01T12:00:00Z",
-  "worldTime": {
-    "timelineId": "garden-day-1",
-    "tick": 20
-  },
-  "status": "unknown",
-  "execution": "unknown",
-  "events": [],
-  "error": {
-    "code": "timeout",
-    "message": "The transport closed before an authoritative result arrived.",
-    "retry": "reconcile-first"
-  }
-}

package/specs/world-adapter/examples/action-result.json

@@ -1,45 +0,0 @@
-{
-  "schemaVersion": "draft-0.1.0",
-  "kind": "action-result",
-  "resultId": "result-water-1",
-  "actionId": "action-water-1",
-  "adapterId": "synthetic-garden",
-  "worldId": "garden",
-  "sessionId": "session-1",
-  "actorId": "actor-mira",
-  "recordedAt": "2026-01-01T12:00:00Z",
-  "worldTime": {
-    "timelineId": "garden-day-1",
-    "tick": 20
-  },
-  "status": "success",
-  "execution": "completed",
-  "events": [
-    {
-      "schemaVersion": "draft-0.1.0",
-      "kind": "world-event",
-      "eventId": "world-event-water-1",
-      "adapterId": "synthetic-garden",
-      "worldId": "garden",
-      "sessionId": "session-1",
-      "sourceSequence": 1,
-      "recordedAt": "2026-01-01T12:00:00Z",
-      "worldTime": {
-        "timelineId": "garden-day-1",
-        "tick": 20
-      },
-      "scope": {
-        "audience": "private",
-        "subjectIds": ["actor-mira"],
-        "export": "allowed"
-      },
-      "type": "plant-watered",
-      "payload": {
-        "plantId": "plant-1",
-        "amountMl": 100
-      },
-      "actionId": "action-water-1"
-    }
-  ],
-  "worldRevision": "revision-20"
-}

package/specs/world-adapter/examples/action.json

@@ -1,17 +0,0 @@
-{
-  "schemaVersion": "draft-0.1.0",
-  "kind": "action",
-  "actionId": "action-water-1",
-  "worldId": "garden",
-  "sessionId": "session-1",
-  "actorId": "actor-mira",
-  "capabilityId": "water-plant",
-  "capabilityRevision": "capabilities-1",
-  "arguments": {
-    "plantId": "plant-1",
-    "amountMl": 100
-  },
-  "requestedAt": "2026-01-01T12:00:00Z",
-  "deadlineAt": "2026-01-01T12:00:05Z",
-  "observedWorldRevision": "revision-19"
-}