googlechatai 0.0.1__py3-none-any.whl

googlechatai/__init__.py

@@ -0,0 +1,403 @@
+"""Google Chat AI SDK Python package."""
+
+from .actions import normalize_action, render_action_system_notes
+from .agent_interop import normalize_agent_response, plan_agent_response_message
+from .attachments import (
+    CHAT_MEDIA_UPLOAD_MAX_BYTES,
+    DEFAULT_ATTACHMENT_DOWNLOAD_MAX_BYTES,
+    DEFAULT_DRIVE_EXPORT_MAX_BYTES,
+    DEFAULT_TRANSCRIPTION_MAX_BYTES,
+    DRIVE_READONLY_SCOPE,
+    classify_media_kind,
+    collect_attachments_from_context,
+    collect_drive_link_candidates,
+    create_drive_export_plan,
+    create_drive_link_retrieval_plan,
+    create_download_plan,
+    create_gemini_transcription_provider,
+    create_openai_transcription_provider,
+    create_upload_plan,
+    default_drive_export_mime_type,
+    evaluate_attachment_policy,
+    normalize_attachment,
+    normalize_attachments,
+    normalize_attachments_from_message,
+    plan_attachment_pipeline,
+    parse_attachment_content,
+    render_attachment_context_parts,
+    sanitize_filename,
+    summarize_transcription_evidence,
+    transcribe_audio,
+)
+from .cache import (
+    FileArtifactCache,
+    InMemoryArtifactCache,
+    build_artifact_cache_key,
+    build_negative_cache_entry,
+    hash_bytes,
+)
+from .capabilities import (
+    explain_chat_capability,
+    explain_google_chat_error,
+    plan_chat_permission,
+)
+from .chat_links import (
+    CHAT_APP_MESSAGES_READONLY_SCOPE,
+    CHAT_BOT_SCOPE,
+    CHAT_MESSAGES_READONLY_SCOPE,
+    CHAT_SPACES_READONLY_SCOPE,
+    build_chat_link_cache_key,
+    collect_chat_link_candidates,
+    create_chat_link_retrieval_plan,
+)
+from .cards import (
+    DEFAULT_CARD_ACTION_STATE_PARAMETER,
+    build_approval_card,
+    build_card_navigation_response,
+    build_card_message,
+    build_create_message_response,
+    build_dialog,
+    build_error_card,
+    build_feedback_accessory_message,
+    build_feedback_accessory_widgets,
+    build_feedback_card,
+    build_open_dialog_response,
+    build_progress_card,
+    build_sources_card,
+    build_streaming_status_card,
+    build_thinking_card,
+    build_tool_status_card,
+    build_update_card_response,
+    decode_card_action_state,
+    encode_card_action_state,
+    lint_card_payload,
+    push_card,
+    read_card_action_state,
+    render_card_action_note,
+    route_card_action,
+    summarize_card_action,
+    summarize_cards,
+    translate_card_payload,
+    update_card,
+    validate_card_message,
+    with_card_action_state,
+)
+from .events import InvalidChatEventError, normalize_event
+from .identity import (
+    DIRECTORY_USER_READONLY_SCOPE,
+    FileIdentityCache,
+    InMemoryIdentityCache,
+    build_directory_users_list_plan,
+    render_identity_system_note,
+    resolve_human_identity,
+    sync_directory_users_to_cache,
+)
+from .ingestion import plan_chat_ingestion, process_polling_ingestion_page
+from .message_ast import normalize_message
+from .messages import (
+    build_buffered_stream_patches,
+    build_update_mask,
+    generate_client_message_id,
+    generate_request_id,
+    hydrate_placeholder_response_handle,
+    InMemoryAsyncResponseQueue,
+    plan_async_response,
+    plan_buffered_placeholder_completion,
+    plan_buffered_stream_message,
+    plan_complete_placeholder_response,
+    plan_delete_app_message,
+    plan_edit_message,
+    plan_find_or_setup_dm,
+    plan_placeholder_response,
+    plan_reply_in_thread,
+    plan_reply_to_event,
+    plan_replace_cards,
+    plan_search_messages,
+    plan_send_to_space,
+    plan_send_to_user,
+    plan_start_thread,
+    plan_stream_message,
+    resolve_reply_target,
+    select_placeholder_text,
+)
+from .reactions import (
+    CHAT_REACTIONS_READONLY_SCOPE,
+    CHAT_REACTIONS_SCOPE,
+    build_reaction_filter_for_emoji,
+    feedback_rating_to_emoji,
+    plan_add_reaction,
+    plan_delete_reaction,
+    plan_feedback_reaction,
+    plan_list_reactions,
+)
+from .router import ChatResponse, GoogleChatAI, HandlerContext, ReplyBuilder, json_response
+from .threads import (
+    build_conversation_context,
+    build_conversation_context_with_identity,
+    plan_read_space_context,
+    plan_read_thread_context,
+    render_ai_context,
+)
+from .transport import (
+    DuplicateEventGuardResult,
+    FileIdempotencyStore,
+    IdempotencyClaim,
+    InMemoryIdempotencyStore,
+    RetryDecision,
+    RetryDecisionInput,
+    RetryPolicyOptions,
+    RetryingChatClient,
+    RetryingJsonResponse,
+    build_retry_decision,
+    create_retrying_chat_client,
+    guard_duplicate_event_delivery,
+    is_replay_safe,
+    parse_retry_after_ms,
+    request_json_with_retry,
+)
+from .execute import (
+    CHAT_API_BASE_URL,
+    DEFAULT_PLACEHOLDER_RESOLVERS,
+    execute_chat_plan,
+)
+from .pins import (
+    CHAT_PIN_DOCS_LISTED_NOTE,
+    PIN_MESSAGES_SCOPE,
+    plan_ensure_message_pinned,
+    plan_list_message_pins,
+    plan_pin_message,
+    plan_unpin_message,
+)
+from .queues import (
+    AsyncResponseQueue,
+    CloudTasksQueueAdapter,
+    FileAsyncResponseQueue,
+    PubSubQueueAdapter,
+)
+from .streaming import (
+    FileStreamCancellationRegistry,
+    InMemoryStreamCancellationRegistry,
+    advance_stream_scheduler,
+    astream_chat_reply,
+    create_chat_request_applier,
+    create_stream_scheduler_state,
+    replay_stream_scheduler,
+    stream_chat_reply,
+)
+from .token_store import (
+    FileTokenStore,
+    InMemoryTokenStore,
+    SecretManagerTokenStore,
+    TokenRecord,
+    TokenStore,
+    get_access_token_from_store,
+)
+from .verify import (
+    GOOGLE_CHAT_JWKS_URL,
+    GOOGLE_CHAT_TOKEN_ISSUER,
+    GOOGLE_OIDC_ISSUERS,
+    GOOGLE_OIDC_JWKS_URL,
+    GoogleChatTokenVerifier,
+    bearer_token_from_authorization,
+    create_google_chat_token_verifier,
+    create_pubsub_push_verifier,
+    decode_jwt_without_verifying,
+    verify_chat_request_authorization,
+    verify_google_chat_token,
+)
+from .workspace_events import (
+    FileWorkspaceEventsCheckpointStore,
+    InMemoryWorkspaceEventsCheckpointStore,
+    parse_pubsub_pull_payload,
+    parse_pubsub_push_payload,
+    parse_workspace_chat_resource_event,
+)
+
+__all__ = [
+    "CHAT_API_BASE_URL",
+    "DEFAULT_PLACEHOLDER_RESOLVERS",
+    "execute_chat_plan",
+    "CHAT_PIN_DOCS_LISTED_NOTE",
+    "PIN_MESSAGES_SCOPE",
+    "plan_ensure_message_pinned",
+    "plan_list_message_pins",
+    "plan_pin_message",
+    "plan_unpin_message",
+    "AsyncResponseQueue",
+    "CloudTasksQueueAdapter",
+    "FileAsyncResponseQueue",
+    "PubSubQueueAdapter",
+    "FileStreamCancellationRegistry",
+    "InMemoryStreamCancellationRegistry",
+    "advance_stream_scheduler",
+    "astream_chat_reply",
+    "create_chat_request_applier",
+    "create_stream_scheduler_state",
+    "replay_stream_scheduler",
+    "stream_chat_reply",
+    "FileTokenStore",
+    "InMemoryTokenStore",
+    "SecretManagerTokenStore",
+    "TokenRecord",
+    "TokenStore",
+    "get_access_token_from_store",
+    "GOOGLE_CHAT_JWKS_URL",
+    "GOOGLE_CHAT_TOKEN_ISSUER",
+    "GOOGLE_OIDC_ISSUERS",
+    "GOOGLE_OIDC_JWKS_URL",
+    "GoogleChatTokenVerifier",
+    "bearer_token_from_authorization",
+    "create_google_chat_token_verifier",
+    "create_pubsub_push_verifier",
+    "decode_jwt_without_verifying",
+    "verify_chat_request_authorization",
+    "verify_google_chat_token",
+    "plan_replace_cards",
+    "plan_search_messages",
+    "ChatResponse",
+    "CHAT_MEDIA_UPLOAD_MAX_BYTES",
+    "CHAT_APP_MESSAGES_READONLY_SCOPE",
+    "CHAT_BOT_SCOPE",
+    "CHAT_MESSAGES_READONLY_SCOPE",
+    "CHAT_REACTIONS_READONLY_SCOPE",
+    "CHAT_REACTIONS_SCOPE",
+    "CHAT_SPACES_READONLY_SCOPE",
+    "DIRECTORY_USER_READONLY_SCOPE",
+    "DEFAULT_ATTACHMENT_DOWNLOAD_MAX_BYTES",
+    "DEFAULT_CARD_ACTION_STATE_PARAMETER",
+    "DEFAULT_DRIVE_EXPORT_MAX_BYTES",
+    "DEFAULT_TRANSCRIPTION_MAX_BYTES",
+    "DRIVE_READONLY_SCOPE",
+    "DuplicateEventGuardResult",
+    "FileArtifactCache",
+    "FileIdentityCache",
+    "FileWorkspaceEventsCheckpointStore",
+    "FileIdempotencyStore",
+    "GoogleChatAI",
+    "HandlerContext",
+    "IdempotencyClaim",
+    "InMemoryArtifactCache",
+    "InMemoryIdentityCache",
+    "InMemoryIdempotencyStore",
+    "InMemoryWorkspaceEventsCheckpointStore",
+    "InvalidChatEventError",
+    "ReplyBuilder",
+    "RetryDecision",
+    "RetryDecisionInput",
+    "RetryPolicyOptions",
+    "RetryingChatClient",
+    "RetryingJsonResponse",
+    "build_approval_card",
+    "build_artifact_cache_key",
+    "build_card_navigation_response",
+    "build_card_message",
+    "build_create_message_response",
+    "build_conversation_context",
+    "build_conversation_context_with_identity",
+    "build_directory_users_list_plan",
+    "build_dialog",
+    "build_error_card",
+    "build_feedback_accessory_message",
+    "build_feedback_accessory_widgets",
+    "build_feedback_card",
+    "build_buffered_stream_patches",
+    "build_chat_link_cache_key",
+    "build_open_dialog_response",
+    "build_progress_card",
+    "build_sources_card",
+    "build_streaming_status_card",
+    "build_thinking_card",
+    "build_tool_status_card",
+    "build_retry_decision",
+    "build_negative_cache_entry",
+    "build_reaction_filter_for_emoji",
+    "build_update_card_response",
+    "build_update_mask",
+    "classify_media_kind",
+    "collect_attachments_from_context",
+    "collect_drive_link_candidates",
+    "collect_chat_link_candidates",
+    "create_drive_export_plan",
+    "create_drive_link_retrieval_plan",
+    "create_download_plan",
+    "create_gemini_transcription_provider",
+    "create_openai_transcription_provider",
+    "create_retrying_chat_client",
+    "create_upload_plan",
+    "create_chat_link_retrieval_plan",
+    "decode_card_action_state",
+    "default_drive_export_mime_type",
+    "encode_card_action_state",
+    "evaluate_attachment_policy",
+    "explain_chat_capability",
+    "explain_google_chat_error",
+    "generate_client_message_id",
+    "generate_request_id",
+    "guard_duplicate_event_delivery",
+    "hash_bytes",
+    "lint_card_payload",
+    "hydrate_placeholder_response_handle",
+    "feedback_rating_to_emoji",
+    "is_replay_safe",
+    "json_response",
+    "normalize_action",
+    "normalize_agent_response",
+    "normalize_attachment",
+    "normalize_attachments",
+    "normalize_attachments_from_message",
+    "normalize_event",
+    "normalize_message",
+    "plan_attachment_pipeline",
+    "parse_pubsub_pull_payload",
+    "parse_attachment_content",
+    "parse_retry_after_ms",
+    "parse_pubsub_push_payload",
+    "parse_workspace_chat_resource_event",
+    "InMemoryAsyncResponseQueue",
+    "plan_async_response",
+    "plan_buffered_placeholder_completion",
+    "plan_add_reaction",
+    "plan_agent_response_message",
+    "plan_chat_ingestion",
+    "plan_delete_app_message",
+    "plan_delete_reaction",
+    "plan_buffered_stream_message",
+    "plan_chat_permission",
+    "plan_complete_placeholder_response",
+    "plan_edit_message",
+    "plan_feedback_reaction",
+    "plan_find_or_setup_dm",
+    "plan_list_reactions",
+    "plan_placeholder_response",
+    "plan_read_space_context",
+    "plan_read_thread_context",
+    "plan_reply_in_thread",
+    "plan_reply_to_event",
+    "plan_send_to_space",
+    "plan_send_to_user",
+    "plan_start_thread",
+    "plan_stream_message",
+    "resolve_reply_target",
+    "push_card",
+    "process_polling_ingestion_page",
+    "read_card_action_state",
+    "render_card_action_note",
+    "request_json_with_retry",
+    "render_action_system_notes",
+    "render_attachment_context_parts",
+    "render_ai_context",
+    "render_identity_system_note",
+    "resolve_human_identity",
+    "route_card_action",
+    "select_placeholder_text",
+    "summarize_card_action",
+    "summarize_cards",
+    "summarize_transcription_evidence",
+    "sanitize_filename",
+    "sync_directory_users_to_cache",
+    "transcribe_audio",
+    "translate_card_payload",
+    "update_card",
+    "validate_card_message",
+    "with_card_action_state",
+]