@ifsoul/core 0.3.0 → 0.4.0

package/specs/v0.2/examples/context-after-inspection.json

@@ -1,44 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "context-report",
-  "reportId": "briefing-after-inspection",
-  "contextRevision": "context-102",
-  "environmentRevision": "garden-profile-1",
-  "correlationId": "daily-cycle-1",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "recordedAt": "2026-01-01T08:01:01Z",
-  "period": {
-    "basis": "world-ticks",
-    "timelineId": "garden-day-1",
-    "fromTick": 100,
-    "toTick": 110
-  },
-  "observedState": {
-    "summary": "The host reports inspection completed and no water available.",
-    "properties": [
-      {
-        "subjectId": "gardener-1",
-        "propertyId": "available-water-ml",
-        "value": 0
-      }
-    ]
-  },
-  "priorNeeds": [],
-  "priorPlans": [
-    {
-      "planId": "plan-day-1",
-      "taskStates": [
-        {
-          "taskId": "task-inspect",
-          "status": "succeeded"
-        }
-      ]
-    }
-  ],
-  "changes": []
-}

package/specs/v0.2/examples/context-chat.json

@@ -1,27 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "context-report",
-  "reportId": "context-chat",
-  "contextRevision": "chat-context-1",
-  "environmentRevision": "chat-profile-1",
-  "correlationId": "context-chat-cycle",
-  "binding": {
-    "environmentId": "quiet-chat",
-    "sessionId": "chat-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "chat-terminal-1"
-  },
-  "recordedAt": "2026-01-01T08:00:00Z",
-  "period": {
-    "basis": "utc",
-    "startAt": "2026-01-01T07:59:00Z",
-    "endAt": "2026-01-01T08:00:00Z"
-  },
-  "observedState": {
-    "summary": "Only the context explicitly supplied by the synthetic host is available.",
-    "properties": []
-  },
-  "priorNeeds": [],
-  "priorPlans": [],
-  "changes": []
-}

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

@@ -1,69 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "context-report",
-  "reportId": "briefing-day-1",
-  "contextRevision": "context-100",
-  "environmentRevision": "garden-profile-1",
-  "correlationId": "daily-cycle-1",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "recordedAt": "2026-01-01T08:00:00Z",
-  "period": {
-    "basis": "world-ticks",
-    "timelineId": "garden-day-1",
-    "fromTick": 0,
-    "toTick": 100
-  },
-  "observedState": {
-    "summary": "The host reports a reachable herb area and one dry plot.",
-    "properties": [
-      {
-        "subjectId": "plot-1",
-        "propertyId": "soil",
-        "value": "dry"
-      },
-      {
-        "subjectId": "gardener-1",
-        "propertyId": "available-water-ml",
-        "value": 0
-      }
-    ]
-  },
-  "priorNeeds": [
-    {
-      "needId": "care-garden",
-      "description": "The herb plot may need care.",
-      "priority": "normal",
-      "status": "current"
-    }
-  ],
-  "priorPlans": [],
-  "changes": [
-    {
-      "changeId": "dry-weather",
-      "kind": "event",
-      "recordedAt": "2026-01-01T08:00:00Z",
-      "summary": "The host observed dry weather.",
-      "worldTime": {
-        "timelineId": "garden-day-1",
-        "tick": 99
-      }
-    }
-  ],
-  "planningRequest": {
-    "requestId": "daily-request-1",
-    "cadence": "daily",
-    "horizon": {
-      "basis": "world-ticks",
-      "timelineId": "garden-day-1",
-      "fromTick": 100,
-      "toTick": 600
-    },
-    "maxTasks": 4,
-    "allowedIntentIds": ["inspect-area", "tend-plot"]
-  }
-}

package/specs/v0.2/examples/context-no-speech.json

@@ -1,27 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "context-report",
-  "reportId": "context-no-speech",
-  "contextRevision": "horse-context-1",
-  "environmentRevision": "horse-profile-1",
-  "correlationId": "context-no-speech-cycle",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-2",
-    "characterId": "character-mira",
-    "embodimentId": "horse-1"
-  },
-  "recordedAt": "2026-01-01T08:00:00Z",
-  "period": {
-    "basis": "utc",
-    "startAt": "2026-01-01T07:59:00Z",
-    "endAt": "2026-01-01T08:00:00Z"
-  },
-  "observedState": {
-    "summary": "Only the context explicitly supplied by the synthetic host is available.",
-    "properties": []
-  },
-  "priorNeeds": [],
-  "priorPlans": [],
-  "changes": []
-}

package/specs/v0.2/examples/conversation-delivery.json

@@ -1,17 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-delivery",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "requestId": "utterance-request-1",
-  "responseId": "utterance-response-1",
-  "correlationId": "utterance-cycle-1",
-  "channelId": "garden-nearby",
-  "deliveryId": "delivery-1",
-  "recordedAt": "2026-01-01T08:02:02Z",
-  "status": "delivered"
-}

package/specs/v0.2/examples/conversation-live-request.json

