Method query

examples/python-client.py:165–204

Structured query against the Postgres structured store. Use this for exact lookups like 'get fact with key X' or 'list all statuses'. Args: memory_type: 'events', 'facts', or 'statuses'. key: For facts — filter by key. subject:

(
        self,
        memory_type: str = "events",
        key: str | None = None,
        subject: str | None = None,
        since: str | None = None,
        source_agent: str | None = None,
        client_id: str | None = None,
    )

    # ----- Structured query -----

    def query(
        self,
        memory_type: str = "events",
        key: str | None = None,
        subject: str | None = None,
        since: str | None = None,
        source_agent: str | None = None,
        client_id: str | None = None,
    ) -> dict:
        """
        Structured query against the Postgres structured store.

        Use this for exact lookups like 'get fact with key X' or 'list all statuses'.

        Args:
            memory_type: 'events', 'facts', or 'statuses'.
            key:         For facts — filter by key.
            subject:     For statuses — filter by subject.
            since:       For events — filter by timestamp (ISO 8601).
            source_agent: Filter by agent.
            client_id:   Filter by client.

        Returns:
            Dict with 'type', 'count', and 'results' list.
        """
        params = {"type": memory_type}
        if key:
            params["key"] = key
        if subject:
            params["subject"] = subject
        if since:
            params["since"] = since
        if source_agent:
            params["source_agent"] = source_agent
        if client_id:
            params["client_id"] = client_id

        resp = self.session.get(f"{self.api_url}/memory/query", params=params)
        resp.raise_for_status()
        return resp.json()

    # ----- Delete a memory -----