@xfey/tutti 0.1.111 → 0.1.113

package/node_modules/@tutti/shared/dist/schemas/internal/platform-clarification.d.ts

@@ -0,0 +1,354 @@
+import { type Static } from "@sinclair/typebox";
+import type { SubmitClarificationRoundResponse } from "../api/types.js";
+export declare const INTEGRATION_CLARIFICATION_TUNNEL_PATH = "/internal/integration/v1/clarification";
+export declare const INTEGRATION_CLARIFICATION_CONTROL_PATH = "/integration-control/v1/projects/:relayProjectRef/clarification";
+export declare const IntegrationClarificationRequestSchema: import("@sinclair/typebox").TObject<{
+    protocol_version: import("@sinclair/typebox").TLiteral<1>;
+    command_id: import("@sinclair/typebox").TString;
+    relay_project_ref: import("@sinclair/typebox").TString;
+    binding_ref: import("@sinclair/typebox").TString;
+    operation_ref: import("@sinclair/typebox").TString;
+    conversation: import("@sinclair/typebox").TObject<{
+        installation: import("@sinclair/typebox").TObject<{
+            platform: import("@sinclair/typebox").TString;
+            installation_ref: import("@sinclair/typebox").TString;
+        }>;
+        conversation_ref: import("@sinclair/typebox").TString;
+        thread_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        parent_message_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        root_message_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    external_subject: import("@sinclair/typebox").TObject<{
+        installation: import("@sinclair/typebox").TObject<{
+            platform: import("@sinclair/typebox").TString;
+            installation_ref: import("@sinclair/typebox").TString;
+        }>;
+        subject_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"app">, import("@sinclair/typebox").TLiteral<"system">]>;
+        subject_ref: import("@sinclair/typebox").TString;
+    }>;
+    origin: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"development_operator">;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"card_callback">;
+        message_ref: import("@sinclair/typebox").TString;
+        action_ref: import("@sinclair/typebox").TString;
+    }>]>;
+    operation: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"query">;
+        round_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"submit">;
+        round_id: import("@sinclair/typebox").TString;
+        expected_answer_revision: import("@sinclair/typebox").TInteger;
+    }>]>;
+}>;
+export declare const TrustedClarificationCommandSchema: import("@sinclair/typebox").TObject<{
+    actor: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"human">;
+        account_ref: import("@sinclair/typebox").TString;
+        display_name: import("@sinclair/typebox").TString;
+        membership: import("@sinclair/typebox").TObject<{
+            relay_project_ref: import("@sinclair/typebox").TString;
+            label: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"owner">, import("@sinclair/typebox").TLiteral<"member">]>;
+        }>;
+        channel: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"platform_chat">, import("@sinclair/typebox").TLiteral<"platform_h5">, import("@sinclair/typebox").TLiteral<"platform_card_callback">, import("@sinclair/typebox").TLiteral<"platform_document_sync">]>;
+        external_subject: import("@sinclair/typebox").TObject<{
+            installation: import("@sinclair/typebox").TObject<{
+                platform: import("@sinclair/typebox").TString;
+                installation_ref: import("@sinclair/typebox").TString;
+            }>;
+            subject_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"app">, import("@sinclair/typebox").TLiteral<"system">]>;
+            subject_ref: import("@sinclair/typebox").TString;
+        }>;
+        binding_ref: import("@sinclair/typebox").TString;
+        verified_at: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"bot">;
+        purpose: import("@sinclair/typebox").TLiteral<"development_operator">;
+        channel: import("@sinclair/typebox").TLiteral<"platform_chat">;
+        account_ref: import("@sinclair/typebox").TString;
+        display_name: import("@sinclair/typebox").TString;
+        membership: import("@sinclair/typebox").TObject<{
+            relay_project_ref: import("@sinclair/typebox").TString;
+            label: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"owner">, import("@sinclair/typebox").TLiteral<"member">]>;
+        }>;
+        external_subject: import("@sinclair/typebox").TObject<{
+            installation: import("@sinclair/typebox").TObject<{
+                platform: import("@sinclair/typebox").TString;
+                installation_ref: import("@sinclair/typebox").TString;
+            }>;
+            subject_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"app">, import("@sinclair/typebox").TLiteral<"system">]>;
+            subject_ref: import("@sinclair/typebox").TString;
+        }>;
+        binding_ref: import("@sinclair/typebox").TString;
+        verified_at: import("@sinclair/typebox").TString;
+    }>]>;
+    protocol_version: import("@sinclair/typebox").TLiteral<1>;
+    command_id: import("@sinclair/typebox").TString;
+    relay_project_ref: import("@sinclair/typebox").TString;
+    binding_ref: import("@sinclair/typebox").TString;
+    operation_ref: import("@sinclair/typebox").TString;
+    conversation: import("@sinclair/typebox").TObject<{
+        installation: import("@sinclair/typebox").TObject<{
+            platform: import("@sinclair/typebox").TString;
+            installation_ref: import("@sinclair/typebox").TString;
+        }>;
+        conversation_ref: import("@sinclair/typebox").TString;
+        thread_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        parent_message_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        root_message_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    external_subject: import("@sinclair/typebox").TObject<{
+        installation: import("@sinclair/typebox").TObject<{
+            platform: import("@sinclair/typebox").TString;
+            installation_ref: import("@sinclair/typebox").TString;
+        }>;
+        subject_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"bot">, import("@sinclair/typebox").TLiteral<"app">, import("@sinclair/typebox").TLiteral<"system">]>;
+        subject_ref: import("@sinclair/typebox").TString;
+    }>;
+    origin: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"development_operator">;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"card_callback">;
+        message_ref: import("@sinclair/typebox").TString;
+        action_ref: import("@sinclair/typebox").TString;
+    }>]>;
+    operation: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"query">;
+        round_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"submit">;
+        round_id: import("@sinclair/typebox").TString;
+        expected_answer_revision: import("@sinclair/typebox").TInteger;
+    }>]>;
+}>;
+export declare const IntegrationClarificationResponseSchema: import("@sinclair/typebox").TObject<{
+    protocol_version: import("@sinclair/typebox").TLiteral<1>;
+    disposition: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"queried">;
+        active: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            state: import("@sinclair/typebox").TLiteral<"none">;
+        }>, import("@sinclair/typebox").TObject<{
+            state: import("@sinclair/typebox").TLiteral<"active">;
+            thread: import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                owner: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"task_compile">;
+                    workflow_ref: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"task">;
+                    task_id: import("@sinclair/typebox").TString;
+                }>]>;
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"closed">]>;
+                current_round_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                created_from_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                closed_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"resolved">, import("@sinclair/typebox").TLiteral<"contract_changed">, import("@sinclair/typebox").TLiteral<"cancelled">]>>;
+                created_at: import("@sinclair/typebox").TString;
+                updated_at: import("@sinclair/typebox").TString;
+            }>;
+            round: import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                thread_id: import("@sinclair/typebox").TString;
+                round_index: import("@sinclair/typebox").TInteger;
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"writable">, import("@sinclair/typebox").TLiteral<"sealed">]>;
+                request_payload: import("@sinclair/typebox").TObject<{
+                    summary: import("@sinclair/typebox").TString;
+                    request: import("@sinclair/typebox").TString;
+                    interaction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        kind: import("@sinclair/typebox").TLiteral<"freeform">;
+                        purpose: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"clarify_requirement">, import("@sinclair/typebox").TLiteral<"confirm_risk">]>;
+                        prompt: import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TString;
+                            request: import("@sinclair/typebox").TString;
+                        }>;
+                        subject: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"deployment_target">, import("@sinclair/typebox").TLiteral<"project_context">]>;
+                            ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TString;
+                        }>>;
+                        expires_when: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"current_run_only">, import("@sinclair/typebox").TLiteral<"until_task_contract_changes">]>>;
+                    }>>;
+                    title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    related_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"project_doc">;
+                        path: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"directory_readme">;
+                        path: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"task_detail">;
+                        task_id: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"worklist">;
+                        module_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"scratchpad">;
+                        id: import("@sinclair/typebox").TLiteral<"current">;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"clarification_round">;
+                        clarification_round_ref: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"chat_messages">;
+                        message_refs: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"repo_paths">;
+                        paths: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"recovery_summary">;
+                        recovery_summary_id: import("@sinclair/typebox").TString;
+                    }>]>>>;
+                }>;
+                card_message_id: import("@sinclair/typebox").TString;
+                opening_message_id: import("@sinclair/typebox").TString;
+                answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
+                successor_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"next_round">;
+                    clarification_round_ref: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"run">;
+                    activity_ref: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"chain_closed">;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"proposal_applied">;
+                    workflow_ref: import("@sinclair/typebox").TString;
+                }>]>>;
+                capabilities: import("@sinclair/typebox").TObject<{
+                    send_message: import("@sinclair/typebox").TBoolean;
+                    submit: import("@sinclair/typebox").TBoolean;
+                }>;
+                created_at: import("@sinclair/typebox").TString;
+                updated_at: import("@sinclair/typebox").TString;
+            }>;
+        }>]>;
+        selected: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            thread: import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                owner: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"task_compile">;
+                    workflow_ref: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"task">;
+                    task_id: import("@sinclair/typebox").TString;
+                }>]>;
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"closed">]>;
+                current_round_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                created_from_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                closed_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"resolved">, import("@sinclair/typebox").TLiteral<"contract_changed">, import("@sinclair/typebox").TLiteral<"cancelled">]>>;
+                created_at: import("@sinclair/typebox").TString;
+                updated_at: import("@sinclair/typebox").TString;
+            }>;
+            round: import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                thread_id: import("@sinclair/typebox").TString;
+                round_index: import("@sinclair/typebox").TInteger;
+                status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"writable">, import("@sinclair/typebox").TLiteral<"sealed">]>;
+                request_payload: import("@sinclair/typebox").TObject<{
+                    summary: import("@sinclair/typebox").TString;
+                    request: import("@sinclair/typebox").TString;
+                    interaction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        kind: import("@sinclair/typebox").TLiteral<"freeform">;
+                        purpose: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"clarify_requirement">, import("@sinclair/typebox").TLiteral<"confirm_risk">]>;
+                        prompt: import("@sinclair/typebox").TObject<{
+                            title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TString;
+                            request: import("@sinclair/typebox").TString;
+                        }>;
+                        subject: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"deployment_target">, import("@sinclair/typebox").TLiteral<"project_context">]>;
+                            ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                            summary: import("@sinclair/typebox").TString;
+                        }>>;
+                        expires_when: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"current_run_only">, import("@sinclair/typebox").TLiteral<"until_task_contract_changes">]>>;
+                    }>>;
+                    title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    related_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"project_doc">;
+                        path: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"directory_readme">;
+                        path: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"task_detail">;
+                        task_id: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"worklist">;
+                        module_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"scratchpad">;
+                        id: import("@sinclair/typebox").TLiteral<"current">;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"clarification_round">;
+                        clarification_round_ref: import("@sinclair/typebox").TString;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"chat_messages">;
+                        message_refs: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"repo_paths">;
+                        paths: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+                    }>, import("@sinclair/typebox").TObject<{
+                        ref_kind: import("@sinclair/typebox").TLiteral<"recovery_summary">;
+                        recovery_summary_id: import("@sinclair/typebox").TString;
+                    }>]>>>;
+                }>;
+                card_message_id: import("@sinclair/typebox").TString;
+                opening_message_id: import("@sinclair/typebox").TString;
+                answer_revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                submitted_message_refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+                successor_status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"not_materialized">, import("@sinclair/typebox").TLiteral<"materialized">]>;
+                successor_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"next_round">;
+                    clarification_round_ref: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"run">;
+                    activity_ref: import("@sinclair/typebox").TString;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"chain_closed">;
+                }>, import("@sinclair/typebox").TObject<{
+                    kind: import("@sinclair/typebox").TLiteral<"proposal_applied">;
+                    workflow_ref: import("@sinclair/typebox").TString;
+                }>]>>;
+                capabilities: import("@sinclair/typebox").TObject<{
+                    send_message: import("@sinclair/typebox").TBoolean;
+                    submit: import("@sinclair/typebox").TBoolean;
+                }>;
+                created_at: import("@sinclair/typebox").TString;
+                updated_at: import("@sinclair/typebox").TString;
+            }>;
+        }>>;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"submitted">;
+        response: import("@sinclair/typebox").TSchema;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"invalid">, import("@sinclair/typebox").TLiteral<"unauthorized">]>;
+        reason_code: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TLiteral<"unavailable">;
+        retryable: import("@sinclair/typebox").TBoolean;
+        reason_code: import("@sinclair/typebox").TString;
+    }>]>;
+}>;
+export type IntegrationClarificationRequest = Static<typeof IntegrationClarificationRequestSchema>;
+export type TrustedClarificationCommand = Static<typeof TrustedClarificationCommandSchema>;
+type StaticResponse = Static<typeof IntegrationClarificationResponseSchema>;
+export type IntegrationClarificationResponse = {
+    protocol_version: 1;
+    disposition: Exclude<StaticResponse["disposition"], {
+        kind: "submitted";
+    }> | {
+        kind: "submitted";
+        response: SubmitClarificationRoundResponse;
+    };
+};
+export declare function isIntegrationClarificationRequest(value: unknown): value is IntegrationClarificationRequest;
+export declare function isTrustedClarificationCommand(value: unknown): value is TrustedClarificationCommand;
+export declare function isIntegrationClarificationResponse(value: unknown): value is IntegrationClarificationResponse;
+export {};
+//# sourceMappingURL=platform-clarification.d.ts.map

