Dealership OS checks a tenant-scoped lead against consent, STOP, quiet-hours, pacing, verified-sender, identity, assignment, and manager-exception rules. It returns an eligibility or hold decision, a human action card, and an opaque receipt. The entitled customer modes are evaluate and synthetic_acceptance. It never sends outreach, clears STOP, writes CRM or inventory, reserves inventory, calculates a deal, approves desk/OTD terms, or replaces human authority; governance registration and STOP recording are operator-only modes.
View input schema
{
"type": "object",
"properties": {
"tenant_id": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"evaluate",
"synthetic_acceptance",
"register_governance",
"record_stop"
]
},
"fixture_id": {
"type": "string",
"enum": [
"synthetic_internet_lead_v1"
]
},
"evaluation": {
"type": "object",
"additionalProperties": false,
"properties": {
"ingest": {
"type": "object",
"additionalProperties": false,
"properties": {
"schema_version": {
"type": "string",
"enum": [
"stackfast.dealership_lead_worker.v1"
]
},
"tenant_id": {
"type": "string"
},
"lead_id": {
"type": "string"
},
"opportunity_id": {
"type": "string"
},
"source": {
"type": "string",
"enum": [
"web",
"phone",
"email",
"chat",
"oem_marketplace",
"walk_in",
"service_to_sales",
"incumbent_crm_sync"
]
},
"source_record_ref": {
"type": "string"
},
"source_revision": {
"type": "string"
},
"occurred_at": {
"type": "string",
"format": "date-time"
},
"correlation_id": {
"type": "string"
},
"causation_id": {
"type": "string"
},
"relationship_candidates": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"relationship_id": {
"type": "string"
},
"authority_receipt_ref": {
"type": "string"
}
},
"required": [
"relationship_id",
"authority_receipt_ref"
]
}
},
"evidence_refs": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"location_ref": {
"type": "string"
},
"requested_channel": {
"type": [
"string",
"null"
],
"enum": [
"sms",
"email",
"voice",
"chat",
null
]
}
},
"required": [
"schema_version",
"tenant_id",
"lead_id",
"opportunity_id",
"source",
"source_record_ref",
"source_revision",
"occurred_at",
"correlation_id",
"causation_id",
"relationship_candidates",
"evidence_refs",
"location_ref",
"requested_channel"
]
},
"nurture": {
"type": "object",
"additionalProperties": false,
"properties": {
"channel": {
"type": "string",
"enum": [
"sms",
"email",
"voice",
"chat"
]
},
"sender_ref": {
"type": "string"
},
"sender_authority_receipt_ref": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
},
"prior_attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"occurred_at": {
"type": "string",
"format": "date-time"
},
"channel": {
"type": "string",
"enum": [
"sms",
"email",
"voice",
"chat"
]
}
},
"required": [
"occurred_at",
"channel"
]
}
},
"active_stop_conditions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"opt_out",
"sold",
"lost",
"human_takeover",
"identity_conflict",
"provider_failure"
]
}
},
"policy": {
"type": "object",
"additionalProperties": false,
"properties": {
"policy_id": {
"type": "string"
},
"policy_revision": {
"type": "string"
},
"purpose": {
"type": "string",
"enum": [
"lead_response",
"appointment_follow_up",
"post_visit_follow_up",
"delivery_follow_up"
]
},
"allowed_channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"sms",
"email",
"voice",
"chat"
]
}
},
"consent_status": {
"type": "string",
"enum": [
"granted",
"revoked",
"unknown"
]
},
"consent_evidence_ref": {
"type": [
"string",
"null"
]
},
"consent_authority_receipt_ref": {
"type": [
"string",
"null"
]
},
"captured_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"quiet_hours_local": {
"type": "object",
"additionalProperties": false,
"properties": {
"time_zone": {
"type": "string"
},
"start_minute": {
"type": "integer",
"minimum": 0,
"maximum": 1439
},
"end_minute": {
"type": "integer",
"minimum": 0,
"maximum": 1439
}
},
"required": [
"time_zone",
"start_minute",
"end_minute"
]
},
"pacing": {
"type": "object",
"additionalProperties": false,
"properties": {
"minimum_interval_minutes": {
"type": "integer",
"minimum": 1
},
"maximum_attempts_per_24h": {
"type": "integer",
"minimum": 1
}
},
"required": [
"minimum_interval_minutes",
"maximum_attempts_per_24h"
]
},
"verified_sender_refs": {
"type": "array",
"items": {
"type": "string"
}
},
"stop_conditions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"opt_out",
"sold",
"lost",
"human_takeover",
"identity_conflict",
"provider_failure"
]
}
}
},
"required": [
"policy_id",
"policy_revision",
"purpose",
"allowed_channels",
"consent_status",
"consent_evidence_ref",
"consent_authority_receipt_ref",
"captured_at",
"expires_at",
"quiet_hours_local",
"pacing",
"verified_sender_refs",
"stop_conditions"
]
}
},
"required": [
"channel",
"sender_ref",
"sender_authority_receipt_ref",
"evaluated_at",
"prior_attempts",
"active_stop_conditions",
"policy"
]
},
"assignment": {
"type": "object",
"additionalProperties": false,
"properties": {
"assigned_at": {
"type": "string",
"format": "date-time"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"owner_ref": {
"type": "string"
},
"owner_role": {
"type": "string",
"enum": [
"salesperson",
"manager"
]
},
"location_refs": {
"type": "array",
"items": {
"type": "string"
}
},
"skill_refs": {
"type": "array",
"items": {
"type": "string"
}
},
"available": {
"type": "boolean"
},
"active_lead_count": {
"type": "integer",
"minimum": 0
},
"last_assigned_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"owner_ref",
"owner_role",
"location_refs",
"skill_refs",
"available",
"active_lead_count",
"last_assigned_at"
]
}
},
"policy": {
"type": "object",
"additionalProperties": false,
"properties": {
"policy_id": {
"type": "string"
},
"policy_revision": {
"type": "string"
},
"strategy": {
"type": "string",
"enum": [
"round_robin",
"skill_location_load"
]
},
"required_skill_refs": {
"type": "array",
"items": {
"type": "string"
}
},
"acknowledgement_timeout_minutes": {
"type": "integer",
"minimum": 1
},
"backup_owner_ref": {
"type": "string"
},
"manager_owner_ref": {
"type": "string"
}
},
"required": [
"policy_id",
"policy_revision",
"strategy",
"required_skill_refs",
"acknowledgement_timeout_minutes",
"backup_owner_ref",
"manager_owner_ref"
]
}
},
"required": [
"assigned_at",
"candidates",
"policy"
]
},
"human_action": {
"type": "object",
"additionalProperties": false,
"properties": {
"requested_action": {
"type": "string",
"enum": [
"send_photo",
"call",
"book_appointment",
"follow_later",
"request_desk_otd",
"reassign",
"not_mine",
"opt_out",
"lost",
"not_yet"
]
},
"due_at": {
"type": "string",
"format": "date-time"
},
"confirmed_need_ref": {
"type": "string"
},
"context_refs": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"do_not_repeat_refs": {
"type": "array",
"items": {
"type": "string"
}
},
"approved_next_message_ref": {
"type": [
"string",
"null"
]
},
"state_revision": {
"type": "string"
},
"token_expires_at": {
"type": "string",
"format": "date-time"
},
"owner_role": {
"type": "string",
"enum": [
"salesperson",
"manager"
]
}
},
"required": [
"requested_action",
"due_at",
"confirmed_need_ref",
"context_refs",
"do_not_repeat_refs",
"approved_next_message_ref",
"state_revision",
"token_expires_at",
"owner_role"
]
},
"manager_exception_due_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"ingest",
"nurture",
"assignment",
"human_action",
"manager_exception_due_at"
]
},
"governance": {
"type": "object",
"additionalProperties": false,
"properties": {
"tenant_id": {
"type": "string"
},
"lead_id": {
"type": "string"
},
"relationship_id": {
"type": "string"
},
"identity_receipt_ref": {
"type": "string"
},
"consent_receipt_ref": {
"type": "string"
},
"sender_receipt_ref": {
"type": "string"
},
"policy_id": {
"type": "string"
},
"policy_revision": {
"type": "string"
},
"consent_status": {
"type": "string",
"enum": [
"granted",
"revoked"
]
},
"consent_captured_at": {
"type": "string",
"format": "date-time"
},
"consent_expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"allowed_channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"sms",
"email",
"voice",
"chat"
]
},
"minItems": 1
},
"sender_ref": {
"type": "string"
},
"sender_status": {
"type": "string",
"enum": [
"verified",
"revoked"
]
},
"minimum_interval_minutes": {
"type": "integer",
"minimum": 1
},
"maximum_attempts_per_24h": {
"type": "integer",
"minimum": 1
}
},
"required": [
"tenant_id",
"lead_id",
"relationship_id",
"identity_receipt_ref",
"consent_receipt_ref",
"sender_receipt_ref",
"policy_id",
"policy_revision",
"consent_status",
"consent_captured_at",
"consent_expires_at",
"allowed_channels",
"sender_ref",
"sender_status",
"minimum_interval_minutes",
"maximum_attempts_per_24h"
]
},
"stop": {
"type": "object",
"additionalProperties": false,
"properties": {
"tenant_id": {
"type": "string"
},
"lead_id": {
"type": "string"
},
"stop_code": {
"type": "string",
"enum": [
"opt_out",
"sold",
"lost",
"human_takeover",
"identity_conflict",
"provider_failure"
]
},
"source_revision": {
"type": "string"
}
},
"required": [
"tenant_id",
"lead_id",
"stop_code",
"source_revision"
]
}
},
"required": [
"mode"
],
"additionalProperties": false
}