@trylucy/agent-memory 0.0.0 → 0.1.3

package/schemas/v1/error.schema.json

@@ -0,0 +1,90 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/error.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "error": {
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "code": {
+                "enum": [
+                  "rate_limited",
+                  "service_unavailable",
+                  "billing_unavailable"
+                ]
+              }
+            },
+            "required": [
+              "code"
+            ]
+          },
+          "then": {
+            "properties": {
+              "retryable": {
+                "const": true
+              }
+            },
+            "type": "object"
+          },
+          "else": {
+            "properties": {
+              "retryable": {
+                "const": false
+              }
+            },
+            "type": "object"
+          }
+        }
+      ],
+      "properties": {
+        "code": {
+          "enum": [
+            "unauthenticated",
+            "forbidden",
+            "not_found_or_not_visible",
+            "invalid_scope",
+            "invalid_request",
+            "unsupported_version",
+            "conflict",
+            "version_conflict",
+            "rate_limited",
+            "payload_too_large",
+            "service_unavailable",
+            "insufficient_credits",
+            "billing_unavailable"
+          ]
+        },
+        "message": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "code",
+        "message",
+        "retryable"
+      ],
+      "type": "object"
+    },
+    "request_id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/requestId"
+    },
+    "schema_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/schemaVersion"
+    }
+  },
+  "required": [
+    "schema_version",
+    "request_id",
+    "error"
+  ],
+  "title": "Public error response",
+  "type": "object"
+}

package/schemas/v1/memory-version-state.schema.json

@@ -0,0 +1,39 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/memory-version-state.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryId"
+    },
+    "key": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+    },
+    "kind": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+    },
+    "lifecycle": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryLifecycle"
+    },
+    "schema_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/schemaVersion"
+    },
+    "scope": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+    },
+    "version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/version"
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "version",
+    "key",
+    "kind",
+    "scope",
+    "lifecycle"
+  ],
+  "title": "Memory version lifecycle state",
+  "type": "object"
+}

package/schemas/v1/memory.schema.json

@@ -0,0 +1,47 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/memory.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "content": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/content"
+    },
+    "id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryId"
+    },
+    "key": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+    },
+    "kind": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+    },
+    "receipt": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/receipt.schema.json"
+    },
+    "schema_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/schemaVersion"
+    },
+    "scope": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+    },
+    "status": {
+      "const": "active"
+    },
+    "version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/version"
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "version",
+    "key",
+    "kind",
+    "scope",
+    "content",
+    "status",
+    "receipt"
+  ],
+  "title": "Authoritative memory version",
+  "type": "object"
+}

package/schemas/v1/proposal-status.schema.json

@@ -0,0 +1,277 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/proposal-status.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "create"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "key": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+              },
+              "kind": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+              },
+              "scope": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+              }
+            },
+            "required": [
+              "key",
+              "kind",
+              "scope"
+            ],
+            "type": "object"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "replace"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "expected_version": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/expectedVersion"
+              },
+              "key": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+              },
+              "kind": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+              },
+              "memory_id": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryId"
+              },
+              "scope": {
+                "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+              }
+            },
+            "required": [
+              "memory_id",
+              "expected_version",
+              "key",
+              "kind",
+              "scope"
+            ],
+            "type": "object"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "pending"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "decided_at": {
+            "type": "null"
+          },
+          "result": {
+            "type": "null"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "approved"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "decided_at": {
+            "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+          },
+          "result": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "rejected",
+              "expired",
+              "superseded"
+            ]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "decided_at": {
+            "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+          },
+          "result": {
+            "type": "null"
+          }
+        }
+      }
+    }
+  ],
+  "properties": {
+    "created_at": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+    },
+    "decided_at": {
+      "oneOf": [
+        {
+          "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "expires_at": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+    },
+    "id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/proposalId"
+    },
+    "operation": {
+      "enum": [
+        "create",
+        "replace"
+      ]
+    },
+    "proposal_version": {
+      "const": 1
+    },
+    "relations": {
+      "items": false,
+      "maxItems": 0,
+      "type": "array"
+    },
+    "requested": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "key": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+            },
+            "kind": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+            },
+            "scope": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+            }
+          },
+          "required": [
+            "key",
+            "kind",
+            "scope"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expected_version": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/version"
+            },
+            "key": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+            },
+            "kind": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+            },
+            "memory_id": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryId"
+            },
+            "scope": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+            }
+          },
+          "required": [
+            "memory_id",
+            "expected_version",
+            "key",
+            "kind",
+            "scope"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "result": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "memory_id": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryId"
+            },
+            "memory_version": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/version"
+            },
+            "receipt_id": {
+              "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/receiptId"
+            }
+          },
+          "required": [
+            "memory_id",
+            "memory_version",
+            "receipt_id"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "schema_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/schemaVersion"
+    },
+    "status": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/proposalLifecycle"
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "proposal_version",
+    "operation",
+    "status",
+    "requested",
+    "relations",
+    "created_at",
+    "expires_at",
+    "decided_at",
+    "result"
+  ],
+  "title": "Proposal status",
+  "type": "object"
+}

