file transfer (ts): parse images/files, wire directive sink to Rust parity

[brentrager]

Problem

The file-transfer protocol contract merged in #342 (send_message.files[] + images[], and the send_file directive convention on eventual_response.directive) was spec-only. The Rust server already implements images/directive; the TypeScript server parsed message only, built the user message text-only, and never emitted a directive.

Solution — TS server to Rust parity

• Regen protocol types (typescript/src/generated/types.ts via scripts/generate.ts): send_message gains images[]/files[]; eventual_response gains directive.
• Images → model: parsed in the dispatcher and attached to the turn's user message as OpenAI image_url content parts. The published @smooai/smooth-operator-core engine takes a plain-string message and reuses it for retrieval/memory, so a new withUserImages() wrapper rewrites the outgoing request body's current user message ("text" → [{type:'text'},{type:'image_url'}]) — the exact shape Rust's with_user_images produces — while leaving text-based retrieval untouched.
• Files → tool context: parsed and surfaced on a new per-turn ToolContext (parallel to images), never sent to the model — mirroring the Rust ToolProviderContext.
• Directive sink: a new optional toolProvider seam (mirrors Rust ToolProvider::tools_for) hands host tools the per-turn context. A host tool writes ctx.directive; the dispatcher drains it after the turn and passes it to the eventual_response builder (last-write-wins, omitted when none).
• All attachment parsing is fail-soft (a malformed entry is dropped, never rejects the turn).

Notes

• The TS core engine (1.7.1) has no multimodal seam; the request-body wrapper is the workaround, with a ponytail: upgrade path to a core withUserImages when the engine gains one (as Rust has).
• Additive + back-compat: no attachments / no provider ⇒ behaviour byte-for-byte unchanged. Existing conformance/scenario-parity suites stay green with no edits.

Tests / gates

• New withUserImages + parseImages/parseFiles unit tests, plus end-to-end (real WS): images-attach, files-on-context, tool → directive → eventual_response, back-compat omit, and fail-soft. 12 new tests.
• Green: typecheck + test + build for @smooai/smooth-operator and @smooai/smooth-operator-server (245 server + 41 SDK tests pass).
• Changeset added (minor on both packages).

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: bbd1c0f

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

This PR includes changesets to release 3 packages

Name	Type
@smooai/smooth-operator-server	Minor
@smooai/smooth-operator	Minor
@smooai/smooth-operator-web-chat-example	Patch

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