@ifsoul/core 0.3.0 → 0.5.0

package/specs/current/model-provider/examples/response.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "0.3.0",
+  "schemaVersion": "0.4.0",
   "kind": "model-response",
   "requestId": "request-1",
   "providerId": "synthetic-provider",

package/docs/npm-publishing.md

@@ -1,44 +0,0 @@
-# First npm publication preparation
-
-The intended first registry package is `@ifsoul/core@0.3.0`, public on
-`https://registry.npmjs.org/` with the `latest` dist-tag. This is preparation,
-not a publication receipt. Package names reflect the current manifest; GitHub
-organization ownership does not establish npm scope ownership or publish rights.
-
-Run existing frozen-install/check/build/package gates locally. Inspect the exact
-built archive, its license/member inventory and SHA-256/SHA-512, then install that
-archive in an external consumer and check runtime/declarations. Publish only the
-reviewed archive after separate owner approval; do not repack a changed tree under
-the approved digest. `publishConfig` fixes public access and the intended registry.
-
-Before approval, re-read public registry name/version metadata and verify the
-publisher's npm identity, scope/team permissions and interactive 2FA readiness.
-A public 404 does not prove scope ownership or that a hidden package is absent.
-Do not request credentials or tokens in chat. Account setup belongs to the owner
-in their browser. Never stage a package as a harmless check: npm staged publishing
-can create a public placeholder for a new package.
-
-Core and SDK are independent runtime packages; publish Core first and verify its
-registry readback, then SDK, as a coordinated release sequence. Neither needs an
-unpublished IfSoul registry dependency. Existing App/game/Website/Cloud/bridge
-archive pins and provenance stay unchanged until a separately reviewed migration
-to actually published versions. No automatic publish workflow is authorized.
-
-After final owner approval and authenticated scope checks, the proposed command
-for the exact approved archive is:
-
-```sh
-npm publish /absolute/path/to/ifsoul-core-0.3.0.tgz --access public --tag latest --registry=https://registry.npmjs.org/ --ignore-scripts
-```
-
-This command is intentionally not a package script and has not been run. The
-local release manifest supplies the real path and immutable candidate digests.
-Local digest/provenance receipts are not an npm registry provenance attestation.
-Do not add trusted-publisher settings or a CI publication workflow without a
-separate owner decision.
-
-The current [npm scoped-public guide](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages/)
-and [publish command](https://docs.npmjs.com/cli/v11/commands/npm-publish/)
-require explicit public access and suitable account authentication/2FA policy.
-A name/version pair cannot be reused after publication; if it becomes occupied,
-stop for a reviewed version/name decision rather than overwrite or unpublish.

package/packages/protocol/schemas/action-result.schema.json

@@ -1,187 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.1.0:action-result",
-  "type": "object",
-  "properties": {
-    "schemaVersion": {
-      "const": "draft-0.1.0"
-    },
-    "kind": {
-      "const": "action-result"
-    },
-    "resultId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "actionId": {
-      "$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"
-    },
-    "actorId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "recordedAt": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/utcTimestamp"
-    },
-    "worldTime": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/worldTime"
-    },
-    "status": {
-      "enum": ["success", "rejected", "failed", "unknown"]
-    },
-    "execution": {
-      "enum": ["not-started", "completed", "partial", "unknown"]
-    },
-    "events": {
-      "type": "array",
-      "items": {
-        "$ref": "urn:ifsoul:protocol:draft-0.1.0:world-event"
-      },
-      "minItems": 0
-    },
-    "error": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/error"
-    },
-    "worldRevision": {
-      "$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",
-    "resultId",
-    "actionId",
-    "adapterId",
-    "worldId",
-    "sessionId",
-    "actorId",
-    "recordedAt",
-    "worldTime",
-    "status",
-    "execution",
-    "events"
-  ],
-  "additionalProperties": false,
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "status": {
-            "const": "success"
-          }
-        },
-        "required": ["status"]
-      },
-      "then": {
-        "properties": {
-          "execution": {
-            "const": "completed"
-          },
-          "error": false
-        }
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "status": {
-            "const": "rejected"
-          }
-        },
-        "required": ["status"]
-      },
-      "then": {
-        "properties": {
-          "execution": {
-            "const": "not-started"
-          },
-          "events": {
-            "maxItems": 0,
-            "type": "array"
-          }
-        },
-        "required": ["error"]
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "status": {
-            "const": "failed"
-          }
-        },
-        "required": ["status"]
-      },
-      "then": {
-        "properties": {
-          "execution": {
-            "enum": ["not-started", "partial"]
-          }
-        },
-        "required": ["error"]
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "status": {
-            "const": "unknown"
-          }
-        },
-        "required": ["status"]
-      },
-      "then": {
-        "properties": {
-          "execution": {
-            "const": "unknown"
-          },
-          "error": {
-            "properties": {
-              "retry": {
-                "const": "reconcile-first"
-              }
-            },
-            "type": "object"
-          }
-        },
-        "required": ["error"]
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "execution": {
-            "const": "not-started"
-          }
-        },
-        "required": ["execution"]
-      },
-      "then": {
-        "properties": {
-          "events": {
-            "type": "array",
-            "maxItems": 0
-          }
-        }
-      }
-    }
-  ]
-}

