feat(sdk/rust): add SessionEnvelopeV1 harness types (parity with TS SDK)

[sanil-23]

Summary

Ports the harness session-envelope schema from the TypeScript SDK (sdk/typescript/src/types/harness.ts) to the Rust SDK. Rust consumers (e.g. the OpenHuman core ingest path) can now decode the envelope a wrapped Codex/Claude session forwards inside an encrypted Signal DM body via tinyplace::types::SessionEnvelopeV1, instead of hand-maintaining a mirror that silently drifts from the TS source of truth.

What's added — sdk/rust/src/types/harness.rs

Mirrors the TS interface 1:1:

• SessionEnvelopeV1 (+ HarnessBucket, HarnessScope, HarnessInfo, HarnessMessage, HarnessSource)
• SESSION_ENVELOPE_VERSION_V1 const and the SessionEnvelope alias (matching export type SessionEnvelope = SessionEnvelopeV1)
• String-union type aliases (HarnessProvider, HarnessMessageRole, HarnessBucketUnit, HarnessEnvelopeScope) following the existing pub type EnvelopeType = String convention in messaging.rs
• is_valid_v1() / parse(&str) -> Option<Self> consumer helpers
• types/mod.rs: module declared + flat re-exported like every sibling

Wire-format note (important)

The harness envelope is snake_case on the wire (the CLI wrapper emits a literal snake_case object), unlike the camelCase used by the rest of the API. The structs therefore intentionally omit #[serde(rename_all = "camelCase")]. A round-trip unit test guards against a future camelCase "normalization" that would break decoding of real envelopes.

Tests

cargo test -p tinyplace --lib harness — 2 passing:

• parses_and_round_trips_v1 (asserts snake_case keys survive serialization)
• rejects_unknown_version_and_plain_dm

cargo fmt --check and cargo clippy clean on the crate.

Notes

• No behavior change to existing types; purely additive.
• Follow-up (separate): publish a new tinyplace crate version so downstream (OpenHuman) can bump and drop its hand-written mirror.

Summary by CodeRabbit

• New Features

  • Added support for a new encrypted direct-message envelope format.
  • Improved message handling with validation for version and required session details.
  • Expanded Rust type exports so the new envelope data can be used across the SDK.

• Tests

  • Added coverage for valid envelope parsing, JSON round-tripping, and rejection of unsupported or incomplete payloads.

[vercel]

@sanil-23 is attempting to deploy a commit to the Vezures Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 72115fe0-37e6-4bea-9856-f75df0fec0dc

📥 Commits

Reviewing files that changed from the base of the PR and between d641e1b and 94b4a48.

📒 Files selected for processing (2)

• sdk/rust/src/types/harness.rs
• sdk/rust/src/types/mod.rs

---

📝 Walkthrough

Walkthrough

Adds a new Rust module (sdk/rust/src/types/harness.rs) defining serde structs and type aliases for a v1 harness session envelope wire schema, with is_valid_v1 and parse methods and unit tests. Registers the module in the types barrel (sdk/rust/src/types/mod.rs).

Changes

Harness Envelope Schema

Layer / File(s)	Summary
Envelope type definitions sdk/rust/src/types/harness.rs	Adds SESSION_ENVELOPE_VERSION_V1 constant, string type aliases (HarnessProvider, HarnessMessageRole, HarnessBucketUnit, HarnessEnvelopeScope), and structs HarnessBucket, HarnessScope, HarnessInfo, HarnessMessage, HarnessSource, and SessionEnvelopeV1 (with SessionEnvelope alias).
Validation, parsing, and tests sdk/rust/src/types/harness.rs, sdk/rust/src/types/mod.rs	Implements is_valid_v1 and parse on SessionEnvelopeV1, adds unit tests for round-trip serialization and rejection of invalid payloads, and registers/re-exports the harness module in the types barrel.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

Not applicable — this PR adds a self-contained data schema and parsing utility without multi-component orchestration flow.

Poem

A bunny found a coded scroll,
"session_envelope_v1", quite whole! 🐰
With buckets, scopes, and messages neat,
parse() and is_valid_v1() — such a treat!
Hop hop, the schema's now complete!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: adding Rust SessionEnvelopeV1 harness types with TypeScript SDK parity.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

_{Comment @coderabbitai help to get the list of available commands.}