@listeningkit/log 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/AGENTS.md +65 -0
  2. package/README.md +65 -1683
  3. package/docs/README.md +27 -0
  4. package/docs/accounts.md +63 -0
  5. package/docs/accountsAndListings.md +76 -58
  6. package/docs/adsPower.md +78 -44
  7. package/docs/browserSetup.md +58 -0
  8. package/docs/browsers.md +44 -26
  9. package/docs/commandNaming.md +27 -30
  10. package/docs/conversations.md +30 -41
  11. package/docs/deployment.md +78 -152
  12. package/docs/deviceIsolation/deepResearch.json +1130 -1130
  13. package/docs/deviceIsolation/deepResearch.md +353 -353
  14. package/docs/diagrams/browsers.mmd +1 -1
  15. package/docs/diagrams/commands.mmd +8 -0
  16. package/docs/diagrams/platforms.mmd +7 -0
  17. package/docs/diagrams/surface.mmd +3 -3
  18. package/docs/errorCatalog.md +7 -2
  19. package/docs/groupListening.md +55 -52
  20. package/docs/groupMembers.md +47 -34
  21. package/docs/groupRead.md +89 -57
  22. package/docs/guides/facebookBrowser.md +21 -21
  23. package/docs/guides/facebookFlows.md +6 -6
  24. package/docs/guides/facebookMarketplace.md +1 -1
  25. package/docs/guides/knowledgeAndSearch.md +5 -3
  26. package/docs/guides/linkedin.md +50 -0
  27. package/docs/guides/logMcpInstructions.md +34 -24
  28. package/docs/guides/runsAndEvidence.md +5 -5
  29. package/docs/guides/xAccount.md +7 -3
  30. package/docs/guides/xInbox.md +9 -5
  31. package/docs/guides/xSending.md +86 -27
  32. package/docs/howItWorks.md +104 -0
  33. package/docs/infra/apiKeys.md +27 -0
  34. package/docs/infra/node02.md +96 -3
  35. package/docs/install.md +68 -0
  36. package/docs/knowledgeBase.md +35 -34
  37. package/docs/layout.md +53 -0
  38. package/docs/lifecycle.md +92 -66
  39. package/docs/listingMedia.md +25 -46
  40. package/docs/listingMonitor.md +43 -0
  41. package/docs/listingPublish/README.md +21 -39
  42. package/docs/listingPublish/captchaKraken.md +33 -75
  43. package/docs/listingPublish/formFill.md +28 -35
  44. package/docs/listingPublish/imagePipeline.md +55 -95
  45. package/docs/listingPublish/sources.md +60 -79
  46. package/docs/listingPublish/stateMachine.md +45 -79
  47. package/docs/mcp.md +56 -0
  48. package/docs/namingConventions.md +23 -33
  49. package/docs/platformGuides/discord.md +44 -0
  50. package/docs/platformGuides/facebook.md +52 -0
  51. package/docs/platformGuides/linkedin.md +37 -0
  52. package/docs/platformGuides/reddit.md +34 -0
  53. package/docs/platformGuides/x.md +68 -0
  54. package/docs/platforms/facebook/README.md +2 -2
  55. package/docs/platforms/linkedin/README.md +27 -0
  56. package/docs/providerResearch/agentVmHosts.json +1465 -1465
  57. package/docs/providerResearch/agentVmHosts.md +760 -760
  58. package/docs/providerResearch/prompts/agentVmHosts.poll.log +36 -36
  59. package/docs/providerResearch/prompts/agentVmHosts.run.json +8 -8
  60. package/docs/providerResearch/prompts/cloudBrowsersAndAntidetect.poll.log +22 -22
  61. package/docs/providerResearch/prompts/cloudBrowsersAndAntidetect.run.json +8 -8
  62. package/docs/providerResearch/prompts/cloudPhonesAndDevices.poll.log +24 -24
  63. package/docs/providerResearch/prompts/cloudPhonesAndDevices.run.json +8 -8
  64. package/docs/providerResearch/prompts/proxiesAndCaptcha.poll.log +34 -34
  65. package/docs/providerResearch/prompts/proxiesAndCaptcha.run.json +8 -8
  66. package/docs/providerResearch/prompts/selfManagedCompute.poll.log +49 -49
  67. package/docs/providerResearch/prompts/selfManagedCompute.run.json +8 -8
  68. package/docs/providerResearch/proxiesAndCaptcha.json +1189 -1189
  69. package/docs/providerResearch/proxiesAndCaptcha.md +643 -643
  70. package/docs/providerResearch/selfManagedCompute.json +832 -832
  71. package/docs/providerResearch/selfManagedCompute.md +62 -62
  72. package/docs/proxies.md +205 -167
  73. package/docs/proxyVendors/README.md +40 -29
  74. package/docs/proxyVendors/byteful.md +52 -42
  75. package/docs/rea/README.md +36 -68
  76. package/docs/rea/comparison.md +41 -71
  77. package/docs/rea/facebookClient.md +65 -127
  78. package/docs/rea/publicExamples.md +42 -75
  79. package/docs/rea/roadmap.md +23 -70
  80. package/docs/rea/sources.md +25 -67
  81. package/docs/rea/spec.md +44 -76
  82. package/docs/recordToFlow.md +55 -66
  83. package/docs/reference.md +1407 -0
  84. package/docs/signingIn.md +29 -0
  85. package/docs/site.json +62 -0
  86. package/docs/status.md +93 -69
  87. package/docs/twenty.md +84 -0
  88. package/docs/twitterPlatform.md +95 -56
  89. package/docs/useCases/README.md +1 -1
  90. package/docs/useCases/twitter/README.md +1 -1
  91. package/docs/usingLog.md +44 -0
  92. package/docs/vendors/order_33923855504144.txt +10 -0
  93. package/docs/voice/perPersonVoice.md +38 -40
  94. package/package.json +8 -5
  95. package/python/checks/linkedinTransport.py +67 -0
  96. package/python/errors/errorCatalog.json +60 -4
  97. package/python/linkedinApi/__init__.py +0 -0
  98. package/python/linkedinApi/engine.py +80 -0
  99. package/python/twitterApi/engine.py +159 -10
  100. package/python/twitterApi/host.py +221 -0
  101. package/python/twitterApi/inboxSync.py +5 -1
  102. package/scripts/checks/checkAgentHooks.ts +1 -1
  103. package/scripts/checks/checkFacebookClientDocs.mjs +3 -3
  104. package/scripts/checks/checkLinkedinTransport.ts +18 -0
  105. package/scripts/docs/buildDocs.ts +7 -1
  106. package/scripts/docs/syncSiteDocs.mjs +147 -0
  107. package/scripts/twenty/twentySetup.mjs +1 -1
  108. package/skills/accountToDryRun/SKILL.md +1 -1
  109. package/skills/adsPower/SKILL.md +6 -6
  110. package/skills/flow/SKILL.md +6 -6
  111. package/skills/humanMouse/SKILL.md +3 -3
  112. package/skills/inspect/SKILL.md +10 -10
  113. package/skills/logCli/SKILL.md +24 -24
  114. package/skills/profileSetup/SKILL.md +2 -2
  115. package/skills/reaCapture/SKILL.md +5 -5
  116. package/skills/xPosting/SKILL.md +59 -4
  117. package/skills/xchatReplies/SKILL.md +4 -4
  118. package/src/agentHooks/liveLog/index.ts +4 -1
  119. package/src/cli/inspect/index.ts +1 -1
  120. package/src/cli/linkedin/helpers/cookies.ts +125 -0
  121. package/src/cli/linkedin/helpers/index.ts +1 -0
  122. package/src/cli/linkedin/index.ts +62 -0
  123. package/src/cli/runner/client.ts +2 -0
  124. package/src/cli/runner/helpers/commandIndex.ts +2 -0
  125. package/src/cli/runner/helpers/platforms.ts +3 -1
  126. package/src/cli/runner/index.ts +3 -0
  127. package/src/cli/runner/types.ts +1 -0
  128. package/src/cli/twitter/helpers/cookies.ts +5 -4
  129. package/src/directApi/engine/client.ts +17 -3
  130. package/src/directApi/engine/types.ts +2 -1
  131. package/src/errors/catalog/types.ts +49 -4
  132. package/src/linkedin/account/index.ts +1 -0
  133. package/src/linkedin/account/session/client.ts +30 -0
  134. package/src/linkedin/account/session/index.ts +1 -0
  135. package/src/mcp/freshness/client.ts +1 -1
  136. package/src/mcp/server/helpers/agentRules.ts +21 -16
  137. package/src/mcp/server/helpers/guides.ts +1 -0
  138. package/src/mcp/server/types.ts +5 -5
  139. package/src/subq/decisions/client.ts +13 -2
  140. package/src/surface/readme/index.ts +1 -1
  141. package/vendor/openLinkedinApi/LICENSE +21 -0
  142. package/vendor/openLinkedinApi/README.md +355 -0
  143. package/vendor/openLinkedinApi/UPSTREAM +1 -0
  144. package/vendor/openLinkedinApi/open_linkedin_api/__init__.py +7 -0
  145. package/vendor/openLinkedinApi/open_linkedin_api/client.py +163 -0
  146. package/vendor/openLinkedinApi/open_linkedin_api/cookie_repository.py +70 -0
  147. package/vendor/openLinkedinApi/open_linkedin_api/linkedin.py +1787 -0
  148. package/vendor/openLinkedinApi/open_linkedin_api/settings.py +7 -0
  149. package/vendor/openLinkedinApi/open_linkedin_api/transport.py +10 -0
  150. package/vendor/openLinkedinApi/open_linkedin_api/utils/__init__.py +0 -0
  151. package/vendor/openLinkedinApi/open_linkedin_api/utils/helpers.py +266 -0
  152. package/vendor/openLinkedinApi/pyproject.toml +25 -0
  153. package/vendor/twikit/tests/test_transaction_cache.py +69 -0
  154. package/vendor/twikit/twikit/x_client_transaction/transaction.py +21 -0
