All tools
ToolWrite

Remember workspace memory

remember_workspace_memory

Use only after the user explicitly states a durable workspace fact, preference, procedure, open question, or source preference should be remembered.

When to use it

Use only after the user explicitly states a durable workspace fact, preference, procedure, open question, or source preference should be remembered.

Typical workflow

Read context, list durable memory when stable ids are needed, then remember only explicit durable facts or preferences; correct or forget by stable memory id.

What it returns

Bounded memory records with stable ids, or the created, superseded, review-gated, suppressed, or purged workspace-memory result.

Avoid using it when

The information is transient, inferred without confirmation, or belongs in a source document instead of memory.

Advanced input contract

Agent hosts use this JSON Schema to validate the exact input shape.

View full registry notes

Save an explicit durable fact, preference, procedure, open question, or source preference for one Prism workspace. This is never inferred silently and does not modify source documents. Use when: Use only after the user explicitly states a durable workspace fact, preference, procedure, open question, or source preference should be remembered.

View JSON Schema
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "format": "uuid"
    },
    "scope": {
      "type": "string",
      "enum": [
        "shared",
        "client"
      ],
      "default": "shared",
      "description": "shared is available across authorized agents; client is only valid for procedural_preference and is bound to the current client."
    },
    "kind": {
      "type": "string",
      "enum": [
        "semantic_fact",
        "episodic_event",
        "procedural_preference",
        "project_preference",
        "open_question",
        "source_preference"
      ]
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "pinned": {
      "type": "boolean"
    },
    "sourceType": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "sourceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "evidenceRefs": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "library_content_chunk",
              "library_file",
              "library_document",
              "library_artifact",
              "library_canvas",
              "agent_context_run",
              "agent_interaction_event"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "snippet": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "relationship": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          }
        },
        "required": [
          "type",
          "id"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "folderId",
    "kind",
    "content"
  ],
  "allOf": [
    {
      "if": {
        "properties": {
          "kind": {
            "const": "semantic_fact"
          }
        },
        "required": [
          "kind"
        ]
      },
      "then": {
        "required": [
          "evidenceRefs"
        ],
        "properties": {
          "evidenceRefs": {
            "minItems": 1
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "scope": {
            "const": "client"
          }
        },
        "required": [
          "scope"
        ]
      },
      "then": {
        "properties": {
          "kind": {
            "const": "procedural_preference"
          }
        }
      }
    }
  ],
  "additionalProperties": false
}

Useful next tools