@clagentic/console 1.11.0 → 1.12.0-beta.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 (99) hide show
  1. package/README.md +1 -0
  2. package/bin/cli.js +14 -2
  3. package/lib/build-changes.js +8 -2
  4. package/lib/build-sha.json +2 -2
  5. package/lib/build-update-offer.js +31 -7
  6. package/lib/claude-settings-env.js +142 -0
  7. package/lib/cli/arg-validation.js +1 -1
  8. package/lib/cli/duration.js +27 -0
  9. package/lib/cli/ipc-subcommands.js +26 -0
  10. package/lib/cli/schedule-input-subcommands.js +1 -22
  11. package/lib/cli/session-subcommands.js +38 -7
  12. package/lib/daemon.js +26 -0
  13. package/lib/notification-prefs.js +257 -0
  14. package/lib/notify/core.js +175 -0
  15. package/lib/notify/index.js +31 -0
  16. package/lib/notify/live-prompts.js +36 -0
  17. package/lib/notify/payload.js +63 -0
  18. package/lib/notify/target.js +5 -0
  19. package/lib/notify/type-registry.js +64 -0
  20. package/lib/notify/types.js +20 -0
  21. package/lib/open-sockets.js +27 -0
  22. package/lib/outbound-access.js +74 -0
  23. package/lib/outbound-entry.js +109 -0
  24. package/lib/outbound-ledger.js +306 -0
  25. package/lib/outbound-query.js +153 -0
  26. package/lib/pending-prompts.js +31 -16
  27. package/lib/project-connection.js +40 -1
  28. package/lib/project-filesystem.js +20 -5
  29. package/lib/project-http.js +9 -1
  30. package/lib/project-loop.js +25 -13
  31. package/lib/project-notifications.js +206 -42
  32. package/lib/project-prompt-responses.js +1 -1
  33. package/lib/project-sessions.js +30 -1
  34. package/lib/project.js +15 -1
  35. package/lib/prompt-registry.js +92 -24
  36. package/lib/prompt-reminders.js +282 -0
  37. package/lib/prompt-source.js +43 -8
  38. package/lib/public/app.js +1 -0
  39. package/lib/public/css/diagnostics.css +28 -0
  40. package/lib/public/css/home-hub.css +12 -0
  41. package/lib/public/css/icon-strip.css +9 -0
  42. package/lib/public/css/input.css +93 -0
  43. package/lib/public/css/menus.css +22 -0
  44. package/lib/public/css/mobile-nav.css +11 -0
  45. package/lib/public/css/server-settings.css +24 -0
  46. package/lib/public/css/sidebar.css +24 -0
  47. package/lib/public/index.html +6 -0
  48. package/lib/public/modules/activity-state.js +20 -4
  49. package/lib/public/modules/app-connection.js +22 -5
  50. package/lib/public/modules/app-header.js +2 -0
  51. package/lib/public/modules/app-messages.js +6 -2
  52. package/lib/public/modules/app-notifications.js +65 -40
  53. package/lib/public/modules/app-projects.js +3 -1
  54. package/lib/public/modules/app-rate-limit.js +12 -6
  55. package/lib/public/modules/app-rendering.js +26 -3
  56. package/lib/public/modules/build-update-sessions.js +81 -0
  57. package/lib/public/modules/collapsible-text.js +77 -0
  58. package/lib/public/modules/diagnostics.js +9 -2
  59. package/lib/public/modules/env-shadow-notice.js +34 -0
  60. package/lib/public/modules/keep-alive.js +66 -0
  61. package/lib/public/modules/notification-prefs.js +151 -0
  62. package/lib/public/modules/notify-client.js +153 -0
  63. package/lib/public/modules/project-settings.js +5 -0
  64. package/lib/public/modules/prompt-reminders-setting.js +13 -0
  65. package/lib/public/modules/prompt-state.js +3 -3
  66. package/lib/public/modules/prompts.js +1 -1
  67. package/lib/public/modules/server-settings.js +3 -0
  68. package/lib/public/modules/sidebar-mobile.js +8 -0
  69. package/lib/public/modules/sidebar-sessions.js +27 -0
  70. package/lib/public/modules/terminal-links.js +175 -0
  71. package/lib/public/modules/terminal.js +19 -103
  72. package/lib/public/notify-sw-logic.js +300 -0
  73. package/lib/public/notify-target.js +97 -0
  74. package/lib/public/sw.js +15 -62
  75. package/lib/push-audience.js +84 -0
  76. package/lib/push.js +87 -20
  77. package/lib/runtime-env.js +1 -0
  78. package/lib/sdk-bridge.js +83 -36
  79. package/lib/sdk-message-processor.js +148 -49
  80. package/lib/sender-ref.js +3 -0
  81. package/lib/server.js +80 -4
  82. package/lib/session-directory.js +6 -4
  83. package/lib/session-input-ipc.js +11 -1
  84. package/lib/session-input.js +95 -14
  85. package/lib/session-liveness.js +53 -0
  86. package/lib/session-reclaim.js +37 -2
  87. package/lib/sessions.js +58 -4
  88. package/lib/usage-store.js +403 -0
  89. package/lib/vendor-auth.js +33 -2
  90. package/lib/ws-schema.js +13 -2
  91. package/lib/yoke/adapters/claude-vendor.js +11 -1
  92. package/lib/yoke/adapters/claude.js +17 -0
  93. package/lib/yoke/adapters/codex.js +5 -1
  94. package/lib/yoke/auth-checks.js +17 -2
  95. package/lib/yoke/index.js +21 -3
  96. package/lib/yoke/provider-credentials.js +24 -0
  97. package/lib/yoke/registry.js +8 -1
  98. package/package.json +2 -2
  99. package/scripts/check-test-count.js +14 -0
