@ifsoul/core 0.3.0 → 0.5.0

package/packages/protocol/schemas/v0.2/planning.schema.json

@@ -1,443 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.2.0:planning",
-  "oneOf": [
-    {
-      "$ref": "#/$defs/proposal"
-    },
-    {
-      "$ref": "#/$defs/decision"
-    },
-    {
-      "$ref": "#/$defs/report"
-    },
-    {
-      "$ref": "#/$defs/cancelRequest"
-    },
-    {
-      "$ref": "#/$defs/cancelResult"
-    }
-  ],
-  "$defs": {
-    "proposal": {
-      "type": "object",
-      "properties": {
-        "schemaVersion": {
-          "const": "draft-0.2.0"
-        },
-        "kind": {
-          "const": "plan-proposal"
-        },
-        "binding": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/binding"
-        },
-        "correlationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "planId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "requestId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "contextReportId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "contextRevision": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "environmentRevision": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "createdAt": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/utc"
-        },
-        "expiresAt": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/utc"
-        },
-        "horizon": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/period"
-        },
-        "tasks": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "taskId": {
-                "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-              },
-              "intentId": {
-                "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-              },
-              "arguments": {
-                "type": "object",
-                "maxProperties": 16,
-                "propertyNames": {
-                  "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-                },
-                "additionalProperties": {
-                  "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/argument"
-                }
-              },
-              "priority": {
-                "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/priority"
-              },
-              "dependsOnTaskIds": {
-                "type": "array",
-                "items": {
-                  "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-                },
-                "minItems": 0,
-                "maxItems": 16,
-                "uniqueItems": true
-              },
-              "explanation": {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 500
-              }
-            },
-            "required": [
-              "taskId",
-              "intentId",
-              "arguments",
-              "priority",
-              "dependsOnTaskIds"
-            ],
-            "additionalProperties": false
-          },
-          "minItems": 0,
-          "maxItems": 16
-        },
-        "extensions": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensions"
-        },
-        "requiredExtensions": {
-          "type": "array",
-          "items": {
-            "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensionName"
-          },
-          "minItems": 0,
-          "maxItems": 16,
-          "uniqueItems": true
-        }
-      },
-      "required": [
-        "schemaVersion",
-        "kind",
-        "binding",
-        "correlationId",
-        "planId",
-        "requestId",
-        "contextReportId",
-        "contextRevision",
-        "environmentRevision",
-        "createdAt",
-        "expiresAt",
-        "horizon",
-        "tasks"
-      ],
-      "additionalProperties": false
-    },
-    "decision": {
-      "type": "object",
-      "properties": {
-        "schemaVersion": {
-          "const": "draft-0.2.0"
-        },
-        "kind": {
-          "const": "plan-decision"
-        },
-        "binding": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/binding"
-        },
-        "correlationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "planId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "decisionId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "requestId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "contextRevision": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "recordedAt": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/utc"
-        },
-        "status": {
-          "enum": ["accepted", "partially-accepted", "rejected"]
-        },
-        "taskDecisions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "taskId": {
-                "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-              },
-              "decision": {
-                "enum": ["accepted", "rejected"]
-              },
-              "reason": {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 500
-              }
-            },
-            "required": ["taskId", "decision"],
-            "additionalProperties": false
-          },
-          "minItems": 0,
-          "maxItems": 16
-        },
-        "extensions": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensions"
-        },
-        "requiredExtensions": {
-          "type": "array",
-          "items": {
-            "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensionName"
-          },
-          "minItems": 0,
-          "maxItems": 16,
-          "uniqueItems": true
-        }
-      },
-      "required": [
-        "schemaVersion",
-        "kind",
-        "binding",
-        "correlationId",
-        "planId",
-        "decisionId",
-        "requestId",
-        "contextRevision",
-        "recordedAt",
-        "status",
-        "taskDecisions"
-      ],
-      "additionalProperties": false
-    },
-    "report": {
-      "type": "object",
-      "properties": {
-        "schemaVersion": {
-          "const": "draft-0.2.0"
-        },
-        "kind": {
-          "const": "task-report"
-        },
-        "binding": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/binding"
-        },
-        "correlationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "planId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "reportId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "taskId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "contextRevision": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "recordedAt": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/utc"
-        },
-        "status": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/taskStatus"
-        },
-        "summary": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 1000
-        },
-        "observedEffects": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 500
-          },
-          "minItems": 0,
-          "maxItems": 16
-        },
-        "nextContextReportId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "extensions": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensions"
-        },
-        "requiredExtensions": {
-          "type": "array",
-          "items": {
-            "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensionName"
-          },
-          "minItems": 0,
-          "maxItems": 16,
-          "uniqueItems": true
-        }
-      },
-      "required": [
-        "schemaVersion",
-        "kind",
-        "binding",
-        "correlationId",
-        "planId",
-        "reportId",
-        "taskId",
-        "contextRevision",
-        "recordedAt",
-        "status",
-        "summary",
-        "observedEffects"
-      ],
-      "additionalProperties": false
-    },
-    "cancelRequest": {
-      "type": "object",
-      "properties": {
-        "schemaVersion": {
-          "const": "draft-0.2.0"
-        },
-        "kind": {
-          "const": "plan-cancel-request"
-        },
-        "binding": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/binding"
-        },
-        "correlationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "planId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "cancellationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "taskIds": {
-          "type": "array",
-          "items": {
-            "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-          },
-          "minItems": 1,
-          "maxItems": 16,
-          "uniqueItems": true
-        },
-        "requestedAt": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/utc"
-        },
-        "reason": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 500
-        },
-        "extensions": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensions"
-        },
-        "requiredExtensions": {
-          "type": "array",
-          "items": {
-            "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensionName"
-          },
-          "minItems": 0,
-          "maxItems": 16,
-          "uniqueItems": true
-        }
-      },
-      "required": [
-        "schemaVersion",
-        "kind",
-        "binding",
-        "correlationId",
-        "planId",
-        "cancellationId",
-        "taskIds",
-        "requestedAt",
-        "reason"
-      ],
-      "additionalProperties": false
-    },
-    "cancelResult": {
-      "type": "object",
-      "properties": {
-        "schemaVersion": {
-          "const": "draft-0.2.0"
-        },
-        "kind": {
-          "const": "plan-cancel-result"
-        },
-        "binding": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/binding"
-        },
-        "correlationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "planId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "cancellationId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-        },
-        "recordedAt": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/utc"
-        },
-        "taskResults": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "taskId": {
-                "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/id"
-              },
-              "status": {
-                "enum": ["cancelled", "already-finished", "rejected", "unknown"]
-              },
-              "reason": {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 500
-              }
-            },
-            "required": ["taskId", "status"],
-            "additionalProperties": false
-          },
-          "minItems": 1,
-          "maxItems": 16
-        },
-        "extensions": {
-          "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensions"
-        },
-        "requiredExtensions": {
-          "type": "array",
-          "items": {
-            "$ref": "urn:ifsoul:protocol:draft-0.2.0:common#/$defs/extensionName"
-          },
-          "minItems": 0,
-          "maxItems": 16,
-          "uniqueItems": true
-        }
-      },
-      "required": [
-        "schemaVersion",
-        "kind",
-        "binding",
-        "correlationId",
-        "planId",
-        "cancellationId",
-        "recordedAt",
-        "taskResults"
-      ],
-      "additionalProperties": false
-    }
-  }
-}

