@ai-matrx/associations 0.10.6 → 0.11.0

package/dist/index.d.cts

@@ -2,6 +2,18 @@ import { ElementType, ComponentType, ReactNode } from 'react';
 
 declare const ASSOCIATION_TARGET_TYPES: readonly ["organization", "scope", "scope_type", "project", "task", "context_item", "thread", "war_room", "category", "conversation", "fc_set", "fc_card", "study_media", "assessment", "note", "file", "quiz_session", "agent", "agent_term_list", "research_tag", "skill", "surface", "plan_entity", "plan_node", "web_site", "seo_topic", "seo_keyword", "web_page", "web_screenshot", "party", "crm_outreach_list", "crm_deal", "rulebook"];
 type AssociationTargetType = (typeof ASSOCIATION_TARGET_TYPES)[number];
+/** Runtime guard: is this token one of the deliberate container (target) types? */
+declare function isAssociationTargetType(value: unknown): value is AssociationTargetType;
+/**
+ * Which edges a primary entity's association surfaces read and write.
+ *  - `incoming` (default) — the primary is a CONTAINER: it lists what is
+ *    attached INTO it (`resource → primary`) and "+" attaches resources to it.
+ *  - `outgoing` — the primary is FILED UNDER things (a Source under a project,
+ *    a research topic, a Library): it lists its own `primary → container`
+ *    edges and "+" files it under a container. Only container (target) types
+ *    can be filed under.
+ */
+type AssociationDirection = "incoming" | "outgoing";
 interface AssociationEdge {
     id: string;
     direction: "outgoing" | "incoming";
@@ -501,7 +513,7 @@ interface EntityTypeMeta {
  */
 type EntityTypeToken = "access_delta_probe" | "access_delta_run" | "access_request" | "account_addon" | "acquisition_block" | "activity" | "admin_audit_log" | "admin_email_log" | "admin_markdown_sample" | "admin_user" | "admission_config" | "agent" | "agent_card" | "agent_definition_version" | "agent_drift_alert" | "agent_exemplar" | "agent_mandate_note" | "agent_prompt_remediation" | "agent_run" | "agent_run_stage" | "agent_schedule" | "agent_schedule_claim" | "agent_shortcut" | "agent_surface_binding" | "agent_template" | "agent_term_list" | "agent_usage" | "ai_api" | "ai_endpoint" | "ai_model" | "ai_model_alias" | "ai_offering" | "ai_provider" | "ai_setting" | "analysis_result" | "anon_form" | "anon_function_birth_grandfather" | "anon_hit" | "anon_inbound" | "anon_replay" | "anon_submission" | "anon_token" | "api_field_warning" | "api_request_log" | "app" | "app_config" | "app_config_history" | "app_definition_version" | "app_error" | "app_execution" | "app_instance" | "app_log" | "app_log_muted_pattern" | "app_log_norm_exception" | "app_rate_limit" | "app_setting" | "app_sync_status" | "approach" | "artifact" | "assessment" | "assessment_item" | "assessment_result" | "assignment_session" | "assist" | "assist_producer_policy" | "assist_producer_policy_history" | "association_type" | "assurance_level" | "attempt" | "audit_broken_functions" | "audit_canonical_findings" | "audit_exemption" | "audit_function_deps" | "audit_function_runtime_probe" | "audit_m2m_candidates" | "audit_refresh_log" | "audit_stale_registry" | "audit_unregistered_candidates" | "base_entity_template" | "batch_cost_event" | "batch_provider_batch" | "batch_work_item" | "billing_capability" | "billing_capability_limit" | "billing_connect_account" | "billing_customer" | "billing_plan" | "billing_plan_limit" | "billing_price" | "billing_product" | "billing_spend_guardrail" | "billing_stripe_event" | "billing_subscription" | "billing_usage_ledger" | "billing_user_plan" | "browser_account_binding" | "browser_action_event" | "browser_authenticator_window" | "browser_capture" | "browser_control_request" | "browser_handoff" | "browser_login_attempt" | "browser_login_recipe" | "browser_profile" | "browser_profile_checkpoint" | "browser_run" | "browser_site_observation" | "browser_site_policy" | "browser_stream_ticket" | "build_lock" | "calendar_event" | "canvas_comment" | "canvas_comment_like" | "canvas_item" | "canvas_item_state" | "canvas_like" | "canvas_score" | "canvas_view" | "capture_window" | "carrying_rule" | "catalog_entries_history" | "catalog_entry" | "category" | "change_type_default" | "chat_user_usage_summary" | "citations" | "class_purchase" | "classifier_revision_ledger" | "client_callable_door" | "client_callable_door_retirement" | "client_excluded_column_unregistered" | "cmp_entry" | "cmp_feedback" | "code_file" | "code_folder" | "code_repository" | "coding_session" | "coding_session_entry" | "comment" | "commerce_asset_allocation" | "commerce_asset_grading" | "commerce_asset_identifier" | "commerce_asset_lot_event" | "commerce_asset_mandate_result" | "commerce_asset_price_factor" | "commerce_asset_reshoot_request" | "commerce_asset_review" | "commerce_asset_unknown" | "commerce_certified_printer" | "commerce_cloud_sync_connection" | "commerce_ebay_business_policy" | "commerce_ebay_category" | "commerce_ebay_category_aspect" | "commerce_ebay_category_tree" | "commerce_ebay_custom_policy" | "commerce_ebay_inventory_item" | "commerce_ebay_inventory_item_group" | "commerce_ebay_inventory_item_group_member" | "commerce_ebay_inventory_location" | "commerce_ebay_listing" | "commerce_ebay_marketplace_policy" | "commerce_ebay_media_asset" | "commerce_ebay_notification_destination" | "commerce_ebay_notification_event" | "commerce_ebay_notification_subscription" | "commerce_ebay_notification_topic" | "commerce_ebay_offer" | "commerce_ebay_order" | "commerce_ebay_order_line_item" | "commerce_ebay_shipping_fulfillment" | "commerce_ebay_store_category" | "commerce_human_correction" | "commerce_intake_artifact" | "commerce_intake_asset" | "commerce_intake_batch" | "commerce_label_batch" | "commerce_label_code" | "commerce_marketplace_account" | "commerce_marketplace_account_deletion_audit" | "commerce_marketplace_api_call" | "commerce_marketplace_rate_budget" | "commerce_marketplace_site" | "commerce_marketplace_sync_run" | "commerce_prediction_outcome" | "commerce_print_order" | "commerce_product" | "commerce_product_channel_ref" | "commerce_product_media" | "commerce_product_variant" | "commerce_recall_audit" | "comparison_set" | "contact_medium" | "contact_submission" | "content_certification" | "content_ir_kind" | "content_ir_kind_component" | "content_ir_kind_component_incident" | "content_ir_kind_conformance" | "content_ir_kind_edge" | "content_ir_kind_example" | "content_ir_kind_instance" | "content_ir_kind_surface" | "content_lane" | "context_access_log" | "context_item" | "context_item_suggestion" | "context_item_value" | "context_value_refs" | "conversation" | "conversation_value" | "courts" | "credential_attachment" | "credential_item" | "credential_mutation_receipt" | "crm_address" | "crm_affiliation" | "crm_blocklist_entry" | "crm_contact_candidate" | "crm_deal" | "crm_deal_stage_event" | "crm_enrichment_call" | "crm_interaction" | "crm_merge_candidate" | "crm_outreach_list" | "crm_outreach_list_member" | "crm_party_merge" | "crm_registry_ingest_run" | "crm_registry_source" | "crm_saved_view" | "crm_sending_event" | "crm_sending_identity" | "crm_sending_identity_check" | "crm_sending_policy" | "custom_entity_definition" | "custom_field_definition" | "custom_field_target" | "custom_record" | "cx_agent_memory" | "cx_agent_plan" | "cx_agent_task" | "cx_code_edit" | "cx_code_message_file" | "cx_media" | "cx_observational_memory" | "cx_observational_memory_event" | "cx_pending_injection" | "cx_request" | "cx_request_snapshot" | "cx_tool_trace" | "cx_user_request" | "cx_user_todo" | "data_rights_event" | "data_store" | "data_store_members" | "dataset" | "ddl_guard_log" | "deck_suggestion" | "definer_class_exemption" | "definer_client_grant_grandfather" | "definer_grant_baseline" | "deprecated_relation" | "derive_run" | "dev_login_audit" | "dict_entry" | "dict_provider_publication" | "dict_setting" | "dm_conversation" | "dm_message" | "dm_participant" | "doc_render" | "doc_signature" | "dockets" | "document" | "document_version" | "domain_classification" | "edge_payload_kind" | "egress_device" | "egress_pairing" | "egress_ticket" | "emails" | "embedding_cache" | "embeddings_google_gemini_2_1536" | "embeddings_oai_3_small_1536" | "embeddings_voyage_4_large_1024" | "embeddings_voyage_code_3_1024" | "endpoint_family_sweep_state" | "engine_owner_task" | "entity_grant" | "entity_relationship" | "entity_type" | "esign_campaign" | "esign_campaign_member" | "esign_consent_disclosure" | "esign_envelope" | "esign_envelope_certificate" | "esign_envelope_document" | "esign_envelope_event" | "esign_envelope_external_ref" | "esign_envelope_signer" | "esign_provider" | "esign_provider_binding" | "esign_signing_key" | "execution_event_cursor" | "extension_auth_code" | "external_link" | "external_source" | "extract_sweep_state" | "fc_card" | "fc_detail" | "fc_set" | "feature_doc" | "feature_knob" | "feedback_comments" | "feedback_user_messages" | "file" | "file_analysis" | "file_entities" | "file_overrides" | "file_page_annotations" | "file_pages" | "file_rag_job" | "file_version" | "files_account_tier" | "files_machine_written_prefix" | "files_sync_mapping" | "files_user_account" | "flexible_data" | "folder" | "function_contract" | "game_badge" | "game_result" | "game_room" | "global_execution" | "global_execution_checkpoint" | "global_execution_control" | "global_execution_event" | "global_meter_entry" | "global_origin" | "global_request" | "google_document" | "growth_loop_event" | "growth_loop_run" | "growth_loop_stage_run" | "guardian_link" | "guest_conversion_audit" | "guest_execution_log" | "guest_executions" | "guided_checklist_run" | "heatmap_save" | "hindsight_enrollment" | "hindsight_finding" | "hindsight_regression_case" | "hindsight_replay" | "hindsight_replay_step" | "hindsight_review" | "hr_access_audit" | "hr_access_role" | "hr_accommodation_request" | "hr_ai_evidence" | "hr_alert_routing_rule" | "hr_application" | "hr_approval_authority" | "hr_approval_delegation" | "hr_asset" | "hr_asset_assignment" | "hr_attendance_exception" | "hr_auto_close_rule" | "hr_availability" | "hr_background_check" | "hr_benefits_event" | "hr_calculation_snapshot" | "hr_candidate" | "hr_candidate_conversion" | "hr_candidate_message" | "hr_careers_portal" | "hr_checklist_item" | "hr_checklist_run" | "hr_checklist_template" | "hr_checklist_template_item" | "hr_compensation" | "hr_corrective_action" | "hr_course" | "hr_course_version" | "hr_credential" | "hr_crew" | "hr_deduction_code" | "hr_department" | "hr_derived_grant" | "hr_disposition_event" | "hr_earning_code" | "hr_eeo_response" | "hr_emergency_contact" | "hr_employee" | "hr_employee_private" | "hr_employer_profile" | "hr_employment" | "hr_employment_pin" | "hr_engagement" | "hr_establishment" | "hr_external_identity" | "hr_field_policy" | "hr_holiday" | "hr_holiday_calendar" | "hr_i9" | "hr_i9_document" | "hr_incident" | "hr_incident_party" | "hr_interview" | "hr_interview_kit" | "hr_job_title" | "hr_jurisdiction" | "hr_jurisdiction_rule" | "hr_jurisdiction_rule_class" | "hr_jurisdiction_rule_org_decision" | "hr_jurisdiction_rule_test" | "hr_kiosk_device" | "hr_kiosk_session" | "hr_labor_target" | "hr_leave_case" | "hr_leave_enrollment" | "hr_leave_ledger" | "hr_leave_policy" | "hr_leave_request" | "hr_legal_hold" | "hr_legal_hold_item" | "hr_location" | "hr_new_hire_report" | "hr_offer" | "hr_opening" | "hr_overtime_alert" | "hr_overtime_alert_rule" | "hr_overtime_preapproval" | "hr_pay_group" | "hr_pay_period" | "hr_pay_period_employment" | "hr_payroll_export" | "hr_payroll_export_line" | "hr_position_assignment" | "hr_posting" | "hr_posting_publication" | "hr_provider_binding" | "hr_provider_event" | "hr_provisioning_result" | "hr_punch" | "hr_recalculation_batch" | "hr_record_class" | "hr_records_request" | "hr_reference_check" | "hr_reporting_line" | "hr_requisition" | "hr_restricted_note" | "hr_retention_rule" | "hr_role_assignment" | "hr_schedule" | "hr_schedule_change" | "hr_schedule_guidance" | "hr_schedule_template" | "hr_schedule_template_shift" | "hr_scorecard" | "hr_separation" | "hr_shift" | "hr_shift_claim" | "hr_staffing_requirement" | "hr_survey" | "hr_survey_invitation" | "hr_survey_question" | "hr_survey_response" | "hr_tax_registration" | "hr_tax_withholding" | "hr_time_adjustment" | "hr_training_assignment" | "hr_training_attempt" | "hr_transcript_entry" | "hr_verification_letter_request" | "hr_work_interval" | "hr_workflow_binding" | "hr_workflow_decision" | "hr_workflow_definition" | "hr_workflow_event" | "hr_workflow_failure" | "hr_workflow_flow_type" | "hr_workflow_instance" | "hr_workflow_step" | "hr_workflow_step_definition" | "hr_workweek" | "html_extraction" | "iam_access_audit" | "iam_api_key" | "iam_emergency_door_request" | "idempotency" | "industry" | "industry_curator" | "infra_status" | "ingest_runs" | "integration_connection" | "integration_connection_resource" | "interview_decision_interview" | "interview_decision_question" | "interview_document_revision" | "interview_hole" | "interview_question" | "interview_session" | "interview_turn" | "invitation" | "invitation_code" | "invitation_request" | "io_comment" | "io_contract" | "io_import" | "io_outbox" | "item" | "item_mastery" | "judge_verdict" | "jurisdiction_policy" | "keyword_classification_queue" | "kg_alert" | "kg_chunk_entities" | "kg_chunks" | "kg_clusters" | "kg_edges" | "kg_entities" | "kg_entity_aliases" | "kg_suggestion_ack" | "kg_sweep_queue" | "kg_sweep_run" | "kg_sweep_state" | "kg_value_match" | "knob_override" | "knob_override_audit" | "knob_rung_lock" | "knob_scope_kind" | "knob_write_door" | "league_membership" | "learn_doc" | "library_doc" | "lifecycle_archive" | "lifecycle_archive_row" | "lifecycle_audit" | "lifecycle_entity_plan" | "lifecycle_map_build" | "lifecycle_reference_map" | "lifecycle_run" | "lifecycle_tier_ledger" | "location" | "mandate" | "mandate_advance_batch_row" | "mandate_binding" | "mandate_goal_clauses" | "mandate_observation" | "mandate_reference" | "mandate_scan" | "mandate_treatment" | "marketing_initiative" | "masterwork_corpus_item" | "masterwork_run" | "masterwork_run_kind" | "masterwork_source" | "math_course_structure" | "math_problem" | "matrx_action_ledger" | "mcp_config" | "mcp_server" | "mcp_user_conn" | "media_capture_handoff" | "media_catalog_setting" | "media_library_item" | "media_selection_item" | "media_selection_job" | "media_source_library" | "meet_call_invite" | "meet_meeting" | "meet_note" | "meet_participant" | "meet_recording" | "meet_transcript_segment" | "membership" | "membership_grant" | "merge_field_provenance" | "message" | "message_template" | "message_template_detail" | "meta_excluded_schema" | "meta_table_stats_history" | "metadata_reserved_keys" | "migration_log" | "mtx_media_heal_queue" | "mtx_public_url_guard" | "ner_shadow" | "note" | "note_folder" | "notification" | "notification_channel_preference" | "notification_event_override" | "notification_event_type" | "notification_preference" | "notification_submission" | "notify_outsider_door_baseline" | "oauth_handoff_claim" | "opinion_clusters" | "opinions" | "ops_issue_class" | "ops_issue_event" | "ops_proof_check" | "ops_proof_run" | "ops_proof_scenario" | "org_admin_audit" | "org_change_policy" | "org_context_ledger" | "org_industries" | "org_member_control" | "org_module_config" | "org_plan" | "organization" | "organization_preferences" | "organization_visibility_version" | "output_feedback" | "outreach_acceptance" | "page_extraction_job" | "page_extraction_page_run" | "page_extraction_results" | "page_extraction_runs" | "page_intent_queue" | "page_mapping_queue" | "part_config" | "part_config_sub" | "party" | "party_contact_point" | "passkey_credential" | "pc_article" | "pc_episode" | "pc_show" | "pc_studio_run" | "pc_studio_run_asset" | "pdf_consolidation_log" | "pdf_redaction_audit" | "pdf_redaction_key_escrow" | "permission_grant" | "plan_cms_fill_item" | "plan_cms_fill_job" | "plan_entity" | "plan_node" | "plan_node_artifact" | "plan_node_step" | "plan_profile" | "platform_action_request" | "platform_actor_session" | "platform_actor_token" | "platform_actor_token_event" | "platform_continued_access" | "platform_outcome_event" | "platform_outsider_consumer" | "platform_reachability" | "platform_reference_category" | "platform_reference_declaration" | "platform_repo" | "platform_saved_view" | "platform_schema" | "platform_share_link" | "podcast_race" | "processed_document" | "processed_document_page" | "product_capture_file" | "product_capture_item" | "product_capture_payload" | "product_capture_product" | "product_capture_question" | "project" | "provider_account" | "provider_account_credential" | "provision" | "provision_generate_target" | "provision_grant" | "provision_marker" | "provision_rule_message" | "provision_schema" | "provision_shape_debt" | "provision_spec" | "provision_spec_grandfather" | "provision_vocabulary" | "purpose" | "quiz_session" | "rag_ingest_run" | "rag_library_audit_log" | "rate_limit_buckets" | "recompute_queue" | "record" | "record_alias" | "redaction_mapping" | "research_analysis" | "research_content" | "research_context_bundle" | "research_document" | "research_intent" | "research_keyword" | "research_media" | "research_source" | "research_synthesis" | "research_tag" | "research_template" | "research_topic" | "retention_policy" | "retrieval_audit" | "review_queue" | "route_manifest_entry" | "row_version" | "rulebook" | "runtime_operation_stream" | "runtime_operation_stream_batch" | "sandbox_instance" | "sch_agent_task" | "sch_run" | "sch_task" | "sch_trigger" | "schema_client_exposure" | "schema_migration_ledger" | "schema_migration_legacy" | "schema_migration_slot_grandfather" | "schema_templates" | "scope" | "scope_association_suggestion" | "scope_dataset_instance" | "scope_door_registry" | "scope_item_value_suggestion" | "scope_suggestion" | "scope_type" | "scrape_domain" | "scrape_domain_settings" | "scrape_failure_log" | "scrape_parsed_page" | "scrape_path_override" | "scrape_path_pattern" | "scrape_retry_queue" | "seo_ai_capability" | "seo_ai_visibility_citation" | "seo_ai_visibility_claim" | "seo_ai_visibility_panel" | "seo_ai_visibility_response" | "seo_ai_visibility_signal" | "seo_backlink" | "seo_backlink_change_event" | "seo_backlink_dimension_snapshot" | "seo_backlink_observation" | "seo_backlink_snapshot" | "seo_change_assessment" | "seo_change_event" | "seo_change_item" | "seo_change_metric" | "seo_change_set" | "seo_change_theory" | "seo_collection_run" | "seo_competitor" | "seo_competitor_observation" | "seo_competitor_opportunity" | "seo_coverage_mention" | "seo_coverage_tracker" | "seo_dimension_value_matcher" | "seo_engine_schedule" | "seo_geo_place" | "seo_gsc_dig_rule" | "seo_keyword" | "seo_keyword_class_rule" | "seo_keyword_edge" | "seo_keyword_facet" | "seo_keyword_market" | "seo_keyword_market_observation" | "seo_keyword_place" | "seo_keyword_saved_view" | "seo_keyword_topic" | "seo_landscape_brief" | "seo_link_gap_domain" | "seo_link_gap_match" | "seo_map_facet" | "seo_map_facet_value" | "seo_map_topic" | "seo_page_measurement_health" | "seo_page_performance" | "seo_provider_call" | "seo_provider_task" | "seo_rank_observation" | "seo_rank_target" | "seo_raw_payload" | "seo_referring_domain_profile" | "seo_reputation_case" | "seo_search_performance_daily" | "seo_serp_mention" | "seo_serp_opportunity" | "seo_serp_result" | "seo_serp_snapshot" | "seo_site_geo_area" | "seo_site_keyword_offering" | "seo_site_keyword_value" | "seo_site_offering_value" | "seo_site_topic_value" | "seo_site_value_combo" | "seo_site_value_worth" | "seo_site_vocabulary" | "seo_source_request" | "seo_starter_pack" | "seo_starter_pack_item" | "seo_story_angle" | "seo_topic" | "seo_topical_map" | "seo_web_analytics_daily" | "shareable_resource_registry" | "shared_canvas_item" | "short_link" | "skill" | "skill_detail" | "skill_render_definition" | "sms_consent" | "sms_conversation" | "sms_message" | "sms_message_media" | "sms_notification" | "sms_notification_preference" | "sms_phone_number" | "sms_rate_limits" | "sms_webhook_logs" | "soft_delete_edge" | "source_authority" | "stage_ref_kind" | "stamped_write_table" | "structure" | "structured_list" | "studio_cleaned_segments" | "studio_concept_items" | "studio_documents" | "studio_module_segments" | "studio_raw_segments" | "studio_recording_chunks" | "studio_recording_segments" | "studio_run" | "studio_session" | "studio_session_settings" | "study_attempt" | "study_goal" | "study_media" | "study_plan" | "study_plan_block" | "study_plan_day" | "study_reminder_context" | "study_reminder_delivery" | "study_session" | "study_source_chunk" | "study_streak" | "study_structured_section" | "superseded_policy" | "surface" | "system_announcement" | "system_context_item" | "system_error" | "system_orgs" | "system_personal_org_failure" | "system_write_failure" | "task" | "task_user_state" | "taxonomy_node" | "template_context_items" | "template_scope_types" | "templates" | "test_handset_inbox" | "test_handset_verification" | "thread" | "tool" | "tool_binding" | "tool_bundle" | "tool_call" | "tool_definition_version" | "tool_executor" | "tool_surface_defaults" | "tool_test_sample" | "tool_ui" | "tool_ui_incident" | "tool_ui_version" | "topic_placement_queue" | "transcript" | "trigger_event" | "udt_dataset_fields" | "udt_dataset_row_versions" | "udt_dataset_rows" | "udt_dataset_template" | "udt_dataset_template_fields" | "udt_document" | "udt_document_snapshot" | "udt_structured_list_items" | "udt_workbook_snapshot" | "ui_client" | "ui_surface_agent_pref" | "ui_surface_agent_role" | "ui_surface_client_tool" | "ui_surface_config" | "ui_surface_value" | "ui_surface_write_target" | "univer_payload" | "unsubscribe_token" | "uploads_inflight" | "user_achievement" | "user_active_context" | "user_analysis_preference" | "user_bookmark" | "user_email_preference" | "user_entity_state" | "user_feedback" | "user_follows" | "user_form_profile" | "user_markdown_sample" | "user_memory" | "user_preference" | "user_profile" | "user_secret" | "user_secret_audit" | "user_secret_grant" | "user_stat" | "user_storage_usage" | "user_surface_state" | "visibility_cache" | "visibility_epoch" | "voice" | "war_room" | "wbx_demo" | "wbx_guidance" | "wbx_highlight" | "wbx_pattern" | "wbx_recipe" | "wbx_screenshot" | "wbx_seo_audit" | "wc_claim" | "wc_impairment_definition" | "wc_injury" | "wc_report" | "web_analysis_item" | "web_brand" | "web_brand_asset" | "web_brand_offering" | "web_business_fact" | "web_business_location" | "web_channel_analytics_daily" | "web_crawl_event" | "web_crawl_preset" | "web_crawl_schedule" | "web_crawl_session" | "web_crawl_url" | "web_discovered_item" | "web_finding" | "web_gsc_page_stat" | "web_link_edge" | "web_listing_publisher" | "web_location_listing" | "web_offering_template" | "web_page" | "web_page_content" | "web_page_evidence" | "web_page_sitemap" | "web_property" | "web_provider" | "web_result" | "web_screenshot" | "web_site" | "web_site_endpoint_rule" | "web_site_item_config" | "web_site_offering" | "web_sitemap" | "web_snapshot" | "web_tag_manager_snapshot" | "web_youtube_video" | "webhook_deliveries" | "webhook_dispatch_state" | "webhooks" | "wf_node_data_slot" | "work_claim" | "work_item" | "workbook" | "worker_heartbeat" | "workflow" | "workflow_card" | "workflow_checkpoint" | "workflow_comparison" | "workflow_definition_version" | "workflow_idempotency" | "workflow_job" | "workflow_node_events" | "workflow_node_outcome" | "workflow_plan" | "workflow_plan_event" | "workflow_plan_sample" | "workflow_recovery_audit" | "workflow_run" | "workflow_run_log" | "workflow_runtime_surface" | "workflow_template" | "workflow_trigger" | "workflow_trigger_fire" | "workflow_work_item" | "working_document" | "write_guard_key" | "youtube_quota_day" | "youtube_search" | "youtube_video";
 /** Tokens flagged `reference_pickable` — offered in reference "Allowed types" choosers. */
-type ReferencePickableEntityToken = "agent" | "agent_shortcut" | "agent_surface_binding" | "agent_template" | "ai_api" | "ai_endpoint" | "ai_model" | "ai_provider" | "ai_setting" | "app" | "assessment" | "canvas_comment" | "canvas_item" | "canvas_score" | "category" | "code_file" | "code_folder" | "code_repository" | "comparison_set" | "contact_submission" | "content_ir_kind" | "content_ir_kind_instance" | "context_item" | "conversation" | "crm_deal" | "crm_outreach_list" | "cx_agent_memory" | "data_store" | "dataset" | "fc_set" | "feature_doc" | "file" | "flexible_data" | "folder" | "game_result" | "heatmap_save" | "hr_asset" | "hr_candidate" | "hr_careers_portal" | "hr_checklist_template" | "hr_course" | "hr_crew" | "hr_deduction_code" | "hr_department" | "hr_earning_code" | "hr_employee" | "hr_holiday_calendar" | "hr_interview_kit" | "hr_job_title" | "hr_jurisdiction" | "hr_jurisdiction_rule_class" | "hr_leave_policy" | "hr_location" | "hr_pay_group" | "hr_posting" | "hr_record_class" | "hr_requisition" | "hr_schedule" | "hr_schedule_template" | "hr_survey" | "league_membership" | "learn_doc" | "marketing_initiative" | "message_template" | "note" | "note_folder" | "organization" | "page_extraction_job" | "party" | "pc_article" | "pc_episode" | "pc_show" | "pc_studio_run" | "processed_document" | "project" | "quiz_session" | "research_template" | "research_topic" | "rulebook" | "sch_task" | "scope" | "scope_type" | "seo_topic" | "shared_canvas_item" | "skill" | "skill_render_definition" | "structured_list" | "studio_session" | "study_goal" | "study_media" | "study_plan" | "study_plan_block" | "surface" | "task" | "thread" | "tool" | "tool_bundle" | "transcript" | "udt_document" | "user_markdown_sample" | "user_profile" | "voice" | "war_room" | "wbx_pattern" | "web_analysis_item" | "web_brand" | "web_provider" | "web_site" | "workbook" | "workflow" | "workflow_plan" | "workflow_template" | "workflow_trigger" | "working_document";
+type ReferencePickableEntityToken = "agent" | "agent_shortcut" | "agent_surface_binding" | "agent_template" | "ai_api" | "ai_endpoint" | "ai_model" | "ai_provider" | "ai_setting" | "app" | "assessment" | "canvas_comment" | "canvas_item" | "canvas_score" | "category" | "code_file" | "code_folder" | "code_repository" | "comparison_set" | "contact_submission" | "content_ir_kind" | "content_ir_kind_instance" | "context_item" | "conversation" | "crm_deal" | "crm_outreach_list" | "cx_agent_memory" | "data_store" | "dataset" | "fc_card" | "fc_set" | "feature_doc" | "file" | "flexible_data" | "folder" | "game_result" | "heatmap_save" | "hr_asset" | "hr_candidate" | "hr_careers_portal" | "hr_checklist_template" | "hr_course" | "hr_crew" | "hr_deduction_code" | "hr_department" | "hr_earning_code" | "hr_employee" | "hr_holiday_calendar" | "hr_interview_kit" | "hr_job_title" | "hr_jurisdiction" | "hr_jurisdiction_rule_class" | "hr_leave_policy" | "hr_location" | "hr_pay_group" | "hr_posting" | "hr_record_class" | "hr_requisition" | "hr_schedule" | "hr_schedule_template" | "hr_survey" | "league_membership" | "learn_doc" | "marketing_initiative" | "message_template" | "note" | "note_folder" | "organization" | "page_extraction_job" | "party" | "pc_article" | "pc_episode" | "pc_show" | "pc_studio_run" | "processed_document" | "project" | "quiz_session" | "research_template" | "research_topic" | "rulebook" | "sch_task" | "scope" | "scope_type" | "seo_topic" | "shared_canvas_item" | "skill" | "skill_render_definition" | "structured_list" | "studio_session" | "study_goal" | "study_media" | "study_plan" | "study_plan_block" | "surface" | "task" | "thread" | "tool" | "tool_bundle" | "transcript" | "udt_document" | "user_markdown_sample" | "user_profile" | "voice" | "war_room" | "wbx_pattern" | "web_analysis_item" | "web_brand" | "web_provider" | "web_site" | "workbook" | "workflow" | "workflow_plan" | "workflow_template" | "workflow_trigger" | "working_document";
 /** Tokens flagged `is_component` — child/detail rows, not standalone entities. */
 type ComponentEntityToken = "agent_card" | "agent_definition_version" | "agent_drift_alert" | "agent_run_stage" | "agent_usage" | "analysis_result" | "app_definition_version" | "app_error" | "app_execution" | "app_rate_limit" | "artifact" | "assessment_item" | "attempt" | "browser_account_binding" | "browser_action_event" | "browser_capture" | "browser_control_request" | "browser_handoff" | "browser_login_attempt" | "browser_run" | "browser_site_observation" | "canvas_item_state" | "cmp_entry" | "coding_session_entry" | "commerce_asset_allocation" | "commerce_asset_grading" | "commerce_asset_identifier" | "commerce_asset_lot_event" | "commerce_asset_mandate_result" | "commerce_asset_price_factor" | "commerce_asset_reshoot_request" | "commerce_asset_review" | "commerce_asset_unknown" | "commerce_ebay_business_policy" | "commerce_ebay_custom_policy" | "commerce_ebay_inventory_item" | "commerce_ebay_inventory_item_group" | "commerce_ebay_inventory_item_group_member" | "commerce_ebay_inventory_location" | "commerce_ebay_listing" | "commerce_ebay_media_asset" | "commerce_ebay_notification_subscription" | "commerce_ebay_offer" | "commerce_ebay_order" | "commerce_ebay_order_line_item" | "commerce_ebay_shipping_fulfillment" | "commerce_ebay_store_category" | "commerce_human_correction" | "commerce_intake_artifact" | "commerce_intake_asset" | "commerce_label_code" | "commerce_marketplace_site" | "commerce_marketplace_sync_run" | "commerce_prediction_outcome" | "commerce_product_channel_ref" | "commerce_product_media" | "commerce_product_variant" | "commerce_recall_audit" | "content_ir_kind_component" | "content_ir_kind_component_incident" | "content_ir_kind_conformance" | "content_ir_kind_edge" | "content_ir_kind_example" | "content_ir_kind_surface" | "context_item_value" | "context_value_refs" | "conversation_value" | "credential_attachment" | "crm_address" | "crm_affiliation" | "crm_contact_candidate" | "crm_deal_stage_event" | "crm_interaction" | "crm_merge_candidate" | "crm_outreach_list_member" | "crm_party_merge" | "crm_sending_event" | "crm_sending_identity_check" | "custom_record" | "cx_agent_plan" | "cx_agent_task" | "cx_code_edit" | "cx_code_message_file" | "cx_media" | "cx_observational_memory" | "cx_observational_memory_event" | "cx_pending_injection" | "cx_request" | "cx_request_snapshot" | "cx_tool_trace" | "cx_user_todo" | "data_store_members" | "dm_message" | "dm_participant" | "document_version" | "embeddings_google_gemini_2_1536" | "embeddings_oai_3_small_1536" | "embeddings_voyage_4_large_1024" | "embeddings_voyage_code_3_1024" | "endpoint_family_sweep_state" | "esign_campaign_member" | "esign_envelope_certificate" | "esign_envelope_document" | "esign_envelope_external_ref" | "esign_envelope_signer" | "fc_detail" | "feedback_comments" | "feedback_user_messages" | "file_analysis" | "file_entities" | "file_overrides" | "file_page_annotations" | "file_pages" | "file_rag_job" | "file_version" | "global_execution" | "global_execution_checkpoint" | "global_execution_control" | "global_execution_event" | "global_meter_entry" | "growth_loop_event" | "growth_loop_stage_run" | "hindsight_finding" | "hindsight_replay" | "hindsight_review" | "hr_application" | "hr_asset_assignment" | "hr_attendance_exception" | "hr_availability" | "hr_benefits_event" | "hr_candidate_conversion" | "hr_candidate_message" | "hr_checklist_item" | "hr_checklist_run" | "hr_checklist_template_item" | "hr_course_version" | "hr_credential" | "hr_engagement" | "hr_establishment" | "hr_external_identity" | "hr_holiday" | "hr_i9_document" | "hr_incident_party" | "hr_interview" | "hr_jurisdiction_rule_test" | "hr_labor_target" | "hr_leave_enrollment" | "hr_leave_ledger" | "hr_leave_request" | "hr_legal_hold_item" | "hr_new_hire_report" | "hr_opening" | "hr_overtime_alert" | "hr_overtime_preapproval" | "hr_pay_period" | "hr_pay_period_employment" | "hr_payroll_export" | "hr_payroll_export_line" | "hr_position_assignment" | "hr_posting_publication" | "hr_provider_event" | "hr_provisioning_result" | "hr_punch" | "hr_reporting_line" | "hr_schedule_change" | "hr_schedule_template_shift" | "hr_scorecard" | "hr_shift" | "hr_shift_claim" | "hr_staffing_requirement" | "hr_survey_invitation" | "hr_survey_question" | "hr_survey_response" | "hr_tax_registration" | "hr_time_adjustment" | "hr_training_assignment" | "hr_training_attempt" | "hr_transcript_entry" | "hr_work_interval" | "hr_workflow_binding" | "hr_workflow_failure" | "hr_workflow_step" | "hr_workflow_step_definition" | "hr_workweek" | "integration_connection_resource" | "interview_decision_question" | "interview_document_revision" | "interview_hole" | "interview_question" | "interview_turn" | "item" | "keyword_classification_queue" | "kg_chunk_entities" | "kg_edges" | "kg_entity_aliases" | "mandate_observation" | "masterwork_corpus_item" | "masterwork_run" | "masterwork_source" | "media_capture_handoff" | "media_library_item" | "media_selection_item" | "media_selection_job" | "meet_note" | "meet_participant" | "meet_recording" | "meet_transcript_segment" | "message" | "message_template_detail" | "ops_proof_run" | "org_industries" | "organization_preferences" | "page_extraction_results" | "page_extraction_runs" | "party_contact_point" | "pc_studio_run_asset" | "plan_cms_fill_item" | "plan_cms_fill_job" | "plan_node_artifact" | "plan_node_step" | "processed_document_page" | "product_capture_file" | "product_capture_payload" | "product_capture_product" | "product_capture_question" | "redaction_mapping" | "research_analysis" | "research_content" | "research_document" | "research_keyword" | "research_media" | "research_source" | "research_synthesis" | "research_tag" | "sch_agent_task" | "sch_run" | "sch_trigger" | "scope_dataset_instance" | "seo_ai_visibility_citation" | "seo_ai_visibility_claim" | "seo_ai_visibility_panel" | "seo_ai_visibility_response" | "seo_ai_visibility_signal" | "seo_backlink" | "seo_backlink_change_event" | "seo_backlink_dimension_snapshot" | "seo_backlink_observation" | "seo_backlink_snapshot" | "seo_change_assessment" | "seo_change_event" | "seo_change_item" | "seo_change_metric" | "seo_change_set" | "seo_change_theory" | "seo_competitor" | "seo_competitor_observation" | "seo_competitor_opportunity" | "seo_coverage_mention" | "seo_coverage_tracker" | "seo_dimension_value_matcher" | "seo_keyword_market_observation" | "seo_keyword_saved_view" | "seo_landscape_brief" | "seo_link_gap_domain" | "seo_link_gap_match" | "seo_map_topic" | "seo_page_measurement_health" | "seo_page_performance" | "seo_provider_call" | "seo_provider_task" | "seo_rank_observation" | "seo_raw_payload" | "seo_referring_domain_profile" | "seo_reputation_case" | "seo_search_performance_daily" | "seo_serp_mention" | "seo_serp_opportunity" | "seo_serp_result" | "seo_serp_snapshot" | "seo_site_geo_area" | "seo_site_keyword_offering" | "seo_site_keyword_value" | "seo_site_offering_value" | "seo_site_topic_value" | "seo_site_value_combo" | "seo_site_value_worth" | "seo_site_vocabulary" | "seo_web_analytics_daily" | "skill_detail" | "sms_message" | "sms_message_media" | "sms_webhook_logs" | "structure" | "studio_cleaned_segments" | "studio_concept_items" | "studio_documents" | "studio_module_segments" | "studio_raw_segments" | "studio_recording_segments" | "studio_session_settings" | "tool_binding" | "tool_call" | "tool_definition_version" | "tool_test_sample" | "tool_ui" | "tool_ui_incident" | "tool_ui_version" | "topic_placement_queue" | "trigger_event" | "udt_dataset_fields" | "udt_dataset_row_versions" | "udt_dataset_rows" | "udt_dataset_template_fields" | "udt_document_snapshot" | "udt_structured_list_items" | "udt_workbook_snapshot" | "univer_payload" | "user_follows" | "wc_injury" | "wc_report" | "web_brand_asset" | "web_brand_offering" | "web_business_fact" | "web_business_location" | "web_crawl_event" | "web_crawl_preset" | "web_crawl_schedule" | "web_crawl_session" | "web_crawl_url" | "web_discovered_item" | "web_finding" | "web_gsc_page_stat" | "web_link_edge" | "web_location_listing" | "web_page" | "web_page_content" | "web_page_evidence" | "web_page_sitemap" | "web_property" | "web_result" | "web_screenshot" | "web_site_endpoint_rule" | "web_site_item_config" | "web_site_offering" | "web_sitemap" | "web_snapshot" | "web_tag_manager_snapshot" | "webhook_deliveries" | "wf_node_data_slot" | "work_item" | "workflow_card" | "workflow_checkpoint" | "workflow_definition_version" | "workflow_idempotency" | "workflow_job" | "workflow_node_events" | "workflow_node_outcome" | "workflow_plan" | "workflow_plan_event" | "workflow_plan_sample" | "workflow_recovery_audit" | "workflow_trigger_fire" | "workflow_work_item";
 /** Tokens flagged `default_scopeable` — can carry scope tags by default. */
@@ -4868,7 +4880,7 @@ declare const ENTITY_TYPE_METADATA: {
         readonly token: "document";
         readonly schema: "content";
         readonly table: "document";
-        readonly label: "Document";
+        readonly label: "Markdown document";
         readonly baseTier: 1;
         readonly isComponent: false;
         readonly isModule: false;
@@ -5435,8 +5447,8 @@ declare const ENTITY_TYPE_METADATA: {
         readonly isListed: false;
         readonly scopeable: true;
         readonly category: null;
-        readonly referencePickable: false;
-        readonly titleColumn: null;
+        readonly referencePickable: true;
+        readonly titleColumn: "front";
         readonly contentRole: null;
         readonly referenceCategory: null;
     };
@@ -14628,7 +14640,7 @@ declare const ENTITY_TYPE_METADATA: {
         readonly token: "udt_document";
         readonly schema: "workbench";
         readonly table: "udt_documents";
-        readonly label: "Document";
+        readonly label: "Cloud document";
         readonly baseTier: 1;
         readonly isComponent: false;
         readonly isModule: false;
@@ -16767,6 +16779,11 @@ interface AssociationPickerProps {
         ok: boolean;
         error?: string;
     }>;
+    /**
+     * Filed-under mode: the primary is being FILED UNDER the picked items
+     * (`primary → item`), so the header says "File … under" not "Attach to".
+     */
+    filing?: boolean;
 }
 /** Per-token picker override map — absent tokens use the generic picker sheet. */
 type PickerOverrideMap = Partial<Record<EntityTypeToken, ComponentType<AssociationPickerProps>>>;
@@ -16848,4 +16865,4 @@ interface AssociationsConfig {
     authorDisplay?: AuthorDisplayPort;
 }
 
-export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };
+export { ASSOCIATION_TARGET_TYPES, type AssociationDirection, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationTargetType, isAssociationsRpcErr, isEntityTypeToken };

package/dist/index.d.ts

@@ -2,6 +2,18 @@ import { ElementType, ComponentType, ReactNode } from 'react';
 
 declare const ASSOCIATION_TARGET_TYPES: readonly ["organization", "scope", "scope_type", "project", "task", "context_item", "thread", "war_room", "category", "conversation", "fc_set", "fc_card", "study_media", "assessment", "note", "file", "quiz_session", "agent", "agent_term_list", "research_tag", "skill", "surface", "plan_entity", "plan_node", "web_site", "seo_topic", "seo_keyword", "web_page", "web_screenshot", "party", "crm_outreach_list", "crm_deal", "rulebook"];
 type AssociationTargetType = (typeof ASSOCIATION_TARGET_TYPES)[number];
+/** Runtime guard: is this token one of the deliberate container (target) types? */
+declare function isAssociationTargetType(value: unknown): value is AssociationTargetType;
+/**
+ * Which edges a primary entity's association surfaces read and write.
+ *  - `incoming` (default) — the primary is a CONTAINER: it lists what is
+ *    attached INTO it (`resource → primary`) and "+" attaches resources to it.
+ *  - `outgoing` — the primary is FILED UNDER things (a Source under a project,
+ *    a research topic, a Library): it lists its own `primary → container`
+ *    edges and "+" files it under a container. Only container (target) types
+ *    can be filed under.
+ */
+type AssociationDirection = "incoming" | "outgoing";
 interface AssociationEdge {
     id: string;
     direction: "outgoing" | "incoming";
@@ -501,7 +513,7 @@ interface EntityTypeMeta {
  */
 type EntityTypeToken = "access_delta_probe" | "access_delta_run" | "access_request" | "account_addon" | "acquisition_block" | "activity" | "admin_audit_log" | "admin_email_log" | "admin_markdown_sample" | "admin_user" | "admission_config" | "agent" | "agent_card" | "agent_definition_version" | "agent_drift_alert" | "agent_exemplar" | "agent_mandate_note" | "agent_prompt_remediation" | "agent_run" | "agent_run_stage" | "agent_schedule" | "agent_schedule_claim" | "agent_shortcut" | "agent_surface_binding" | "agent_template" | "agent_term_list" | "agent_usage" | "ai_api" | "ai_endpoint" | "ai_model" | "ai_model_alias" | "ai_offering" | "ai_provider" | "ai_setting" | "analysis_result" | "anon_form" | "anon_function_birth_grandfather" | "anon_hit" | "anon_inbound" | "anon_replay" | "anon_submission" | "anon_token" | "api_field_warning" | "api_request_log" | "app" | "app_config" | "app_config_history" | "app_definition_version" | "app_error" | "app_execution" | "app_instance" | "app_log" | "app_log_muted_pattern" | "app_log_norm_exception" | "app_rate_limit" | "app_setting" | "app_sync_status" | "approach" | "artifact" | "assessment" | "assessment_item" | "assessment_result" | "assignment_session" | "assist" | "assist_producer_policy" | "assist_producer_policy_history" | "association_type" | "assurance_level" | "attempt" | "audit_broken_functions" | "audit_canonical_findings" | "audit_exemption" | "audit_function_deps" | "audit_function_runtime_probe" | "audit_m2m_candidates" | "audit_refresh_log" | "audit_stale_registry" | "audit_unregistered_candidates" | "base_entity_template" | "batch_cost_event" | "batch_provider_batch" | "batch_work_item" | "billing_capability" | "billing_capability_limit" | "billing_connect_account" | "billing_customer" | "billing_plan" | "billing_plan_limit" | "billing_price" | "billing_product" | "billing_spend_guardrail" | "billing_stripe_event" | "billing_subscription" | "billing_usage_ledger" | "billing_user_plan" | "browser_account_binding" | "browser_action_event" | "browser_authenticator_window" | "browser_capture" | "browser_control_request" | "browser_handoff" | "browser_login_attempt" | "browser_login_recipe" | "browser_profile" | "browser_profile_checkpoint" | "browser_run" | "browser_site_observation" | "browser_site_policy" | "browser_stream_ticket" | "build_lock" | "calendar_event" | "canvas_comment" | "canvas_comment_like" | "canvas_item" | "canvas_item_state" | "canvas_like" | "canvas_score" | "canvas_view" | "capture_window" | "carrying_rule" | "catalog_entries_history" | "catalog_entry" | "category" | "change_type_default" | "chat_user_usage_summary" | "citations" | "class_purchase" | "classifier_revision_ledger" | "client_callable_door" | "client_callable_door_retirement" | "client_excluded_column_unregistered" | "cmp_entry" | "cmp_feedback" | "code_file" | "code_folder" | "code_repository" | "coding_session" | "coding_session_entry" | "comment" | "commerce_asset_allocation" | "commerce_asset_grading" | "commerce_asset_identifier" | "commerce_asset_lot_event" | "commerce_asset_mandate_result" | "commerce_asset_price_factor" | "commerce_asset_reshoot_request" | "commerce_asset_review" | "commerce_asset_unknown" | "commerce_certified_printer" | "commerce_cloud_sync_connection" | "commerce_ebay_business_policy" | "commerce_ebay_category" | "commerce_ebay_category_aspect" | "commerce_ebay_category_tree" | "commerce_ebay_custom_policy" | "commerce_ebay_inventory_item" | "commerce_ebay_inventory_item_group" | "commerce_ebay_inventory_item_group_member" | "commerce_ebay_inventory_location" | "commerce_ebay_listing" | "commerce_ebay_marketplace_policy" | "commerce_ebay_media_asset" | "commerce_ebay_notification_destination" | "commerce_ebay_notification_event" | "commerce_ebay_notification_subscription" | "commerce_ebay_notification_topic" | "commerce_ebay_offer" | "commerce_ebay_order" | "commerce_ebay_order_line_item" | "commerce_ebay_shipping_fulfillment" | "commerce_ebay_store_category" | "commerce_human_correction" | "commerce_intake_artifact" | "commerce_intake_asset" | "commerce_intake_batch" | "commerce_label_batch" | "commerce_label_code" | "commerce_marketplace_account" | "commerce_marketplace_account_deletion_audit" | "commerce_marketplace_api_call" | "commerce_marketplace_rate_budget" | "commerce_marketplace_site" | "commerce_marketplace_sync_run" | "commerce_prediction_outcome" | "commerce_print_order" | "commerce_product" | "commerce_product_channel_ref" | "commerce_product_media" | "commerce_product_variant" | "commerce_recall_audit" | "comparison_set" | "contact_medium" | "contact_submission" | "content_certification" | "content_ir_kind" | "content_ir_kind_component" | "content_ir_kind_component_incident" | "content_ir_kind_conformance" | "content_ir_kind_edge" | "content_ir_kind_example" | "content_ir_kind_instance" | "content_ir_kind_surface" | "content_lane" | "context_access_log" | "context_item" | "context_item_suggestion" | "context_item_value" | "context_value_refs" | "conversation" | "conversation_value" | "courts" | "credential_attachment" | "credential_item" | "credential_mutation_receipt" | "crm_address" | "crm_affiliation" | "crm_blocklist_entry" | "crm_contact_candidate" | "crm_deal" | "crm_deal_stage_event" | "crm_enrichment_call" | "crm_interaction" | "crm_merge_candidate" | "crm_outreach_list" | "crm_outreach_list_member" | "crm_party_merge" | "crm_registry_ingest_run" | "crm_registry_source" | "crm_saved_view" | "crm_sending_event" | "crm_sending_identity" | "crm_sending_identity_check" | "crm_sending_policy" | "custom_entity_definition" | "custom_field_definition" | "custom_field_target" | "custom_record" | "cx_agent_memory" | "cx_agent_plan" | "cx_agent_task" | "cx_code_edit" | "cx_code_message_file" | "cx_media" | "cx_observational_memory" | "cx_observational_memory_event" | "cx_pending_injection" | "cx_request" | "cx_request_snapshot" | "cx_tool_trace" | "cx_user_request" | "cx_user_todo" | "data_rights_event" | "data_store" | "data_store_members" | "dataset" | "ddl_guard_log" | "deck_suggestion" | "definer_class_exemption" | "definer_client_grant_grandfather" | "definer_grant_baseline" | "deprecated_relation" | "derive_run" | "dev_login_audit" | "dict_entry" | "dict_provider_publication" | "dict_setting" | "dm_conversation" | "dm_message" | "dm_participant" | "doc_render" | "doc_signature" | "dockets" | "document" | "document_version" | "domain_classification" | "edge_payload_kind" | "egress_device" | "egress_pairing" | "egress_ticket" | "emails" | "embedding_cache" | "embeddings_google_gemini_2_1536" | "embeddings_oai_3_small_1536" | "embeddings_voyage_4_large_1024" | "embeddings_voyage_code_3_1024" | "endpoint_family_sweep_state" | "engine_owner_task" | "entity_grant" | "entity_relationship" | "entity_type" | "esign_campaign" | "esign_campaign_member" | "esign_consent_disclosure" | "esign_envelope" | "esign_envelope_certificate" | "esign_envelope_document" | "esign_envelope_event" | "esign_envelope_external_ref" | "esign_envelope_signer" | "esign_provider" | "esign_provider_binding" | "esign_signing_key" | "execution_event_cursor" | "extension_auth_code" | "external_link" | "external_source" | "extract_sweep_state" | "fc_card" | "fc_detail" | "fc_set" | "feature_doc" | "feature_knob" | "feedback_comments" | "feedback_user_messages" | "file" | "file_analysis" | "file_entities" | "file_overrides" | "file_page_annotations" | "file_pages" | "file_rag_job" | "file_version" | "files_account_tier" | "files_machine_written_prefix" | "files_sync_mapping" | "files_user_account" | "flexible_data" | "folder" | "function_contract" | "game_badge" | "game_result" | "game_room" | "global_execution" | "global_execution_checkpoint" | "global_execution_control" | "global_execution_event" | "global_meter_entry" | "global_origin" | "global_request" | "google_document" | "growth_loop_event" | "growth_loop_run" | "growth_loop_stage_run" | "guardian_link" | "guest_conversion_audit" | "guest_execution_log" | "guest_executions" | "guided_checklist_run" | "heatmap_save" | "hindsight_enrollment" | "hindsight_finding" | "hindsight_regression_case" | "hindsight_replay" | "hindsight_replay_step" | "hindsight_review" | "hr_access_audit" | "hr_access_role" | "hr_accommodation_request" | "hr_ai_evidence" | "hr_alert_routing_rule" | "hr_application" | "hr_approval_authority" | "hr_approval_delegation" | "hr_asset" | "hr_asset_assignment" | "hr_attendance_exception" | "hr_auto_close_rule" | "hr_availability" | "hr_background_check" | "hr_benefits_event" | "hr_calculation_snapshot" | "hr_candidate" | "hr_candidate_conversion" | "hr_candidate_message" | "hr_careers_portal" | "hr_checklist_item" | "hr_checklist_run" | "hr_checklist_template" | "hr_checklist_template_item" | "hr_compensation" | "hr_corrective_action" | "hr_course" | "hr_course_version" | "hr_credential" | "hr_crew" | "hr_deduction_code" | "hr_department" | "hr_derived_grant" | "hr_disposition_event" | "hr_earning_code" | "hr_eeo_response" | "hr_emergency_contact" | "hr_employee" | "hr_employee_private" | "hr_employer_profile" | "hr_employment" | "hr_employment_pin" | "hr_engagement" | "hr_establishment" | "hr_external_identity" | "hr_field_policy" | "hr_holiday" | "hr_holiday_calendar" | "hr_i9" | "hr_i9_document" | "hr_incident" | "hr_incident_party" | "hr_interview" | "hr_interview_kit" | "hr_job_title" | "hr_jurisdiction" | "hr_jurisdiction_rule" | "hr_jurisdiction_rule_class" | "hr_jurisdiction_rule_org_decision" | "hr_jurisdiction_rule_test" | "hr_kiosk_device" | "hr_kiosk_session" | "hr_labor_target" | "hr_leave_case" | "hr_leave_enrollment" | "hr_leave_ledger" | "hr_leave_policy" | "hr_leave_request" | "hr_legal_hold" | "hr_legal_hold_item" | "hr_location" | "hr_new_hire_report" | "hr_offer" | "hr_opening" | "hr_overtime_alert" | "hr_overtime_alert_rule" | "hr_overtime_preapproval" | "hr_pay_group" | "hr_pay_period" | "hr_pay_period_employment" | "hr_payroll_export" | "hr_payroll_export_line" | "hr_position_assignment" | "hr_posting" | "hr_posting_publication" | "hr_provider_binding" | "hr_provider_event" | "hr_provisioning_result" | "hr_punch" | "hr_recalculation_batch" | "hr_record_class" | "hr_records_request" | "hr_reference_check" | "hr_reporting_line" | "hr_requisition" | "hr_restricted_note" | "hr_retention_rule" | "hr_role_assignment" | "hr_schedule" | "hr_schedule_change" | "hr_schedule_guidance" | "hr_schedule_template" | "hr_schedule_template_shift" | "hr_scorecard" | "hr_separation" | "hr_shift" | "hr_shift_claim" | "hr_staffing_requirement" | "hr_survey" | "hr_survey_invitation" | "hr_survey_question" | "hr_survey_response" | "hr_tax_registration" | "hr_tax_withholding" | "hr_time_adjustment" | "hr_training_assignment" | "hr_training_attempt" | "hr_transcript_entry" | "hr_verification_letter_request" | "hr_work_interval" | "hr_workflow_binding" | "hr_workflow_decision" | "hr_workflow_definition" | "hr_workflow_event" | "hr_workflow_failure" | "hr_workflow_flow_type" | "hr_workflow_instance" | "hr_workflow_step" | "hr_workflow_step_definition" | "hr_workweek" | "html_extraction" | "iam_access_audit" | "iam_api_key" | "iam_emergency_door_request" | "idempotency" | "industry" | "industry_curator" | "infra_status" | "ingest_runs" | "integration_connection" | "integration_connection_resource" | "interview_decision_interview" | "interview_decision_question" | "interview_document_revision" | "interview_hole" | "interview_question" | "interview_session" | "interview_turn" | "invitation" | "invitation_code" | "invitation_request" | "io_comment" | "io_contract" | "io_import" | "io_outbox" | "item" | "item_mastery" | "judge_verdict" | "jurisdiction_policy" | "keyword_classification_queue" | "kg_alert" | "kg_chunk_entities" | "kg_chunks" | "kg_clusters" | "kg_edges" | "kg_entities" | "kg_entity_aliases" | "kg_suggestion_ack" | "kg_sweep_queue" | "kg_sweep_run" | "kg_sweep_state" | "kg_value_match" | "knob_override" | "knob_override_audit" | "knob_rung_lock" | "knob_scope_kind" | "knob_write_door" | "league_membership" | "learn_doc" | "library_doc" | "lifecycle_archive" | "lifecycle_archive_row" | "lifecycle_audit" | "lifecycle_entity_plan" | "lifecycle_map_build" | "lifecycle_reference_map" | "lifecycle_run" | "lifecycle_tier_ledger" | "location" | "mandate" | "mandate_advance_batch_row" | "mandate_binding" | "mandate_goal_clauses" | "mandate_observation" | "mandate_reference" | "mandate_scan" | "mandate_treatment" | "marketing_initiative" | "masterwork_corpus_item" | "masterwork_run" | "masterwork_run_kind" | "masterwork_source" | "math_course_structure" | "math_problem" | "matrx_action_ledger" | "mcp_config" | "mcp_server" | "mcp_user_conn" | "media_capture_handoff" | "media_catalog_setting" | "media_library_item" | "media_selection_item" | "media_selection_job" | "media_source_library" | "meet_call_invite" | "meet_meeting" | "meet_note" | "meet_participant" | "meet_recording" | "meet_transcript_segment" | "membership" | "membership_grant" | "merge_field_provenance" | "message" | "message_template" | "message_template_detail" | "meta_excluded_schema" | "meta_table_stats_history" | "metadata_reserved_keys" | "migration_log" | "mtx_media_heal_queue" | "mtx_public_url_guard" | "ner_shadow" | "note" | "note_folder" | "notification" | "notification_channel_preference" | "notification_event_override" | "notification_event_type" | "notification_preference" | "notification_submission" | "notify_outsider_door_baseline" | "oauth_handoff_claim" | "opinion_clusters" | "opinions" | "ops_issue_class" | "ops_issue_event" | "ops_proof_check" | "ops_proof_run" | "ops_proof_scenario" | "org_admin_audit" | "org_change_policy" | "org_context_ledger" | "org_industries" | "org_member_control" | "org_module_config" | "org_plan" | "organization" | "organization_preferences" | "organization_visibility_version" | "output_feedback" | "outreach_acceptance" | "page_extraction_job" | "page_extraction_page_run" | "page_extraction_results" | "page_extraction_runs" | "page_intent_queue" | "page_mapping_queue" | "part_config" | "part_config_sub" | "party" | "party_contact_point" | "passkey_credential" | "pc_article" | "pc_episode" | "pc_show" | "pc_studio_run" | "pc_studio_run_asset" | "pdf_consolidation_log" | "pdf_redaction_audit" | "pdf_redaction_key_escrow" | "permission_grant" | "plan_cms_fill_item" | "plan_cms_fill_job" | "plan_entity" | "plan_node" | "plan_node_artifact" | "plan_node_step" | "plan_profile" | "platform_action_request" | "platform_actor_session" | "platform_actor_token" | "platform_actor_token_event" | "platform_continued_access" | "platform_outcome_event" | "platform_outsider_consumer" | "platform_reachability" | "platform_reference_category" | "platform_reference_declaration" | "platform_repo" | "platform_saved_view" | "platform_schema" | "platform_share_link" | "podcast_race" | "processed_document" | "processed_document_page" | "product_capture_file" | "product_capture_item" | "product_capture_payload" | "product_capture_product" | "product_capture_question" | "project" | "provider_account" | "provider_account_credential" | "provision" | "provision_generate_target" | "provision_grant" | "provision_marker" | "provision_rule_message" | "provision_schema" | "provision_shape_debt" | "provision_spec" | "provision_spec_grandfather" | "provision_vocabulary" | "purpose" | "quiz_session" | "rag_ingest_run" | "rag_library_audit_log" | "rate_limit_buckets" | "recompute_queue" | "record" | "record_alias" | "redaction_mapping" | "research_analysis" | "research_content" | "research_context_bundle" | "research_document" | "research_intent" | "research_keyword" | "research_media" | "research_source" | "research_synthesis" | "research_tag" | "research_template" | "research_topic" | "retention_policy" | "retrieval_audit" | "review_queue" | "route_manifest_entry" | "row_version" | "rulebook" | "runtime_operation_stream" | "runtime_operation_stream_batch" | "sandbox_instance" | "sch_agent_task" | "sch_run" | "sch_task" | "sch_trigger" | "schema_client_exposure" | "schema_migration_ledger" | "schema_migration_legacy" | "schema_migration_slot_grandfather" | "schema_templates" | "scope" | "scope_association_suggestion" | "scope_dataset_instance" | "scope_door_registry" | "scope_item_value_suggestion" | "scope_suggestion" | "scope_type" | "scrape_domain" | "scrape_domain_settings" | "scrape_failure_log" | "scrape_parsed_page" | "scrape_path_override" | "scrape_path_pattern" | "scrape_retry_queue" | "seo_ai_capability" | "seo_ai_visibility_citation" | "seo_ai_visibility_claim" | "seo_ai_visibility_panel" | "seo_ai_visibility_response" | "seo_ai_visibility_signal" | "seo_backlink" | "seo_backlink_change_event" | "seo_backlink_dimension_snapshot" | "seo_backlink_observation" | "seo_backlink_snapshot" | "seo_change_assessment" | "seo_change_event" | "seo_change_item" | "seo_change_metric" | "seo_change_set" | "seo_change_theory" | "seo_collection_run" | "seo_competitor" | "seo_competitor_observation" | "seo_competitor_opportunity" | "seo_coverage_mention" | "seo_coverage_tracker" | "seo_dimension_value_matcher" | "seo_engine_schedule" | "seo_geo_place" | "seo_gsc_dig_rule" | "seo_keyword" | "seo_keyword_class_rule" | "seo_keyword_edge" | "seo_keyword_facet" | "seo_keyword_market" | "seo_keyword_market_observation" | "seo_keyword_place" | "seo_keyword_saved_view" | "seo_keyword_topic" | "seo_landscape_brief" | "seo_link_gap_domain" | "seo_link_gap_match" | "seo_map_facet" | "seo_map_facet_value" | "seo_map_topic" | "seo_page_measurement_health" | "seo_page_performance" | "seo_provider_call" | "seo_provider_task" | "seo_rank_observation" | "seo_rank_target" | "seo_raw_payload" | "seo_referring_domain_profile" | "seo_reputation_case" | "seo_search_performance_daily" | "seo_serp_mention" | "seo_serp_opportunity" | "seo_serp_result" | "seo_serp_snapshot" | "seo_site_geo_area" | "seo_site_keyword_offering" | "seo_site_keyword_value" | "seo_site_offering_value" | "seo_site_topic_value" | "seo_site_value_combo" | "seo_site_value_worth" | "seo_site_vocabulary" | "seo_source_request" | "seo_starter_pack" | "seo_starter_pack_item" | "seo_story_angle" | "seo_topic" | "seo_topical_map" | "seo_web_analytics_daily" | "shareable_resource_registry" | "shared_canvas_item" | "short_link" | "skill" | "skill_detail" | "skill_render_definition" | "sms_consent" | "sms_conversation" | "sms_message" | "sms_message_media" | "sms_notification" | "sms_notification_preference" | "sms_phone_number" | "sms_rate_limits" | "sms_webhook_logs" | "soft_delete_edge" | "source_authority" | "stage_ref_kind" | "stamped_write_table" | "structure" | "structured_list" | "studio_cleaned_segments" | "studio_concept_items" | "studio_documents" | "studio_module_segments" | "studio_raw_segments" | "studio_recording_chunks" | "studio_recording_segments" | "studio_run" | "studio_session" | "studio_session_settings" | "study_attempt" | "study_goal" | "study_media" | "study_plan" | "study_plan_block" | "study_plan_day" | "study_reminder_context" | "study_reminder_delivery" | "study_session" | "study_source_chunk" | "study_streak" | "study_structured_section" | "superseded_policy" | "surface" | "system_announcement" | "system_context_item" | "system_error" | "system_orgs" | "system_personal_org_failure" | "system_write_failure" | "task" | "task_user_state" | "taxonomy_node" | "template_context_items" | "template_scope_types" | "templates" | "test_handset_inbox" | "test_handset_verification" | "thread" | "tool" | "tool_binding" | "tool_bundle" | "tool_call" | "tool_definition_version" | "tool_executor" | "tool_surface_defaults" | "tool_test_sample" | "tool_ui" | "tool_ui_incident" | "tool_ui_version" | "topic_placement_queue" | "transcript" | "trigger_event" | "udt_dataset_fields" | "udt_dataset_row_versions" | "udt_dataset_rows" | "udt_dataset_template" | "udt_dataset_template_fields" | "udt_document" | "udt_document_snapshot" | "udt_structured_list_items" | "udt_workbook_snapshot" | "ui_client" | "ui_surface_agent_pref" | "ui_surface_agent_role" | "ui_surface_client_tool" | "ui_surface_config" | "ui_surface_value" | "ui_surface_write_target" | "univer_payload" | "unsubscribe_token" | "uploads_inflight" | "user_achievement" | "user_active_context" | "user_analysis_preference" | "user_bookmark" | "user_email_preference" | "user_entity_state" | "user_feedback" | "user_follows" | "user_form_profile" | "user_markdown_sample" | "user_memory" | "user_preference" | "user_profile" | "user_secret" | "user_secret_audit" | "user_secret_grant" | "user_stat" | "user_storage_usage" | "user_surface_state" | "visibility_cache" | "visibility_epoch" | "voice" | "war_room" | "wbx_demo" | "wbx_guidance" | "wbx_highlight" | "wbx_pattern" | "wbx_recipe" | "wbx_screenshot" | "wbx_seo_audit" | "wc_claim" | "wc_impairment_definition" | "wc_injury" | "wc_report" | "web_analysis_item" | "web_brand" | "web_brand_asset" | "web_brand_offering" | "web_business_fact" | "web_business_location" | "web_channel_analytics_daily" | "web_crawl_event" | "web_crawl_preset" | "web_crawl_schedule" | "web_crawl_session" | "web_crawl_url" | "web_discovered_item" | "web_finding" | "web_gsc_page_stat" | "web_link_edge" | "web_listing_publisher" | "web_location_listing" | "web_offering_template" | "web_page" | "web_page_content" | "web_page_evidence" | "web_page_sitemap" | "web_property" | "web_provider" | "web_result" | "web_screenshot" | "web_site" | "web_site_endpoint_rule" | "web_site_item_config" | "web_site_offering" | "web_sitemap" | "web_snapshot" | "web_tag_manager_snapshot" | "web_youtube_video" | "webhook_deliveries" | "webhook_dispatch_state" | "webhooks" | "wf_node_data_slot" | "work_claim" | "work_item" | "workbook" | "worker_heartbeat" | "workflow" | "workflow_card" | "workflow_checkpoint" | "workflow_comparison" | "workflow_definition_version" | "workflow_idempotency" | "workflow_job" | "workflow_node_events" | "workflow_node_outcome" | "workflow_plan" | "workflow_plan_event" | "workflow_plan_sample" | "workflow_recovery_audit" | "workflow_run" | "workflow_run_log" | "workflow_runtime_surface" | "workflow_template" | "workflow_trigger" | "workflow_trigger_fire" | "workflow_work_item" | "working_document" | "write_guard_key" | "youtube_quota_day" | "youtube_search" | "youtube_video";
 /** Tokens flagged `reference_pickable` — offered in reference "Allowed types" choosers. */
-type ReferencePickableEntityToken = "agent" | "agent_shortcut" | "agent_surface_binding" | "agent_template" | "ai_api" | "ai_endpoint" | "ai_model" | "ai_provider" | "ai_setting" | "app" | "assessment" | "canvas_comment" | "canvas_item" | "canvas_score" | "category" | "code_file" | "code_folder" | "code_repository" | "comparison_set" | "contact_submission" | "content_ir_kind" | "content_ir_kind_instance" | "context_item" | "conversation" | "crm_deal" | "crm_outreach_list" | "cx_agent_memory" | "data_store" | "dataset" | "fc_set" | "feature_doc" | "file" | "flexible_data" | "folder" | "game_result" | "heatmap_save" | "hr_asset" | "hr_candidate" | "hr_careers_portal" | "hr_checklist_template" | "hr_course" | "hr_crew" | "hr_deduction_code" | "hr_department" | "hr_earning_code" | "hr_employee" | "hr_holiday_calendar" | "hr_interview_kit" | "hr_job_title" | "hr_jurisdiction" | "hr_jurisdiction_rule_class" | "hr_leave_policy" | "hr_location" | "hr_pay_group" | "hr_posting" | "hr_record_class" | "hr_requisition" | "hr_schedule" | "hr_schedule_template" | "hr_survey" | "league_membership" | "learn_doc" | "marketing_initiative" | "message_template" | "note" | "note_folder" | "organization" | "page_extraction_job" | "party" | "pc_article" | "pc_episode" | "pc_show" | "pc_studio_run" | "processed_document" | "project" | "quiz_session" | "research_template" | "research_topic" | "rulebook" | "sch_task" | "scope" | "scope_type" | "seo_topic" | "shared_canvas_item" | "skill" | "skill_render_definition" | "structured_list" | "studio_session" | "study_goal" | "study_media" | "study_plan" | "study_plan_block" | "surface" | "task" | "thread" | "tool" | "tool_bundle" | "transcript" | "udt_document" | "user_markdown_sample" | "user_profile" | "voice" | "war_room" | "wbx_pattern" | "web_analysis_item" | "web_brand" | "web_provider" | "web_site" | "workbook" | "workflow" | "workflow_plan" | "workflow_template" | "workflow_trigger" | "working_document";
+type ReferencePickableEntityToken = "agent" | "agent_shortcut" | "agent_surface_binding" | "agent_template" | "ai_api" | "ai_endpoint" | "ai_model" | "ai_provider" | "ai_setting" | "app" | "assessment" | "canvas_comment" | "canvas_item" | "canvas_score" | "category" | "code_file" | "code_folder" | "code_repository" | "comparison_set" | "contact_submission" | "content_ir_kind" | "content_ir_kind_instance" | "context_item" | "conversation" | "crm_deal" | "crm_outreach_list" | "cx_agent_memory" | "data_store" | "dataset" | "fc_card" | "fc_set" | "feature_doc" | "file" | "flexible_data" | "folder" | "game_result" | "heatmap_save" | "hr_asset" | "hr_candidate" | "hr_careers_portal" | "hr_checklist_template" | "hr_course" | "hr_crew" | "hr_deduction_code" | "hr_department" | "hr_earning_code" | "hr_employee" | "hr_holiday_calendar" | "hr_interview_kit" | "hr_job_title" | "hr_jurisdiction" | "hr_jurisdiction_rule_class" | "hr_leave_policy" | "hr_location" | "hr_pay_group" | "hr_posting" | "hr_record_class" | "hr_requisition" | "hr_schedule" | "hr_schedule_template" | "hr_survey" | "league_membership" | "learn_doc" | "marketing_initiative" | "message_template" | "note" | "note_folder" | "organization" | "page_extraction_job" | "party" | "pc_article" | "pc_episode" | "pc_show" | "pc_studio_run" | "processed_document" | "project" | "quiz_session" | "research_template" | "research_topic" | "rulebook" | "sch_task" | "scope" | "scope_type" | "seo_topic" | "shared_canvas_item" | "skill" | "skill_render_definition" | "structured_list" | "studio_session" | "study_goal" | "study_media" | "study_plan" | "study_plan_block" | "surface" | "task" | "thread" | "tool" | "tool_bundle" | "transcript" | "udt_document" | "user_markdown_sample" | "user_profile" | "voice" | "war_room" | "wbx_pattern" | "web_analysis_item" | "web_brand" | "web_provider" | "web_site" | "workbook" | "workflow" | "workflow_plan" | "workflow_template" | "workflow_trigger" | "working_document";
 /** Tokens flagged `is_component` — child/detail rows, not standalone entities. */
 type ComponentEntityToken = "agent_card" | "agent_definition_version" | "agent_drift_alert" | "agent_run_stage" | "agent_usage" | "analysis_result" | "app_definition_version" | "app_error" | "app_execution" | "app_rate_limit" | "artifact" | "assessment_item" | "attempt" | "browser_account_binding" | "browser_action_event" | "browser_capture" | "browser_control_request" | "browser_handoff" | "browser_login_attempt" | "browser_run" | "browser_site_observation" | "canvas_item_state" | "cmp_entry" | "coding_session_entry" | "commerce_asset_allocation" | "commerce_asset_grading" | "commerce_asset_identifier" | "commerce_asset_lot_event" | "commerce_asset_mandate_result" | "commerce_asset_price_factor" | "commerce_asset_reshoot_request" | "commerce_asset_review" | "commerce_asset_unknown" | "commerce_ebay_business_policy" | "commerce_ebay_custom_policy" | "commerce_ebay_inventory_item" | "commerce_ebay_inventory_item_group" | "commerce_ebay_inventory_item_group_member" | "commerce_ebay_inventory_location" | "commerce_ebay_listing" | "commerce_ebay_media_asset" | "commerce_ebay_notification_subscription" | "commerce_ebay_offer" | "commerce_ebay_order" | "commerce_ebay_order_line_item" | "commerce_ebay_shipping_fulfillment" | "commerce_ebay_store_category" | "commerce_human_correction" | "commerce_intake_artifact" | "commerce_intake_asset" | "commerce_label_code" | "commerce_marketplace_site" | "commerce_marketplace_sync_run" | "commerce_prediction_outcome" | "commerce_product_channel_ref" | "commerce_product_media" | "commerce_product_variant" | "commerce_recall_audit" | "content_ir_kind_component" | "content_ir_kind_component_incident" | "content_ir_kind_conformance" | "content_ir_kind_edge" | "content_ir_kind_example" | "content_ir_kind_surface" | "context_item_value" | "context_value_refs" | "conversation_value" | "credential_attachment" | "crm_address" | "crm_affiliation" | "crm_contact_candidate" | "crm_deal_stage_event" | "crm_interaction" | "crm_merge_candidate" | "crm_outreach_list_member" | "crm_party_merge" | "crm_sending_event" | "crm_sending_identity_check" | "custom_record" | "cx_agent_plan" | "cx_agent_task" | "cx_code_edit" | "cx_code_message_file" | "cx_media" | "cx_observational_memory" | "cx_observational_memory_event" | "cx_pending_injection" | "cx_request" | "cx_request_snapshot" | "cx_tool_trace" | "cx_user_todo" | "data_store_members" | "dm_message" | "dm_participant" | "document_version" | "embeddings_google_gemini_2_1536" | "embeddings_oai_3_small_1536" | "embeddings_voyage_4_large_1024" | "embeddings_voyage_code_3_1024" | "endpoint_family_sweep_state" | "esign_campaign_member" | "esign_envelope_certificate" | "esign_envelope_document" | "esign_envelope_external_ref" | "esign_envelope_signer" | "fc_detail" | "feedback_comments" | "feedback_user_messages" | "file_analysis" | "file_entities" | "file_overrides" | "file_page_annotations" | "file_pages" | "file_rag_job" | "file_version" | "global_execution" | "global_execution_checkpoint" | "global_execution_control" | "global_execution_event" | "global_meter_entry" | "growth_loop_event" | "growth_loop_stage_run" | "hindsight_finding" | "hindsight_replay" | "hindsight_review" | "hr_application" | "hr_asset_assignment" | "hr_attendance_exception" | "hr_availability" | "hr_benefits_event" | "hr_candidate_conversion" | "hr_candidate_message" | "hr_checklist_item" | "hr_checklist_run" | "hr_checklist_template_item" | "hr_course_version" | "hr_credential" | "hr_engagement" | "hr_establishment" | "hr_external_identity" | "hr_holiday" | "hr_i9_document" | "hr_incident_party" | "hr_interview" | "hr_jurisdiction_rule_test" | "hr_labor_target" | "hr_leave_enrollment" | "hr_leave_ledger" | "hr_leave_request" | "hr_legal_hold_item" | "hr_new_hire_report" | "hr_opening" | "hr_overtime_alert" | "hr_overtime_preapproval" | "hr_pay_period" | "hr_pay_period_employment" | "hr_payroll_export" | "hr_payroll_export_line" | "hr_position_assignment" | "hr_posting_publication" | "hr_provider_event" | "hr_provisioning_result" | "hr_punch" | "hr_reporting_line" | "hr_schedule_change" | "hr_schedule_template_shift" | "hr_scorecard" | "hr_shift" | "hr_shift_claim" | "hr_staffing_requirement" | "hr_survey_invitation" | "hr_survey_question" | "hr_survey_response" | "hr_tax_registration" | "hr_time_adjustment" | "hr_training_assignment" | "hr_training_attempt" | "hr_transcript_entry" | "hr_work_interval" | "hr_workflow_binding" | "hr_workflow_failure" | "hr_workflow_step" | "hr_workflow_step_definition" | "hr_workweek" | "integration_connection_resource" | "interview_decision_question" | "interview_document_revision" | "interview_hole" | "interview_question" | "interview_turn" | "item" | "keyword_classification_queue" | "kg_chunk_entities" | "kg_edges" | "kg_entity_aliases" | "mandate_observation" | "masterwork_corpus_item" | "masterwork_run" | "masterwork_source" | "media_capture_handoff" | "media_library_item" | "media_selection_item" | "media_selection_job" | "meet_note" | "meet_participant" | "meet_recording" | "meet_transcript_segment" | "message" | "message_template_detail" | "ops_proof_run" | "org_industries" | "organization_preferences" | "page_extraction_results" | "page_extraction_runs" | "party_contact_point" | "pc_studio_run_asset" | "plan_cms_fill_item" | "plan_cms_fill_job" | "plan_node_artifact" | "plan_node_step" | "processed_document_page" | "product_capture_file" | "product_capture_payload" | "product_capture_product" | "product_capture_question" | "redaction_mapping" | "research_analysis" | "research_content" | "research_document" | "research_keyword" | "research_media" | "research_source" | "research_synthesis" | "research_tag" | "sch_agent_task" | "sch_run" | "sch_trigger" | "scope_dataset_instance" | "seo_ai_visibility_citation" | "seo_ai_visibility_claim" | "seo_ai_visibility_panel" | "seo_ai_visibility_response" | "seo_ai_visibility_signal" | "seo_backlink" | "seo_backlink_change_event" | "seo_backlink_dimension_snapshot" | "seo_backlink_observation" | "seo_backlink_snapshot" | "seo_change_assessment" | "seo_change_event" | "seo_change_item" | "seo_change_metric" | "seo_change_set" | "seo_change_theory" | "seo_competitor" | "seo_competitor_observation" | "seo_competitor_opportunity" | "seo_coverage_mention" | "seo_coverage_tracker" | "seo_dimension_value_matcher" | "seo_keyword_market_observation" | "seo_keyword_saved_view" | "seo_landscape_brief" | "seo_link_gap_domain" | "seo_link_gap_match" | "seo_map_topic" | "seo_page_measurement_health" | "seo_page_performance" | "seo_provider_call" | "seo_provider_task" | "seo_rank_observation" | "seo_raw_payload" | "seo_referring_domain_profile" | "seo_reputation_case" | "seo_search_performance_daily" | "seo_serp_mention" | "seo_serp_opportunity" | "seo_serp_result" | "seo_serp_snapshot" | "seo_site_geo_area" | "seo_site_keyword_offering" | "seo_site_keyword_value" | "seo_site_offering_value" | "seo_site_topic_value" | "seo_site_value_combo" | "seo_site_value_worth" | "seo_site_vocabulary" | "seo_web_analytics_daily" | "skill_detail" | "sms_message" | "sms_message_media" | "sms_webhook_logs" | "structure" | "studio_cleaned_segments" | "studio_concept_items" | "studio_documents" | "studio_module_segments" | "studio_raw_segments" | "studio_recording_segments" | "studio_session_settings" | "tool_binding" | "tool_call" | "tool_definition_version" | "tool_test_sample" | "tool_ui" | "tool_ui_incident" | "tool_ui_version" | "topic_placement_queue" | "trigger_event" | "udt_dataset_fields" | "udt_dataset_row_versions" | "udt_dataset_rows" | "udt_dataset_template_fields" | "udt_document_snapshot" | "udt_structured_list_items" | "udt_workbook_snapshot" | "univer_payload" | "user_follows" | "wc_injury" | "wc_report" | "web_brand_asset" | "web_brand_offering" | "web_business_fact" | "web_business_location" | "web_crawl_event" | "web_crawl_preset" | "web_crawl_schedule" | "web_crawl_session" | "web_crawl_url" | "web_discovered_item" | "web_finding" | "web_gsc_page_stat" | "web_link_edge" | "web_location_listing" | "web_page" | "web_page_content" | "web_page_evidence" | "web_page_sitemap" | "web_property" | "web_result" | "web_screenshot" | "web_site_endpoint_rule" | "web_site_item_config" | "web_site_offering" | "web_sitemap" | "web_snapshot" | "web_tag_manager_snapshot" | "webhook_deliveries" | "wf_node_data_slot" | "work_item" | "workflow_card" | "workflow_checkpoint" | "workflow_definition_version" | "workflow_idempotency" | "workflow_job" | "workflow_node_events" | "workflow_node_outcome" | "workflow_plan" | "workflow_plan_event" | "workflow_plan_sample" | "workflow_recovery_audit" | "workflow_trigger_fire" | "workflow_work_item";
 /** Tokens flagged `default_scopeable` — can carry scope tags by default. */
@@ -4868,7 +4880,7 @@ declare const ENTITY_TYPE_METADATA: {
         readonly token: "document";
         readonly schema: "content";
         readonly table: "document";
-        readonly label: "Document";
+        readonly label: "Markdown document";
         readonly baseTier: 1;
         readonly isComponent: false;
         readonly isModule: false;
@@ -5435,8 +5447,8 @@ declare const ENTITY_TYPE_METADATA: {
         readonly isListed: false;
         readonly scopeable: true;
         readonly category: null;
-        readonly referencePickable: false;
-        readonly titleColumn: null;
+        readonly referencePickable: true;
+        readonly titleColumn: "front";
         readonly contentRole: null;
         readonly referenceCategory: null;
     };
@@ -14628,7 +14640,7 @@ declare const ENTITY_TYPE_METADATA: {
         readonly token: "udt_document";
         readonly schema: "workbench";
         readonly table: "udt_documents";
-        readonly label: "Document";
+        readonly label: "Cloud document";
         readonly baseTier: 1;
         readonly isComponent: false;
         readonly isModule: false;
@@ -16767,6 +16779,11 @@ interface AssociationPickerProps {
         ok: boolean;
         error?: string;
     }>;
+    /**
+     * Filed-under mode: the primary is being FILED UNDER the picked items
+     * (`primary → item`), so the header says "File … under" not "Attach to".
+     */
+    filing?: boolean;
 }
 /** Per-token picker override map — absent tokens use the generic picker sheet. */
 type PickerOverrideMap = Partial<Record<EntityTypeToken, ComponentType<AssociationPickerProps>>>;
@@ -16848,4 +16865,4 @@ interface AssociationsConfig {
     authorDisplay?: AuthorDisplayPort;
 }
 
-export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };
+export { ASSOCIATION_TARGET_TYPES, type AssociationDirection, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationTargetType, isAssociationsRpcErr, isEntityTypeToken };

package/dist/index.js

@@ -272,7 +272,7 @@ var ENTITY_TYPE_METADATA = {
   "doc_render": { token: "doc_render", schema: "custom", table: "doc_render", label: "Rendered Document", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "Custom Data", referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "doc_signature": { token: "doc_signature", schema: "custom", table: "doc_signature", label: "Document Signature", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "Custom Data", referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "dockets": { token: "dockets", schema: "legal", table: "dockets", label: "Dockets", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
-  "document": { token: "document", schema: "content", table: "document", label: "Document", baseTier: 1, isComponent: false, isModule: false, isListed: true, scopeable: true, category: "Documents", referencePickable: false, titleColumn: "title", contentRole: "hybrid", referenceCategory: null },
+  "document": { token: "document", schema: "content", table: "document", label: "Markdown document", baseTier: 1, isComponent: false, isModule: false, isListed: true, scopeable: true, category: "Documents", referencePickable: false, titleColumn: "title", contentRole: "hybrid", referenceCategory: null },
   "document_version": { token: "document_version", schema: "content", table: "document_version", label: "Document Version", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: "Documents", referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "domain_classification": { token: "domain_classification", schema: "platform", table: "domain_classification", label: "Domain Classification", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "edge_payload_kind": { token: "edge_payload_kind", schema: "platform", table: "edge_payload_kind", label: "Edge payload kind", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
@@ -307,7 +307,7 @@ var ENTITY_TYPE_METADATA = {
   "external_link": { token: "external_link", schema: "custom", table: "external_link", label: "External Link", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "Custom Data", referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "external_source": { token: "external_source", schema: "custom", table: "external_source", label: "External Source", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "Custom Data", referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "extract_sweep_state": { token: "extract_sweep_state", schema: "workflow", table: "extract_sweep_state", label: "Extract sweep state", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
-  "fc_card": { token: "fc_card", schema: "education", table: "fc_card", label: "Flashcard", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
+  "fc_card": { token: "fc_card", schema: "education", table: "fc_card", label: "Flashcard", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: true, titleColumn: "front", contentRole: null, referenceCategory: null },
   "fc_detail": { token: "fc_detail", schema: "education", table: "fc_detail", label: "Flashcard Detail", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "fc_set": { token: "fc_set", schema: "education", table: "fc_set", label: "Flashcard Set", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: true, titleColumn: "name", contentRole: null, referenceCategory: null },
   "feature_doc": { token: "feature_doc", schema: "admin", table: "feature_docs", label: "Feature Doc", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "documentation", referencePickable: true, titleColumn: "title", contentRole: null, referenceCategory: null },
@@ -882,7 +882,7 @@ var ENTITY_TYPE_METADATA = {
   "udt_dataset_rows": { token: "udt_dataset_rows", schema: "workbench", table: "udt_dataset_rows", label: "Dataset Row", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "udt_dataset_template": { token: "udt_dataset_template", schema: "workbench", table: "udt_dataset_templates", label: "Dataset template", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "udt_dataset_template_fields": { token: "udt_dataset_template_fields", schema: "workbench", table: "udt_dataset_template_fields", label: "Udt Dataset Template Fields", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
-  "udt_document": { token: "udt_document", schema: "workbench", table: "udt_documents", label: "Document", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: true, titleColumn: "document_name", contentRole: "hybrid", referenceCategory: null },
+  "udt_document": { token: "udt_document", schema: "workbench", table: "udt_documents", label: "Cloud document", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: true, titleColumn: "document_name", contentRole: "hybrid", referenceCategory: null },
   "udt_document_snapshot": { token: "udt_document_snapshot", schema: "workbench", table: "udt_document_snapshots", label: "Document snapshot", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "udt_structured_list_items": { token: "udt_structured_list_items", schema: "workbench", table: "udt_structured_list_items", label: "Structured List Item", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: "label", contentRole: null, referenceCategory: null },
   "udt_workbook_snapshot": { token: "udt_workbook_snapshot", schema: "workbench", table: "udt_workbook_snapshots", label: "Workbook snapshot", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
@@ -2107,6 +2107,9 @@ var ASSOCIATION_TARGET_TYPES = [
   "rulebook"
   //             a Masterwork Rulebook — its Scout interviews attach here (conversation→rulebook, role 'interview')
 ];
+function isAssociationTargetType(value) {
+  return typeof value === "string" && ASSOCIATION_TARGET_TYPES.includes(value);
+}
 
 // src/results.ts
 function isAssociationsRpcErr(r) {
@@ -2152,6 +2155,7 @@ export {
   ENTITY_TYPE_TOKENS,
   REFERENCE_CATEGORY_DISPLAY,
   SCHEMA_DISPLAY,
+  isAssociationTargetType,
   isAssociationsRpcErr,
   isEntityTypeToken
 };