package/AGENTS.md CHANGED
@@ -1231,6 +1231,71 @@ facts, not suggestions. Newest at the bottom. Never delete one without matt.
1231
1231
  decides: a 344 stops the run and nothing more goes out until matt says
1232
1232
  so. Discord keeps 60, every other platform 40.
1233
1233
 
1234
+ 102. 2026-10-30 · mandeep: LinkedIn goes out looking like a browser, the
1235
+ way X does (rule 81). `vendor/openLinkedinApi` reaches LinkedIn only
1236
+ through one curl_cffi `Session` in `open_linkedin_api/transport.py`,
1237
+ pinned to one impersonation target (`IMPERSONATE`, `chrome150`, the
1238
+ closest to the Chrome its cookies come from), sending the target's own
1239
+ user agent, never the library's fixed one or plain `requests`.
1240
+ `python/checks/linkedinTransport.py` refuses anything else (`bun run
1241
+ check:linkedinTransport`, pre-commit and pre-push). Every LinkedIn call
1242
+ runs through the account's governor (`python/platformKit/engine.py`), and
1243
+ a LinkedIn account writes at most 10 times a day (`WRITES_PER_DAY`), not
1244
+ 40 (rule 91).
1245
+
1246
+ 103. 2026-10-31 · matt: log-cli moves into the public log repo, and we work
1247
+ there. log-cli on GitHub is archived. "The readme is specifically for how
1248
+ to set up": why use it, what it's for, how to install and use it, and how
1249
+ we use it, about this project and nothing else of ours. Everything
1250
+ technical lives in `docs/`, a page per subject: the generated reference
1251
+ (`docs/reference.md`, from `bun run docs:build`, which replaces rule 56's
1252
+ README section), the guides, the use cases, the platforms, MCP setup
1253
+ (`docs/mcp.md`) and the Mermaid diagrams (`docs/diagrams`). Rule one stays
1254
+ first in AGENTS.md and the MCP instructions, no longer in the README
1255
+ (this narrows rule 76). The docs site at log.listeningkit.com/docs is
1256
+ Fumadocs, built from `docs/` on every site build
1257
+ (`scripts/docs/syncSiteDocs.mjs`). lefthook's `siteDocs` (`bun run
1258
+ check:siteDocs`, pre-commit and pre-push) refuses a page without a title
1259
+ or a link to a file that doesn't exist, beside `docs`. log is installed
1260
+ as the npm package `@listeningkit/log` and runs as `log` and `logMcp`:
1261
+ docs, skills and messages say `log …`, never `bun bin/log.ts`. "We don't
1262
+ use Convex at all": no Convex, and no dashboard. The site is the landing
1263
+ page plus the docs.
1264
+
1265
+ 104. 2026-11-01 · matt: "the timing stuff there i saw you hand rolled the
1266
+ outbound stuff when it should be queued and it has to have random
1267
+ intervals, but the bundle itself actually reveals more information".
1268
+ On 2026-11-01 matthewsoldit got a soft block, then X's 226 ("looks
1269
+ automated") on a reply. The live log showed 8 thread reads fired in
1270
+ 0.2 s by two parallel helpers while sends went out from a hand-written
1271
+ loop, and every `log twitter` call was a fresh client that loaded
1272
+ x.com's home page and its signer before acting, so a 3-line dm was 3
1273
+ cold starts in 9 s. X's own web client (`sign.o` in its x-web bundle,
1274
+ read 2026-11-01) loads the page once and signs every call from it.
1275
+ From now on: more than one send goes through the queue (`log twitter
1276
+ queue build|plan|run`, random times), never a hand-rolled loop and
1277
+ never helpers reading or sending on one account in parallel. The X
1278
+ engine takes one call per account at a time (`engine.lock`, refused
1279
+ with `accountBusy` after 15 min), waits 4 to 11 s after the last call,
1280
+ and keeps the transaction key in `clientTransaction.json` for 3 hours
1281
+ (`python/twitterApi/engine.py`, `vendor/twikit` `ClientTransaction.state`
1282
+ and `restore`).
1283
+
1284
+ 105. 2026-11-01 · matt: "we cannot be opening multiple sessions there,
1285
+ that defeats the core purpose of what we use this tool for ... it
1286
+ should always be one, and then it needs to loudly create issues". An X
1287
+ account has one session, always. Every X call (CLI, MCP, hooks, the
1288
+ queue, the X Chat watch) goes through the account's one engine host
1289
+ (`python/twitterApi/host.py`, started on the first call, closed after
1290
+ 30 idle minutes or when the engine code changes): one twikit client,
1291
+ one connection, one cookie jar and one transaction key, the way X's
1292
+ own web app keeps one page and signs every call from it (x-web
1293
+ `startup-dynamic`, read with rea 2026-11-01). A second host can't
1294
+ start (`host.lock`); a call that can't reach the host is refused with
1295
+ `xSessionHostDown` and sends nothing, never falls back to a session of
1296
+ its own. The hook's account line shows the open session (pid, since,
1297
+ calls). `LOG_TWITTER_HOST=inline` runs the old way, for tests only.
1298
+
1234
1299
  ## Checks
1235
1300
 
1236
1301
  - Run `bun run check` before pushing: no comments (rule 70), naming gate, `tsc --noEmit`, `bun test`.