socialcli 0.3.0__py3-none-any.whl

socialcli-0.3.0.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.5
+Name: socialcli
+Version: 0.3.0
+Summary: SocialCli: publish and manage creator-owned social content from the terminal.
+Project-URL: Homepage, https://socialcli.app
+Project-URL: Repository, https://github.com/engels-florentino/SocialCli
+Project-URL: Issues, https://github.com/engels-florentino/SocialCli/issues
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: keyring>=25.0
+Requires-Dist: pydantic>=2.13.5
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: typer>=0.27.2
+Provides-Extra: connection-server
+Requires-Dist: cryptography>=43; extra == 'connection-server'
+Requires-Dist: fastapi>=0.115; extra == 'connection-server'
+Requires-Dist: uvicorn>=0.30; extra == 'connection-server'
+Provides-Extra: headless-credentials
+Requires-Dist: cryptography>=43; extra == 'headless-credentials'
+Description-Content-Type: text/markdown
+
+<p align="center"><img src="docs/assets/socialcli-logo.png" width="128" height="128" alt="SocialCli logo: S and terminal prompt &gt;_"></p>
+
+# SocialCli
+
+**Current source version: 0.3.0.** SocialCli SaaS is the current SocialCli
+product. The repository root on `main` is its single development workspace;
+the CLI, hosted connection service and account/billing components live together
+here. Earlier versions remain in Git history for reference and migration.
+
+**A social media CLI for AI agents and the people who supervise them.** Use a terminal-enabled assistant to inspect your accounts, draft posts and prepare user-approved actions on YouTube, Facebook, Instagram and TikTok. SocialCli provides concrete commands, validation, previews and local records for creators and teams.
+
+[Website and documentation](https://socialcli.app/) · [AI agent guide](docs/ai-agents.md) · [Setup](SETUP.md) · [Security](SECURITY.md) · [TikTok limitations](docs/tiktok-review.md)
+
+## Work with your AI agent
+
+Install SocialCli where your agent can run shell commands, point it at your creator workspace and name the brand explicitly. Try:
+
+> Check MyBrand's TikTok connection and available capabilities. Summarize missing permissions without publishing.
+
+> Use MyBrand/media/my-video.mp4, draft a caption in our brand voice and show the complete TikTok dry-run preview. Wait for my approval before sending it.
+
+> Inspect my YouTube video and propose a description change. Show the proposal and fingerprint before applying anything.
+
+[The AI agent guide](docs/ai-agents.md) includes the commands behind these prompts, workspace instructions and the approval workflow. JSON is available on supported diagnostics and inventory commands. SocialCli runs through the agent's shell; it does not include an AI model or an MCP server. Your agent must keep credentials private and preserve the distinction between confirmed, pending and uncertain results.
+
+## Public SaaS pilot
+
+Copy this line into your terminal-enabled AI assistant:
+
+> Install SocialCli: https://socialcli.app/agents
+
+The installation guide verifies the selected release download and uses
+https://pilot.socialcli.app for email sign-in, assistant approval and account
+connections. The pilot supports eligible YouTube, Facebook, Instagram and TikTok
+test accounts. Provider verification is separate from the OAuth publishing
+toggle; Meta development access and TikTok sandbox restrictions still apply.
+Stripe uses test mode. Planned access costs
+USD 10/month after 14 free days from the first successful connection. No real
+subscriptions are collected in this pilot.
+
+The current client release target is **0.3.0** (published first to TestPyPI and
+then to PyPI through the reviewed release workflow). The compatible hosted
+runtime is `socialcli-saas-candidate:45fda63`. The client's wheel and
+source archive are verified against the
+reviewed build hashes before publication. Provider commercial approvals and live
+billing cutover remain separate from package publication. See the
+[release record](deploy/saas/release.md).
+The [stable release scope](docs/stable-scope.md) excludes unsupported automatic
+operations; disabled research catalogue entries are not offered features.
+
+## Install and connect
+
+Use the short installation prompt above. Your assistant needs a persistent shell,
+Python 3.11+, macOS or Linux and protected credential storage. The bootstrap
+verifies the exact wheel before installation and resolves dependencies from normal
+PyPI. Video validation also requires ffprobe from FFmpeg.
+
+The setup order is **brand → credentials → account login → connect**. Ask for the
+brand name explicitly, preserve its workspace outside the application repository,
+and read socialcli agent-guide setup. The account step uses
+https://pilot.socialcli.app. Give each printed link directly to the user without
+opening it; the user signs in and approves the assistant and provider account in
+their browser. Never request OTPs or provider tokens in chat.
+
+```bash
+socialcli account login --brand MyBrand --service https://pilot.socialcli.app --no-browser
+socialcli connect youtube --brand MyBrand --management --analytics --no-browser
+socialcli connections --brand MyBrand --json
+```
+
+Run these after creating the brand and configuring protected credentials as shown
+in the [connection guide](docs/connections.md). OS keyring and explicit encrypted
+file storage are supported; there is no silent fallback. Use the same workspace,
+store and key in later conversations. Connecting never authorizes publication.
+
+For source development use uv sync --group dev, uv run pytest and
+uv run socialcli --help in the repository. [SETUP.md](SETUP.md) covers independent
+operator apps; customers of the hosted SaaS do not need developer credentials.
+
+## Review and publish
+
+Create `MyBrand/posts/my-video/post.yml` and place your produced file in `MyBrand/media/`. [Example](examples/post.yml):
+
+```yaml
+slug: my-video
+campaign: clip-vertical
+platforms:
+  tiktok:
+    body: "A story worth telling."
+    hashtags: []
+    media: ["my-video.mp4"]
+```
+
+```bash
+socialcli publish my-video --brand MyBrand --only tiktok --dry-run
+socialcli publish my-video --brand MyBrand --only tiktok
+```
+
+The first command displays a preview without publishing. The second displays it again and requests confirmation. TikTok defaults to **inbox**: the video reaches your inbox and you complete publication in TikTok. A pending confirmation status does not mean the video is published.
+
+## Features
+
+- Separate brands, local credentials and token renewal where supported by the provider.
+- File validation, previews and confirmation before publication.
+- Publishing, inventory, metrics and content management, subject to each platform's permissions and capabilities.
+- Scheduling with approval checks and handling of ambiguous results to reduce duplicates.
+- Adapter tests with simulated responses that do not publish to real accounts.
+
+Each command group documents its options with `socialcli <group> --help`. The internal Python package remains `socialctl`; the public command is `socialcli`. `socialctl` remains a compatibility alias.
+
+## Status and limitations
+
+Public source code does not grant production API access. Each platform imposes requirements, permissions, quotas and reviews. SocialCli **has no accredited TikTok production approval**. Direct Post is disabled and excluded from the current offer; creator-reviewed inbox upload is supported. Direct Post still lacks the complete user experience controls described in [the technical review](docs/tiktok-review.md). Publishing this repository does not satisfy those requirements.
+
+Metrics and management permissions are separate from publishing permissions. A valid connection does not demonstrate authorization for every feature. Check capabilities and verify remote results before retrying an uncertain operation.
+
+## Contributing and support
+
+Read [CONTRIBUTING.md](CONTRIBUTING.md). For questions or bugs, open an [issue](https://github.com/engels-florentino/SocialCli/issues) without tokens, keys, `.env` files or private logs. Report vulnerabilities through the private channel described in [SECURITY.md](SECURITY.md).
+
+[MIT license](LICENSE). SocialCli is not affiliated with the platforms it integrates.
+
+## Account, media and scheduling
+
+[Account](https://socialcli.app/account/) lets you manage your brand, connected
+platforms, approved assistants and billing. The plan covers one brand and one
+account per supported platform. Subscribe during the 14-day trial without losing
+its remaining days; the first USD 10 payment is due at the original trial end.
+The current pilot uses Stripe test mode and collects no live payments.
+
+Instagram can use automatic 15-minute temporary staging on florentino.pro for
+supplied originals, up to 512 MiB and subject to quotas. Files are excluded from
+backups and removed after the operation or by expiry cleanup. Local schedules
+keep the original on the customer runner and stage it only at dispatch. Verified
+native scheduling uses provider storage where supported. See
+[media handling](MEDIA-INGESTION.md) and [scheduling](NATIVE-SCHEDULING.md).
+
+Read the packaged socialcli agent-guide topic for the operation, the
+[capability matrix](docs/capabilities.md), [security](SECURITY.md),
+[privacy policy](https://socialcli.app/privacy.html) and
+[terms](https://socialcli.app/terms.html). Historical 0.2.6 releases and deploy
+records are migration evidence, not a second current product.
+
+SocialCli is operated by **Florentino.pro**. For private account, billing or privacy
+questions, contact [admin@socialcli.app](mailto:admin@socialcli.app).

socialcli-0.3.0.dist-info/RECORD

@@ -0,0 +1,224 @@
+socialctl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+socialctl/__main__.py,sha256=3s7Cky_ATIRXnfgny8sqCzMRHxjYav3L9SliXLqcwTs,141
+socialctl/agent_errors.py,sha256=xLzVgBuwUSY8M0ePXEQZcAc9kTF4XrpFewcoJeN2RII,12875
+socialctl/agent_guide.py,sha256=p8IAs3NKbBu24XmBofcWfDAHGoHS-nISY9z7P-yiG3g,1749
+socialctl/approval_cli.py,sha256=fxIZE7YY4nklzgsIEVltNgL7CiZ_zr7iLl_w46p91YU,1192
+socialctl/auth.py,sha256=OyaJ2FFws7DrAZgxbXSCDy2Ql_ID6b1oL6cTvlTN4ac,5556
+socialctl/authflow.py,sha256=lkz9SeZ-B2oTtNd_wY5A2slNPS08o14_kw5GJkN1DhU,14130
+socialctl/brands.py,sha256=sXWGTB86Ua8-23cpP0AFivTNkRrtbNONl8OIeBvCz38,7001
+socialctl/capabilities.py,sha256=U2Nei99yeid0IqLkGcvVQYXpFJrv4U-cXY2SyQP9MQs,2672
+socialctl/capabilities.yml,sha256=_4ox5_m3TOxD9QLjxgpUzkN7GTlarL-N5FQV_GUNtg0,301164
+socialctl/cli.py,sha256=bO4ndUvXfPwim0qpmPTbyuWjBMoSbIUDaMVUIZ36Xy8,80555
+socialctl/delivery_options.py,sha256=B2yyGTOyJwgnv5gKS_RO241Nf3YxIVkL8JtpBm0sxRA,4165
+socialctl/engagement.py,sha256=SCWSL0BdYpWMzN1qaIz-cIhHTlP3WB4MXUdrkQQFSr8,13746
+socialctl/engagement_cli.py,sha256=Azo4kTqE6ZUDsyWA5oe30hpnPzH3KnFFsZ3UyzlTX90,2887
+socialctl/executor.py,sha256=vWY96Ic94R0w7srcCPMEpAl_9Ys-wSMHIdb5U2p_6r0,5751
+socialctl/formatter.py,sha256=Q0LFYzaIBwh04MP8F6qENxP-0LT0VWIKFtQHpdxG-8M,11737
+socialctl/hosted_media.py,sha256=5kY5aDqPo0HAFWniarh_rJEjc4Aqv8W8y4OcERTPUJ0,7984
+socialctl/identity.py,sha256=lnu65GD4y5kNugG1olNTAGZWuunewEXoGNm4HToLmvA,9232
+socialctl/inbox.py,sha256=q9O6lkfRRCKcL-E4KIo4zSjlhYNEuedp3LP--FHuuhs,20042
+socialctl/inbox_cli.py,sha256=a6c9SYcNLfjp5MwXQWa1yi0p9eyoCU0QqmR4Z1Ag9sU,3198
+socialctl/inventory.py,sha256=57RxmRUgLPhLePRP3G-Bfav0CQ9qnk7P1wEnD6eThGY,7088
+socialctl/inventory_cli.py,sha256=fiwHLRcCtYW6VYBIrcxLpsJVZD1e98zhfqTD_4bsNLA,9458
+socialctl/inventory_sources.py,sha256=17OsoPxc5kRfHuZJuj1hAwbsC-jfFUt4IfC2HBR-Pgw,5177
+socialctl/media.py,sha256=qERziLP5N1vgrnXrsKkQf9iCUUeF2ERDS1SUntUdNOU,11397
+socialctl/media_cli.py,sha256=Y8XWyPxs9F8OG9PnoLIIEOL6vItH9s-kUcGgVcwTphA,9242
+socialctl/media_ingress.py,sha256=S9xfOo-b0Jga_0kzuZSBSP7xWh1FzrmmFGAOpEwj-QU,11409
+socialctl/media_preflight.py,sha256=iHwI6cS1fEC5TxidEPc4OLwb4WX284d2itPNYhxEWrk,7328
+socialctl/media_registry.py,sha256=TBLA4DBdPGppa3wqI-Ykoyp15JkBo60jkS6nMVG-qPA,12872
+socialctl/media_requirements.py,sha256=LX0ze-d_N2C2f60_-RJc_fn8R-Gz5p1OY_cDuRTd_VY,3672
+socialctl/migration_cli.py,sha256=N8EIUuvvCnO9NI-eeplsSvQIK3mMscjoQqXpl7qWAZQ,3019
+socialctl/migration_files.py,sha256=ohpaIZF0RjLAI2Rj5AQwZcRRbKH8hEYBy8ncatZ-R3s,2776
+socialctl/models.py,sha256=xkT06nUZtGd7m8WgZZLgNEq-h7ghyr_pH9eHA8KWt4I,5405
+socialctl/operation_output.py,sha256=6j4_zFuanr97Ym9RshJydjaZ9oPdk2zlP9uaRdxStbs,4192
+socialctl/postfile.py,sha256=RSNQKKEHH8OE7eosd9nkRUsT2o9Q7A3oAL55Gw9A8uE,8946
+socialctl/preflight.py,sha256=Sa2dEcNvb_L-8Gd5M0FMJM8eH7tctewtppKKzKsAfz0,3294
+socialctl/publication_policy.py,sha256=NgZ3xJwh1oCpO8Pq-IWZDDM53QLnRKSIwwj3ZtekQEQ,1666
+socialctl/publication_status.py,sha256=9uAubMLqjhBHvY6UC8C_6GZVjjvmLtjSv0ZQUNPnVTc,3223
+socialctl/publication_steps.py,sha256=lgzxiX6wqcpnqe2lasGtvk_PgyzEGTM7nWR5DgJYBXw,20189
+socialctl/publish_output.py,sha256=-etcw5NhQ5v003SJ9x4iVslNItvxcZjLx05AfDe0Qa0,4406
+socialctl/publisher.py,sha256=IacW5xVvnVhCLSQvhVp-EXLRv4DNXsM-BYlf29zZI9A,19481
+socialctl/queue_migration.py,sha256=LfxhCmIWlpvcEs1OCjh-ch4bUU5KaEodMT8mEVFTCxg,17295
+socialctl/read_budget.py,sha256=vEmAFPw0YVQiMWO_Pir-n0Ml1nwMUHwR7eCmqzZ_AEU,8980
+socialctl/read_reports.py,sha256=5G_ISxwy1PeMfanDuWX3_VpE9E8yRa1QR1UJi0LCZwI,3832
+socialctl/rutas.py,sha256=BFMEwYFcYtjCgrdBEjnjtjzbfd2M24UbxMkLoDWVs4Y,3176
+socialctl/schedule_remote.py,sha256=mDMJt6OVjktzbqdg3zZHcuMOGzty6b5_YgOKZurPrgU,11872
+socialctl/schedule_sqlite.py,sha256=eNH6crxROqKpFEMBYHgmzoH-wJTsimtV5IFTPglfJno,1732
+socialctl/scheduler.py,sha256=SkIRSHGlz5Zna893OhD7SNqr7j16MhWnxsdXSC1yHYE,24357
+socialctl/scheduler_launchd.py,sha256=j83yWSOn6-ayxICPD0ZFXcvMWzUaMXbAbS5VUxxyI_M,14729
+socialctl/scheduler_systemd.py,sha256=LENCFf1ONdgxS3g_8bmPbap1nz6A1cqNUmvoc8uUKx8,8104
+socialctl/source_links.py,sha256=uLYTZHUV1LLG9E-mzaR9ZcGY_MYuGHiA9hegyvUAR-Q,5150
+socialctl/upload_consent.py,sha256=o5yvAHIW1aFrxh4_5DyfmzGIi7xGzxCvyhCeBPsk4iI,625
+socialctl/workspace.py,sha256=9UHAudzn5L7ph5xDIvKMmFV9Tfqgp2AC7uqSyhFZOBY,282
+socialctl/youtube_data.py,sha256=Mwj4GtupQ7QMwVQH17gY57rxyaoAKoXjfvC_9K0CNo8,25904
+socialctl/youtube_data_service.py,sha256=0LFwEP3wwL-0dFeFmGtRkZrdYbH_aZYwwYzkvYTfXJg,12515
+socialctl/adapters/__init__.py,sha256=alhYdPAuSS3mjoWJkUvcPPiJ-j_wthyWiT2jFOmKyso,259
+socialctl/adapters/base.py,sha256=yIaNIElmmhVSaqryNe1IEtkmNVGk0ubKV1ZaUhbfPko,2440
+socialctl/adapters/errores.py,sha256=zwMDFMSpm1HTEe3BYrWoFgnQKyZK0BXcfob9m2wfbII,2281
+socialctl/adapters/facebook.py,sha256=1XT_6j2Tdj3_poXkHk7TW3hzdc5IlE0TPqsI1UrAQuU,7617
+socialctl/adapters/instagram.py,sha256=QASMlAhcRg8y8Ief1CiJKgPOWt6-0MuwqzBbZiYlsr8,20807
+socialctl/adapters/tiktok.py,sha256=A65fWWsOIm5BocSbR6GoizYmARQkTfC7kjfaKqGSGWs,22473
+socialctl/adapters/youtube.py,sha256=rOvYUvFmEYjgFt82KU03LMRwIqZHc0snAQcuTaleUTI,14232
+socialctl/connection_service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+socialctl/connection_service/__main__.py,sha256=7lRogxeJPacEv-nroh9ZdXAjH2IiJgY1Jhe_ZMOp2tc,1196
+socialctl/connection_service/app.py,sha256=flGGsMs-0c71a7i-9v1dQvif-D7iYaIogUgWDcLy66o,29517
+socialctl/connection_service/landing.py,sha256=U_u3CETMb1FxHLhV6g_zp-KAkV-6lBtE8MR5zDs_HY4,9165
+socialctl/connection_service/legacy.py,sha256=7RfnXZ-8QV9F7K3zhNIJnu8qdfHbKe93-GzMps7u4KU,2932
+socialctl/connection_service/peer.py,sha256=j58hz1rkIgctAvwpIfzPGKEIla0koqeCh19Td9kDf-4,484
+socialctl/connection_service/providers.py,sha256=vZlMdD7yl0CcD766gK2nISICiq30UUuM89DkrgXCuXw,18621
+socialctl/connection_service/settings.py,sha256=SeZ8GWka5kJ0u5NUNXBfjwdDZ9wRQ_5Br12ZzUHaIm8,4068
+socialctl/connection_service/store.py,sha256=xnaWOp_6CfVItuw3GrIV80vHjptOEvN6Fnbnp7JyBYc,7804
+socialctl/connection_service/assets/PLATFORM-LOGOS-LICENSE.txt,sha256=qTln01sbo6pxnSHj1JaDJc4Rp0fim4tZrsuFT5p1u_A,7424
+socialctl/connection_service/assets/connection.css,sha256=QIfJppSpAGofSeD-eWxpFi7lO7P8A9j-hH4EP3VPSog,8723
+socialctl/connection_service/assets/facebook.webp,sha256=BOOKYfnLN0C085IMpaMYSAJ2YwVv4Hcg1-dg5GQQtwo,27072
+socialctl/connection_service/assets/instagram.svg,sha256=aaf9ceB3ERS1s4DkE0EloGbjXambRP5WBO4ML8eejp4,13615
+socialctl/connection_service/assets/socialcli-logo.png,sha256=ShFXrB9hES6MvNdMNDCuYHQmT6BsP_323nKJmq4cblY,847748
+socialctl/connection_service/assets/tiktok.png,sha256=B9yfoewhvRdduETG1WjAN0iWGsTpImgYsPZ3PBoeCYQ,11997
+socialctl/connection_service/assets/youtube.svg,sha256=f1FWRIucG2UVbjTkRD8O_4uF9a-ng_yKjQn0k4D-1CQ,474
+socialctl/connections/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+socialctl/connections/account_cli.py,sha256=Nr7DaM7FuxUVkvh3FavarbSFLU7ooMDDxyPujSUTz1A,27606
+socialctl/connections/cli.py,sha256=EsQ9iHriZREMbFk7NIuV3xA20kpAvzB44vepDvEElf8,22719
+socialctl/connections/client.py,sha256=EXUSsN5hBsXSv9ZT70EUe3lnH7mlTVSdbKXzmkMxRz8,6216
+socialctl/connections/credential_cli.py,sha256=NL9oEzYefHEobwgkmiRQ_3bPH-QahTyN_b_A4fDXSIk,12688
+socialctl/connections/credential_store.py,sha256=vyEPLgDMnmd8joDwj1kKvzzF-kMy-BYoxSrKn0X2M-8,1939
+socialctl/connections/file_store.py,sha256=sKhunqb0boJRSoXTqZcnmRVAdgVRpxGDeoukDZDTrhI,7838
+socialctl/connections/keychain.py,sha256=jHZw4oRqd4GWit0kqe2zxLMpPmKwdg-dZiAMDWsyJZ0,2709
+socialctl/connections/meta_user.py,sha256=tNx5OIScdsCgdgBt0pWHlqXVxalHfFH716lUaYpEC3A,5184
+socialctl/connections/rotation_cli.py,sha256=AEYAQCwsGRIf5jWpkQm8GY_Y4nNHa0CqMChNeqDayNo,8470
+socialctl/connections/saas_client.py,sha256=JXJILjmTdq_1yTeTqWFA4orohdJ5sJtjiNM9pK89PCk,7234
+socialctl/connections/temporary_media.py,sha256=BnVkZL0ClgTVP516xYvmgvtGalkqbet0OMe9913AiQE,3144
+socialctl/management/__init__.py,sha256=t04iFkzm438qvqCPfHueAiF1fak4eKJMY93ejC3p6p0,55
+socialctl/management/batch_cli.py,sha256=fVDgKOv-AbW88FQM3X_ESJzx_7JzUlNCkBo6Hp6K8lo,6001
+socialctl/management/batches.py,sha256=EUVlU8jbRU2akUu4fc_xVTw8MAZEVO-Qvo1thTvy_fE,14027
+socialctl/management/changes.py,sha256=yrIL6qI3Rf9kpaVjravwDDd1NhTOxs3KoeK2j8akX08,17526
+socialctl/management/cli.py,sha256=zFFeVm0ifVqbz9ztPhVRYEjmQNch58qVtDL_wr6rTm8,7933
+socialctl/management/comments_cli.py,sha256=ihKZl9ssGTR8XI6BdWvsX56QvYuR1kl_N62fdGyWtC0,20001
+socialctl/management/community_batch_cli.py,sha256=9xAWIzKxK7ovabP1ngLqOn5ZU6BJuSFTqoyYnN8Ec6o,3732
+socialctl/management/community_batches.py,sha256=3ZaqXxD4W78NfK0MvGddSXuRtwgDBRFyBFNs4_QAww4,16169
+socialctl/management/community_changes.py,sha256=he4BqaHGnY0mW8XU6aCYB5kg47DKa8pkGA4hoR3fmUg,20600
+socialctl/management/community_cli.py,sha256=no9awxKiCIKxHAhzSYMYDszCRbPgX4Ak0tZCWt9a840,10169
+socialctl/management/community_schema.py,sha256=CWzv443pnGZCE4jd8DumsH1cAEPumpTx1xTYPxEXOrc,5092
+socialctl/management/facebook_groups.py,sha256=6QLkAHsWwHF7OwKhFMGKDwtDeVgPv2pgigt050cPvC4,45511
+socialctl/management/groups_cli.py,sha256=21p5ZfnScYik5yxidJDF44BMVzCRiQ0ZlnykMfz0Fzk,11445
+socialctl/management/inbox_readers.py,sha256=8DTUlivtAiLRnO5-yHDjngX4wDWHbOfNROAK6SLl348,3760
+socialctl/management/meta_changes.py,sha256=mMX4sBDg6seFnD-865KiODWs8xXeXxI7f9klp6-aYJY,8818
+socialctl/management/meta_cli.py,sha256=qG_y2prECoyzlo2-RAj3n89tRbX4UKBjij12acgrtrY,14019
+socialctl/management/meta_client.py,sha256=giynNCMmePUC9IaU34nW4Fh0pxMQLSiID9ISJQnQVjM,39380
+socialctl/management/meta_comment_inbox.py,sha256=KD9J3pX-J6-9c_GSc4kMXWHNLabNcoCMJS8CkBm1vLk,28390
+socialctl/management/meta_comments.py,sha256=ilBmnMj5x6FpYw_jPBAVgpyWCvEerSTcI6ueM3YaUqY,30298
+socialctl/management/meta_errors.py,sha256=jOrYOBaeYm2ZwwgwR8HPdiH9BhoZn5MxX0eLHfKPgfk,2695
+socialctl/management/meta_pagination.py,sha256=uCNLokJjzjvCwiudZ0Rqu5gXNSNozRSgkqDtCN_KF28,2252
+socialctl/management/meta_schema.py,sha256=x_mdfMQTcXbay21iWlU9XVrG1jIWoSfzXdMDCEbwkbM,4693
+socialctl/management/meta_webhooks.py,sha256=Xt0jqA6lqG28h8VFq6lsZHI7Gmpr8hO6qzDYDdUikwc,8093
+socialctl/management/metadata_parts.py,sha256=KI-AXjE1ansOi3XCTwH4vYwseFOJoBi_fvGsqq8Dcrg,7775
+socialctl/management/owned_assets.py,sha256=8vgMEIrTV_T2FiVTAZU_wQQnJOlUUHCWfLIX2iTEzhw,4004
+socialctl/management/owned_changes.py,sha256=hZbnmpj96s0gZd71MlCIBRO1Aiy30D6RtT_R97A7Nt4,25772
+socialctl/management/owned_cli.py,sha256=39I45aeav-qgFA-6tYG5Zd4BnUWP1WSRyIqZPU1Vomw,6691
+socialctl/management/owned_reorder.py,sha256=zk59W3TJZ1HcgsMeOwj85DzB7Ry1kPjif5sN_lw646w,3623
+socialctl/management/owned_schema.py,sha256=EX9i66XrMMRpRIYmlu0errC3HUB82spDBXEiXw0mmco,19952
+socialctl/management/reply_context.py,sha256=wWLUvtLqdtaT03J0fhescPlToLtxSk5HXofigNmbAIg,1509
+socialctl/management/reply_evidence.py,sha256=gscXyZj9SbWhUn7OW40rFgLTwuHu-jgj-TB0M7JQiUQ,4320
+socialctl/management/resource_changes.py,sha256=nseklqxxZ0cuaFckcgG3CavdwXPdIho-_rEGZAhwDrA,20964
+socialctl/management/resource_cli.py,sha256=hINDGj4Zi0GAWzqKtzyqqrEx7xAf8tk1-N8kqntaow8,7127
+socialctl/management/snippet_readback.py,sha256=WO84_L7TyqJtD4okdAyF8ki5pwa7FqTFn-fOcVh9WM4,1246
+socialctl/management/stories.py,sha256=CBne8BcGlGoUYH2-i9eLPC3Yxf7Mlh4gtUlMeKwKQIE,29554
+socialctl/management/stories_cli.py,sha256=TgEvjoAyGauR2bX27vumbdEyWD5ryXyfDTRJWuH0fAE,7104
+socialctl/management/youtube.py,sha256=Eas89K5o76s-8JMJo7f9K_yl5EBY0KjxAThAHffXxnM,13108
+socialctl/management/youtube_community.py,sha256=wZIrHz8aP5QA4viZMU9EVrsAvqv888HOFzDV0j-2PuY,19517
+socialctl/management/youtube_metadata.py,sha256=zYIlgtC6s-NuhyDzwaA-3GdhNyU7sytW48FUJWn_Kx0,6513
+socialctl/management/youtube_owned.py,sha256=_BeteA8L6C7V9YBo656HR0Mri5ZvbzDSPrrjCDPFMLw,15751
+socialctl/management/youtube_resources.py,sha256=FW-dVF2LGCq0ivfbLH4AmoFBviBGdkEds5LI9l6A9KA,15656
+socialctl/metricas/__init__.py,sha256=cpYEcSTf66Rnre_I6pn8pGZFN3gUmX9SSQ6NKsOalcI,285
+socialctl/metricas/almacen.py,sha256=ppIYnb1N7fu5pwKhhinGUWub2VB5R7MrZuQ4q6-9SkE,4948
+socialctl/metricas/analytics_changes.py,sha256=F3lBUSAjgQl9v6yQkNAfLEisn8b6y2FhAS8YQx3mIbU,14825
+socialctl/metricas/analytics_cli.py,sha256=jIOz3l9X8DXy-xoC51NOT_KxTa7YfGxOwHke5g4JFcY,11031
+socialctl/metricas/analytics_client.py,sha256=BPijijFWmOmyaj5xiIpCWPk-AvRHERQFjfieNxaT7CA,18909
+socialctl/metricas/analytics_ingest.py,sha256=zNbM9DEeNnfoapCTj1cypXEfQ48Kz0unr26dfARa9Hc,15438
+socialctl/metricas/analytics_schema.py,sha256=gKUJ2fXqGYcm0dqs_KWATlAGOK6X8VZ74qGH1r6clZY,11690
+socialctl/metricas/base.py,sha256=v5Y2c0FJqkaN-yQiHwqgOmpdHuBERzfIIZmii3jMPLQ,6912
+socialctl/metricas/facebook.py,sha256=fRkQ3bVyo8Xv85upsi9lvmSP69M8oyFAhtbsic7WwHA,18527
+socialctl/metricas/insights.py,sha256=v2KwGytyDZzXR3uFAJSfFnEBIcaJBAs7K8nrV3P6sIk,12503
+socialctl/metricas/instagram.py,sha256=drsyavF3NYhhDJ5bl_AAhQKKpQygv31qFTifegyd3u4,5683
+socialctl/metricas/modelos.py,sha256=wEo0X_N7JmcD510xKjaM3quVi41dYGJyNXQ-NYXMlZQ,2714
+socialctl/metricas/piezas.py,sha256=Ng52s-CTQUTdf1nWcRR84LVbuuWZxKoPyvKSbgEKumI,5924
+socialctl/metricas/reach.py,sha256=mPyDHJdj-6xXf3tLDEGIc9P4aEPUjQyMEsasF2sk8o8,4181
+socialctl/metricas/reporting_client.py,sha256=4xfrTyrl4gOBVyIrL3zpUVUI600Bbvswy2dKbCmX2Jc,5998
+socialctl/metricas/resumen.py,sha256=UTwT9VGVzaTS3WWEsKGH_HJ7mVWiUfsxk0zhu7O_2qE,11112
+socialctl/metricas/slugs.py,sha256=FluUgAs4Y2n_IwiLS1xch575Pc99F8vjDBbVgYt3LQc,3459
+socialctl/metricas/tiktok.py,sha256=z2iEkzW1owaF6twpcNcthSlqgOyusDE5X28jIlsdL34,8141
+socialctl/metricas/youtube.py,sha256=PrHudr_VMskf5XFSfVqmTeBurY3_7ip4UlDiHhFg2Uw,17630
+socialctl/native_schedule/__init__.py,sha256=NF-U_AIOP6YCmsQqJD-pjCijdRqi65j_eFywNi9EylI,387
+socialctl/native_schedule/api_delivery.py,sha256=CoJHpVEDW6jJs31avBl82_iQ7YTWCFet0OIaBGfjqiY,492
+socialctl/native_schedule/api_reconcile.py,sha256=FwSPSL31LLGyP9ZrtuP3Iz6qs2iXhhUHZGEqpqsfEy4,1862
+socialctl/native_schedule/approval.py,sha256=tZB9_afKEUSkP4np0oTP7WCQeE6aYAUD7ytGG87Al_U,8179
+socialctl/native_schedule/cadence.py,sha256=iWRsyPX7Njoku7Tkd1-Xi0P_DtzkgxW01kbB8iW7nlA,3024
+socialctl/native_schedule/cli.py,sha256=Kitq5Eyu_yXf7ieS1YLiGgsC333CPdPjbIM6pjUO_Yw,30614
+socialctl/native_schedule/dispatcher.py,sha256=fOUCy9Edkk41jx7VRNn5s9R2QYxnuJWGe9EMaPy2vjs,6862
+socialctl/native_schedule/facebook.py,sha256=F8pj0aeUVgo1Nu3HdeXAnDPQKkfZ7eBE45OVaue1QSM,5037
+socialctl/native_schedule/facebook_reels.py,sha256=t2GIH_rehfNVGp2nwcGyCLUljpWTai3TQtAvWM58ZG0,6827
+socialctl/native_schedule/first_comment.py,sha256=FGwCnuUkirqx0WFaF3AvH7k6HL9VGqkh7bZl88uWMVM,9818
+socialctl/native_schedule/handoff.py,sha256=BaqT4gn9ItikDkJctgd_t2NkNxuDa0MY_d3J6KfPkG8,9207
+socialctl/native_schedule/instagram_delivery.py,sha256=cq73jAcrMDQug4hEYl7I_YK7u47ssUT7X1V1R9yYy9s,10648
+socialctl/native_schedule/instagram_runtime.py,sha256=dgGJyzIrKFQjD0tKucx3b-265n24nuKEqIBCBHfBP7c,4141
+socialctl/native_schedule/inventory.py,sha256=nxIwhOX1KcXnfpZ0vCEwiIW8RLpanYg60SwNPFpC8C0,3765
+socialctl/native_schedule/migration.py,sha256=5Wea4pWq_gp9Ybnu2d00cyiotuyCi1_OZes2ia2T6xI,17247
+socialctl/native_schedule/models.py,sha256=EBlrDJtfazoBeWsLlX0toYOkcEQ1ueYUgF29YBAA_w4,3759
+socialctl/native_schedule/reconcile.py,sha256=LcSEayCfL5AvCPGTGksGLsnF1FVVh3UYQQeS7nVOrF8,4158
+socialctl/native_schedule/remote_data.py,sha256=CTLfLulufRN-xfLWmaKObwCVj6pGFT281zCRWo3H5xs,11245
+socialctl/native_schedule/report.py,sha256=prEbasLdLRxZ-DkNoHoDTMN6NoL3XnnYpHHD2GzTzKA,6945
+socialctl/native_schedule/store.py,sha256=Ag6c9JulrnCgnFP3kBS8hX1s5wPXGUnFO2o4mDLVcDI,34016
+socialctl/native_schedule/verification.py,sha256=sPNpRqr5yYgfnWw9EUL-eT5AQtXMS5r4m00cu7_R8Uc,1517
+socialctl/native_schedule/youtube.py,sha256=49R69xWvbQ2uhlcxTPD2txHnqVxkICZNYWKk4LtnGd4,17634
+socialctl/plantillas/accounts.yml,sha256=Oi5qZBY-BtFJNM4GbT_zRuRlLWf1VcH33BDoclUX53Y,1362
+socialctl/plantillas/brand.md,sha256=v8asOxL9RIC9l2AvJOKeSVL7Pncugx5hBfFI9IoOpQo,3298
+socialctl/plantillas/estrategia.md,sha256=crm69Lq8gOjbMgbW9IYD8vxBG16XVdkJSeWVL_fYqGY,2195
+socialctl/saas/__init__.py,sha256=BWyJVYgra20jZGzjbv08u6p9zFpR-SF8HSu1DB0nQoU,82
+socialctl/saas/access.py,sha256=DtiWaeemSzCrimoaIsPysczeDGstjA7GgjACtXJXpdE,3673
+socialctl/saas/auth.py,sha256=aPvwP5zKrZrp6RFRkTMLPOKoCwz0skKsg0uXuYFGeHg,10771
+socialctl/saas/backup.py,sha256=2dXt4xs8DzfpCGzz_tjecPfRKONo0cI_bu9KmaENdew,6420
+socialctl/saas/billing.py,sha256=EQK2rePnawJENCS1iW_s4XpreD2Y2k3Qkr0NRXTblQM,20172
+socialctl/saas/billing_enrollment.py,sha256=yxUvMQS_q-aCAv9Yn6EfCVs9tblPUmEeVAu620HVkr8,66814
+socialctl/saas/billing_enrollment_schema.py,sha256=0_FT1h38iavzXIDh4DW0hEBIYZ71fd3AmXBTjZG1T_g,15458
+socialctl/saas/billing_inventory.py,sha256=GJ8P6khOhjWh-9vjLHjuHXKVh2DZl_lprGrC7NGfV30,39775
+socialctl/saas/billing_reconcile.py,sha256=ieyhuJrHkJ9hoEmkeQUBM0hD-1OoVNlHeTVAdj67Cgs,8054
+socialctl/saas/billing_routes.py,sha256=n8fWUz_lsZlvq9JJjDHW5BL_uWWiD72bF5rdi0Svo7A,1199
+socialctl/saas/budget.py,sha256=w8B-0Tm5VowhTdmB58omRhbBPKrs2s8c4w5-tMFIhG4,1887
+socialctl/saas/connections.py,sha256=0CM09BBwvnBCQSJsOundJzYB7ZET-HCyBG5QCYSJjuo,25711
+socialctl/saas/consent.py,sha256=hkwbHyqsXDyQI8pdPIMBkg9v8jGn3ezJTWTUntDGu2M,2581
+socialctl/saas/lifecycle.py,sha256=hGKIeM8iaWPb0XCNg6pNKkfLNgCzG0TVc0AFVYnOHuc,25799
+socialctl/saas/mail.py,sha256=qpONTBD263B7iK_JbowyrpAZnVQioEV1Rw99IAnWZMA,3465
+socialctl/saas/maintenance.py,sha256=tiLPsrA_svQPI_gGbAyPk9S9zYO3yfEULgMa75axHsM,3547
+socialctl/saas/meta_user.py,sha256=JnbflRaPnlxlEe3NE0wM61e1WlZoM8WONzm9flpJY3Q,17992
+socialctl/saas/meta_webhooks.py,sha256=iJByhQF44lCs1tStkCmzNwLEPDWxEU_cDMGzf79EdHI,21709
+socialctl/saas/migration.py,sha256=cuF64WbXaIFfrtj8P2dXQNW1XZ_RGJs1PBZwQO8ysUc,7674
+socialctl/saas/models.py,sha256=hyVA-3gTS6s1bUONjW65Io24AoZlKSLt84m8vPwrnjQ,171
+socialctl/saas/operations.py,sha256=x3pIScVhS2MyM9s-Zx4x1bfHmighk1lxSKX3MVzrwRI,5680
+socialctl/saas/pages.py,sha256=q5P3TFuESZpb1fHh7rSSunC9O0Y3YwbbheAw1f16blI,10052
+socialctl/saas/pairing.py,sha256=eA0mPWq-Xw174XTggYdeE3zcqKy1Xeludmf4pQCAKFI,9321
+socialctl/saas/permissions.py,sha256=T7URr-Mu-zyyKbNyx-PV-BlYCDaGmRFnv5ZoToT-myw,2910
+socialctl/saas/reminders.py,sha256=tiJ82R87Jd8-o1JzDaBjzqIs2AneIFpOui2NNZHC22w,7919
+socialctl/saas/renewal.py,sha256=T6O8UCoI_2NGoapyFT9tbZM4v7XQbZ0eh6RxFrU7N1Y,3823
+socialctl/saas/restore_guard.py,sha256=nf0qhKVklY1OqnFioUzDR4e4iTEe0f5VhIfs8Us_RJc,14395
+socialctl/saas/revocation.py,sha256=JbNNFgDbXEiF4Xq_VFrwpeLsAe1MrD-4pOOgR1m8_wk,5498
+socialctl/saas/rotation.py,sha256=CWsVXYo8u70HgipqwD8WBlqHGPyhH123fqTsacF5Pbo,7631
+socialctl/saas/routes.py,sha256=dJN2rjNUdYnNvUOtzrs5aeZ1nSo1XaXSagho4Eh1pXo,12477
+socialctl/saas/settings.py,sha256=xfjgjn2ugFTh_5Gu8u8j7uuOTpb8LdUJmQ9OO6Gs13c,1558
+socialctl/saas/store.py,sha256=JzLc3cSvkMsh6j8bdGBLf_MLWjGAg0-0wNyOC009xn4,9126
+socialctl/saas/temporary_media.py,sha256=V7XFLSlceNiUkKkaWglvfG91p30D15eplEDmaAguXVE,12851
+socialctl/saas/webhooks.py,sha256=P7TK4jmz67fFZhNHEyVozZqgkEk2gQi8i0VyuwJXVnc,4442
+socialctl/ui/__init__.py,sha256=LjSx2Msio0qF4fna7yYdXqlVJly4PzFoolJcPoxxhyk,89
+socialctl/ui/assets/agent-manual.md,sha256=mG_NhiuWrmZS0DxIPAPdvwdW2lRzbF7bKP--2N54Qbs,53108
+socialctl/ui/assets/agents.md,sha256=8hVflKSVHufG7krFaapHge8QTXDQa_UighsA3JWnhrU,1955
+socialctl/ui/assets/components.css,sha256=pI9mI4hlm-e-dclRoZac8JVlEam1iIJ6AhO0KSIw_ZM,1854
+socialctl/ui/assets/connection-layout.css,sha256=SxkRkagEy7Bo2uj-eAri946iapIQqbD5hqvq-I2BDZc,6480
+socialctl/ui/assets/otp.template.html,sha256=g0JXM6gtfciL9BmwDORVHjLYq65OMjXyCPQGq2L9cFY,1248
+socialctl/ui/assets/tokens.css,sha256=Pzna4WThULiIsbeFL2ISpRZKavzwesj9FwoXGk20Bf4,315
+socialctl/ui/assets/trial.template.html,sha256=f8fYQLkw-4YukGTwIgeKbETknhj2KyUb9pfPKU1YyOQ,1572
+socialctl/ui/assets/web-layout.css,sha256=oe5ZarZ_ql989sF29-5Bn4189IvHI5Oxwt89KjkPO04,6007
+socialctl/ui/email/otp.html,sha256=tEzv7traUe2qcMH98HNJyCtF8lLIUyqGQ1ybDqLL2s0,1194
+socialctl/ui/email/trial.html,sha256=auzr8MAOwsM5-wmSzL3TV1o4WXZhbTy63j73A3yKd10,1508
+socialcli-0.3.0.dist-info/METADATA,sha256=OKKYGPm5FoYYRUfzTpoAmqpjHOUh2S5gWsBVAwfVsV0,9572
+socialcli-0.3.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+socialcli-0.3.0.dist-info/entry_points.txt,sha256=fch-ed2Pcudr_MshRQ3CAo40v7F-xbu18UQxmdhjugU,78
+socialcli-0.3.0.dist-info/licenses/LICENSE,sha256=USd1tS37hSkMGbxwJJZvncsZ-NZBbe1rUbtwSZvLnVg,1074
+socialcli-0.3.0.dist-info/RECORD,,

socialcli-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

socialcli-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+socialcli = socialctl.cli:app
+socialctl = socialctl.cli:app

socialcli-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Engels Florentino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

socialctl/__main__.py

@@ -0,0 +1,6 @@
+"""Run the installed socialcli interface through its Python package."""
+
+from socialctl.cli import app
+
+if __name__ == "__main__":
+    app()

socialctl/adapters/__init__.py

@@ -0,0 +1,6 @@
+'Importing this package registers all four adapters in ADAPTADORES.'
+
+from __future__ import annotations
+
+from socialctl.adapters import facebook, instagram, tiktok, youtube  # noqa: F401
+from socialctl.adapters.base import ADAPTADORES, Adapter  # noqa: F401

socialctl/adapters/base.py

@@ -0,0 +1,68 @@
+'Common interface for platform adapters.'
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+import httpx
+
+from socialctl.brands import Brand
+from socialctl.formatter import validar_privacidad, validar_texto
+from socialctl.media import validar_media
+from socialctl.models import Platform, PlatformPost, PostResult, ValidationError
+
+_SIN_VALOR = object()
+
+
+def _sigue_siendo_abstracta(cls: type) -> bool:
+    'Return whether cls still has an unimplemented abstract method.'
+    for nombre in dir(cls):
+        try:
+            miembro = getattr(cls, nombre)
+        except AttributeError:
+            continue
+        if getattr(miembro, "__isabstractmethod__", False):
+            return True
+    return False
+
+
+class Adapter(ABC):
+    'Common validation and publication interface for every supported platform.'
+
+    platform: Platform
+
+    def __init_subclass__(cls, **kwargs: object) -> None:
+        'Require every concrete adapter to declare a valid Platform value.'
+        super().__init_subclass__(**kwargs)
+
+        if _sigue_siendo_abstracta(cls):
+            return
+
+        valor = getattr(cls, "platform", _SIN_VALOR)
+
+        if valor is _SIN_VALOR:
+            raise TypeError(
+                f"{cls.__name__} does not declare 'platform': every concrete "
+                'Adapter must assign a Platform value. The type annotation '
+                'inherited from Adapter is insufficient; assign a value '
+                "(for example, 'platform = Platform.TIKTOK')."
+            )
+
+        if not isinstance(valor, Platform):
+            raise TypeError(
+                f"{cls.__name__} declares 'platform = {valor!r}', which is not a "
+                'Platform member. Use a Platform value '
+                '(for example, Platform.TIKTOK).'
+            )
+
+    def validate(self, post: PlatformPost, brand: Brand) -> list[ValidationError]:
+        'Validate platform content limits without network access.'
+        return validar_texto(post) + validar_media(post) + validar_privacidad(post)
+
+    @abstractmethod
+    def publish(self, post: PlatformPost, brand: Brand, client: httpx.Client) -> PostResult:
+        'Publish the post only after validate() returns no errors.'
+
+
+ADAPTADORES: dict[Platform, type[Adapter]] = {}
+'Registry of adapter classes keyed by Platform. Consumers instantiate ADAPTADORES[platform]() without arguments; concrete adapters must not require constructor parameters.'

socialctl/adapters/errores.py

@@ -0,0 +1,56 @@
+'Extract actionable provider error text while redacting known credentials.\n\nPrefer the provider error.message field when it is a nonempty string. Otherwise\nretain a bounded response-body excerpt. Redact literal and URL-encoded known\nsecrets of at least eight characters, including proxy responses that reflect\nrequest URLs or bodies. This keeps diagnostics useful without disclosing tokens.'
+
+from __future__ import annotations
+
+import urllib.parse
+
+import httpx
+
+# Recorte razonable para no volcar cuerpos de respuesta gigantes (p. ej. una
+# página de error HTML de un proxy intermedio) en un mensaje de error.
+_LONGITUD_MAXIMA_CUERPO_ERROR = 500
+
+_MARCA_REDACCION = '[TOKEN REDACTED]'
+
+# Ver docstring del módulo: evita que un "secreto" de relleno (típicamente
+# muy corto en los tests que no versan sobre seguridad, p. ej. la cadena
+# "t") acabe redactando subcadenas normales de un mensaje legítimo. Ningún
+# token real de las cuatro redes que publica este proyecto es tan corto.
+_LONGITUD_MINIMA_SECRETO_REDACTABLE = 8
+
+
+def _redactar_secretos(texto: str, secretos: tuple[str, ...]) -> str:
+    'Redact literal and URL-encoded occurrences of each sufficiently long secret.'
+    for secreto in secretos:
+        if not secreto or len(secreto) < _LONGITUD_MINIMA_SECRETO_REDACTABLE:
+            continue
+        texto = texto.replace(secreto, _MARCA_REDACCION)
+        codificado = urllib.parse.quote(secreto, safe="")
+        if codificado != secreto:
+            texto = texto.replace(codificado, _MARCA_REDACCION)
+    return texto
+
+
+def mensaje_de_error(respuesta: httpx.Response, *secretos: str) -> str:
+    'Return bounded provider error text with known credentials redacted.'
+    try:
+        mensaje = respuesta.json()["error"]["message"]
+        if isinstance(mensaje, str) and mensaje:
+            return _redactar_secretos(mensaje, secretos)
+    except Exception:
+        pass
+
+    try:
+        cuerpo = respuesta.text.strip()
+    except Exception:
+        cuerpo = ""
+
+    cuerpo = _redactar_secretos(cuerpo, secretos)
+
+    if not cuerpo:
+        return f"HTTP {respuesta.status_code}"
+
+    if len(cuerpo) > _LONGITUD_MAXIMA_CUERPO_ERROR:
+        cuerpo = cuerpo[:_LONGITUD_MAXIMA_CUERPO_ERROR] + "…"
+
+    return f"HTTP {respuesta.status_code}: {cuerpo}"