# agent_log_list

List Agent Log Entries

## Beschreibung

Call this before any action you might have already taken — e.g.
before commenting on a task, nudging a user, or escalating
something. If a recent entry shows you already did the same
action under the same subject, escalate or move on instead of
repeating.

Returns *your own* log entries in this account, newest first.
Other users' entries are invisible.

Filters (all optional, AND-combined):
- `subject` — exact match. Use the same conventions as
  `agent_log_write` (`"task:ENG-123"`,
  `"standup:user_max:2026-05-07"`).
- `tags` — match if the entry has *any* of the given tags
  (OR, not AND).
- `since` — only entries created at or after this moment.
  Same lenient parsing as `agent_reminder_upsert.due_at`:
  relative offset (`+30m`, `+2h`, `+1d`), ISO 8601, date-only,
  space-separated, or Unix epoch. Note: relative offsets here
  are *future*-anchored — to scan the last 2h pass the absolute
  time `(Time.now - 2h).iso8601`, or just pass the date `today`.
  Bad input → error.
- `limit` — default 50, max 200.

Example: before nudging @max again about ENG-123, call with
`subject: "task:ENG-123"`, `tags: ["estimate-reminder"]` — if
anything comes back from the last 24h, don't nudge again.

## Zugriff

Zugriffsprofil: `gated`. Module: `none`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja |  |
| `subject` | string | Nein | Exact-match filter, e.g. 'task:ENG-123'. |
| `tags` | array | Nein | Match if the entry has ANY of these tags (OR). |
| `since` | string | Nein | Only entries created at or after this moment. Accepts ISO 8601, date-only, space-separated, Unix epoch, or relative future offset. Bad input → error. |
| `limit` | integer | Nein | Max rows (default 50, max 200). |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "subject": {
      "type": "string",
      "description": "Exact-match filter, e.g. 'task:ENG-123'."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Match if the entry has ANY of these tags (OR)."
    },
    "since": {
      "type": "string",
      "description": "Only entries created at or after this moment. Accepts ISO 8601, date-only, space-separated, Unix epoch, or relative future offset. Bad input → error."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "description": "Max rows (default 50, max 200)."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "subject": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "created_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "body",
          "tags",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "entries"
  ],
  "type": "object"
}
```