package/packages/protocol/schemas/action.schema.json

@@ -1,68 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.1.0:action",
-  "type": "object",
-  "properties": {
-    "schemaVersion": {
-      "const": "draft-0.1.0"
-    },
-    "kind": {
-      "const": "action"
-    },
-    "actionId": {
-      "$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"
-    },
-    "actorId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "capabilityId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "capabilityRevision": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "arguments": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/jsonObject"
-    },
-    "requestedAt": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/utcTimestamp"
-    },
-    "deadlineAt": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/utcTimestamp"
-    },
-    "observedWorldRevision": {
-      "$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",
-    "actionId",
-    "worldId",
-    "sessionId",
-    "actorId",
-    "capabilityId",
-    "capabilityRevision",
-    "arguments",
-    "requestedAt",
-    "deadlineAt"
-  ],
-  "additionalProperties": false
-}

package/packages/protocol/schemas/archive-manifest.schema.json

@@ -1,126 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.1.0:archive-manifest",
-  "type": "object",
-  "properties": {
-    "schemaVersion": {
-      "const": "draft-0.1.0"
-    },
-    "kind": {
-      "const": "archive-manifest"
-    },
-    "archiveVersion": {
-      "const": "draft-0.1.0"
-    },
-    "archiveId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "createdAt": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/utcTimestamp"
-    },
-    "schemaVersions": {
-      "type": "object",
-      "properties": {
-        "protocol": {
-          "const": "draft-0.1.0"
-        }
-      },
-      "required": ["protocol"],
-      "additionalProperties": false
-    },
-    "files": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "path": {
-            "type": "string",
-            "pattern": "^(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$"
-          },
-          "role": {
-            "enum": ["template", "instance", "events", "derived", "extension"]
-          },
-          "schemaId": {
-            "type": "string",
-            "pattern": "^urn:ifsoul:protocol:draft-0\\.1\\.0:[a-z-]+$"
-          },
-          "sha256": {
-            "type": "string",
-            "pattern": "^[a-f0-9]{64}$"
-          },
-          "sizeBytes": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 9007199254740991
-          }
-        },
-        "required": ["path", "role", "schemaId", "sha256", "sizeBytes"],
-        "additionalProperties": false
-      },
-      "minItems": 1
-    },
-    "filter": {
-      "type": "object",
-      "properties": {
-        "mode": {
-          "enum": ["private-backup", "filtered"]
-        },
-        "omittedCategories": {
-          "type": "array",
-          "items": {
-            "enum": [
-              "profile",
-              "events",
-              "derived",
-              "relationships",
-              "extensions"
-            ]
-          },
-          "minItems": 0,
-          "uniqueItems": true
-        },
-        "reasons": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1
-          },
-          "minItems": 0,
-          "uniqueItems": true
-        },
-        "externalReferences": {
-          "enum": ["none", "present"]
-        }
-      },
-      "required": [
-        "mode",
-        "omittedCategories",
-        "reasons",
-        "externalReferences"
-      ],
-      "additionalProperties": false
-    },
-    "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",
-    "archiveVersion",
-    "archiveId",
-    "createdAt",
-    "schemaVersions",
-    "files",
-    "filter"
-  ],
-  "additionalProperties": false
-}