@@ -1,31 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-request",
-  "binding": {
-    "environmentId": "quiet-chat",
-    "sessionId": "chat-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "chat-terminal-1"
-  },
-  "requestId": "chat-request-1",
-  "correlationId": "chat-cycle-1",
-  "channelId": "quiet-room",
-  "speakerParticipantId": "participant-mira",
-  "recipientParticipantIds": ["participant-visitor"],
-  "environmentRevision": "chat-profile-1",
-  "contextRevision": "chat-context-1",
-  "mode": "live-channel",
-  "trigger": "incoming-message",
-  "requestedModality": "text",
-  "receivedAt": "2026-01-01T08:00:00Z",
-  "deadlineAt": "2026-01-01T08:00:05Z",
-  "messages": [
-    {
-      "messageId": "chat-message-1",
-      "participantId": "participant-visitor",
-      "recordedAt": "2026-01-01T08:00:00Z",
-      "modality": "text",
-      "content": "Would you like to talk about herbs?"
-    }
-  ]
-}

package/specs/v0.2/examples/conversation-live-response.json

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-response",
-  "binding": {
-    "environmentId": "quiet-chat",
-    "sessionId": "chat-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "chat-terminal-1"
-  },
-  "requestId": "chat-request-1",
-  "correlationId": "chat-cycle-1",
-  "channelId": "quiet-room",
-  "speakerParticipantId": "participant-mira",
-  "recipientParticipantIds": ["participant-visitor"],
-  "responseId": "chat-response-1",
-  "createdAt": "2026-01-01T08:00:01Z",
-  "expiresAt": "2026-01-01T08:00:05Z",
-  "output": {
-    "type": "utterance",
-    "modality": "text",
-    "content": "Yes. I would like to learn more about caring for them."
-  }
-}

package/specs/v0.2/examples/conversation-no-speech-request.json

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-request",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-2",
-    "characterId": "character-mira",
-    "embodimentId": "horse-1"
-  },
-  "requestId": "horse-request-1",
-  "correlationId": "horse-cycle-1",
-  "channelId": "garden-nearby",
-  "speakerParticipantId": "participant-mira",
-  "recipientParticipantIds": ["participant-visitor"],
-  "environmentRevision": "horse-profile-1",
-  "contextRevision": "horse-context-1",
-  "mode": "host-requested",
-  "trigger": "host-request",
-  "requestedModality": "speech",
-  "receivedAt": "2026-01-01T08:00:00Z",
-  "deadlineAt": "2026-01-01T08:00:05Z",
-  "messages": []
-}

package/specs/v0.2/examples/conversation-no-speech-response.json

@@ -1,22 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-response",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-2",
-    "characterId": "character-mira",
-    "embodimentId": "horse-1"
-  },
-  "requestId": "horse-request-1",
-  "correlationId": "horse-cycle-1",
-  "channelId": "garden-nearby",
-  "speakerParticipantId": "participant-mira",
-  "recipientParticipantIds": ["participant-visitor"],
-  "responseId": "horse-response-1",
-  "createdAt": "2026-01-01T08:00:01Z",
-  "expiresAt": "2026-01-01T08:00:05Z",
-  "output": {
-    "type": "no-output",
-    "reason": "unsupported-modality"
-  }
-}

package/specs/v0.2/examples/conversation-requested-request.json

@@ -1,31 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-request",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "requestId": "utterance-request-1",
-  "correlationId": "utterance-cycle-1",
-  "channelId": "garden-nearby",
-  "speakerParticipantId": "participant-mira",
-  "recipientParticipantIds": ["participant-visitor"],
-  "environmentRevision": "garden-profile-1",
-  "contextRevision": "context-102",
-  "mode": "host-requested",
-  "trigger": "host-request",
-  "requestedModality": "speech",
-  "receivedAt": "2026-01-01T08:02:00Z",
-  "deadlineAt": "2026-01-01T08:02:05Z",
-  "messages": [
-    {
-      "messageId": "visitor-hello",
-      "participantId": "participant-visitor",
-      "recordedAt": "2026-01-01T08:02:00Z",
-      "modality": "speech",
-      "content": "How is the garden today?"
-    }
-  ]
-}

package/specs/v0.2/examples/conversation-requested-response.json

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "conversation-response",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "requestId": "utterance-request-1",
-  "correlationId": "utterance-cycle-1",
-  "channelId": "garden-nearby",
-  "speakerParticipantId": "participant-mira",
-  "recipientParticipantIds": ["participant-visitor"],
-  "responseId": "utterance-response-1",
-  "createdAt": "2026-01-01T08:02:01Z",
-  "expiresAt": "2026-01-01T08:02:05Z",
-  "output": {
-    "type": "utterance",
-    "modality": "speech",
-    "content": "I inspected the herb beds. One plot is dry, but there is no water available."
-  }
-}

package/specs/v0.2/examples/environment-chat.json

