@mycadet/assistant 0.13.0-dev.202611131045.a556a8a → 0.13.0-dev.202611142107.f5e00a2

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 (246) hide show
  1. package/knip.json +14 -3
  2. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/package.json +18 -0
  3. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/endpoint.test.ts +36 -0
  4. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/endpoint.ts +142 -0
  5. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/index.ts +18 -0
  6. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/ipc-framing.ts +295 -0
  7. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/listen-options.ts +3 -0
  8. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/socket-watchdog.test.ts +444 -0
  9. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/src/socket-watchdog.ts +236 -0
  10. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/ipc-server-utils/tsconfig.json +20 -0
  11. package/node_modules/@mycadet/ces-client/node_modules/@mycadet/service-contracts/src/rpc.ts +33 -3
  12. package/node_modules/@mycadet/ces-client/package.json +7 -2
  13. package/node_modules/@mycadet/ces-client/src/index.ts +7 -0
  14. package/node_modules/@mycadet/ces-client/src/ipc-credentials.ts +363 -0
  15. package/node_modules/@mycadet/ces-client/src/log-export.ts +187 -0
  16. package/node_modules/@mycadet/ces-client/src/socket-path.ts +34 -0
  17. package/node_modules/@mycadet/ces-client/src/test-support.ts +280 -0
  18. package/node_modules/@mycadet/credential-storage/src/index.ts +0 -56
  19. package/node_modules/@mycadet/environments/package.json +0 -1
  20. package/node_modules/@mycadet/environments/src/index.ts +8 -19
  21. package/node_modules/@mycadet/gateway-client/node_modules/@mycadet/service-contracts/src/rpc.ts +33 -3
  22. package/node_modules/@mycadet/service-contracts/src/rpc.ts +33 -3
  23. package/node_modules/@mycadet/shared/eslint/imports-first.mjs +51 -0
  24. package/node_modules/@mycadet/shared/eslint/imports-first.test.mjs +95 -0
  25. package/node_modules/@mycadet/shared/eslint/no-empty-imports.mjs +65 -0
  26. package/node_modules/@mycadet/shared/eslint/no-empty-imports.test.mjs +71 -0
  27. package/node_modules/@mycadet/shared/eslint/no-re-exports.mjs +136 -0
  28. package/node_modules/@mycadet/shared/eslint/no-re-exports.test.mjs +167 -0
  29. package/node_modules/@mycadet/shared/fetch.ts +12 -0
  30. package/node_modules/@mycadet/shared/github-repository.ts +5 -0
  31. package/node_modules/@mycadet/shared/index.ts +18 -0
  32. package/node_modules/@mycadet/shared/package.json +21 -0
  33. package/node_modules/@mycadet/shared/providers/baseten.test.ts +41 -0
  34. package/node_modules/@mycadet/shared/providers/baseten.ts +40 -0
  35. package/node_modules/@mycadet/shared/scripts/run-isolated-tests.ts +700 -0
  36. package/node_modules/@mycadet/shared/seeds.ts +299 -0
  37. package/node_modules/@mycadet/shared/version.ts +124 -0
  38. package/package.json +5 -4
  39. package/scripts/check-circular-deps.ts +4 -4
  40. package/scripts/lint.ts +8 -8
  41. package/src/__tests__/browser-fill-credential.test.ts +0 -1
  42. package/src/__tests__/catalog-files.test.ts +2 -2
  43. package/src/__tests__/ces-startup-timeout.test.ts +0 -60
  44. package/src/__tests__/cloud-callback-registration.test.ts +1 -1
  45. package/src/__tests__/cloud-fallback-dispatch.test.ts +1 -1
  46. package/src/__tests__/cloud-proxy-context.test.ts +1 -1
  47. package/src/__tests__/config-loader-backfill.test.ts +89 -787
  48. package/src/__tests__/config-schema.test.ts +9 -20
  49. package/src/__tests__/conversation-context-window-manager-recovery.test.ts +77 -0
  50. package/src/__tests__/conversation-messaging-secret-redirect.test.ts +0 -1
  51. package/src/__tests__/conversation-runtime-assembly.test.ts +2 -4
  52. package/src/__tests__/credential-broker-browser-fill.test.ts +2 -3
  53. package/src/__tests__/credential-broker-server-use.test.ts +2 -3
  54. package/src/__tests__/credential-broker.test.ts +2 -3
  55. package/src/__tests__/credential-execution-api-key-propagation.test.ts +7 -7
  56. package/src/__tests__/credential-execution-client.test.ts +16 -17
  57. package/src/__tests__/credential-metadata-store.test.ts +87 -785
  58. package/src/__tests__/credential-record-retire.test.ts +62 -238
  59. package/src/__tests__/credential-record-write-through.test.ts +36 -59
  60. package/src/__tests__/credential-resolve.test.ts +86 -60
  61. package/src/__tests__/credential-security-invariants.test.ts +13 -40
  62. package/src/__tests__/discord-channel-config.test.ts +10 -4
  63. package/src/__tests__/get-skill-detail-audit.test.ts +1 -1
  64. package/src/__tests__/helpers/mock-conversation.ts +1 -1
  65. package/src/__tests__/host-cu-routes-targeted.test.ts +1 -1
  66. package/src/__tests__/identity-routes.test.ts +40 -39
  67. package/src/__tests__/inference-no-mode-boot-e2e.test.ts +7 -3
  68. package/src/__tests__/injector-disk-pressure.test.ts +1 -1
  69. package/src/__tests__/plugin-api-resolve-credential.test.ts +35 -18
  70. package/src/__tests__/plugin-api-store-credential.test.ts +11 -5
  71. package/src/__tests__/provider-cloud-proxy-integration.test.ts +1 -2
  72. package/src/__tests__/secret-routes-cloud-proxy.test.ts +1 -1
  73. package/src/__tests__/secure-keys.test.ts +33 -321
  74. package/src/__tests__/shell-credential-ref.test.ts +36 -13
  75. package/src/__tests__/skills-file-content-endpoint.test.ts +1 -1
  76. package/src/__tests__/skills-files-catalog-fallback.test.ts +1 -1
  77. package/src/__tests__/slack-channel-config.test.ts +16 -4
  78. package/src/__tests__/test-preload-verifier.ts +4 -4
  79. package/src/__tests__/test-preload.ts +5 -5
  80. package/src/__tests__/thread-backfill.test.ts +2 -4
  81. package/src/__tests__/token-manager.test.ts +0 -3
  82. package/src/__tests__/workspace-migration-046-seed-conversation-starters-callsite.test.ts +0 -16
  83. package/src/__tests__/workspace-migration-050-seed-main-agent-opus-callsite.test.ts +0 -14
  84. package/src/__tests__/workspace-migration-051-seed-conversation-summarization-callsite.test.ts +0 -16
  85. package/src/__tests__/workspace-migration-054-seed-recall-callsite.test.ts +0 -16
  86. package/src/__tests__/workspace-migration-066-seed-heartbeat-callsite-cost-default.test.ts +0 -16
  87. package/src/__tests__/workspace-migration-072-seed-reply-suggestion-callsite.test.ts +0 -16
  88. package/src/__tests__/workspace-migration-077-seed-memory-router-callsite.test.ts +0 -14
  89. package/src/__tests__/workspace-migration-082-backfill-managed-profile-labels.test.ts +0 -31
  90. package/src/__tests__/workspace-migration-087-memory-router-balanced-profile.test.ts +0 -23
  91. package/src/__tests__/workspace-migration-090-memory-router-cost-optimized-profile.test.ts +0 -21
  92. package/src/__tests__/workspace-migration-099-disable-cache-one-shot-callsites.test.ts +0 -2
  93. package/src/__tests__/workspace-migration-111-prune-seeded-callsite-defaults.test.ts +0 -8
  94. package/src/__tests__/workspace-migration-142-consolidate-voice-front-door.test.ts +0 -31
  95. package/src/acp/__tests__/acp-claude-oauth.test.ts +24 -5
  96. package/src/acp/__tests__/prepare-agent-env.test.ts +19 -4
  97. package/src/acp/acp-claude-oauth.ts +1 -1
  98. package/src/acp/prepare-agent-env.ts +7 -7
  99. package/src/api/constants/codex-models.ts +22 -0
  100. package/src/api/index.ts +1 -0
  101. package/src/calls/voice-triage-escalate.ts +1 -1
  102. package/src/cli/commands/credentials.ts +21 -15
  103. package/src/cli/commands/logs.help.ts +46 -0
  104. package/src/cli/commands/logs.ts +124 -0
  105. package/src/cli/index.help.ts +2 -0
  106. package/src/cli/lib/__tests__/install-from-github.test.ts +1 -1
  107. package/src/cli/lib/__tests__/upgrade-plugin.test.ts +1 -1
  108. package/src/cli/lib/install-from-cloud.ts +2 -2
  109. package/src/cli/lib/nested-value.ts +0 -17
  110. package/src/cli/lib/plugin-catalog-cloud.ts +2 -2
  111. package/src/cli/lib/publish-plugin.ts +1 -1
  112. package/src/cli/program.ts +2 -0
  113. package/src/config/__tests__/cloud-identity.test.ts +2 -2
  114. package/src/config/cloud-identity.ts +2 -2
  115. package/src/config/env.ts +10 -22
  116. package/src/config/input-modalities.ts +1 -2
  117. package/src/config/loader.ts +6 -134
  118. package/src/config/schemas/logging.ts +37 -1
  119. package/src/config/schemas/services.ts +5 -17
  120. package/src/config/seed-inference-profiles.ts +0 -6
  121. package/src/credential-execution/ces-runtime.ts +39 -294
  122. package/src/credential-execution/client.test.ts +22 -0
  123. package/src/credential-execution/client.ts +210 -14
  124. package/src/credential-execution/executable-discovery.ts +12 -26
  125. package/src/credential-execution/process-manager.test.ts +12 -0
  126. package/src/credential-execution/process-manager.ts +13 -11
  127. package/src/credential-execution/prompted-credential.ts +2 -2
  128. package/src/credential-execution/startup-timeout.ts +1 -36
  129. package/src/daemon/__tests__/conversation-tool-setup.test.ts +1 -1
  130. package/src/daemon/config-watcher.ts +3 -1
  131. package/src/daemon/conversation-assembly-types.ts +79 -0
  132. package/src/daemon/conversation-error.ts +3 -1
  133. package/src/daemon/conversation-history.ts +1 -1
  134. package/src/daemon/conversation-messaging.ts +2 -2
  135. package/src/daemon/conversation-runtime-assembly.ts +5 -72
  136. package/src/daemon/conversation.ts +43 -23
  137. package/src/daemon/disk-pressure-background-gate.ts +1 -1
  138. package/src/daemon/handlers/config-discord-channel.ts +2 -2
  139. package/src/daemon/handlers/config-ingress.ts +2 -2
  140. package/src/daemon/handlers/config-slack-channel.ts +17 -17
  141. package/src/daemon/handlers/config-telegram.ts +5 -5
  142. package/src/daemon/handlers/config-vercel.ts +2 -2
  143. package/src/daemon/lifecycle.ts +25 -64
  144. package/src/home/home-greeting.ts +10 -1
  145. package/src/i18n/index.ts +0 -1
  146. package/src/i18n/locales.ts +0 -7
  147. package/src/inbound/cloud-callback-registration.ts +2 -2
  148. package/src/live-voice/protocol.ts +4 -4
  149. package/src/messaging/providers/slack/render.ts +1 -1
  150. package/src/notifications/activity-failed-dedupe.ts +1 -1
  151. package/src/notifications/background-failure-signal.ts +6 -1
  152. package/src/oauth/user-oauth-connection.test.ts +2 -2
  153. package/src/persistence/delivery-status.ts +1 -1
  154. package/src/persistence/embeddings/embedding-backend.ts +2 -11
  155. package/src/persistence/external-conversation-store.ts +1 -1
  156. package/src/persistence/migrations/run-migrations.ts +1 -1
  157. package/src/plugins/defaults/compaction/context-overflow-reducer.ts +1 -1
  158. package/src/plugins/defaults/compaction/window-manager.ts +1 -1
  159. package/src/plugins/defaults/memory/anisotropy.ts +1 -1
  160. package/src/plugins/defaults/memory/context-search/limits.ts +5 -3
  161. package/src/plugins/defaults/memory/context-search/recall-input.ts +3 -1
  162. package/src/plugins/defaults/memory/graph/capability-seed.ts +5 -1
  163. package/src/plugins/defaults/memory/indexer.ts +1 -15
  164. package/src/plugins/defaults/memory/v1/graph/bootstrap.ts +1 -105
  165. package/src/plugins/defaults/memory/v2/rerank-local.ts +1 -1
  166. package/src/plugins/defaults/memory/worker.ts +1 -1
  167. package/src/plugins/defaults/turn-context/unified-turn-context.ts +1 -1
  168. package/src/plugins/ensure-plugin-api-shim.ts +0 -1
  169. package/src/plugins/pipeline.ts +1 -1
  170. package/src/plugins/surface-import.ts +1 -1
  171. package/src/plugins/types.ts +1 -1
  172. package/src/prompts/__tests__/parallel-tasks-section.test.ts +1 -1
  173. package/src/prompts/delegation-gate.ts +1 -1
  174. package/src/prompts/persona-resolver.ts +1 -1
  175. package/src/prompts/system-prompt.ts +1 -1
  176. package/src/providers/__tests__/registry-native-web-search.test.ts +0 -1
  177. package/src/providers/cloud-proxy/context.ts +2 -2
  178. package/src/providers/fetch-provider-catalog.ts +1 -1
  179. package/src/providers/inference/missing-credential-guard.ts +19 -7
  180. package/src/providers/openai/codex-models.ts +6 -21
  181. package/src/providers/registry.ts +0 -1
  182. package/src/providers/routing-identity.ts +1 -0
  183. package/src/runtime/background-job-runner.ts +4 -3
  184. package/src/runtime/routes/__tests__/ps-routes.test.ts +7 -3
  185. package/src/runtime/routes/auth-routes.ts +2 -2
  186. package/src/runtime/routes/cloud-credentials.ts +4 -7
  187. package/src/runtime/routes/cloud-routes.ts +2 -2
  188. package/src/runtime/routes/conversation-query-routes.ts +31 -0
  189. package/src/runtime/routes/credential-routes.ts +40 -119
  190. package/src/runtime/routes/host-browser-routes.ts +1 -1
  191. package/src/runtime/routes/identity-routes.ts +21 -1
  192. package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +2 -0
  193. package/src/runtime/routes/integrations/twilio.ts +4 -4
  194. package/src/runtime/routes/plugins-routes.ts +4 -4
  195. package/src/runtime/routes/ps-routes.ts +19 -5
  196. package/src/runtime/routes/secret-routes.ts +14 -4
  197. package/src/runtime/routes/settings-routes.ts +5 -2
  198. package/src/runtime/verification-outbound-actions.ts +1 -1
  199. package/src/schedule/scheduler.ts +2 -4
  200. package/src/schedule/worker.ts +1 -1
  201. package/src/security/ces-rpc-record-backend.ts +126 -86
  202. package/src/security/secure-keys.ts +41 -442
  203. package/src/skills/catalog-files.ts +2 -2
  204. package/src/skills/catalog-install.ts +4 -4
  205. package/src/skills/categories-cache.ts +4 -4
  206. package/src/tools/credentials/metadata-store.ts +189 -190
  207. package/src/tools/credentials/settings-catalog.ts +152 -0
  208. package/src/tools/credentials/store.ts +1 -1
  209. package/src/tools/terminal/__tests__/safe-env.test.ts +8 -8
  210. package/src/tools/terminal/__tests__/sanitized-bash.test.ts +5 -14
  211. package/src/tools/terminal/safe-env.ts +1 -7
  212. package/src/tools/types.ts +1 -1
  213. package/src/util/errors.ts +25 -4
  214. package/src/util/logger.ts +45 -2
  215. package/src/util/read-stdin.ts +1 -1
  216. package/src/workspace/migrations/040-seed-latency-callsite-defaults.ts +8 -17
  217. package/src/workspace/migrations/046-seed-conversation-starters-callsite.ts +0 -6
  218. package/src/workspace/migrations/050-seed-main-agent-opus-callsite.ts +0 -5
  219. package/src/workspace/migrations/051-seed-conversation-summarization-callsite.ts +0 -6
  220. package/src/workspace/migrations/054-seed-recall-callsite.ts +0 -4
  221. package/src/workspace/migrations/066-seed-heartbeat-callsite-cost-default.ts +0 -4
  222. package/src/workspace/migrations/072-seed-reply-suggestion-callsite.ts +0 -6
  223. package/src/workspace/migrations/077-seed-memory-router-callsite.ts +0 -5
  224. package/src/workspace/migrations/082-backfill-managed-profile-labels.ts +0 -1
  225. package/src/workspace/migrations/087-memory-router-balanced-profile.ts +0 -4
  226. package/src/workspace/migrations/090-memory-router-cost-optimized-profile.ts +0 -4
  227. package/src/workspace/migrations/099-disable-cache-one-shot-callsites.ts +2 -6
  228. package/src/workspace/migrations/140-repair-seed-pinned-memory-v3-live.ts +8 -7
  229. package/src/workspace/migrations/141-stt-english-default-to-multilingual.ts +0 -4
  230. package/src/workspace/migrations/registry.ts +0 -2
  231. package/node_modules/@mycadet/credential-storage/src/static-credentials.ts +0 -396
  232. package/node_modules/@mycadet/environments/src/__tests__/cloud-assistant-hub-url.test.ts +0 -76
  233. package/node_modules/@mycadet/environments/src/seeds.ts +0 -89
  234. package/node_modules/@mycadet/environments/src/types.ts +0 -70
  235. package/scripts/check-unused-production-exports.ts +0 -111
  236. package/src/__tests__/credential-storage-static-compat.test.ts +0 -424
  237. package/src/__tests__/secure-keys-cloud-failover.test.ts +0 -75
  238. package/src/__tests__/volume-security-guard.test.ts +0 -151
  239. package/src/__tests__/workspace-migration-052-seed-default-inference-profiles.test.ts +0 -260
  240. package/src/config/prune-seeded-callsite-defaults.ts +0 -130
  241. package/src/credential-execution/ces-connect.test.ts +0 -69
  242. package/src/credential-execution/ces-connect.ts +0 -114
  243. package/src/security/__tests__/ces-http-record-backend.test.ts +0 -137
  244. package/src/security/ces-credential-client.ts +0 -112
  245. package/src/security/ces-http-record-backend.ts +0 -114
  246. package/src/workspace/migrations/052-seed-default-inference-profiles.ts +0 -158