package/README.md CHANGED
@@ -24,6 +24,7 @@ Agents do not need a browser. From a shell, or from inside a console session, an
24
24
  - **Message sessions:** `clagentic-console send-input --to builder@my-project --prompt "The build passed."` The input is pushed into the session, which is resumed first if it was reaped.
25
25
  - **Reply:** `clagentic-console send-input --reply --prompt "Done."` answers whoever last messaged the calling session.
26
26
  - **List sessions:** `clagentic-console list-sessions --state live` shows each session's state and any prompts it is waiting on.
27
+ - **List what a session sent:** `clagentic-console list-outbound --session 4f1c9d2e-7a3b-4c55-9e0a-1b2c3d4e5f60 --since 2h` shows the calls that session (named by its vendor session id, from `list-sessions`) made with `send-input` and `open-session`: target, prompt, time and initiator. The daemon keeps them for 30 days by default (`outboundRetentionDays` in `daemon.json`; `0` stops recording and deletes existing entries). Prompt text goes to the daemon's OS user for every session that runs as it; a session that runs as another OS user (os-users mode) is listed without its text, because that text is never stored. See the [agent guide](docs/guides/AGENT-GUIDE.md#list-outbound).
27
28
  - **Schedule input:** `clagentic-console schedule-input create --session 12 --project my-project --every 30m --count 4 --prompt "Check the build."` sends text into a session later, once or on a repeat that always has an end. People do the same from the clock button next to the message box.
28
29
 
29
30
  Every injected message records who sent it, and an agent's message is never recorded as a human's. See the [agents guide](docs/guides/AGENT-GUIDE.md) for every verb and flag.
package/bin/cli.js CHANGED
@@ -33,7 +33,7 @@ var { forkDaemon, devMode, setDaemonWatcherOpts } = require("../lib/cli/daemon-l
33
33
  var { setup, promptRestoreProjects, showMainMenu } = require("../lib/cli/menus");
34
34
  var { getLocalIP } = require("../lib/cli/net-detect");
35
35
  var { log, a, sym } = require("../lib/cli/tui");
36
- var { handleShutdown, handleRestart, handleAdd, handleRemove, handleList, handleActivityDiagnostics, handleProcessBuildStatus } = require("../lib/cli/ipc-subcommands");
36
+ var { handleShutdown, handleRestart, handleAdd, handleRemove, handleList, handleActivityDiagnostics, handleUsage, handleProcessBuildStatus } = require("../lib/cli/ipc-subcommands");
37
37
 
38
38
  var args = process.argv.slice(2);
39
39
 
@@ -89,7 +89,7 @@ if (args[0] === "release") {
89
89
  }
90
90
  }
91
91
 
92
- // --- `open-session` / `send-input` / `list-sessions`: drive a session through the running daemon ---
92
+ // --- `open-session` / `send-input` / `list-sessions` / `list-outbound`: drive a session through the running daemon ---
93
93
  // Positional verbs, handled before flag parsing: `clagentic-console send-input --project <slug> ...`.
94
94
  var { SESSION_VERBS, runSessionVerb } = require("../lib/cli/session-subcommands");
