RememberRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kagura-ai-com/json-schema/kagura-ai-com-remember-request-schema.json",
  "title": "RememberRequest",
  "description": "Request schema for remember() API.\n\nExample:\n    {\n        \"summary\": \"認証エラー修正。JWTトークン有効期限チェック追加。\",\n        \"context_summary\": \"ユーザーからログイン失敗の報告があり...\",\n        \"content\": \"auth.pyのverify_token関数にexpired_atの検証を追加\",\n        \"details\": {\"code_diff\": \"...\", \"test_results\": \"...\"},\n        \"type\": \"code\",\n        \"importance\": 0.8,\n        \"tags\": [\"python\", \"authentication\"],\n        \"context\": {\"context_id\": \"my-context\", \"file_path\": \"auth.py\"}\n    }",
  "x-generated": "2026-11-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kagura-ai-com-openapi.json#/components/schemas/RememberRequest",
  "properties": {
    "summary": {
      "type": "string",
      "maxLength": 500,
      "minLength": 10,
      "title": "Summary",
      "description": "検索用サマリー"
    },
    "context_summary": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ],
      "title": "Context Summary",
      "description": "背景・文脈説明"
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "title": "Content",
      "description": "基本内容"
    },
    "details": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Details",
      "description": "完全詳細（JSONB）"
    },
    "type": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1,
      "title": "Type",
      "description": "メモリタイプ"
    },
    "importance": {
      "type": "number",
      "maximum": 1.0,
      "minimum": 0.0,
      "title": "Importance",
      "description": "重要度 (0.0-1.0)",
      "default": 0.5
    },
    "tags": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Tags",
      "description": "タグ"
    },
    "context": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Context",
      "description": "コンテキスト情報"
    },
    "private_workspace_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "title": "Private Workspace Id",
      "description": "Require the caller's own private context in this selected workspace at commit time."
    },
    "delivery_mode": {
      "type": "string",
      "enum": [
        "always",
        "on_recall",
        "on_trigger"
      ],
      "title": "Delivery Mode",
      "description": "Delivery mode: always (pin, load every turn) | on_recall (default) | on_trigger",
      "default": "on_recall"
    },
    "source_uri": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Uri",
      "description": "Origin URI: file://, http(s)://, vault://, obsidian://"
    },
    "source_type": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "file",
            "url",
            "vault",
            "api",
            "manual"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Type",
      "description": "Origin type"
    },
    "linked_memory_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string",
            "format": "uuid"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Linked Memory Ids",
      "description": "Explicit links to existing memories (creates declared_link edges)"
    },
    "linked_source_uris": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Linked Source Uris",
      "description": "Explicit links by source_uri (resolved at remember time, unresolved silently skipped)"
    },
    "supersedes": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "title": "Supersedes",
      "description": "Memory ID this new memory supersedes (old one is shadowed, not deleted)"
    },
    "observed_at": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ],
      "title": "Observed At",
      "description": "When the fact held or the event happened (ISO 8601 date or datetime); stored as details.observed_at"
    }
  },
  "type": "object",
  "required": [
    "summary",
    "content",
    "type"
  ]
}