Previous: 21 Opt-In Prompt Proxy Next: 23 Event Feeds & Codemods

Stage 22aq22_schema_handshakeDB-UNIT-11Pre-Effect Handshakes, SWHID Parameter Bundles & Kleisli Wrappers Core

Schema & THP Handshake

Atomic flat-row micro-queue with 0-call slot and 5-role pod.

Negotiates pre-effect SDK and table versions, evolves supporting schemas safely, and casts normalized tables to flat task rows.

/components/schema_evolution_and_handshakes.json /components/schema_evolution_and_handshakes.md Open in Queue Commons

Inputs (Flat Row)

Client schema/SDK version
SchemaEvolutionProposal

Atomic Queue & Lanes

aq22_schema_handshake
queues-db.teleon.dev
Version Negotiate
Additive Morphing
Flat-Row Cast

Execution Modes & Agent Freedom

Deterministic (0 calls): thp_v1_hmac_and_schema_caster_v1 (Semver handshake & bidirectional row caster)
Hybrid (<=1 call): schema_drift_compat_advisor_v1
AI Agent (1..6): cross_version_downgrade_shim_synthesizer_v1 (Schema gap detector & migration author; Instructions + Resources + Freedom to search for new resources and new ways not bound by instructions)

Outputs (Table Merge)

X-Teleon-Handshake-Token
Evolved table/view lens
Upcaster shim

Modular 6-layer envelope & 0..32 Kleisli onion middlelayers (DB substrates exempt)

Inbound and outbound calls traverse versioned envelope layers and composable Kleisli middlelayers before reaching the swappable engine slot, while backing database kernels enforce 0 inline agent wrapper steps.

1. frustration_avoidance
2. flexible_pointer_or_slice_carrier
3. thp_schema_and_version_handshake
4. surface_account_and_ring_entitlement
5. idempotent_effect_journal_and_tracking
6. preflight_self_repair_and_zero_call_check
7. 0..32 Kleisli steps (shims / budget deadlines / secret scrub)
8. slot.aq22_schema_handshake (Native | Pinned OSS | Wasm)
ACID DB Core: 0 agent wrapper steps

5-role component managing pod & engine-slot twins

0-Call Slot (R1_DET_ENGINE): Executes SQL, BM25F/Roaring, AST, or fuel-metered Wasm adapters behind a fixed typed engine_slot/v1, pairing pinned upstream OSS adapters with clean Teleon-native twins.
Solver+OpenSearch (R2_PRIMARY_SOLVER): Runs under Instructions + Resources + Freedom to search for new resources and new ways not bound by instructions on 1 self-contained depth-1 flat task row per lease.
Split-Supervisor (R3_QUEUE_SUPERVISOR): Watches queue depth, stalls, and context horizons; explodes oversized tasks into wave-ordered flat subtask rows while preserving the original parent intact for rollup verification and long-horizon benchmarking.
Repair+Shim (R4_DIAGNOSTIC_REPAIR): Reviews whether the edge contract itself failed before mutating code (LE-CONTRACT-002), repairs lease timeouts and schema mismatches, and synthesizes 0..32-step middlelayer shims.
CPOP+Distill (R5_VERIFIER_DISTILLER): Grades outputs across an independent model family (reviewer != producer) and distills recurring high-cost agent wins into 0-call deterministic Sister code.

Parent-preserving supervision, catch-all & optional SCD2 packs

Supervisor split (aq41): Oversized or stalled tasks split into wave-ordered subtask rows while keeping subdivided_parent intact for rollup verification and direct long-horizon benchmarks.
Optional SCD Type 2 packs (Store S12): Versioned pack_sk rows (valid_from_utc, valid_to_utc, is_current, edited_by) supply optional locales, settings, instructions, suggestion paths, and tools across bare_baseline, pre_materialized_flat, and on_demand_claim_hydrated modes.
Flexible carriers: inline_object, swhid_cas_pointer, http_206_byte_slice, d1_row_cursor, signed_r2_uri

Normalized tables, invariants & 1 flat task row

Cell host: queues-db.teleon.dev
Backlog table: teleon_core.handshakes_wrappers_todo_backlog
Hydration: Normalized supporting tables join server-side into 1 flat row on claim
teleon_core.teleon_surface_handshakes
teleon_core.component_parametric_configs
teleon_core.schema_migration_casters

Unsupported versions fail closed prior to side effects unless a verified pure-function SchemaMigrationGate caster exists.
Track-1 workers read pinned active_config_swhid snapshots and never mutate parameters mid-flight.

Atomic micro-queue & Track 2 Sister objective

Atomic queue: aq22_schema_handshake via q06-handshake-queue.teleon.dev
Track 2 Sister (SISTER-11): sq11-improve-handshakes-queue.teleon.dev
Sister objective: Synthesize cross-version up/down-casters, compress middleware overhead, and maintain 10-host plugin parity.

public:fixed_semverinternal:flexible_morphrow:flat_hydrated

Bot & harness fleet actions (Codex, Claude Code, ChatGPT, Dots, Meta Muse, GrokBot)

Detect repeated unmapped fields and propose additive supporting tables or columns
Author pure upcasters/downcasters keeping public Teleon endpoints non-breaking
Create custom schemas, flat-row hydrators, and micro-queues for new surfaces

Sister self-tuning areas & HTTP queue submission

Synthesize pure-function downgrade/upgrade shims for rolling 12-month SDK versions (DIM-03)
Tune edge KV handshake cache TTLs and pre-warmed parameter bundles (DIM-07)
Expand universal plugin hooks across ZCode, Claude Code, T3 Code/Chat, Zed, and Cursor (DIM-03, DIM-06)

# Zero-auth claim 1 flat-hydrated task row from this atomic micro-queue:
curl -sS "https://router.teleon.dev/v1/claim?agent=meta-muse&atomic_queue_id=aq22_schema_handshake"
# Or enqueue a task directly onto this atomic micro-queue:
curl -sS https://queues.teleon.dev/v1/queues/submit \
  -H "Content-Type: application/json" \
  -d '{"atomic_queue_id":"aq22_schema_handshake","db_unit_id":"DB-UNIT-11","title":"Task for schema_evolution_and_handshakes"}'