package/packages/protocol/schemas/world-event.schema.json

@@ -1,74 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.1.0:world-event",
-  "type": "object",
-  "properties": {
-    "schemaVersion": {
-      "const": "draft-0.1.0"
-    },
-    "kind": {
-      "const": "world-event"
-    },
-    "eventId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "adapterId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "worldId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "sessionId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "sourceSequence": {
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "recordedAt": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/utcTimestamp"
-    },
-    "worldTime": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/worldTime"
-    },
-    "scope": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/scope"
-    },
-    "type": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "payload": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/jsonObject"
-    },
-    "actionId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "extensions": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/extensions"
-    },
-    "requiredExtensions": {
-      "type": "array",
-      "items": {
-        "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/extensionName"
-      },
-      "minItems": 0,
-      "uniqueItems": true
-    }
-  },
-  "required": [
-    "schemaVersion",
-    "kind",
-    "eventId",
-    "adapterId",
-    "worldId",
-    "sessionId",
-    "sourceSequence",
-    "recordedAt",
-    "worldTime",
-    "scope",
-    "type",
-    "payload"
-  ],
-  "additionalProperties": false
-}

package/specs/character/README.md

@@ -1,84 +0,0 @@
-# Character and archive contracts
-
-Historical v0.1 contract. See [v0.2](../v0.2/README.md) for the current design;
-the v0.1 JSON examples remain unchanged for regression checks.
-
-A template is reusable authored material; an instance is an individual portable
-character with separately referenced history. Importing a template MUST NOT
-silently import a person's conversations, memories, relationships, owner
-identity, or provider configuration. Closed template fields reject history.
-Template edits create a new positive integer `revision`; existing instance
-profiles do not automatically change when a template changes.
-
-| Document          | Required fields beyond `schemaVersion`, `kind`                                    |
-| ----------------- | --------------------------------------------------------------------------------- |
-| CharacterTemplate | `templateId`, `revision`, `profile`, `provenance`                                 |
-| CharacterInstance | `characterId`, `createdAt`, `profile`, `historyEventIds`, `relationshipMemoryIds` |
-| Archive manifest  | `archiveVersion`, `archiveId`, `createdAt`, `schemaVersions`, `files`, `filter`   |
-
-`profile` contains `name`, `description`, and `traits` (a map of simple strings,
-numbers, or booleans). A template's `provenance` requires nonempty `authors` and
-`license`; an optional `source` describes origin. These are claims to verify,
-not automatic proof of rights. An instance's optional `template` is an exact
-`templateId` + `revision` reference, not inheritance or a remote fetch request.
-`historyEventIds` refer to its memory events; `relationshipMemoryIds` refer to
-its derived records whose payload type is `relationship`. An empty array means
-there are no referenced records at that snapshot, not that a deleted history
-can be reconstructed.
-
-Preferences and goals may be represented as explicitly documented traits or
-namespaced extensions in this small baseline. Experience is represented by
-memory events and derived summaries; dedicated preference, goal, skill, or
-experience fields are deferred. A consumer MUST preserve unknown optional
-extensions or declare losses; it MUST NOT flatten richer input into this profile
-and silently discard unsupported state. Profile text does not grant permissions.
-
-## Archive manifest
-
-The manifest describes files; it is not an importer, container format, database,
-or encryption scheme. `archiveVersion` versions the archive layout independently
-of wire `schemaVersion`, even though both are `draft-0.1.0` now.
-`schemaVersions.protocol` declares the contract baseline used. Every file entry
-contains a safe relative `path`, `role`, `schemaId`, lowercase hexadecimal
-`sha256`, and nonnegative `sizeBytes`. SHA-256 covers the exact uncompressed file
-bytes, not a canonicalized JSON document. The manifest does not list itself.
-
-The draft exchange layout uses one UTF-8 JSON document for template and instance
-files, and UTF-8 JSONL for event/derived streams (one complete document per
-nonempty line). Roles map to the `character-template`, `character-instance`,
-`memory-event`, and `derived-memory` schema IDs respectively. Extension files
-require their explicitly declared schema ID and reader support. This draft's
-schema-ID pattern only admits baseline URNs; a new external extension file schema
-requires a later agreed contract. Optional extension data can already live in
-ordinary document `extensions`.
-
-A future importer MUST independently check:
-
-- Every listed file exists, matches its exact byte count/checksum, has the
-  declared role/schema combination, and validates before use.
-- Paths are unique and confined to the extraction root after normalization;
-  platform case collisions, symlinks, archive entries absent from the manifest,
-  decompression bombs, and oversized files are rejected. The schema's restricted
-  ASCII path syntax is only the first check. No absolute paths or `..` segments
-  are accepted.
-- Referenced templates, instances, events, and derived records exist and have
-  consistent identities, or the filtered manifest explicitly declares external
-  references. Dangling references are not silently invented or discarded.
-
-`filter` always contains `mode`, `omittedCategories`, `reasons`, and
-`externalReferences`. `private-backup` means all data the exporter is authorized
-to back up is included: omitted categories and reasons MUST be empty and
-external references MUST be `none`. It is not a bypass of consent or access
-restrictions. If any selected data cannot be included, use `filtered`, record
-categories and nonempty reasons, and set `externalReferences: "present"` when
-remaining provenance points outside the archive. That flag declares incomplete
-closure, not authority to fetch data or expose omitted private IDs.
-
-Keys, secrets, owner addresses, provider configuration, and access tokens are
-outside this archive contract. Checksums detect changed bytes; they do not
-identify a trusted author. Import/export, deletion propagation, migrations,
-round-trip guarantees, and archive size limits remain unimplemented.
-
-Positive examples: [template](examples/character-template.json),
-[instance](examples/character-instance.json), [manifest](examples/archive-manifest.json).
-The manifest's two sibling files form a synthetic initial snapshot.