package/packages/protocol/schemas/capability.schema.json

@@ -1,131 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.1.0:capability",
-  "type": "object",
-  "properties": {
-    "schemaVersion": {
-      "const": "draft-0.1.0"
-    },
-    "kind": {
-      "const": "capability-set"
-    },
-    "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"
-    },
-    "actorId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "capabilityRevision": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "supportedSchemaVersions": {
-      "type": "array",
-      "items": {
-        "const": "draft-0.1.0"
-      },
-      "minItems": 1,
-      "uniqueItems": true
-    },
-    "capabilities": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "capabilityId": {
-            "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-          },
-          "description": {
-            "type": "string",
-            "minLength": 1
-          },
-          "argumentsSchema": {
-            "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/jsonSchema"
-          },
-          "requiredPermissions": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "resource": {
-                  "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-                },
-                "action": {
-                  "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-                }
-              },
-              "required": ["resource", "action"],
-              "additionalProperties": false
-            },
-            "minItems": 0,
-            "uniqueItems": true
-          },
-          "semantics": {
-            "type": "object",
-            "properties": {
-              "preconditions": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "minLength": 1
-                },
-                "minItems": 0
-              },
-              "possibleEffects": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "minLength": 1
-                },
-                "minItems": 0
-              }
-            },
-            "required": ["preconditions", "possibleEffects"],
-            "additionalProperties": false
-          },
-          "idempotency": {
-            "enum": ["none", "action-id"]
-          }
-        },
-        "required": [
-          "capabilityId",
-          "description",
-          "argumentsSchema",
-          "requiredPermissions",
-          "semantics",
-          "idempotency"
-        ],
-        "additionalProperties": false
-      },
-      "minItems": 0
-    },
-    "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",
-    "adapterId",
-    "worldId",
-    "sessionId",
-    "actorId",
-    "capabilityRevision",
-    "supportedSchemaVersions",
-    "capabilities"
-  ],
-  "additionalProperties": false
-}

package/packages/protocol/schemas/character-instance.schema.json

@@ -1,73 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:ifsoul:protocol:draft-0.1.0:character-instance",
-  "type": "object",
-  "properties": {
-    "schemaVersion": {
-      "const": "draft-0.1.0"
-    },
-    "kind": {
-      "const": "character-instance"
-    },
-    "characterId": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-    },
-    "createdAt": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/utcTimestamp"
-    },
-    "template": {
-      "type": "object",
-      "properties": {
-        "templateId": {
-          "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-        },
-        "revision": {
-          "type": "integer",
-          "minimum": 1
-        }
-      },
-      "required": ["templateId", "revision"],
-      "additionalProperties": false
-    },
-    "profile": {
-      "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/profile"
-    },
-    "historyEventIds": {
-      "type": "array",
-      "items": {
-        "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-      },
-      "minItems": 0,
-      "uniqueItems": true
-    },
-    "relationshipMemoryIds": {
-      "type": "array",
-      "items": {
-        "$ref": "urn:ifsoul:protocol:draft-0.1.0:common#/$defs/id"
-      },
-      "minItems": 0,
-      "uniqueItems": true
-    },
-    "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",
-    "characterId",
-    "createdAt",
-    "profile",
-    "historyEventIds",
-    "relationshipMemoryIds"
-  ],
-  "additionalProperties": false
-}