package/node_modules/@tutti/shared/dist/schemas/internal/platform-clarification.js

@@ -0,0 +1,94 @@
+import { Type } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
+import { ClarificationRoundRefSchema, IdempotencyKeySchema, RelayProjectRefSchema, } from "../domain/index.js";
+import { ActiveClarificationProjectionSchema, GetClarificationRoundResponseSchema, SubmitClarificationRoundResponseSchema, } from "../api/clarifications.js";
+import { ExternalObjectRefSchema, ExternalSubjectLocatorSchema, IntegrationOwnedRefSchema, PlatformConversationLocatorSchema, TrustedDevelopmentBotActorContextSchema, TrustedHumanIntegrationActorContextSchema, } from "./platform-integration.js";
+export const INTEGRATION_CLARIFICATION_TUNNEL_PATH = "/internal/integration/v1/clarification";
+export const INTEGRATION_CLARIFICATION_CONTROL_PATH = "/integration-control/v1/projects/:relayProjectRef/clarification";
+const requestProperties = {
+    protocol_version: Type.Literal(1),
+    command_id: IdempotencyKeySchema,
+    relay_project_ref: RelayProjectRefSchema,
+    binding_ref: IntegrationOwnedRefSchema,
+    operation_ref: IntegrationOwnedRefSchema,
+    conversation: PlatformConversationLocatorSchema,
+    external_subject: ExternalSubjectLocatorSchema,
+    origin: Type.Union([
+        Type.Object({ kind: Type.Literal("development_operator") }, { additionalProperties: false }),
+        Type.Object({
+            kind: Type.Literal("card_callback"),
+            message_ref: ExternalObjectRefSchema,
+            action_ref: IntegrationOwnedRefSchema,
+        }, { additionalProperties: false }),
+    ]),
+    operation: Type.Union([
+        Type.Object({ kind: Type.Literal("query"), round_id: Type.Optional(ClarificationRoundRefSchema) }, { additionalProperties: false }),
+        Type.Object({
+            kind: Type.Literal("submit"),
+            round_id: ClarificationRoundRefSchema,
+            expected_answer_revision: Type.Integer({ minimum: 0 }),
+        }, { additionalProperties: false }),
+    ]),
+};
+export const IntegrationClarificationRequestSchema = Type.Object(requestProperties, {
+    additionalProperties: false,
+});
+export const TrustedClarificationCommandSchema = Type.Object({
+    ...requestProperties,
+    actor: Type.Union([
+        TrustedHumanIntegrationActorContextSchema,
+        TrustedDevelopmentBotActorContextSchema,
+    ]),
+}, { additionalProperties: false });
+export const IntegrationClarificationResponseSchema = Type.Object({
+    protocol_version: Type.Literal(1),
+    disposition: Type.Union([
+        Type.Object({
+            kind: Type.Literal("queried"),
+            active: ActiveClarificationProjectionSchema,
+            selected: Type.Optional(GetClarificationRoundResponseSchema),
+        }, { additionalProperties: false }),
+        Type.Object({ kind: Type.Literal("submitted"), response: SubmitClarificationRoundResponseSchema }, { additionalProperties: false }),
+        Type.Object({
+            kind: Type.Union([Type.Literal("invalid"), Type.Literal("unauthorized")]),
+            reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+        }, { additionalProperties: false }),
+        Type.Object({
+            kind: Type.Literal("unavailable"),
+            retryable: Type.Boolean(),
+            reason_code: Type.String({ minLength: 1, maxLength: 128 }),
+        }, { additionalProperties: false }),
+    ]),
+}, { additionalProperties: false });
+function validRequest(value) {
+    const installation = value.conversation.installation;
+    const subject = value.external_subject;
+    return (installation.platform === "feishu" &&
+        subject.installation.platform === installation.platform &&
+        subject.installation.installation_ref === installation.installation_ref &&
+        (value.origin.kind === "development_operator"
+            ? subject.subject_kind === "bot"
+            : subject.subject_kind === "human" && value.operation.kind === "submit"));
+}
+export function isIntegrationClarificationRequest(value) {
+    return Value.Check(IntegrationClarificationRequestSchema, value) && validRequest(value);
+}
+export function isTrustedClarificationCommand(value) {
+    if (!Value.Check(TrustedClarificationCommandSchema, value) || !validRequest(value))
+        return false;
+    const actor = value.actor;
+    return (actor.binding_ref === value.binding_ref &&
+        actor.membership.relay_project_ref === value.relay_project_ref &&
+        actor.external_subject.subject_ref === value.external_subject.subject_ref &&
+        actor.external_subject.subject_kind === value.external_subject.subject_kind &&
+        actor.external_subject.installation.platform === value.conversation.installation.platform &&
+        actor.external_subject.installation.installation_ref ===
+            value.conversation.installation.installation_ref &&
+        (value.origin.kind === "development_operator"
+            ? actor.kind === "bot" && actor.membership.label === "member"
+            : actor.kind === "human" && actor.channel === "platform_card_callback"));
+}
+export function isIntegrationClarificationResponse(value) {
+    return Value.Check(IntegrationClarificationResponseSchema, value);
+}
+//# sourceMappingURL=platform-clarification.js.map