package/specs/character/examples/archive-manifest.json

@@ -1,32 +0,0 @@
-{
-  "schemaVersion": "draft-0.1.0",
-  "kind": "archive-manifest",
-  "archiveVersion": "draft-0.1.0",
-  "archiveId": "archive-mira-initial",
-  "createdAt": "2026-01-01T12:00:00Z",
-  "schemaVersions": {
-    "protocol": "draft-0.1.0"
-  },
-  "files": [
-    {
-      "path": "character-template.json",
-      "role": "template",
-      "schemaId": "urn:ifsoul:protocol:draft-0.1.0:character-template",
-      "sha256": "ce0aa4a3887f3618f4d31859d14f3bd348afdf318fb6f63beb7793e9deccc2ad",
-      "sizeBytes": 466
-    },
-    {
-      "path": "character-instance.json",
-      "role": "instance",
-      "schemaId": "urn:ifsoul:protocol:draft-0.1.0:character-instance",
-      "sha256": "4964e8f042835743056b10045c7e0476cc0034ce517e42cfaee1727e415cc806",
-      "sizeBytes": 475
-    }
-  ],
-  "filter": {
-    "mode": "private-backup",
-    "omittedCategories": [],
-    "reasons": [],
-    "externalReferences": "none"
-  }
-}