package/schemas/v1/public-surface.schema.json

@@ -0,0 +1,26 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/public-surface.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "mcp_tools": {
+      "const": [
+        "memory_recall",
+        "memory_propose",
+        "memory_proposal_status"
+      ]
+    },
+    "public_permissions": {
+      "const": [
+        "memory:read",
+        "memory:propose"
+      ]
+    }
+  },
+  "required": [
+    "public_permissions",
+    "mcp_tools"
+  ],
+  "title": "Public permission and MCP surface",
+  "type": "object"
+}

package/schemas/v1/recall-request.schema.json

@@ -0,0 +1,45 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/recall-request.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "keys": {
+      "items": {
+        "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+      },
+      "maxItems": 20,
+      "minItems": 1,
+      "type": "array",
+      "uniqueItems": true
+    },
+    "kinds": {
+      "items": {
+        "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+      },
+      "maxItems": 5,
+      "minItems": 1,
+      "type": "array",
+      "uniqueItems": true
+    },
+    "limit": {
+      "default": 3,
+      "maximum": 5,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "query": {
+      "maxLength": 1024,
+      "minLength": 1,
+      "type": "string"
+    },
+    "scope": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+    }
+  },
+  "required": [
+    "query",
+    "scope"
+  ],
+  "title": "Recall request",
+  "type": "object"
+}

package/schemas/v1/recall-response.schema.json

@@ -0,0 +1,60 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/recall-response.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "as_of": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+    },
+    "consistency": {
+      "const": "canonical_active"
+    },
+    "notices": {
+      "items": {
+        "maxLength": 500,
+        "type": "string"
+      },
+      "maxItems": 20,
+      "type": "array"
+    },
+    "request_id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/requestId"
+    },
+    "results": {
+      "items": {
+        "allOf": [
+          {
+            "$ref": "https://schemas.trylucy.ai/agent-memory/v1/memory.schema.json"
+          },
+          {
+            "properties": {
+              "status": {
+                "const": "active"
+              }
+            },
+            "type": "object"
+          }
+        ]
+      },
+      "maxItems": 5,
+      "type": "array"
+    },
+    "schema_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/schemaVersion"
+    },
+    "scope": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+    }
+  },
+  "required": [
+    "schema_version",
+    "request_id",
+    "as_of",
+    "consistency",
+    "scope",
+    "results",
+    "notices"
+  ],
+  "title": "Recall response",
+  "type": "object"
+}

package/schemas/v1/receipt.schema.json

@@ -0,0 +1,67 @@
+{
+  "$id": "https://schemas.trylucy.ai/agent-memory/v1/receipt.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "authoritative_at": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+    },
+    "authority": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/authority"
+    },
+    "id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/receiptId"
+    },
+    "issued_at": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/timestamp"
+    },
+    "key": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/key"
+    },
+    "kind": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryKind"
+    },
+    "lifecycle": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryLifecycle"
+    },
+    "memory_id": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/memoryId"
+    },
+    "memory_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/version"
+    },
+    "provenance": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/provenance"
+    },
+    "relations": {
+      "items": {
+        "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/relation"
+      },
+      "maxItems": 20,
+      "type": "array"
+    },
+    "schema_version": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/schemaVersion"
+    },
+    "scope": {
+      "$ref": "https://schemas.trylucy.ai/agent-memory/v1/common.schema.json#/$defs/scope"
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "memory_id",
+    "memory_version",
+    "key",
+    "kind",
+    "scope",
+    "lifecycle",
+    "authority",
+    "authoritative_at",
+    "issued_at",
+    "provenance",
+    "relations"
+  ],
+  "title": "Memory authority receipt",
+  "type": "object"
+}