95
95
  if (SESSION_VERBS.indexOf(args[0]) !== -1) {
@@ -116,6 +116,7 @@ var addPath = null;
116
116
  var removePath = null;
117
117
  var listMode = false;
118
118
  var activityDiagnosticsMode = false;
119
+ var usageMode = false;
119
120
  var processBuildStatusMode = false;
120
121
  var headlessMode = false;
121
122
  var watchMode = false;
@@ -175,6 +176,8 @@ for (var i = 0; i < args.length; i++) {
175
176
  listMode = true;
176
177
  } else if (args[i] === "--activity-diagnostics") {
177
178
  activityDiagnosticsMode = true;
179
+ } else if (args[i] === "--usage") {
180
+ usageMode = true;
178
181
  } else if (args[i] === "--process-build-status") {
179
182
  processBuildStatusMode = true;
180
183
  } else if (args[i] === "--headless") {
@@ -193,10 +196,12 @@ for (var i = 0; i < args.length; i++) {
193
196
  console.log(" clagentic-console --remove <path> Remove a project from the running daemon");
194
197
  console.log(" clagentic-console --list List registered projects");
195
198
  console.log(" clagentic-console --activity-diagnostics Print activity-divergence probe totals as JSON (agent-readable)");
199
+ console.log(" clagentic-console --usage Print account usage per vendor and rate-limit bucket as JSON, with how fresh each reading is and why (agent-readable)");
196
200
  console.log(" clagentic-console --process-build-status Print the running process's loaded build SHA as JSON (agent-readable)");
197
201
  console.log(" clagentic-console open-session (--project <slug> | --to <address>) --prompt <text|-> [--vendor <id>] [--agent <name>] [--name <session-name>] [--visibility shared|private] [--permission-mode <mode>] [--initiator <kind>] [--context-note <text>] [--from <name>] [--from-session <id>] Open a session and run a first prompt (prints JSON)");
198
202
  console.log(" clagentic-console send-input (--project <slug> --session <id> | --to <address> | --reply) --prompt <text|-> [--initiator <kind>] [--context-note <text>] [--from <name>] [--from-session <id>] Send input to a session, resuming it if needed (prints JSON; exit 3 ambiguous, 4 not found by address)");
199
203
  console.log(" clagentic-console list-sessions [--project <slug>] [--agent <name>] [--vendor <id>] [--state live|idle|reaped|any] List the console's sessions (prints JSON)");
204
+ console.log(" clagentic-console list-outbound --session <vendor-session-id> [--project <slug>] [--since <dur>] [--kind sent|opens] List what a session (by vendor session id, see list-sessions) sent out with send-input and open-session: target, prompt, time, initiator (prints JSON; read-only; kept 30 days by default)");
200
205
  console.log(" clagentic-console schedule-input create --session <id> [--project <slug>] (--in <dur> | --at <time> | --every <dur> (--until <time> | --count <n>)) (--prompt <text|-> | --prompt-file <path>) Send text into a session later, once or on a repeat with an end (prints JSON)");
201
206
  console.log(" clagentic-console schedule-input list [--session <id>] [--project <slug>] [--state armed|done|ended|any] List scheduled input, from the browser or the CLI (prints JSON)");
202
207
  console.log(" clagentic-console schedule-input delete --id <id> [--project <slug>] Cancel a scheduled input");
@@ -222,6 +227,7 @@ for (var i = 0; i < args.length; i++) {
222
227
  console.log(" --remove <path> Remove a project directory");
223
228
  console.log(" --list List all registered projects");
224
229
  console.log(" --activity-diagnostics Print activity-divergence probe totals as JSON");
230
+ console.log(" --usage Print account usage per vendor and rate-limit bucket as JSON, with freshness and why a reading is old");
225
231
  console.log(" --process-build-status Print the running process's loaded build SHA as JSON");
226
232
  console.log(" --headless Start daemon and exit immediately (implies --yes)");
227
233
  console.log(" --multi-user Start in multi-user mode (use with --yes for headless)");
@@ -272,6 +278,12 @@ if (activityDiagnosticsMode) {
272
278
  return;
273
279
  }
274
280
 
281
+ // --- Handle --usage before anything else ---
282
+ if (usageMode) {
283
+ handleUsage();
284
+ return;
285
+ }
286
+
275
287
  // --- Handle --process-build-status before anything else ---
276
288
  if (processBuildStatusMode) {
277
289
  handleProcessBuildStatus();
@@ -16,6 +16,12 @@ var DEFAULT_LIMIT = 30;
16
16
  var SUBJECT_MAX = 200;
17
17
  var GIT_TIMEOUT_MS = 5000;
18
18
 
19
+ // An install made from a packed tarball (npm install -g, including the
20
+ // install:local-test script) carries no .git directory, so the package
21
+ // directory cannot answer; only buildSourceRepo in daemon.json can.
22
+ var NO_REPO_REASON = 'this install carries no git history (it was installed from a package, not a checkout); ' +
23
+ 'set buildSourceRepo in daemon.json to the checkout it was built from to list the changes';
24
+
19
25
  /** The repository to read history from, or null when there is none to try. */
20
26
  function resolveHistoryRepo(configured, packageRoot) {
21
27
  if (typeof configured === 'string' && path.isAbsolute(configured)) return configured;
@@ -47,7 +53,7 @@ function listBuildChanges(o) {
47
53
  function unavailable(reason) {
48
54
  return { available: false, commits: [], truncated: false, reason: reason };
49
55
  }
50
- if (!o.repo) return Promise.resolve(unavailable('no git history is available for this install'));
56
+ if (!o.repo) return Promise.resolve(unavailable(NO_REPO_REASON));
51
57
  // Only hex revisions reach git, so a value can never be read as an option.
52
58
  if (!SHA_RE.test(String(o.fromSha)) || !SHA_RE.test(String(o.toSha))) {
53
59
  return Promise.resolve(unavailable('a build sha is not a git revision'));
@@ -76,4 +82,4 @@ function listBuildChanges(o) {
76
82
  });
77
83
  }
78
84
 
79
- module.exports = { listBuildChanges: listBuildChanges, resolveHistoryRepo: resolveHistoryRepo, DEFAULT_LIMIT: DEFAULT_LIMIT };
85
+ module.exports = { listBuildChanges: listBuildChanges, resolveHistoryRepo: resolveHistoryRepo, DEFAULT_LIMIT: DEFAULT_LIMIT, NO_REPO_REASON: NO_REPO_REASON };
@@ -1,4 +1,4 @@
1
1
  {
2
- "sha": "64781e933f0b75244454f5effdb42544cae89712",
3
- "writtenAt": "2026-10-23T20:59:57.884Z"
2
+ "sha": "539865735f50f10bc98a10405ad939dd97d47b75",
3
+ "writtenAt": "2026-11-07T22:06:56.438Z"
4
4
  }
@@ -10,6 +10,7 @@
10
10
 
11
11
  var SESSION_TITLE_MAX = 80;
12
12
  var liveAgentTasks = require('./session-reclaim').liveAgentTasks;
13
+ var liveness = require('./session-liveness');
13
14
 
14
15
  function oneLine(text, max, fallback) {
15
16
  if (typeof text !== 'string') return fallback;
@@ -26,13 +27,14 @@ function isLive(session) {
26
27
  * Everything a restart now would end, across every project.
27
28
  *
28
29
  * @param {Array<{slug: string, sm: {sessions: Map}}>} projects
29
- * @returns {{sessions: Array<object>, sessionCount: number, processingCount: number, agentCount: number, keys: string[]}}
30
+ * @returns {{sessions: Array<object>, sessionCount: number, processingCount: number, waitingCount: number, agentCount: number, keys: string[]}}
30
31
  */
31
32
  function collectInterruptions(projects) {
32
33
  var sessions = [];
33
34
  var keys = [];
34
35
  var agentCount = 0;
35
36
  var processingCount = 0;
37
+ var waitingCount = 0;
36
38
  (projects || []).forEach(function (proj) {
37
39
  if (!proj || !proj.sm || !proj.sm.sessions) return;
38
40
  proj.sm.sessions.forEach(function (session) {
@@ -40,19 +42,24 @@ function collectInterruptions(projects) {
40
42
  var key = proj.slug + '#' + session.localId;
41
43
  var agents = liveAgentTasks(session);
42
44
  var processing = !!session.isProcessing;
45
+ var activity = liveness.activityOf(session);
46
+ var waiting = activity === liveness.ACTIVITY.WAITING;
43
47
  keys.push(key);
44
48
  // Busy state is part of what the operator was shown: a session offered as
45
- // idle that starts a turn afterwards is not covered.
49
+ // idle that starts a turn, or blocks on a prompt, afterwards is not covered.
46
50
  if (processing) keys.push(key + '#busy');
51
+ if (waiting) keys.push(key + '#waiting');
47
52
  agents.forEach(function (a) { keys.push(key + '#' + a.id); });
48
53
  agentCount += agents.length;
49
54
  if (processing) processingCount += 1;
55
+ if (waiting) waitingCount += 1;
50
56
  sessions.push({
51
57
  key: key,
52
58
  slug: proj.slug,
53
59
  localId: session.localId,
54
60
  title: oneLine(session.title, SESSION_TITLE_MAX, 'Untitled session'),
55
61
  processing: processing,
62
+ activity: activity,
56
63
  agents: agents.map(function (a) { return a.label; }),
57
64
  });
58
65
  });
@@ -61,15 +68,32 @@ function collectInterruptions(projects) {
61
68
  sessions: sessions,
62
69
  sessionCount: sessions.length,
63
70
  processingCount: processingCount,
71
+ waitingCount: waitingCount,
64
72
  agentCount: agentCount,
65
73
  keys: keys,
66
74
  };
67
75
  }
68
76
 
77
+ // The three words the card uses; a reaped session is not on the card.
78
+ var ACTIVITY_LABEL = {
79
+ running: 'running a turn',
80
+ waiting: 'waiting on a prompt',
81
+ idle: 'idle',
82
+ };
83
+
69
84
  function plural(n, word) {
70
85
  return n + ' ' + word + (n === 1 ? '' : 's');
71
86
  }
72
87
 
88
+ /** One session as the card words it: "[slug] title (state; background agents: ...)". */
89
+ function describeSession(s) {
90
+ var state = ACTIVITY_LABEL[s.activity] || (s.processing ? ACTIVITY_LABEL.running : ACTIVITY_LABEL.idle);
91
+ var agents = s.agents.length > 0
92
+ ? '; background agents: ' + s.agents.map(function (l) { return '"' + l + '"'; }).join(', ')
93
+ : '';
94
+ return '[' + s.slug + '] ' + s.title + ' (' + state + agents + ')';
95
+ }
96
+
73
97
  /** The operator-facing statement of what a restart ends. */
74
98
  function describeInterruptions(i) {
75
99
  if (i.sessionCount === 0) {
@@ -80,11 +104,7 @@ function describeInterruptions(i) {
80
104
  (i.agentCount > 0 ? ' and ' + plural(i.agentCount, 'background agent') : '') + '.',
81
105
  ];
82
106
  i.sessions.forEach(function (s) {
83
- var state = s.processing ? 'running a turn' : 'idle';
84
- var agents = s.agents.length > 0
85
- ? '; background agents: ' + s.agents.map(function (l) { return '"' + l + '"'; }).join(', ')
86
- : '';
87
- lines.push('- [' + s.slug + '] ' + s.title + ' (' + state + agents + ')');
107
+ lines.push('- ' + describeSession(s));
88
108
  });
89
109
  lines.push('Restarting ends these sessions and any that start before the restart happens. ' +
90
110
  'Ended sessions resume when you send them a message.');
@@ -110,6 +130,9 @@ function buildOffer(o) {
110
130
  sessions: o.interruptions.sessions,
111
131
  sessionCount: o.interruptions.sessionCount,
112
132
  agentCount: o.interruptions.agentCount,
133
+ // The same wording the message carries, so the client can set the list
134
+ // apart from the message without parsing it.
135
+ lines: o.interruptions.sessions.map(describeSession),
113
136
  };
114
137
  offer.interruptionText = describeInterruptions(o.interruptions);
115
138
  }
@@ -174,6 +197,7 @@ module.exports = {
174
197
  composeNotice: composeNotice,
175
198
  collectInterruptions: collectInterruptions,
176
199
  describeInterruptions: describeInterruptions,
200
+ describeSession: describeSession,
177
201
  buildOffer: buildOffer,
178
202
  summarizeOffer: summarizeOffer,
179
203
  liveAgentTasks: liveAgentTasks,
@@ -0,0 +1,142 @@
1
+ // claude-settings-env.js - the variables the Claude user settings file sets in
2
+ // its own "env" block, and which of them a Settings environment text names too.
3
+ //
4
+ // Claude Code applies that block to its own environment at startup, after the
5
+ // environment it was handed, so for a key present in both the settings file
6
+ // wins over the value saved in Settings. The editor warns about those keys
7
+ // rather than letting a saved value silently have no effect. Names only: no
8
+ // value is read out of the file into a result.
9
+
10
+ var fs = require("fs");
11
+ var os = require("os");
12
+ var path = require("path");
13
+ var runtimeEnv = require("./runtime-env");
14
+
15
+ /**
16
+ * The one settings file the daemon reads, located from the daemon's own
17
+ * environment alone: its CLAUDE_CONFIG_DIR if it has one, else its home. Text
18
+ * saved in Settings (shared or per project) is written by other people and
19
+ * never chooses the path, so the daemon cannot be pointed at another account's
20
+ * file. Null means "read nothing": under os-users mode the session runs as
21
+ * another account whose file the daemon does not read.
22
+ *
23
+ * @param {{osUsers?: boolean, homeDir?: string}} [opts]
24
+ * @returns {?string}
25
+ */
26
+ function resolveSettingsFile(opts) {
27
+ opts = opts || {};
28
+ if (opts.osUsers) return null;
29
+ var configDir = process.env.CLAUDE_CONFIG_DIR;
30
+ if (configDir) return path.join(configDir, "settings.json");
31
+ return path.join(opts.homeDir || os.homedir(), ".claude", "settings.json");
32
+ }
33
+
34
+ function userSettingsEnvBlock(opts) {
35
+ opts = opts || {};
36
+ var file = resolveSettingsFile(opts);
37
+ if (!file) return null;
38
+ var parsed;
39
+ try {
40
+ parsed = JSON.parse(fs.readFileSync(file, "utf8"));
41
+ } catch (e) {
42
+ // No file, or one that is not valid JSON, sets nothing the runtime can see.
43
+ return null;
44
+ }
45
+ var block = parsed && typeof parsed === "object" ? parsed.env : null;
46
+ if (!block || typeof block !== "object" || Array.isArray(block)) return null;
47
+ return block;
48
+ }
49
+
50
+ /**
51
+ * A cheap change stamp for the settings file, for cache keys: mtime and size,
52
+ * no content read and nothing of it logged.
53
+ *
54
+ * @param {{osUsers?: boolean, homeDir?: string}} [opts]
55
+ * @returns {string} "" when no file is read or it does not exist
56
+ */
57
+ function settingsFileStamp(opts) {
58
+ var file = resolveSettingsFile(opts);
59
+ if (!file) return "";
60
+ try {
61
+ var st = fs.statSync(file);
62
+ return st.mtimeMs + ":" + st.size;
63
+ } catch (e) {
64
+ // An absent file is a stable, distinct state; creating it changes the stamp.
65
+ return "";
66
+ }
67
+ }
68
+
69
+ /**
70
+ * @param {{osUsers?: boolean, homeDir?: string}} [opts]
71
+ * @returns {string[]} the names in the settings file's env block; [] when the
72
+ * file is absent or unreadable, or under os-users mode
73
+ */
74
+ function userSettingsEnvKeys(opts) {
75
+ var block = userSettingsEnvBlock(opts);
76
+ return block ? Object.keys(block) : [];
77
+ }
78
+
79
+ /**
80
+ * The environment the Claude CLI actually sees: the one it was handed with the
81
+ * settings file's env block applied over it (the file wins). Used to decide
82
+ * what the CLI will do (which provider it talks to), never to hand a value on:
83
+ * the result is for in-process classification and is not logged or sent.
84
+ *
85
+ * Under os-users mode the file belongs to another account and is not read, so
86
+ * the result is the given environment unchanged: a provider selected only in
87
+ * that account's own settings file is not seen by the console there.
88
+ * @param {object} env the composed environment the runtime is started with
89
+ * @param {{homeDir?: string, osUsers?: boolean}} [opts]
90
+ * @returns {object} a new object; env is not modified
91
+ */
92
+ function applyUserSettingsEnv(env, opts) {
93
+ var out = Object.assign({}, env);
94
+ var block = userSettingsEnvBlock(opts);
95
+ if (!block) return out;
96
+ Object.keys(block).forEach(function (key) {
97
+ var value = block[key];
98
+ if (typeof value === "string") out[key] = value;
99
+ else if (typeof value === "number" || typeof value === "boolean") out[key] = String(value);
100
+ });
101
+ return out;
102
+ }
103
+
104
+ /**
105
+ * @param {string} envText a Settings environment text
106
+ * @param {{homeDir?: string, osUsers?: boolean}} [opts]
107
+ * @returns {string[]} names the text sets that the settings file also sets; []
108
+ * under os-users mode, where the file is not read
109
+ */
110
+ function shadowedKeys(envText, opts) {
111
+ var fileKeys = userSettingsEnvKeys(opts);
112
+ if (fileKeys.length === 0) return [];
113
+ var inFile = new Set(fileKeys);
114
+ var seen = new Set();
115
+ return runtimeEnv.scanEnvText(envText).entries
116
+ .map(function (entry) { return entry.key; })
117
+ .filter(function (key) {
118
+ if (!inFile.has(key) || seen.has(key)) return false;
119
+ seen.add(key);
120
+ return true;
121
+ });
122
+ }
123
+
124
+ /**
125
+ * @param {string} envText a Settings environment text
126
+ * @returns {boolean} whether it sets CLAUDE_CONFIG_DIR, which the console never
127
+ * reads a path from (the editor says its check covers one file only)
128
+ */
129
+ function setsConfigDir(envText) {
130
+ return runtimeEnv.scanEnvText(envText).entries.some(function (entry) {
131
+ return entry.key === "CLAUDE_CONFIG_DIR";
132
+ });
133
+ }
134
+
135
+ module.exports = {
136
+ setsConfigDir: setsConfigDir,
137
+ resolveSettingsFile: resolveSettingsFile,
138
+ settingsFileStamp: settingsFileStamp,
139
+ userSettingsEnvKeys: userSettingsEnvKeys,
140
+ applyUserSettingsEnv: applyUserSettingsEnv,
141
+ shadowedKeys: shadowedKeys,
142
+ };
@@ -9,7 +9,7 @@
9
9
  var BOOLEAN_FLAGS = [
10
10
  "--no-https", "--local-cert", "--no-update", "--skip-update", "--dev",
11
11
  "--watch", "-w", "--debug", "-y", "--yes", "--shutdown", "--restart",
12
- "--no-restart", "--list", "--activity-diagnostics", "--process-build-status",
12
+ "--no-restart", "--list", "--activity-diagnostics", "--usage", "--process-build-status",
13
13
  "--headless", "--multi-user", "--os-users",
14
14
  // Removed flag: the flag loop prints its own dedicated message and exits 1.
15
15
  "--dangerously-skip-permissions",
@@ -0,0 +1,27 @@
1
+ // lib/cli/duration.js - the duration a CLI flag takes ("10m", "1h30m", "90").
2
+ // Shared by schedule-input (--in, --every) and list-outbound (--since).
3
+
4
+ var UNIT_MS = Object.freeze({ s: 1000, m: 60000, h: 3600000, d: 86400000 });
5
+
6
+ var DURATION_RE = /^(?:\d+[smhd])+$/;
7
+ var DURATION_PART_RE = /(\d+)([smhd])/g;
8
+
9
+ // A bare number is minutes, the unit the person's own field uses.
10
+ // Returns { ms } or { error }.
11
+ function parseDuration(raw) {
12
+ var text = typeof raw === "string" ? raw.trim().toLowerCase() : "";
13
+ if (/^\d+$/.test(text)) text += "m";
14
+ if (!DURATION_RE.test(text)) {
15
+ return { error: "not a duration: " + JSON.stringify(String(raw).slice(0, 32)) + " (use for example 90, 10m, 2h, 1h30m)" };
16
+ }
17
+ var total = 0;
18
+ var part;
19
+ DURATION_PART_RE.lastIndex = 0;
20
+ while ((part = DURATION_PART_RE.exec(text)) !== null) {
21
+ total += parseInt(part[1], 10) * UNIT_MS[part[2]];
22
+ }
23
+ if (!Number.isSafeInteger(total) || total <= 0) return { error: "a duration must be longer than zero" };
24
+ return { ms: total };
25
+ }
26
+
27
+ module.exports = { parseDuration: parseDuration };
@@ -261,7 +261,33 @@ function handleActivityDiagnostics() {
261
261
  });
262
262
  }
263
263
 
264
+ // Prints per-vendor, per-bucket account usage (see lib/usage-store.js) as raw
265
+ // JSON, the same agent-readable shape as --activity-diagnostics.
266
+ function handleUsage() {
267
+ var usageConfig = loadConfig();
268
+ isDaemonAliveAsync(usageConfig).then(function (alive) {
269
+ if (!alive) {
270
+ console.error("No running daemon. Start with: npx @clagentic/console");
271
+ process.exit(1);
272
+ }
273
+ sendIPCCommand(socketPath(), { cmd: "get_usage" }).then(function (res) {
274
+ if (!res.ok) {
275
+ console.error("Failed: " + (res.error || "unknown error"));
276
+ process.exit(1);
277
+ return;
278
+ }
279
+ console.log(JSON.stringify({
280
+ generatedAt: res.generatedAt,
281
+ staleAfterSeconds: res.staleAfterSeconds,
282
+ vendors: res.vendors,
283
+ }, null, 2));
284
+ process.exit(0);
285
+ });
286
+ });
287
+ }
288
+
264
289
  module.exports = {
290
+ handleUsage: handleUsage,
265
291
  handleShutdown: handleShutdown,
266
292
  handleRestart: handleRestart,
267
293
  handleAdd: handleAdd,
@@ -28,6 +28,7 @@ var fs = require("fs");
28
28
  var senderRef = require("../sender-ref");
29
29
  var { LIMITS, isCount } = require("../scheduled-input/records");
30
30
  var { requestDaemon, withSenderRef, EXIT } = require("./session-subcommands");
31
+ var { parseDuration } = require("./duration");
31
32
 
32
33
  // --- The time inputs: a duration ("10m", "1h30m"), a local clock time ("20:01")
33
34
  // and a local date-time ("2026-03-01T20:01"). Pure: each takes the current time
@@ -35,31 +36,9 @@ var { requestDaemon, withSenderRef, EXIT } = require("./session-subcommands");
35
36
  // (lib/public/modules/schedule-time.js) because it cannot load this CommonJS
36
37
  // file; test/scheduled-input-client.test.js feeds both the same cases.
37
38
 
38
- var UNIT_MS = Object.freeze({ s: 1000, m: 60000, h: 3600000, d: 86400000 });
39
-
40
- var DURATION_RE = /^(?:\d+[smhd])+$/;
41
- var DURATION_PART_RE = /(\d+)([smhd])/g;
42
39
  var CLOCK_RE = /^(\d{1,2}):(\d{2})$/;
43
40
  var DATE_TIME_RE = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{1,2}):(\d{2})$/;
44
41
 
45
- // A bare number is minutes, the unit the person's own field uses.
46
- // Returns { ms } or { error }.
47
- function parseDuration(raw) {
48
- var text = typeof raw === "string" ? raw.trim().toLowerCase() : "";
49
- if (/^\d+$/.test(text)) text += "m";
50
- if (!DURATION_RE.test(text)) {
51
- return { error: "not a duration: " + JSON.stringify(String(raw).slice(0, 32)) + " (use for example 90, 10m, 2h, 1h30m)" };
52
- }
53
- var total = 0;
54
- var part;
55
- DURATION_PART_RE.lastIndex = 0;
56
- while ((part = DURATION_PART_RE.exec(text)) !== null) {
57
- total += parseInt(part[1], 10) * UNIT_MS[part[2]];
58
- }
59
- if (!Number.isSafeInteger(total) || total <= 0) return { error: "a duration must be longer than zero" };
60
- return { ms: total };
61
- }
62
-
63
42
  function validClock(hours, minutes) {
64
43
  return hours >= 0 && hours <= 23 && minutes >= 0 && minutes <= 59;
65
44
  }
@@ -1,13 +1,15 @@
1
1
  // lib/cli/session-subcommands.js
2
2
  //
3
- // `clagentic-console open-session`, `send-input` and `list-sessions`: open a
4
- // session in a project, send input to one, or list the sessions, through the
5
- // running daemon's IPC socket. Each prints the daemon's result as JSON on stdout.
3
+ // `clagentic-console open-session`, `send-input`, `list-sessions` and
4
+ // `list-outbound`: open a session in a project, send input to one, list the
5
+ // sessions, or list what one session sent out, through the running daemon's IPC
6
+ // socket. Each prints the daemon's result as JSON on stdout.
6
7
  //
7
8
  // Exit codes (documented in docs/guides/AGENT-GUIDE.md):
8
9
  // 0 the request was acted on (opened, delivered, resumed-and-delivered, listed)
9
10
  // 1 refused, error, or not-found for a request that named a session id
10
- // 3 ambiguous: an address named several sessions; the candidates are in the JSON
11
+ // 3 ambiguous: an address named several sessions (or, for list-outbound, a
12
+ // session id several projects hold); the candidates are in the JSON
11
13
  // 4 not-found for a request that gave an address (--to) or --reply
12
14
 
13
15
  var fs = require("fs");
@@ -15,6 +17,7 @@ var fs = require("fs");
15
17
  var { loadConfig, socketPath, isDaemonAliveAsync } = require("../config");
16
18
  var { sendIPCCommand } = require("../ipc");
17
19
  var senderRef = require("../sender-ref");
20
+ var { parseDuration } = require("./duration");
18
21
 
19
22
  // A resumed session starts a runtime before the call answers: longer than the
20
23
  // IPC default.
@@ -37,6 +40,8 @@ var FLAGS = {
37
40
  "--context-note": "contextNote",
38
41
  "--from": "from",
39
42
  "--from-session": "fromSession",
43
+ "--since": "since",
44
+ "--kind": "kind",
40
45
  };
41
46
 
42
47
  // Kept apart from FLAGS because the parser reads a value after every FLAGS
@@ -49,18 +54,21 @@ var USAGE = {
49
54
  "open-session": "Usage: clagentic-console open-session (--project <slug> | --to <address>) --prompt <text|-> [--vendor <id>] [--agent <name>] [--name <session-name>] [--visibility shared|private] [--permission-mode <mode>] [--initiator <kind>] [--context-note <text>] [--from <name>] [--from-session <id>]",
50
55
  "send-input": "Usage: clagentic-console send-input (--project <slug> --session <id> | --to <address> | --reply) --prompt <text|-> [--initiator <kind>] [--context-note <text>] [--from <name>] [--from-session <id>]",
51
56
  "list-sessions": "Usage: clagentic-console list-sessions [--project <slug>] [--agent <name>] [--vendor <id>] [--state live|idle|reaped|any]",
57
+ "list-outbound": "Usage: clagentic-console list-outbound --session <vendor-session-id> [--project <slug>] [--since <dur>] [--kind sent|opens]",
52
58
  };
53
59
 
54
60
  var ALLOWED = {
55
61
  "open-session": ["projectSlug", "to", "prompt", "vendor", "agentName", "sessionName", "sessionVisibility", "permissionMode", "initiator", "contextNote", "from", "fromSession"],
56
62
  "send-input": ["projectSlug", "sessionId", "to", "reply", "prompt", "initiator", "contextNote", "from", "fromSession"],
57
63
  "list-sessions": ["projectSlug", "agentName", "vendor", "state"],
64
+ "list-outbound": ["sessionId", "projectSlug", "since", "kind"],
58
65
  };
59
66
 
60
67
  var REQUIRED = {
61
68
  "open-session": ["prompt"],
62
69
  "send-input": ["prompt"],
63
70
  "list-sessions": [],
71
+ "list-outbound": ["sessionId"],
64
72
  };
65
73
 
66
74
  var TARGET_HINT = {
@@ -72,8 +80,11 @@ var IPC_COMMAND = {
72
80
  "open-session": "open_session",
73
81
  "send-input": "send_session_input",
74
82
  "list-sessions": "list_sessions",
83
+ "list-outbound": "list_outbound",
75
84
  };
76
85
 
86
+ var OUTBOUND_KINDS = ["sent", "opens"];
87
+
77
88
  function flagOf(key) {
78
89
  var all = Object.keys(FLAGS).concat(Object.keys(SWITCHES));
79
90
  return all.filter(function (f) { return FLAGS[f] === key || SWITCHES[f] === key; })[0];
@@ -98,9 +109,25 @@ function checkTarget(verb, request) {
98
109
  return null;
99
110
  }
100
111
 
112
+ // list-outbound: --since is a duration back from now, sent to the daemon as the
113
+ // absolute time; --kind is one of the two. Returns an error string or null.
114
+ function resolveOutboundOptions(request, now) {
115
+ if (request.kind !== undefined && OUTBOUND_KINDS.indexOf(request.kind) === -1) {
116
+ return "Unknown --kind " + JSON.stringify(String(request.kind).slice(0, 32)) + " (accepted: " + OUTBOUND_KINDS.join(", ") + ")";
117
+ }
118
+ if (request.since !== undefined) {
119
+ var dur = parseDuration(request.since);
120
+ if (dur.error) return "--since: " + dur.error;
121
+ request.sinceMs = now - dur.ms;
122
+ delete request.since;
123
+ }
124
+ return null;
125
+ }
126
+
101
127
  // Parses the arguments after the verb. Returns { request } or { error }.
102
- // Pure: reading a "-" prompt from stdin is the handler's job.
103
- function parseSessionArgs(verb, args) {
128
+ // Pure: reading a "-" prompt from stdin is the handler's job. `now` (ms) is for
129
+ // tests.
130
+ function parseSessionArgs(verb, args, now) {
104
131
  var allowed = ALLOWED[verb];
105
132
  var request = {};
106
133
  for (var i = 0; i < args.length; i++) {
@@ -121,6 +148,10 @@ function parseSessionArgs(verb, args) {
121
148
  }
122
149
  var targetError = checkTarget(verb, request);
123
150
  if (targetError) return { error: targetError };
151
+ if (verb === "list-outbound") {
152
+ var outboundError = resolveOutboundOptions(request, now === undefined ? Date.now() : now);
153
+ if (outboundError) return { error: outboundError };
154
+ }
124
155
  return { request: request };
125
156
  }
126
157
 
@@ -172,7 +203,7 @@ function runSessionVerb(verb, args) {
172
203
  request.prompt = fs.readFileSync(0, "utf8").replace(/\n$/, "");
173
204
  }
174
205
  request.cmd = IPC_COMMAND[verb];
175
- if (verb !== "list-sessions") withSenderRef(request, process.env);
206
+ if (verb === "open-session" || verb === "send-input") withSenderRef(request, process.env);
176
207
 
177
208
  requestDaemon(request).then(function (res) {
178
209
  console.log(JSON.stringify(res, null, 2));
package/lib/daemon.js CHANGED
@@ -1564,6 +1564,15 @@ if (existingConfig && existingConfig.pid && existingConfig.pid !== process.pid)
1564
1564
  clearStaleConfig();
1565
1565
  }
1566
1566
  }
1567
+ // Load persisted account usage before IPC can serve get_usage. A bad file
1568
+ // starts empty (see lib/usage-store.js) and must never block daemon start.
1569
+ try {
1570
+ var _usageStoreMod = require("./usage-store");
1571
+ _usageStoreMod.enablePersistence(path.join(CONFIG_DIR, _usageStoreMod.STORE_FILE_NAME));
1572
+ } catch (e) {
1573
+ console.error("[daemon] Clagentic: Console usage persistence disabled:", e && e.message ? e.message : e);
1574
+ }
1575
+
1567
1576
  var ipc = createIPCServer(socketPath(), function (msg) {
1568
1577
  console.log("[daemon] IPC:", msg.cmd);
1569
1578
  switch (msg.cmd) {
@@ -1655,6 +1664,11 @@ var ipc = createIPCServer(socketPath(), function (msg) {
1655
1664
  case "get_activity_diagnostics":
1656
1665
  return buildActivityDiagnosticsResponse();
1657
1666
 
1667
+ case "get_usage":
1668
+ return Object.assign({ ok: true }, require("./usage-store").snapshot({
1669
+ vendorIds: require("./yoke").registry.ids(),
1670
+ }));
1671
+
1658
1672
  // lr-dc9a3b: makes the running-vs-installed mismatch a first-class,
1659
1673
  // queryable signal instead of a journalctl-only warning nothing
1660
1674
  // consumes. verify-installed-build.js (the post-merge gate) already
@@ -1700,6 +1714,12 @@ var ipc = createIPCServer(socketPath(), function (msg) {
1700
1714
  case "list_sessions":
1701
1715
  return require("./session-input-ipc").handleSessionCommand(relay.sessionInput, msg);
1702
1716
 
1717
+ // What one session sent out (the sender-side outbound ledger). Read-only;
1718
+ // the prompt text of an entry is shown only when the caller may read the
1719
+ // target session (lib/outbound-access.js). Same OS-level socket gate.
1720
+ case "list_outbound":
1721
+ return require("./session-input-ipc").handleOutboundCommand(relay.outboundQuery, msg);
1722
+
1703
1723
  // Scheduled input: text sent into a session later, once or on a repeat with
1704
1724
  // an end. The same service the clock button in the browser uses, so a record
1705
1725
  // made here shows there and the reverse. Same OS-level socket gate as the
@@ -2236,6 +2256,12 @@ function gracefulShutdown() {
2236
2256
 
2237
2257
  ipc.close();
2238
2258
 
2259
+ try {
2260
+ require("./usage-store").flush();
2261
+ } catch (e) {
2262
+ console.error("[daemon] Clagentic: Console usage flush at shutdown failed:", e && e.message ? e.message : e);
2263
+ }
2264
+
2239
2265
  // Remove PID from config (skip when a self-spawned replacement's PID is already saved)
2240
2266
  if (!successorSpawned) {
2241
2267
  try {