Identity intake: channel-normalized lead capture (spec + Rust + TS client)

[brentrager]

Problem

Agents need the visitor's name/email/phone constantly, and every channel improvises: the widget has an all-or-nothing pre-chat form, SMS/voice freestyle the asks with no validation. There is no channel-normalized primitive.

Solution

One agent verb, two channel shapes, one validated payload (full design: docs/Architecture/Identity Intake.md):

• Capability negotiation: create_conversation_session gains optional supports: ["identity_form"] — the widget declares it; SMS/voice never do.
• Form path: the request_identity_intake tool parks the turn (write-confirmation park-and-resume pattern), the server emits identity_intake_required, the client's inline form replies with the submit_identity_intake action. Server-side validation (required fields, email shape, E.164 phone normalization); invalid values emit identity_intake_invalid (mirrors otp_invalid — retryable, turn stays parked). A decline resumes gracefully (declined: true).
• Conversational fallback: without the capability the same tool returns a collect-one-field-at-a-time directive; the model submits via the submit_identity_intake tool — same validation, identical resume payload.
• Session identity: successful intake stamps userName/contactEmail/contactPhone session metadata — the same keys the OTP contact seam reads (intake=collect, OTP=verify; unification designed-in, not built).

Shipped here

• spec/: 2 new event schemas + 1 action schema + supports + envelope enums + conformance fixtures
• Rust: identity_intake module (shared validation) + the two tools in smooai-smooth-operator; protocol constructors, pending-intake registry, capability parsing, submit_identity_intake dispatch + runner bridge in smooai-smooth-operator-server
• TypeScript client: regenerated types, supports, submitIdentityIntake()
• Also fixes the pre-existing lambda dispatch build break (missing usage arg)

Tests

• Rust: 398 passed (incl. new tests/identity_intake.rs — form park/invalid-stays-parked/valid-resume/decline, conversational bad-email-reask/normalization, capability recording, no-pending error) — fmt + clippy clean
• TS 39 passed (client park→invalid→resubmit routing, conformance over the new fixtures), TS server 132, Go 46, Python 47+125, .NET 41 — all green

Follow-ups (parity, per repo process)

TS / Python / Go / .NET server implementations of the seam — the spec + fixtures in this PR are the complete contract.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FczKhti6h4s6yhYXG6V86o

[changeset-bot]

🦋 Changeset detected

Latest commit: 9acd2e2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@smooai/smooth-operator	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR