# Records Reference

This page gathers **where the Marketplace edition differs from the SaaS edition** for the record of operations inside the project (Records (audit trail)) and for exporting execution records. How to read records is in the [Record Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/project/guide/record-guide.md#records-audit-trail), and the list of events shared with the SaaS edition is in the [SaaS Records Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/reference/events-ref.md).

## Events that are added

| Event                                            | When it is recorded                                                                                                                                                  |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Case settings change**                         | When a case's settings were made a new version                                                                                                                       |
| **Moved on by the external condition being met** | In a review waiting on an external condition, when the condition was met and the platform moved it to the next step (this is distinguished from a person's approval) |
| Branch decision / Branch asked a person          | Recorded the same as in the SaaS edition                                                                                                                             |

## Common events (kept in the records)

These have the same names as in the SaaS edition and are also kept in the records of the Marketplace edition (confirmed from the code that writes the records).

| Kind                                                                                                         | `event_type` in the CSV                                                                                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Review requested, decided, reminded, overdue, extended, reviewers reassigned                                 | `gate.requested`, `gate.resolved`, `gate.due_soon`, `gate.overdue`, `gate.extended`, `gate.reassigned`                                                                                                                |
| Reviewers reassigned for a case                                                                              | `run.approvers_reassigned`                                                                                                                                                                                            |
| Case started, could not start, deadline set, deadline passed, stalled                                        | `run.started`, `run.start_failed`, `run.deadline_set`, `run.deadline_overdue`, `run.stalled`                                                                                                                          |
| Sending a notification (queued, sent, failed, unconfirmed)                                                   | `delivery.accepted`, `delivery.acked`, `delivery.failed`, `delivery.unconfirmed`                                                                                                                                      |
| Viewing a body, exporting an execution record                                                                | `forensic.viewed`, `forensic.exported`                                                                                                                                                                                |
| Definition changed, submitted for approval, approved, rejected, withdrawn                                    | `project.definition_changed`, `project.definition_submitted`, `project.definition_approved`, `project.definition_rejected`, `project.definition_withdrawn`                                                            |
| Run rules, members, or roles changed                                                                         | `policy.changed`                                                                                                                                                                                                      |
| A Branch decision, a Branch that asked a person                                                              | `branch.decided`, `branch.asked_human`                                                                                                                                                                                |
| A completion report that was ignored because it was for a case that had already closed or for an old attempt | `completion.stale`                                                                                                                                                                                                    |
| Definition exported, imported, template, external access, ownership transferred, deleted                     | `project.exported`, `project.imported`, `project.template_published`, `project.template_unpublished`, `project.created_from_template`, `project.exposure_changed`, `project.ownership_transferred`, `project.deleted` |

These events exist only in the Marketplace edition. **Operations that a registered agent reports through the SDK** (`tool.invoked`, `tool.effect`, `tool.denied`) are also kept in the records. `context.manifest` is stored, but it does not appear on the records screen or in the records CSV. They are not a record of operations the platform stops one by one; they are what the agent itself reported.

| `event_type`             | When it happens                                                              |
| ------------------------ | ---------------------------------------------------------------------------- |
| `case.config.changed`    | A case's settings were made a new version (**Case settings change**)         |
| `artifact.created`       | An artifact was created (an agent's output, or a person's edited version)    |
| `gate.observed_external` | In a review waiting on an external condition, the connector's state was read |

## Records (audit trail) CSV

“Export CSV” outputs the records of the kind you are viewing, up to 5000 rows. A reason is required, and it is kept in the record just like viewing a body. The columns are as follows.

| Column              | Content                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------ |
| `occurred_at`       | The time (UTC)                                                                                         |
| `event_type`        | The kind of event                                                                                      |
| `actor`             | A person's name for a user; otherwise the name of the mechanism that recorded it, or the kind of actor |
| `decision`          | The value of a decision or judgment                                                                    |
| `reason`            | The reason                                                                                             |
| `step`              | The step name                                                                                          |
| `workitem`          | The title of the review request                                                                        |
| `run_id`            | The ID of the case (run)                                                                               |
| `root_execution_id` | The ID of the execution                                                                                |
| `metadata`          | Reference information attached to the record (JSON)                                                    |

## Events that do not exist

The following events do not appear in the records.

- Expiry of a connection confirmation (`gate.cancelled`)
- Resuming a run (`run.resumed`) and merging of parallel lanes (`run.lane_joined`)
- Refusing a start by email (`mail.rejected`)
- A call of External automation (`automation.called`)
- A request to rerun a sweep (`sweep.rerun_requested`)
- Consulting on and applying improvement suggestions (`consult.*`, `improvement.applied`)
- Registering a library file or adding a new version (`library.*`)

## What appears in execution records and exports

An execution record shows the “**execution environment image**”. An export of execution records also shows the tag of the image that ran. For workflows it shows the image digest (`sha256:…`) the administrator certified; for cycles it shows the registry, the image name, and the tag.
