@team-agent/installer 0.5.53 → 0.5.55

package/Cargo.lock

@@ -575,7 +575,7 @@ dependencies = [
 
 [[package]]
 name = "team-agent"
-version = "0.5.53"
+version = "0.5.55"
 dependencies = [
  "anyhow",
  "chrono",

package/Cargo.toml

@@ -9,7 +9,7 @@ members = ["crates/team-agent", "crates/win-conpty-phase0", "crates/conpty-trans
 
 [workspace.package]
 edition = "2021"
-version = "0.5.53"
+version = "0.5.55"
 license = "AGPL-3.0"
 rust-version = "1.95"
 

package/crates/team-agent/src/cli/emit.rs

@@ -317,8 +317,11 @@ fn command_help(command: Option<&str>) -> String {
         Some("compile") => "usage: team-agent compile --team TEAM [--out FILE] [--json]".to_string(),
         Some("send") => concat!(
             "usage: team-agent send TO MESSAGE... ",
-            "[--workspace WORKSPACE] [--team TEAM] [--json]\n\n",
-            "TO is a logical recipient; send returns after the message is persisted."
+            "[--workspace WORKSPACE] [--team TEAM] ",
+            "[--presentation-sink leader|casefile|silent --message-class CLASS [--case-id CASE]] ",
+            "[--json]\n\n",
+            "TO is a logical recipient; send returns after the message is persisted. ",
+            "Presentation changes live display only; every sink remains durable."
         )
         .to_string(),
         Some("allow-peer-talk") => "usage: team-agent allow-peer-talk A B [--workspace WORKSPACE] [--json]".to_string(),
@@ -775,6 +778,9 @@ struct ParsedArgs {
     socket: Option<String>,
     thread_id: Option<String>,
     message_id: Option<String>,
+    presentation_sink: Option<String>,
+    message_class: Option<String>,
+    case_id: Option<String>,
     content: Option<String>,
     primary_error: Option<String>,
     agent_id: Option<String>,
@@ -865,6 +871,9 @@ fn parse_args(args: &[String]) -> ParsedArgs {
             "--socket" => parsed.socket = next_arg(args, &mut i),
             "--thread-id" => parsed.thread_id = next_arg(args, &mut i),
             "--message-id" => parsed.message_id = next_arg(args, &mut i),
+            "--presentation-sink" => parsed.presentation_sink = next_arg(args, &mut i),
+            "--message-class" => parsed.message_class = next_arg(args, &mut i),
+            "--case-id" => parsed.case_id = next_arg(args, &mut i),
             "--content" => parsed.content = next_arg(args, &mut i),
             "--primary-error" => parsed.primary_error = next_arg(args, &mut i),
             "--result-json" => parsed.result_json = next_arg(args, &mut i),
@@ -881,6 +890,17 @@ fn parse_args(args: &[String]) -> ParsedArgs {
             other if other.starts_with("--to-leader=") => {
                 parsed.to_leader = Some(other.trim_start_matches("--to-leader=").to_string());
             }
+            other if other.starts_with("--presentation-sink=") => {
+                parsed.presentation_sink =
+                    Some(other.trim_start_matches("--presentation-sink=").to_string());
+            }
+            other if other.starts_with("--message-class=") => {
+                parsed.message_class =
+                    Some(other.trim_start_matches("--message-class=").to_string());
+            }
+            other if other.starts_with("--case-id=") => {
+                parsed.case_id = Some(other.trim_start_matches("--case-id=").to_string());
+            }
             other if other.starts_with("--provider=") => {
                 parsed.provider = Some(other.trim_start_matches("--provider=").to_string());
             }
@@ -1029,6 +1049,23 @@ fn send_args(args: &[String], cwd: &Path) -> Result<SendArgs, CliError> {
     };
     let message_start = usize::from(target.is_some());
     let workspace = workspace(&parsed, cwd);
+    let presentation_value = if parsed.presentation_sink.is_some()
+        || parsed.message_class.is_some()
+        || parsed.case_id.is_some()
+    {
+        Some(serde_json::json!({
+            "sink": parsed.presentation_sink.clone(),
+            "class": parsed.message_class.clone(),
+            "case_id": parsed.case_id.clone(),
+        }))
+    } else {
+        None
+    };
+    let (presentation, presentation_error) =
+        crate::messaging::presentation::normalize_presentation(presentation_value.as_ref());
+    if let Some(error) = presentation_error {
+        return Err(CliError::Usage(format!("invalid presentation: {error}")));
+    }
     Ok(SendArgs {
         target,
         message: parsed
@@ -1049,6 +1086,7 @@ fn send_args(args: &[String], cwd: &Path) -> Result<SendArgs, CliError> {
         confirm_human: false,
         json: parsed.json,
         message_id: None,
+        presentation,
         pane: parsed.pane.clone(),
         to_name: parsed.to_name.clone(),
         to_leader: parsed.to_leader.clone(),
@@ -1111,11 +1149,22 @@ fn validate_send_flags(args: &[String]) -> Result<(), CliError> {
         "--timeout",
         "--confirm-human",
         "--message-id",
+        "--presentation-sink",
+        "--message-class",
+        "--case-id",
         "--json",
         "-h",
         "--help",
     ];
-    const ALLOWED_PREFIXES: &[&str] = &["--team=", "--pane=", "--to-name=", "--to-leader="];
+    const ALLOWED_PREFIXES: &[&str] = &[
+        "--team=",
+        "--pane=",
+        "--to-name=",
+        "--to-leader=",
+        "--presentation-sink=",
+        "--message-class=",
+        "--case-id=",
+    ];
     if let Some(flag) = args.iter().find(|arg| {
         arg.starts_with('-')
             && !ALLOWED.contains(&arg.as_str())
@@ -2015,6 +2064,48 @@ mod tests {
         let _ = std::fs::remove_dir_all(&cwd);
     }
 
+    #[test]
+    fn send_presentation_flags_map_to_the_typed_request() {
+        let cwd = tmp_workspace();
+        let args = send_args(
+            &cli_argv(&[
+                "leader",
+                "progress",
+                "--presentation-sink",
+                "casefile",
+                "--message-class",
+                "progress",
+                "--case-id",
+                "case-9",
+            ]),
+            &cwd,
+        )
+        .unwrap();
+        assert_eq!(
+            args.presentation.sink,
+            crate::messaging::presentation::PresentationSink::Casefile
+        );
+        assert_eq!(
+            args.presentation.class,
+            crate::messaging::presentation::PresentationClass::Progress
+        );
+        assert_eq!(args.presentation.case_id.as_deref(), Some("case-9"));
+    }
+
+    #[test]
+    fn send_presentation_flags_fail_closed_when_incomplete() {
+        let cwd = tmp_workspace();
+        let error = send_args(
+            &cli_argv(&["leader", "progress", "--presentation-sink", "casefile"]),
+            &cwd,
+        )
+        .unwrap_err();
+        assert!(matches!(
+            error,
+            CliError::Usage(message) if message == "invalid presentation: missing_class"
+        ));
+    }
+
     #[test]
     fn send_to_name_positionals_are_message_not_target() {
         let cwd = tmp_workspace();

package/crates/team-agent/src/cli/send/persist.rs

@@ -25,6 +25,7 @@ pub fn send_options_from_args(args: &SendArgs) -> SendOptions {
         watch_result: args.watch_result,
         team: args.team.as_ref().map(|s| TeamKey::new(s.clone())),
         message_id: args.message_id.clone(),
+        presentation: args.presentation.clone(),
         ..SendOptions::default()
     }
 }

package/crates/team-agent/src/cli/send/presentation.rs

@@ -285,6 +285,7 @@ pub(super) fn first_target(target: &MessageTarget) -> String {
 pub(super) fn delivery_status_wire(status: DeliveryStatus) -> &'static str {
     match status {
         DeliveryStatus::Delivered => "delivered",
+        DeliveryStatus::StoredOnly => "stored_only",
         DeliveryStatus::Failed => "failed",
         DeliveryStatus::Queued => "queued",
         DeliveryStatus::Blocked => "blocked",

package/crates/team-agent/src/cli/send.rs

@@ -169,6 +169,7 @@ pub fn send_to_canonical_leader_target(
         confirm_human: false,
         json: true,
         message_id: None,
+        presentation: crate::messaging::presentation::PresentationRequest::default(),
         pane: None,
         to_name: None,
         to_leader: None,

package/crates/team-agent/src/cli/spec.rs

@@ -155,7 +155,7 @@ pub(crate) struct CommandSpec {
 #[rustfmt::skip]
 pub(crate) const COMMAND_SPECS: &[CommandSpec] = &[
     CommandSpec { name: "quick-start", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::QuickStart), summary: "start or attach a team from TEAM.md", usage: "usage: team-agent quick-start [TEAMDIR] [--workspace WORKSPACE] [--name NAME] [--team-id TEAM|--team TEAM] [--yes] [--no-display] [--backend tmux|conpty] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, alias_of: None, sunset: None, action: None, governance: None },
-    CommandSpec { name: "send", tier: CommandTier::Core, category: CommandCategory::Daily, kind: CommandKind::Dispatch(DispatchKind::Send), summary: "persist a message for a logical recipient", usage: "usage: team-agent send TO MESSAGE... [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, alias_of: None, sunset: Some("next compatibility release"), action: Some("use positional logical TO and the returned message id"), governance: None },
+    CommandSpec { name: "send", tier: CommandTier::Core, category: CommandCategory::Daily, kind: CommandKind::Dispatch(DispatchKind::Send), summary: "persist a message for a logical recipient", usage: "usage: team-agent send TO MESSAGE... [--workspace WORKSPACE] [--team TEAM] [--presentation-sink leader|casefile|silent --message-class CLASS [--case-id CASE]] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, alias_of: None, sunset: Some("next compatibility release"), action: Some("use positional logical TO and the returned message id"), governance: None },
     CommandSpec { name: "status", tier: CommandTier::Core, category: CommandCategory::Daily, kind: CommandKind::Dispatch(DispatchKind::Status), summary: "show current team status", usage: "usage: team-agent status [AGENT] [--workspace WORKSPACE] [--team TEAM] [--summary|--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, alias_of: None, sunset: None, action: None, governance: None },
     CommandSpec { name: "collect", tier: CommandTier::Core, category: CommandCategory::Daily, kind: CommandKind::Dispatch(DispatchKind::Collect), summary: "collect reported results", usage: "usage: team-agent collect [--workspace WORKSPACE] [--team TEAM] [--result-file FILE] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, alias_of: None, sunset: None, action: None, governance: None },
     CommandSpec { name: "restart", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Restart), summary: "restart the selected team", usage: "usage: team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, alias_of: None, sunset: None, action: None, governance: None },

package/crates/team-agent/src/cli/tests/lane_c.rs

@@ -361,7 +361,7 @@ fn cleanup_orphans_dryrun_golden_envelope() {
 // ── fix_schema: golden fix_schema_layout diagnosis envelope (schema_migration.py:258) ─────────────
 // {ok,status,db_path,schema_version,user_version,layout_diffs,recommended_action,would_backup_path,
 // fixed,rebuilds}. RUST mod.rs:538-540 stub {ok,fixed:false}. db_path/would_backup_path are
-// path/clock-derived; lock the deterministic fields. SCHEMA_VERSION==3. RED. ─────────────────────
+// path/clock-derived; lock the deterministic fields against the canonical SCHEMA_VERSION. ────────
 #[test]
 fn fix_schema_golden_layout_diagnosis_envelope() {
     let ws = tmp_workspace();
@@ -370,8 +370,8 @@ fn fix_schema_golden_layout_diagnosis_envelope() {
     assert_eq!(v["status"], json!("missing"), "missing db: status missing");
     assert_eq!(
         v["schema_version"],
-        json!(3),
-        "golden schema_version == SCHEMA_VERSION (3)"
+        json!(crate::db::schema::SCHEMA_VERSION),
+        "golden schema_version == canonical SCHEMA_VERSION"
     );
     assert_eq!(v["user_version"], json!(0), "missing db user_version == 0");
     assert_eq!(

package/crates/team-agent/src/cli/tests/leader_watch.rs

@@ -49,6 +49,7 @@ fn cli_send_persists_real_message_row() {
         confirm_human: false,
         json: true,
         message_id: None,
+        presentation: crate::messaging::presentation::PresentationRequest::default(),
         pane: None,
         to_name: None,
         to_leader: None,

package/crates/team-agent/src/cli/tests/named_address.rs

@@ -157,6 +157,7 @@ fn named_send_args(
         confirm_human: false,
         json: true,
         message_id: None,
+        presentation: crate::messaging::presentation::PresentationRequest::default(),
         pane: pane.map(str::to_string),
         to_name: to_name.map(str::to_string),
         to_leader: None,

package/crates/team-agent/src/cli/tests/status_send.rs

@@ -468,6 +468,7 @@ fn send_args_fixture() -> SendArgs {
         confirm_human: false,
         json: false,
         message_id: None,
+        presentation: crate::messaging::presentation::PresentationRequest::default(),
         pane: None,
         to_name: None,
         to_leader: None,

package/crates/team-agent/src/cli/types.rs

@@ -323,6 +323,7 @@ pub struct SendArgs {
     /// When set, the store insert uses this id verbatim; a repeat with the same
     /// id returns a `Duplicate` refusal instead of creating a second row.
     pub message_id: Option<String>,
+    pub presentation: crate::messaging::presentation::PresentationRequest,
     /// Deprecated compatibility input. Public send refuses pane identity and
     /// requires a logical recipient so persistence always precedes delivery.
     pub pane: Option<String>,

package/crates/team-agent/src/coordinator/tests/basics.rs

@@ -365,16 +365,16 @@ fn orphan_self_terminate_false_when_workspace_exists() {
 
 #[test]
 fn metadata_ok_requires_all_three_to_match() {
-    // metadata.py:37-43 — pid ∧ protocol_version==2 ∧ schema_version==3.
-    let good = meta(555, PROTOCOL_VERSION, GOLDEN_SCHEMA_VERSION);
+    // metadata.py:37-43 — pid, protocol version, and current message schema all match.
+    let good = meta(555, PROTOCOL_VERSION, crate::db::schema::SCHEMA_VERSION);
     assert!(coordinator_metadata_ok(Some(&good), Pid(555)));
     // pid 不符 → false。
     assert!(!coordinator_metadata_ok(Some(&good), Pid(999)));
     // protocol_version 不符(bump 触发 restart_incompatible)→ false。
-    let bad_proto = meta(555, 1, GOLDEN_SCHEMA_VERSION);
+    let bad_proto = meta(555, 1, crate::db::schema::SCHEMA_VERSION);
     assert!(!coordinator_metadata_ok(Some(&bad_proto), Pid(555)));
     // schema_version 不符 → false(不可静默继续旧 schema 写库,card §89)。
-    let bad_schema = meta(555, PROTOCOL_VERSION, 2);
+    let bad_schema = meta(555, PROTOCOL_VERSION, crate::db::schema::SCHEMA_VERSION - 1);
     assert!(!coordinator_metadata_ok(Some(&bad_schema), Pid(555)));
 }
 

package/crates/team-agent/src/db/message_store.rs

@@ -85,6 +85,7 @@ pub struct NotificationClaimParams<'a> {
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum MessageRowStatus {
     Accepted,
+    StoredOnly,
     QueuedUntilLeaderAttach,
     QueuedCoordinatorUnavailable,
 }
@@ -93,6 +94,7 @@ impl MessageRowStatus {
     pub const fn as_str(self) -> &'static str {
         match self {
             Self::Accepted => "accepted",
+            Self::StoredOnly => "stored_only",
             Self::QueuedUntilLeaderAttach => "queued_until_leader_attach",
             Self::QueuedCoordinatorUnavailable => "queued_coordinator_unavailable",
         }
@@ -111,6 +113,7 @@ pub struct PersistMessageInput<'a> {
     pub requires_ack: bool,
     pub status: MessageRowStatus,
     pub content: &'a str,
+    pub presentation: &'a str,
     pub error: Option<&'a str>,
 }
 
@@ -182,9 +185,9 @@ impl MessageStore {
         conn.execute(
             "insert into messages(
                 message_id, owner_team_id, task_id, sender, recipient, reply_to, requires_ack,
-                status, content, artifact_refs, created_at, updated_at, delivered_at,
+                status, content, presentation, artifact_refs, created_at, updated_at, delivered_at,
                 acknowledged_at, error, delivery_attempts
-            ) values (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, '[]', ?10, ?10, null, null, ?11, 0)",
+            ) values (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, '[]', ?11, ?11, null, null, ?12, 0)",
             params![
                 message_id,
                 input.owner_team_id,
@@ -195,6 +198,7 @@ impl MessageStore {
                 if input.requires_ack { 1 } else { 0 },
                 input.status.as_str(),
                 input.content,
+                input.presentation,
                 now,
                 input.error,
             ],
@@ -226,6 +230,7 @@ impl MessageStore {
             requires_ack,
             status: MessageRowStatus::Accepted,
             content,
+            presentation: r#"{"sink":"leader","class":"message"}"#,
             error: None,
         })
     }
@@ -259,6 +264,7 @@ impl MessageStore {
             requires_ack,
             status: MessageRowStatus::Accepted,
             content,
+            presentation: r#"{"sink":"leader","class":"message"}"#,
             error: None,
         })
     }
@@ -809,6 +815,29 @@ mod tests {
         assert_eq!(status_of(&read(&s), &mid), "failed");
     }
 
+    #[test]
+    fn claim_for_delivery_never_claims_stored_only_presentation() {
+        let s = store();
+        let mid = s
+            .persist_message(PersistMessageInput {
+                message_id: None,
+                owner_team_id: Some("team-a"),
+                task_id: None,
+                sender: "worker",
+                recipient: "leader",
+                reply_to: None,
+                requires_ack: false,
+                status: MessageRowStatus::StoredOnly,
+                content: "casefile evidence",
+                presentation: r#"{"sink":"casefile","class":"stage_result"}"#,
+                error: None,
+            })
+            .unwrap();
+        assert!(!s.claim_for_delivery(&mid).unwrap());
+        assert_eq!(status_of(&read(&s), &mid), "stored_only");
+        assert_eq!(col_i64(&read(&s), &mid, "delivery_attempts"), 0);
+    }
+
     // ───────────────────────────── mark state machine ─────────────────────────────
 
     #[test]

package/crates/team-agent/src/db/migration.rs

@@ -26,6 +26,7 @@ pub const MANAGED_TABLE_LAYOUTS: &[(&str, &[&str])] = &[
             "requires_ack",
             "status",
             "content",
+            "presentation",
             "artifact_refs",
             "created_at",
             "updated_at",
@@ -121,7 +122,7 @@ pub const MANAGED_TABLE_LAYOUTS: &[(&str, &[&str])] = &[
 
 /// rebuild / 建缺表用的 DDL 模板(`schema_migration.py:CREATE_TABLE_SQL`,`__TABLE__` 占位)。
 const CREATE_TABLE_TEMPLATES: &[(&str, &str)] = &[
-    ("messages", "create table if not exists __TABLE__ (\n          message_id text primary key,\n          owner_team_id text,\n          task_id text,\n          sender text,\n          recipient text,\n          reply_to text,\n          requires_ack integer,\n          status text,\n          content text,\n          artifact_refs text,\n          created_at text,\n          updated_at text,\n          delivered_at text,\n          acknowledged_at text,\n          error text,\n          delivery_attempts integer not null default 0\n        )"),
+    ("messages", "create table if not exists __TABLE__ (\n          message_id text primary key,\n          owner_team_id text,\n          task_id text,\n          sender text,\n          recipient text,\n          reply_to text,\n          requires_ack integer,\n          status text,\n          content text,\n          presentation text not null default '{\"sink\":\"leader\",\"class\":\"message\"}',\n          artifact_refs text,\n          created_at text,\n          updated_at text,\n          delivered_at text,\n          acknowledged_at text,\n          error text,\n          delivery_attempts integer not null default 0\n        )"),
     ("results", "create table if not exists __TABLE__ (\n          result_id text primary key,\n          owner_team_id text,\n          task_id text not null,\n          agent_id text not null,\n          envelope text not null,\n          status text not null,\n          created_at text not null\n        )"),
     ("scheduled_events", "create table if not exists __TABLE__ (\n          id integer primary key,\n          owner_team_id text,\n          due_at text not null,\n          target text not null,\n          kind text not null,\n          payload_json text not null,\n          status text not null,\n          created_at text not null,\n          fired_at text,\n          result_json text\n        )"),
     ("delivery_tokens", "create table if not exists __TABLE__ (\n          message_id text primary key,\n          unique_token text not null,\n          injected_at text not null,\n          visible_at text,\n          consumed_at text,\n          failed_at text,\n          failure_reason text\n        )"),
@@ -641,11 +642,11 @@ mod tests {
         assert_eq!(m1, "t");
         drop(conn);
 
-        // 迁移后 diagnosis = ok / user_version=3。
+        // 迁移后 diagnosis = ok / current user_version。
         let after = schema_diagnosis(&path, SCHEMA_VERSION).unwrap();
         assert!(after.ok);
         assert_eq!(after.status, "ok");
-        assert_eq!(after.user_version, 3);
+        assert_eq!(after.user_version, SCHEMA_VERSION);
 
         // 备份文件已写(team.db.pre-migration-*-from-v1.bak)。
         let runtime = path.parent().unwrap();
@@ -670,7 +671,7 @@ mod tests {
         let d = schema_diagnosis(&path, SCHEMA_VERSION).unwrap();
         assert!(d.ok);
         assert_eq!(d.status, "ok");
-        assert_eq!(d.user_version, 3);
+        assert_eq!(d.user_version, SCHEMA_VERSION);
     }
 
     #[test]
@@ -788,7 +789,7 @@ mod tests {
         initialize_schema(&conn, Some(&path)).unwrap();
         let cols = table_layout(&conn, "messages").unwrap();
         assert!(!cols.iter().any(|c| c == "legacy_junk"), "废列应被丢弃");
-        assert_eq!(cols.len(), 16);
+        assert_eq!(cols.len(), 17);
         assert_eq!(table_count(&conn, "messages").unwrap(), 1);
     }
 
@@ -846,7 +847,7 @@ mod tests {
                 rebuilds,
             } => {
                 assert!(diagnosis.ok);
-                assert_eq!(diagnosis.user_version, 3);
+                assert_eq!(diagnosis.user_version, SCHEMA_VERSION);
                 assert_eq!(rebuilds.len(), 8);
             }
             other => panic!("expected Fixed, got {other:?}"),

package/crates/team-agent/src/db/schema.rs

@@ -12,11 +12,11 @@ use rusqlite::Connection;
 use crate::db::DbError;
 
 /// `schema.py:90`。
-pub const SCHEMA_VERSION: i64 = 3;
+pub const SCHEMA_VERSION: i64 = 4;
 
 /// 8 张表的 DDL(逐字照搬 `schema.py:initialize_schema` 的内联建表;含 `if not exists`)。
 /// 顺序与 Python 一致(leader_notification_log 在 ensure 块后创建)。
-const CREATE_MESSAGES: &str = "create table if not exists messages (\n              message_id text primary key,\n              owner_team_id text,\n              task_id text,\n              sender text,\n              recipient text,\n              reply_to text,\n              requires_ack integer,\n              status text,\n              content text,\n              artifact_refs text,\n              created_at text,\n              updated_at text,\n              delivered_at text,\n              acknowledged_at text,\n              error text,\n              delivery_attempts integer not null default 0\n            )";
+const CREATE_MESSAGES: &str = "create table if not exists messages (\n              message_id text primary key,\n              owner_team_id text,\n              task_id text,\n              sender text,\n              recipient text,\n              reply_to text,\n              requires_ack integer,\n              status text,\n              content text,\n              presentation text not null default '{\"sink\":\"leader\",\"class\":\"message\"}',\n              artifact_refs text,\n              created_at text,\n              updated_at text,\n              delivered_at text,\n              acknowledged_at text,\n              error text,\n              delivery_attempts integer not null default 0\n            )";
 const CREATE_RESULTS: &str = "create table if not exists results (\n              result_id text primary key,\n              owner_team_id text,\n              task_id text not null,\n              agent_id text not null,\n              envelope text not null,\n              status text not null,\n              created_at text not null\n            )";
 const CREATE_SCHEDULED_EVENTS: &str = "create table if not exists scheduled_events (\n              id integer primary key,\n              owner_team_id text,\n              due_at text not null,\n              target text not null,\n              kind text not null,\n              payload_json text not null,\n              status text not null,\n              created_at text not null,\n              fired_at text,\n              result_json text\n            )";
 const CREATE_DELIVERY_TOKENS: &str = "create table if not exists delivery_tokens (\n              message_id text primary key,\n              unique_token text not null,\n              injected_at text not null,\n              visible_at text,\n              consumed_at text,\n              failed_at text,\n              failure_reason text\n            )";
@@ -47,6 +47,7 @@ const MESSAGE_COLUMNS: &[&str] = &[
     "requires_ack",
     "status",
     "content",
+    "presentation",
     "artifact_refs",
     "created_at",
     "updated_at",
@@ -264,6 +265,10 @@ pub fn initialize_schema(
                 "owner_team_id",
                 "alter table messages add column owner_team_id text",
             ),
+            (
+                "presentation",
+                "alter table messages add column presentation text not null default '{\"sink\":\"leader\",\"class\":\"message\"}'",
+            ),
         ],
     )?;
     ensure_table_columns(
@@ -354,13 +359,13 @@ mod tests {
     }
 
     #[test]
-    fn user_version_is_three() {
+    fn user_version_is_four() {
         let conn = fresh();
         let v: i64 = conn
             .query_row("pragma user_version", [], |r| r.get(0))
             .unwrap();
         assert_eq!(v, SCHEMA_VERSION);
-        assert_eq!(v, 3);
+        assert_eq!(v, 4);
     }
 
     #[test]
@@ -378,6 +383,7 @@ mod tests {
                 "requires_ack",
                 "status",
                 "content",
+                "presentation",
                 "artifact_refs",
                 "created_at",
                 "updated_at",
@@ -394,7 +400,7 @@ mod tests {
         // initialize_schema 二次调用(if not exists / 无缺列)→ 不报错、schema 不变 + 索引仍在。
         let conn = fresh();
         initialize_schema(&conn, None).unwrap();
-        assert_eq!(table_layout(&conn, "messages").unwrap().len(), 16);
+        assert_eq!(table_layout(&conn, "messages").unwrap().len(), 17);
         let idx: i64 = conn
             .query_row(
                 "select count(*) from sqlite_master where type='index' and sql is not null",
@@ -422,6 +428,13 @@ mod tests {
                     ("requires_ack", "INTEGER", 0, None, 0),
                     ("status", "TEXT", 0, None, 0),
                     ("content", "TEXT", 0, None, 0),
+                    (
+                        "presentation",
+                        "TEXT",
+                        1,
+                        Some("'{\"sink\":\"leader\",\"class\":\"message\"}'"),
+                        0,
+                    ),
                     ("artifact_refs", "TEXT", 0, None, 0),
                     ("created_at", "TEXT", 0, None, 0),
                     ("updated_at", "TEXT", 0, None, 0),

package/crates/team-agent/src/lifecycle/tests/phase_golden.rs

@@ -267,6 +267,7 @@ fn run_phase_golden(spec: PhaseGolden) -> Value {
         confirm_human: false,
         json: true,
         message_id: Some("phase-golden-message".to_string()),
+        presentation: crate::messaging::presentation::PresentationRequest::default(),
         pane: None,
         to_name: None,
         to_leader: None,

package/crates/team-agent/src/mcp_server/normalize.rs

@@ -104,6 +104,12 @@ pub fn normalize_report_envelope(env: &Value) -> NormalizedReportEnvelope {
     let summary = text_field(env, "summary").unwrap_or_else(|| "completed".to_string());
     let task_id = text_field(env, "task_id").unwrap_or_else(|| "manual".to_string());
     let agent_id = text_field(env, "agent_id").unwrap_or_else(|| "unknown".to_string());
+    let (presentation_request, presentation_error) =
+        crate::messaging::presentation::normalize_report_presentation(env.get("presentation"));
+    let presentation = crate::messaging::presentation::decide_presentation(
+        &presentation_request,
+        crate::messaging::presentation::PresentationSource::ReportResult,
+    );
     NormalizedReportEnvelope {
         schema_version: "result_envelope_v1".to_string(),
         task_id: TaskId::new(task_id),
@@ -115,6 +121,8 @@ pub fn normalize_report_envelope(env: &Value) -> NormalizedReportEnvelope {
         risks: normalize_risks(env.get("risks")),
         artifacts: normalize_artifacts(env.get("artifacts")),
         next_actions: normalize_next_actions(env.get("next_actions")),
+        presentation,
+        presentation_error,
     }
 }
 

package/crates/team-agent/src/mcp_server/tests/wire.rs

@@ -79,7 +79,7 @@ fn tools_contract_has_thirteen_tools_in_order() {
         .unwrap();
     assert_eq!(
             send["description"],
-            json!("Send a message to a teammate, the leader, or '*' for all other team members. Provide only target and content; Team Agent fills sender, task id, ack policy, and delivery metadata.")
+            json!("Send a message to a teammate, the leader, or '*' for all other team members. Team Agent fills identity and delivery metadata; optional presentation routing is durable and never drops the message.")
         );
     assert_eq!(send["inputSchema"]["additionalProperties"], json!(false));
     assert_eq!(send["inputSchema"]["required"], json!(["to", "content"]));