package/specs/character/examples/character-instance.json

@@ -1,20 +0,0 @@
-{
-  "schemaVersion": "draft-0.1.0",
-  "kind": "character-instance",
-  "characterId": "character-mira",
-  "createdAt": "2026-01-01T12:00:00Z",
-  "template": {
-    "templateId": "mira-vale",
-    "revision": 1
-  },
-  "profile": {
-    "name": "Mira Vale",
-    "description": "An original synthetic garden keeper who values patient observation.",
-    "traits": {
-      "curiosity": 0.7,
-      "patience": "high"
-    }
-  },
-  "historyEventIds": [],
-  "relationshipMemoryIds": []
-}

package/specs/character/examples/character-template.json

@@ -1,19 +0,0 @@
-{
-  "schemaVersion": "draft-0.1.0",
-  "kind": "character-template",
-  "templateId": "mira-vale",
-  "revision": 1,
-  "profile": {
-    "name": "Mira Vale",
-    "description": "An original synthetic garden keeper who values patient observation.",
-    "traits": {
-      "curiosity": 0.7,
-      "patience": "high"
-    }
-  },
-  "provenance": {
-    "authors": ["IfSoul contributors"],
-    "license": "Apache-2.0",
-    "source": "Original synthetic bootstrap example"
-  }
-}