Przejdź do treści

Signal Transform Event v1

Source schema: doc/schemas/signal-transform-event.v1.schema.json

Machine-readable schema for auditable records of transformations applied to user signal when the output is no longer raw.

Governing Basis

Fields

Field Required Shape Description
schema/v yes const: 1 Schema version.
transform_id yes string Stable identifier of this transformation event.
source_ref yes string Stable reference to the source message, segment, or artifact before transformation.
output_ref no string Optional reference to the produced artifact after transformation.
marker_ref no string Optional reference to the visible SignalMarker attached to the output.
input_mode yes enum: raw, structured, transformed, redacted Signal mode of the source artifact before the transformation step.
output_mode yes enum: structured, transformed, redacted Signal mode of the produced artifact after the transformation step.
actor_type yes enum: ai, human, hybrid Who materially performed the transformation.
requested_by yes enum: user, user_policy, safety_policy, exception
basis_ref yes string Reference to the prompt, policy, rule, exception, or other basis authorizing the transformation.
operations yes array
created_at yes string
visibility_scope no enum: user-visible, same-interface, audit-only How the fact of transformation is surfaced relative to the transformed artifact.
content_disclosure no enum: full, partial, metadata-only How much of the transformed content is available to a given audit path.
policy_annotations no object

Definitions

Definition Shape Description
operation enum: structure_extraction, summarization, translation, tone_shift, formality_shift, style_polish, safety_redaction, privacy_redaction

Conditional Rules

Rule 1

When:

{
  "properties": {
    "output_mode": {
      "const": "redacted"
    }
  },
  "required": [
    "output_mode"
  ]
}

Then:

{
  "properties": {
    "operations": {
      "contains": {
        "enum": [
          "safety_redaction",
          "privacy_redaction"
        ]
      }
    }
  }
}

Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

Schema version.

transform_id

  • Required: yes
  • Shape: string

Stable identifier of this transformation event.

source_ref

  • Required: yes
  • Shape: string

Stable reference to the source message, segment, or artifact before transformation.

output_ref

  • Required: no
  • Shape: string

Optional reference to the produced artifact after transformation.

marker_ref

  • Required: no
  • Shape: string

Optional reference to the visible SignalMarker attached to the output.

input_mode

  • Required: yes
  • Shape: enum: raw, structured, transformed, redacted

Signal mode of the source artifact before the transformation step.

output_mode

  • Required: yes
  • Shape: enum: structured, transformed, redacted

Signal mode of the produced artifact after the transformation step.

actor_type

  • Required: yes
  • Shape: enum: ai, human, hybrid

Who materially performed the transformation.

requested_by

  • Required: yes
  • Shape: enum: user, user_policy, safety_policy, exception

basis_ref

  • Required: yes
  • Shape: string

Reference to the prompt, policy, rule, exception, or other basis authorizing the transformation.

operations

  • Required: yes
  • Shape: array

created_at

  • Required: yes
  • Shape: string

visibility_scope

  • Required: no
  • Shape: enum: user-visible, same-interface, audit-only

How the fact of transformation is surfaced relative to the transformed artifact.

content_disclosure

  • Required: no
  • Shape: enum: full, partial, metadata-only

How much of the transformed content is available to a given audit path.

policy_annotations

  • Required: no
  • Shape: object

Definition Semantics

$defs.operation

  • Shape: enum: structure_extraction, summarization, translation, tone_shift, formality_shift, style_polish, safety_redaction, privacy_redaction