@@ -55,6 +55,8 @@ export const CesRpcMethod = {
55
55
  ListCredentialRecords: "list_credential_records",
56
56
  /** Bulk-import credential records. */
57
57
  BulkSetCredentialRecords: "bulk_set_credential_records",
58
+ /** Collect CES's own log files for a diagnostic export (tar.gz, base64). */
59
+ ExportLogs: "export_logs",
58
60
  } as const;
59
61
 
60
62
  export type CesRpcMethod = (typeof CesRpcMethod)[keyof typeof CesRpcMethod];
@@ -72,9 +74,7 @@ export const UpdateCloudCredentialSchema = z.object({
72
74
  */
73
75
  assistantId: z.string().optional(),
74
76
  });
75
- export type UpdateCloudCredential = z.infer<
76
- typeof UpdateCloudCredentialSchema
77
- >;
77
+ export type UpdateCloudCredential = z.infer<typeof UpdateCloudCredentialSchema>;
78
78
 
79
79
  export const UpdateCloudCredentialResponseSchema = z.object({
80
80
  /** Whether the cloud credential was successfully updated. */
@@ -302,6 +302,28 @@ export type BulkSetCredentialRecordsResponse = z.infer<
302
302
  typeof BulkSetCredentialRecordsResponseSchema
303
303
  >;
304
304
 
305
+ // ---------------------------------------------------------------------------
306
+ // export_logs
307
+ // ---------------------------------------------------------------------------
308
+
309
+ export const ExportLogsSchema = z.object({
310
+ /** Inclusive range start (epoch ms); log files entirely before it are skipped. */
311
+ startTime: z.number().optional(),
312
+ /** Inclusive range end (epoch ms); log files entirely after it are skipped. */
313
+ endTime: z.number().optional(),
314
+ });
315
+ export type ExportLogs = z.infer<typeof ExportLogsSchema>;
316
+
317
+ export const ExportLogsResponseSchema = z.object({
318
+ /** tar.gz of the collected log files plus a manifest, base64-encoded. */
319
+ archiveBase64: z.string(),
320
+ /** Number of log files included in the archive. */
321
+ filesCollected: z.number(),
322
+ /** Cumulative size of the collected log files, before archiving. */
323
+ totalBytes: z.number(),
324
+ });
325
+ export type ExportLogsResponse = z.infer<typeof ExportLogsResponseSchema>;
326
+
305
327
  // ---------------------------------------------------------------------------
306
328
  // Full RPC contract type map
307
329
  // ---------------------------------------------------------------------------
@@ -355,6 +377,10 @@ export interface CesRpcContract {
355
377
  request: BulkSetCredentialRecords;
356
378
  response: BulkSetCredentialRecordsResponse;
357
379
  };
380
+ [CesRpcMethod.ExportLogs]: {
381
+ request: ExportLogs;
382
+ response: ExportLogsResponse;
383
+ };
358
384
  }
359
385
 
360
386
  /**
@@ -405,4 +431,8 @@ export const CesRpcSchemas = {
405
431
  request: BulkSetCredentialRecordsSchema,
406
432
  response: BulkSetCredentialRecordsResponseSchema,
407
433
  },
434
+ [CesRpcMethod.ExportLogs]: {
435
+ request: ExportLogsSchema,
436
+ response: ExportLogsResponseSchema,
437
+ },
408
438
  } as const;
@@ -8,14 +8,19 @@
8
8
  ".": "./src/index.ts",
9
9
  "./http-credentials": "./src/http-credentials.ts",
10
10
  "./http-log-export": "./src/http-log-export.ts",
11
+ "./ipc-credentials": "./src/ipc-credentials.ts",
12
+ "./log-export": "./src/log-export.ts",
11
13
  "./rpc-client": "./src/rpc-client.ts",
12
- "./credential-rpc": "./src/credential-rpc.ts"
14
+ "./credential-rpc": "./src/credential-rpc.ts",
15
+ "./socket-path": "./src/socket-path.ts",
16
+ "./test-support": "./src/test-support.ts"
13
17
  },
14
18
  "scripts": {
15
19
  "typecheck": "bunx tsc --noEmit"
16
20
  },
17
21
  "dependencies": {
18
- "@mycadet/service-contracts": "workspace:*"
22
+ "@mycadet/service-contracts": "workspace:*",
23
+ "@mycadet/ipc-server-utils": "workspace:*"
19
24
  },
20
25
  "devDependencies": {
21
26
  "@types/bun": "1.2.4",
@@ -8,6 +8,7 @@
8
8
  * - `@mycadet/ces-client/http-credentials` — credential CRUD over CES HTTP
9
9
  * - `@mycadet/ces-client/http-log-export` — CES log export over HTTP
10
10
  * - `@mycadet/ces-client/rpc-client` — CES RPC envelope/handshake client
11
+ * - `@mycadet/ces-client/socket-path` — shared CES socket path resolution
11
12
  */
12
13
 
13
14
  export {
@@ -43,3 +44,9 @@ export {
43
44
  type CesRpcHandshakeOptions,
44
45
  type CesRpcLogger,
45
46
  } from "./rpc-client.js";
47
+
48
+ export {
49
+ CES_SOCKET_DIR_DEFAULT,
50
+ getCesSocketDir,
51
+ getCesSocketPath,
52
+ } from "./socket-path.js";
@@ -0,0 +1,363 @@
1
+ /**
2
+ * IPC client for CES credential CRUD over the shared Unix socket.
3
+ *
4
+ * The IPC-only replacement for `http-credentials` — same surface, different
5
+ * transport. Every CES caller (assistant, gateway, CLI) dials the socket CES
6
+ * binds; there are no HTTP routes to authenticate against and no
7
+ * CES_SERVICE_TOKEN to manage.
8
+ *
9
+ * The connection is opened lazily on first use, handshakes once, and is
10
+ * reused across calls; a dead transport re-opens on the next operation after
11
+ * a short cooldown so a down CES costs one discovery attempt per window
12
+ * instead of one per call.
13
+ */
14
+
15
+ import { createConnection, type Socket } from "node:net";
16
+ import { StringDecoder } from "node:string_decoder";
17
+
18
+ import { existsSync } from "node:fs";
19
+
20
+ import type { CesRpcContract } from "@mycadet/service-contracts/credential-rpc";
21
+ import { CesRpcMethod } from "@mycadet/service-contracts/credential-rpc";
22
+ import type { CredentialRecord } from "@mycadet/service-contracts/credential-rpc";
23
+
24
+ import { getCesSocketPath } from "./socket-path.js";
25
+ import { createCesRpcClient, type CesRpcClient } from "./rpc-client.js";
26
+
27
+ export type { CredentialRecord };
28
+
29
+ // ---------------------------------------------------------------------------
30
+ // Result types (shared with the HTTP client's shapes)
31
+ // ---------------------------------------------------------------------------
32
+
33
+ export interface CesCredentialGetResult {
34
+ value: string | undefined;
35
+ unreachable: boolean;
36
+ }
37
+
38
+ export interface CesCredentialListResult {
39
+ accounts: string[];
40
+ unreachable: boolean;
41
+ }
42
+
43
+ export type CesDeleteResult = "deleted" | "not-found" | "error";
44
+
45
+ /** Minimal logger interface — callers can supply pino, console, etc. */
46
+ export interface CesIpcLogger {
47
+ warn(obj: Record<string, unknown>, msg: string): void;
48
+ warn(msg: string): void;
49
+ }
50
+
51
+ // ---------------------------------------------------------------------------
52
+ // Client interface — method-compatible with the HTTP credential client
53
+ // ---------------------------------------------------------------------------
54
+
55
+ export interface CesIpcCredentialClient {
56
+ /** Whether the CES socket is present and dialable. */
57
+ isAvailable(): boolean;
58
+
59
+ /** Retrieve a credential by account name. */
60
+ get(account: string): Promise<CesCredentialGetResult>;
61
+
62
+ /** Store or update a credential. */
63
+ set(account: string, value: string): Promise<boolean>;
64
+
65
+ /** Delete a credential by account name. */
66
+ delete(account: string): Promise<CesDeleteResult>;
67
+
68
+ /** Bulk-set multiple credentials. */
69
+ bulkSet(
70
+ credentials: Array<{ account: string; value: string }>,
71
+ ): Promise<Array<{ account: string; ok: boolean }>>;
72
+
73
+ /** List all credential account names. */
74
+ list(): Promise<CesCredentialListResult>;
75
+
76
+ /** Retrieve a credential record (identity + policy) by account name. */
77
+ getRecord(
78
+ account: string,
79
+ ): Promise<{ record: CredentialRecord | undefined; unreachable: boolean }>;
80
+
81
+ /** Store or update a credential record. */
82
+ setRecord(account: string, record: CredentialRecord): Promise<boolean>;
83
+
84
+ /** Delete a credential record by account name. */
85
+ deleteRecord(account: string): Promise<CesDeleteResult>;
86
+
87
+ /** List all credential records. */
88
+ listRecords(): Promise<{
89
+ records: Array<{ account: string; record: CredentialRecord }>;
90
+ unreachable: boolean;
91
+ }>;
92
+
93
+ /** Bulk-set credential records. */
94
+ bulkSetRecords(
95
+ records: Array<{ account: string; record: CredentialRecord }>,
96
+ ): Promise<Array<{ account: string; ok: boolean }>>;
97
+ }
98
+
99
+ // ---------------------------------------------------------------------------
100
+ // Tuning
101
+ // ---------------------------------------------------------------------------
102
+
103
+ /** Minimum interval between connection attempts after a failure. */
104
+ const CONNECT_COOLDOWN_MS = 3_000;
105
+
106
+ const SOCKET_CONNECT_TIMEOUT_MS = 5_000;
107
+
108
+ // ---------------------------------------------------------------------------
109
+ // Socket transport
110
+ // ---------------------------------------------------------------------------
111
+
112
+ interface SocketTransport {
113
+ write(line: string): void;
114
+ onMessage(handler: (message: string) => void): void;
115
+ isAlive(): boolean;
116
+ close(): void;
117
+ }
118
+
119
+ function connectSocket(
120
+ socketPath: string,
121
+ logger: CesIpcLogger,
122
+ ): Promise<SocketTransport> {
123
+ return new Promise<SocketTransport>((resolve, reject) => {
124
+ const socket = createConnection({ path: socketPath });
125
+ const messageHandlers: Array<(message: string) => void> = [];
126
+ let buffer = "";
127
+ let closed = false;
128
+ const decoder = new StringDecoder("utf8");
129
+
130
+ const timer = setTimeout(() => {
131
+ socket.destroy();
132
+ reject(
133
+ new Error(
134
+ `Connection to CES socket at ${socketPath} timed out after ${SOCKET_CONNECT_TIMEOUT_MS}ms`,
135
+ ),
136
+ );
137
+ }, SOCKET_CONNECT_TIMEOUT_MS);
138
+
139
+ socket.on("connect", () => {
140
+ clearTimeout(timer);
141
+ resolve({
142
+ write(line: string): void {
143
+ if (closed || socket.destroyed) {
144
+ throw new Error("CES socket transport is not alive");
145
+ }
146
+ socket.write(line + "\n");
147
+ },
148
+ onMessage(handler: (message: string) => void): void {
149
+ messageHandlers.push(handler);
150
+ },
151
+ isAlive(): boolean {
152
+ return !closed && !socket.destroyed;
153
+ },
154
+ close(): void {
155
+ closed = true;
156
+ socket.destroy();
157
+ },
158
+ });
159
+ });
160
+
161
+ socket.on("error", (err) => {
162
+ // Reject first-connect failures fast (refused, ENOENT on a stale
163
+ // socket file); post-connect errors are transport deaths, logged and
164
+ // surfaced through the next call's unreachable mapping.
165
+ if (timer.hasRef?.()) {
166
+ clearTimeout(timer);
167
+ socket.destroy();
168
+ reject(err);
169
+ return;
170
+ }
171
+ logger.warn({ err }, "CES socket transport error");
172
+ });
173
+
174
+ socket.on("data", (chunk: Buffer | string) => {
175
+ buffer += typeof chunk === "string" ? chunk : decoder.write(chunk);
176
+ let newlineIdx: number;
177
+ while ((newlineIdx = buffer.indexOf("\n")) !== -1) {
178
+ const line = buffer.slice(0, newlineIdx).trim();
179
+ buffer = buffer.slice(newlineIdx + 1);
180
+ if (line) {
181
+ for (const handler of messageHandlers) {
182
+ handler(line);
183
+ }
184
+ }
185
+ }
186
+ });
187
+ });
188
+ }
189
+
190
+ // ---------------------------------------------------------------------------
191
+ // Factory
192
+ // ---------------------------------------------------------------------------
193
+
194
+ export function createCesIpcCredentialClient(
195
+ logger: CesIpcLogger,
196
+ ): CesIpcCredentialClient {
197
+ let client: CesRpcClient | undefined;
198
+ let clientAttempt: Promise<CesRpcClient> | undefined;
199
+ let lastFailedAttemptAt = 0;
200
+
201
+ function isAvailable(): boolean {
202
+ const socketPath = getCesSocketPath();
203
+ return socketPath.startsWith("\\\\.\\pipe\\") || existsSync(socketPath);
204
+ }
205
+
206
+ /**
207
+ * Resolve the connected+handshaked RPC client, opening the socket session
208
+ * on first use and after any transport death. Throws when CES is
209
+ * unreachable; callers map that to their own failure semantics.
210
+ */
211
+ async function ensureClient(): Promise<CesRpcClient> {
212
+ if (client?.isReady()) {
213
+ return client;
214
+ }
215
+ client = undefined;
216
+ if (Date.now() - lastFailedAttemptAt < CONNECT_COOLDOWN_MS) {
217
+ throw new Error("CES is unreachable (recent connection attempt failed)");
218
+ }
219
+ if (!clientAttempt) {
220
+ clientAttempt = (async () => {
221
+ const socketPath = getCesSocketPath();
222
+ const transport = await connectSocket(socketPath, logger);
223
+ const rpc = createCesRpcClient(transport, {
224
+ handshakeTimeoutMs: SOCKET_CONNECT_TIMEOUT_MS,
225
+ logger: {
226
+ info: (objOrMsg: Record<string, unknown> | string, msg?: string) =>
227
+ typeof objOrMsg === "string"
228
+ ? logger.warn(objOrMsg)
229
+ : logger.warn(objOrMsg, msg ?? ""),
230
+ },
231
+ });
232
+ const { accepted, reason } = await rpc.handshake();
233
+ if (!accepted) {
234
+ rpc.close();
235
+ throw new Error(`CES handshake rejected: ${reason ?? "unknown"}`);
236
+ }
237
+ client = rpc;
238
+ return rpc;
239
+ })()
240
+ .catch((err) => {
241
+ lastFailedAttemptAt = Date.now();
242
+ throw err;
243
+ })
244
+ .finally(() => {
245
+ clientAttempt = undefined;
246
+ });
247
+ }
248
+ return clientAttempt;
249
+ }
250
+
251
+ /** Run one RPC call, mapping transport failure to `unreachable`. */
252
+ async function callOrUnreachable<M extends CesRpcMethod>(
253
+ method: M,
254
+ request: CesRpcContract[M]["request"],
255
+ ): Promise<
256
+ { ok: true; response: CesRpcContract[M]["response"] } | { ok: false }
257
+ > {
258
+ try {
259
+ const rpc = await ensureClient();
260
+ const response = await rpc.call(method, request);
261
+ return { ok: true, response };
262
+ } catch (err) {
263
+ logger.warn(
264
+ { err: err instanceof Error ? err.message : String(err), method },
265
+ "CES IPC call failed",
266
+ );
267
+ client = undefined;
268
+ return { ok: false };
269
+ }
270
+ }
271
+
272
+ return {
273
+ isAvailable,
274
+
275
+ async get(account) {
276
+ const result = await callOrUnreachable(CesRpcMethod.GetCredential, {
277
+ account,
278
+ });
279
+ if (!result.ok) return { value: undefined, unreachable: true };
280
+ return {
281
+ value: result.response.found ? result.response.value : undefined,
282
+ unreachable: false,
283
+ };
284
+ },
285
+
286
+ async set(account, value) {
287
+ const result = await callOrUnreachable(CesRpcMethod.SetCredential, {
288
+ account,
289
+ value,
290
+ });
291
+ return result.ok && result.response.ok;
292
+ },
293
+
294
+ async delete(account) {
295
+ const result = await callOrUnreachable(CesRpcMethod.DeleteCredential, {
296
+ account,
297
+ });
298
+ if (!result.ok) return "error";
299
+ return result.response.result;
300
+ },
301
+
302
+ async bulkSet(credentials) {
303
+ const result = await callOrUnreachable(CesRpcMethod.BulkSetCredentials, {
304
+ credentials,
305
+ });
306
+ if (!result.ok) {
307
+ return credentials.map(({ account }) => ({ account, ok: false }));
308
+ }
309
+ return result.response.results;
310
+ },
311
+
312
+ async list() {
313
+ const result = await callOrUnreachable(CesRpcMethod.ListCredentials, {});
314
+ if (!result.ok) return { accounts: [], unreachable: true };
315
+ return { accounts: result.response.accounts, unreachable: false };
316
+ },
317
+
318
+ async getRecord(account) {
319
+ const result = await callOrUnreachable(CesRpcMethod.GetCredentialRecord, {
320
+ account,
321
+ });
322
+ if (!result.ok) return { record: undefined, unreachable: true };
323
+ return { record: result.response.record, unreachable: false };
324
+ },
325
+
326
+ async setRecord(account, record) {
327
+ const result = await callOrUnreachable(CesRpcMethod.SetCredentialRecord, {
328
+ account,
329
+ record,
330
+ });
331
+ return result.ok && result.response.ok;
332
+ },
333
+
334
+ async deleteRecord(account) {
335
+ const result = await callOrUnreachable(
336
+ CesRpcMethod.DeleteCredentialRecord,
337
+ { account },
338
+ );
339
+ if (!result.ok) return "error";
340
+ return result.response.result;
341
+ },
342
+
343
+ async listRecords() {
344
+ const result = await callOrUnreachable(
345
+ CesRpcMethod.ListCredentialRecords,
346
+ {},
347
+ );
348
+ if (!result.ok) return { records: [], unreachable: true };
349
+ return { records: result.response.records, unreachable: false };
350
+ },
351
+
352
+ async bulkSetRecords(records) {
353
+ const result = await callOrUnreachable(
354
+ CesRpcMethod.BulkSetCredentialRecords,
355
+ { records },
356
+ );
357
+ if (!result.ok) {
358
+ return records.map(({ account }) => ({ account, ok: false }));
359
+ }
360
+ return result.response.results;
361
+ },
362
+ };
363
+ }
@@ -0,0 +1,187 @@
1
+ /**
2
+ * IPC client for the CES log export.
3
+ *
4
+ * The IPC-only replacement for `http-log-export` — same result shape
5
+ * (`{ ok, data }` tar.gz bytes), different transport. Log collection is a
6
+ * rare diagnostic operation, so this opens a one-shot connection per export
7
+ * (connect, handshake, `export_logs`, close) instead of holding a session.
8
+ */
9
+
10
+ import { createConnection } from "node:net";
11
+ import { existsSync } from "node:fs";
12
+ import { StringDecoder } from "node:string_decoder";
13
+
14
+ import { CesRpcMethod } from "@mycadet/service-contracts/credential-rpc";
15
+
16
+ import { createCesRpcClient } from "./rpc-client.js";
17
+ import { getCesSocketPath } from "./socket-path.js";
18
+
19
+ // ---------------------------------------------------------------------------
20
+ // Types (shared with the HTTP client's shapes)
21
+ // ---------------------------------------------------------------------------
22
+
23
+ /** Options for a log export request. */
24
+ export interface CesLogExportOptions {
25
+ /** Start of the date range (epoch milliseconds). */
26
+ startTime?: number;
27
+ /** End of the date range (epoch milliseconds). */
28
+ endTime?: number;
29
+ /** Request timeout in milliseconds. Default: 120 000. */
30
+ timeoutMs?: number;
31
+ }
32
+
33
+ /** Successful log export result. */
34
+ export interface CesLogExportSuccess {
35
+ ok: true;
36
+ /** Raw tar.gz archive bytes. */
37
+ data: ArrayBuffer;
38
+ }
39
+
40
+ /** Failed log export result. */
41
+ export interface CesLogExportFailure {
42
+ ok: false;
43
+ /** Human-readable error message. */
44
+ error: string;
45
+ }
46
+
47
+ export type CesLogExportResult = CesLogExportSuccess | CesLogExportFailure;
48
+
49
+ // ---------------------------------------------------------------------------
50
+ // Constants
51
+ // ---------------------------------------------------------------------------
52
+
53
+ const DEFAULT_TIMEOUT_MS = 120_000;
54
+
55
+ const SOCKET_CONNECT_TIMEOUT_MS = 5_000;
56
+
57
+ // ---------------------------------------------------------------------------
58
+ // Client
59
+ // ---------------------------------------------------------------------------
60
+
61
+ /**
62
+ * Fetch a tar.gz archive of CES logs over the shared Unix socket. The
63
+ * archive bytes are returned for the consumer to stage/extract as needed.
64
+ */
65
+ export async function exportCesLogs(
66
+ options?: CesLogExportOptions,
67
+ ): Promise<CesLogExportResult> {
68
+ const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
69
+ const socketPath = getCesSocketPath();
70
+
71
+ if (!socketPath.startsWith("\\\\.\\pipe\\") && !existsSync(socketPath)) {
72
+ return { ok: false, error: `CES socket not found at ${socketPath}` };
73
+ }
74
+
75
+ let rpc: ReturnType<typeof createCesRpcClient> | undefined;
76
+ try {
77
+ const transport = await connectSocket(socketPath, timeoutMs);
78
+ rpc = createCesRpcClient(transport, {
79
+ handshakeTimeoutMs: SOCKET_CONNECT_TIMEOUT_MS,
80
+ requestTimeoutMs: timeoutMs,
81
+ });
82
+
83
+ const { accepted, reason } = await rpc.handshake();
84
+ if (!accepted) {
85
+ return { ok: false, error: `CES handshake rejected: ${reason}` };
86
+ }
87
+
88
+ const result = await rpc.call(CesRpcMethod.ExportLogs, {
89
+ ...(options?.startTime !== undefined
90
+ ? { startTime: options.startTime }
91
+ : {}),
92
+ ...(options?.endTime !== undefined ? { endTime: options.endTime } : {}),
93
+ });
94
+
95
+ const archive = Buffer.from(result.archiveBase64, "base64");
96
+ const bytes = new ArrayBuffer(archive.byteLength);
97
+ new Uint8Array(bytes).set(archive);
98
+ return { ok: true, data: bytes };
99
+ } catch (err) {
100
+ return {
101
+ ok: false,
102
+ error: err instanceof Error ? err.message : String(err),
103
+ };
104
+ } finally {
105
+ rpc?.close();
106
+ }
107
+ }
108
+
109
+ // ---------------------------------------------------------------------------
110
+ // One-shot socket transport
111
+ // ---------------------------------------------------------------------------
112
+
113
+ interface SocketTransport {
114
+ write(line: string): void;
115
+ onMessage(handler: (message: string) => void): void;
116
+ isAlive(): boolean;
117
+ close(): void;
118
+ }
119
+
120
+ function connectSocket(
121
+ socketPath: string,
122
+ timeoutMs: number,
123
+ ): Promise<SocketTransport> {
124
+ return new Promise<SocketTransport>((resolve, reject) => {
125
+ const socket = createConnection({ path: socketPath });
126
+ const messageHandlers: Array<(message: string) => void> = [];
127
+ let buffer = "";
128
+ let closed = false;
129
+ const decoder = new StringDecoder("utf8");
130
+
131
+ const timer = setTimeout(
132
+ () => {
133
+ socket.destroy();
134
+ reject(
135
+ new Error(
136
+ `Connection to CES socket at ${socketPath} timed out after ${SOCKET_CONNECT_TIMEOUT_MS}ms`,
137
+ ),
138
+ );
139
+ },
140
+ Math.min(SOCKET_CONNECT_TIMEOUT_MS, timeoutMs),
141
+ );
142
+
143
+ socket.on("connect", () => {
144
+ clearTimeout(timer);
145
+ resolve({
146
+ write(line: string): void {
147
+ if (closed || socket.destroyed) {
148
+ throw new Error("CES socket transport is not alive");
149
+ }
150
+ socket.write(line + "\n");
151
+ },
152
+ onMessage(handler: (message: string) => void): void {
153
+ messageHandlers.push(handler);
154
+ },
155
+ isAlive(): boolean {
156
+ return !closed && !socket.destroyed;
157
+ },
158
+ close(): void {
159
+ closed = true;
160
+ socket.destroy();
161
+ },
162
+ });
163
+ });
164
+
165
+ socket.on("error", (err) => {
166
+ if (timer.hasRef?.()) {
167
+ clearTimeout(timer);
168
+ socket.destroy();
169
+ reject(err);
170
+ }
171
+ });
172
+
173
+ socket.on("data", (chunk: Buffer | string) => {
174
+ buffer += typeof chunk === "string" ? chunk : decoder.write(chunk);
175
+ let newlineIdx: number;
176
+ while ((newlineIdx = buffer.indexOf("\n")) !== -1) {
177
+ const line = buffer.slice(0, newlineIdx).trim();
178
+ buffer = buffer.slice(newlineIdx + 1);
179
+ if (line) {
180
+ for (const handler of messageHandlers) {
181
+ handler(line);
182
+ }
183
+ }
184
+ }
185
+ });
186
+ });
187
+ }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * CES socket path resolution — shared by every process that dials or binds
3
+ * the CES Unix socket (credential-executor, assistant, gateway, CLI).
4
+ *
5
+ * `ces.sock` lives in its own IPC directory, a sibling of the CES data dir
6
+ * (never inside it — the data dir is CES-private, the socket is the shared
7
+ * rendezvous). Containers default to `/run/ces-ipc`, matching the
8
+ * assistant and gateway IPC layout (`/run/assistant-ipc`, `/run/gateway-ipc`);
9
+ * bare-metal runs set `CES_SOCKET_DIR` to a per-instance directory.
10
+ */
11
+
12
+ import { resolveIpcEndpoint } from "@mycadet/ipc-server-utils";
13
+
14
+ /** Default directory for the CES Unix socket (containerized mode). */
15
+ export const CES_SOCKET_DIR_DEFAULT = "/run/ces-ipc";
16
+
17
+ /**
18
+ * The directory holding `ces.sock`: `CES_SOCKET_DIR` when set, otherwise
19
+ * `/run/ces-ipc`.
20
+ */
21
+ export function getCesSocketDir(): string {
22
+ return process.env["CES_SOCKET_DIR"]?.trim() || CES_SOCKET_DIR_DEFAULT;
23
+ }
24
+
25
+ /**
26
+ * The path to the CES Unix socket used in every environment.
27
+ *
28
+ * Local siblings and managed sidecars share this resolver. The assistant and
29
+ * gateway dial the same path CES binds. Resolved through `resolveIpcEndpoint`
30
+ * so macOS AF_UNIX limits and Windows named pipes stay consistent.
31
+ */
32
+ export function getCesSocketPath(): string {
33
+ return resolveIpcEndpoint("ces", { workspaceDir: getCesSocketDir() }).path;
34
+ }