@@ -1,43 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "environment-profile",
-  "binding": {
-    "environmentId": "quiet-chat",
-    "sessionId": "chat-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "chat-terminal-1"
-  },
-  "hostId": "synthetic-chat-host",
-  "revision": "chat-profile-1",
-  "medium": "chat",
-  "embodiment": {
-    "form": "computer",
-    "description": "A text terminal in an original synthetic chat room.",
-    "modalities": ["text", "status"]
-  },
-  "participantLinks": [
-    {
-      "claimId": "mira-chat-link",
-      "participantId": "participant-mira",
-      "environmentSubjectId": "chat-terminal-1",
-      "issuerId": "synthetic-chat-host"
-    },
-    {
-      "claimId": "visitor-chat-link",
-      "participantId": "participant-visitor",
-      "environmentSubjectId": "chat-visitor-1",
-      "issuerId": "synthetic-chat-host"
-    }
-  ],
-  "planning": {
-    "cadence": "host-requested",
-    "maxTasks": 2
-  },
-  "communication": {
-    "mode": "live-channel",
-    "availability": "persistent",
-    "allowUnrequestedMessages": false,
-    "channelIds": ["quiet-room"]
-  },
-  "hostIntents": []
-}

package/specs/v0.2/examples/environment-game.json

@@ -1,80 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "environment-profile",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-1",
-    "characterId": "character-mira",
-    "embodimentId": "gardener-1"
-  },
-  "hostId": "synthetic-garden-host",
-  "revision": "garden-profile-1",
-  "medium": "game",
-  "embodiment": {
-    "form": "human",
-    "description": "A gardener represented by an existing host NPC.",
-    "modalities": ["speech", "gesture", "status"]
-  },
-  "participantLinks": [
-    {
-      "claimId": "mira-link-1",
-      "participantId": "participant-mira",
-      "environmentSubjectId": "gardener-1",
-      "issuerId": "synthetic-garden-host"
-    },
-    {
-      "claimId": "visitor-link-1",
-      "participantId": "participant-visitor",
-      "environmentSubjectId": "visitor-session-1",
-      "issuerId": "synthetic-garden-host"
-    }
-  ],
-  "planning": {
-    "cadence": "daily",
-    "maxTasks": 4
-  },
-  "communication": {
-    "mode": "host-requested",
-    "availability": "persistent",
-    "allowUnrequestedMessages": false,
-    "channelIds": ["garden-nearby"]
-  },
-  "hostIntents": [
-    {
-      "intentId": "inspect-area",
-      "description": "Ask the existing host NPC system to inspect a reachable area.",
-      "parameters": [
-        {
-          "name": "area",
-          "type": "entity-ref",
-          "required": true
-        }
-      ],
-      "cancellable": true
-    },
-    {
-      "intentId": "tend-plot",
-      "description": "Ask the existing host gardening facility to tend a plot.",
-      "parameters": [
-        {
-          "name": "plot",
-          "type": "entity-ref",
-          "required": true
-        },
-        {
-          "name": "amount",
-          "type": "quantity",
-          "required": true,
-          "unit": "ml",
-          "minimum": 1,
-          "maximum": 100
-        }
-      ],
-      "cancellable": true
-    }
-  ],
-  "worldTime": {
-    "timelineId": "garden-day-1",
-    "tick": 100
-  }
-}

package/specs/v0.2/examples/environment-no-speech.json

@@ -1,47 +0,0 @@
-{
-  "schemaVersion": "draft-0.2.0",
-  "kind": "environment-profile",
-  "binding": {
-    "environmentId": "garden",
-    "sessionId": "garden-session-2",
-    "characterId": "character-mira",
-    "embodimentId": "horse-1"
-  },
-  "hostId": "synthetic-garden-host",
-  "revision": "horse-profile-1",
-  "medium": "game",
-  "embodiment": {
-    "form": "horse",
-    "description": "A horse controlled by the host animal state machine; language output is unavailable.",
-    "modalities": ["vocalization", "gesture", "status"]
-  },
-  "participantLinks": [
-    {
-      "claimId": "mira-horse-link",
-      "participantId": "participant-mira",
-      "environmentSubjectId": "horse-1",
-      "issuerId": "synthetic-garden-host"
-    },
-    {
-      "claimId": "visitor-horse-session-link",
-      "participantId": "participant-visitor",
-      "environmentSubjectId": "visitor-session-2",
-      "issuerId": "synthetic-garden-host"
-    }
-  ],
-  "planning": {
-    "cadence": "daily",
-    "maxTasks": 4
-  },
-  "communication": {
-    "mode": "host-requested",
-    "availability": "persistent",
-    "allowUnrequestedMessages": false,
-    "channelIds": ["garden-nearby"]
-  },
-  "hostIntents": [],
-  "worldTime": {
-    "timelineId": "garden-day-1",
-    "tick": 100
-  }
-}

package/specs/v0.2/examples/intent-checkpoint.json

@@ -1,29 +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": []
-    }
-  ]
-}

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

@@ -1,28 +0,0 @@
-{
-  "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
-  }
-}

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

@@ -1,32 +0,0 @@
-{
-  "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?"
-  }
-}

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

@@ -1,50 +0,0 @@
-{
-  "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."
-    ]
-  }
-}