@skrr-ai/cli 0.1.104 → 0.1.105

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 (110) hide show
  1. package/dist/base-command.js +6 -2
  2. package/dist/commands/agenda/trigger/list.js +2 -0
  3. package/dist/commands/agents/chat.js +4 -1
  4. package/dist/commands/agents/operating-plan.js +5 -2
  5. package/dist/commands/agents/triggers/create.js +3 -1
  6. package/dist/commands/agents/triggers/fire.js +2 -0
  7. package/dist/commands/agents/triggers/replay.js +2 -0
  8. package/dist/commands/agents/triggers/update.js +12 -4
  9. package/dist/commands/commitments/action-history.js +7 -2
  10. package/dist/commands/commitments/cadence-decisions.js +6 -1
  11. package/dist/commands/commitments/cadence-requests/decide.d.ts +1 -1
  12. package/dist/commands/commitments/cadence-requests/decide.js +1 -1
  13. package/dist/commands/commitments/doctor.js +7 -1
  14. package/dist/commands/commitments/observations.js +7 -1
  15. package/dist/commands/commitments/operating-review.d.ts +15 -0
  16. package/dist/commands/commitments/operating-review.js +23 -2
  17. package/dist/commands/commitments/preflight.d.ts +12 -0
  18. package/dist/commands/commitments/preflight.js +23 -9
  19. package/dist/commands/commitments/reflection.js +6 -1
  20. package/dist/commands/commitments/show.js +3 -1
  21. package/dist/commands/commitments/trigger-status.js +2 -22
  22. package/dist/commands/commitments/wake-capabilities.d.ts +13 -0
  23. package/dist/commands/commitments/wake-capabilities.js +39 -3
  24. package/dist/commands/daemon/logs.d.ts +41 -3
  25. package/dist/commands/daemon/logs.js +202 -17
  26. package/dist/commands/followups/act.js +13 -1
  27. package/dist/commands/followups/checkin.js +11 -2
  28. package/dist/commands/followups/reschedule.js +13 -1
  29. package/dist/commands/proposals/discard.d.ts +1 -1
  30. package/dist/commands/proposals/keep.d.ts +1 -1
  31. package/dist/commands/proposals/list.d.ts +7 -0
  32. package/dist/commands/proposals/list.js +31 -5
  33. package/dist/commands/proposals/show.d.ts +2 -1
  34. package/dist/commands/proposals/show.js +31 -4
  35. package/dist/commands/proposals/snooze.d.ts +1 -1
  36. package/dist/commands/requests/create.js +8 -3
  37. package/dist/commands/spaces/workflows/create.js +3 -3
  38. package/dist/commands/tasks/complete.js +4 -0
  39. package/dist/commands/tasks/create.d.ts +2 -0
  40. package/dist/commands/tasks/create.js +17 -3
  41. package/dist/commands/tasks/deliverable/add.d.ts +2 -0
  42. package/dist/commands/tasks/deliverable/add.js +22 -7
  43. package/dist/commands/tasks/deliverable/list.d.ts +13 -0
  44. package/dist/commands/tasks/deliverable/list.js +34 -1
  45. package/dist/commands/tasks/economics-compare.js +7 -1
  46. package/dist/commands/tasks/expectations.d.ts +10 -0
  47. package/dist/commands/tasks/expectations.js +31 -3
  48. package/dist/commands/tasks/list.d.ts +9 -0
  49. package/dist/commands/tasks/list.js +40 -5
  50. package/dist/commands/tasks/report.js +1 -1
  51. package/dist/commands/tasks/result/show.d.ts +7 -0
  52. package/dist/commands/tasks/result/show.js +32 -1
  53. package/dist/commands/tasks/result/submit.js +1 -1
  54. package/dist/commands/tasks/show.d.ts +6 -0
  55. package/dist/commands/tasks/show.js +23 -0
  56. package/dist/commands/tasks/update.d.ts +3 -0
  57. package/dist/commands/tasks/update.js +23 -3
  58. package/dist/commands/triggers/audit.js +6 -2
  59. package/dist/commands/triggers/create.js +3 -1
  60. package/dist/commands/triggers/fire.d.ts +1 -0
  61. package/dist/commands/triggers/fire.js +16 -1
  62. package/dist/commands/triggers/preflight.js +6 -5
  63. package/dist/commands/triggers/replay.js +2 -0
  64. package/dist/commands/triggers/update.js +12 -4
  65. package/dist/commands/workspaces/stewardship.js +5 -1
  66. package/dist/lib/agentic-stream.d.ts +9 -0
  67. package/dist/lib/agentic-stream.js +38 -18
  68. package/dist/lib/commitment-event-wakes.d.ts +8 -0
  69. package/dist/lib/commitment-event-wakes.js +39 -0
  70. package/dist/lib/commitment-ledgers.d.ts +9 -0
  71. package/dist/lib/commitment-ledgers.js +126 -0
  72. package/dist/lib/commitments.d.ts +102 -2
  73. package/dist/lib/commitments.js +208 -8
  74. package/dist/lib/delegated-cli.js +13 -2
  75. package/dist/lib/followups.d.ts +6 -0
  76. package/dist/lib/followups.js +12 -0
  77. package/dist/lib/message-content.d.ts +6 -0
  78. package/dist/lib/message-content.js +24 -0
  79. package/dist/lib/operating-plan-loops.d.ts +8 -0
  80. package/dist/lib/operating-plan-loops.js +32 -0
  81. package/dist/lib/preflight-copy.d.ts +27 -0
  82. package/dist/lib/preflight-copy.js +89 -0
  83. package/dist/lib/proposal-decision-command.d.ts +1 -1
  84. package/dist/lib/proposal-decision-command.js +27 -3
  85. package/dist/lib/proposals.d.ts +17 -0
  86. package/dist/lib/proposals.js +41 -0
  87. package/dist/lib/stewardship-output.js +57 -12
  88. package/dist/lib/task-economics-line.d.ts +30 -0
  89. package/dist/lib/task-economics-line.js +49 -0
  90. package/dist/lib/task-economics.d.ts +15 -0
  91. package/dist/lib/task-economics.js +73 -8
  92. package/dist/lib/task-recurrence-outcome.d.ts +19 -0
  93. package/dist/lib/task-recurrence-outcome.js +30 -0
  94. package/dist/lib/triggers.d.ts +42 -0
  95. package/dist/lib/triggers.js +136 -2
  96. package/dist/lib/widgetTerminalText.d.ts +8 -0
  97. package/dist/lib/widgetTerminalText.js +116 -0
  98. package/dist/node_modules/@skrr-ai/auth-core/dist/cjs/cliHandoffWire.d.ts +33 -0
  99. package/dist/node_modules/@skrr-ai/auth-core/dist/cjs/cliHandoffWire.js +27 -0
  100. package/dist/node_modules/@skrr-ai/auth-core/dist/cjs/telemetryRedaction.d.ts +28 -5
  101. package/dist/node_modules/@skrr-ai/auth-core/dist/cjs/telemetryRedaction.js +50 -5
  102. package/dist/node_modules/@skrr-ai/auth-core/dist/esm/cliHandoffWire.d.ts +33 -0
  103. package/dist/node_modules/@skrr-ai/auth-core/dist/esm/cliHandoffWire.js +26 -0
  104. package/dist/node_modules/@skrr-ai/auth-core/dist/esm/telemetryRedaction.d.ts +28 -5
  105. package/dist/node_modules/@skrr-ai/auth-core/dist/esm/telemetryRedaction.js +50 -5
  106. package/dist/node_modules/@skrr-ai/auth-core/package.json +1 -1
  107. package/dist/node_modules/@skrr-ai/data-provider/index.js +7261 -7056
  108. package/docs/v1/operations.md +1 -1
  109. package/oclif.manifest.json +116 -72
  110. package/package.json +1 -1
@@ -17,10 +17,30 @@
17
17
  * and `api/server/services/HostedPreview/__tests__/telemetryRedaction.spec.js` against tokens the issuer really
18
18
  * mints, so a change to either side fails there rather than in a trace nobody reads.
19
19
  *
20
+ * THE OTHER PATH CREDENTIALS (OSK-16174). Four more bearer credentials travel in a URL, and until they were added here
21
+ * only the request logger's path rewrite (`requestLogger.js`) knew them, so the same address that was scrubbed from a
22
+ * log line reached a trace and an error report in full: a workspace invitation (`wsi_`), a platform invitation
23
+ * (`pinv_`), a member's invitation link (`usr_`) and an operator's (`adm2_`, and the older `adm_`). Unlike `pvw_`, whose
24
+ * prefix is rare enough to match on its own, `usr_` and `adm_` begin ordinary words and identifiers (`/usr_local`,
25
+ * `adm_users`), so each of these is recognised by the SHAPE its minting code gives it, and a lookalike is left alone:
26
+ *
27
+ * wsi_ / pinv_ / usr_ / adm2_ `<prefix>_<32 hex>.<version>.<key id>.<43 base64url>`, from `buildCredential` in
28
+ * `api/models/WorkspaceInvite.js` and `PlatformInvitation.js` and `buildUserCode` and
29
+ * `buildAdminCode` in `InvitationCode.js`. The older member link, `usr_<32 hex>.<24
30
+ * base64url>`, has the same first two fields. Matched from the prefix to the end of the
31
+ * token's characters once the 32-hex id and its dot are there, so a credential cut off
32
+ * later in the log line is still redacted whole.
33
+ * adm_ `adm_<43 base64url>`, the older operator code (`generateCode`: 32 random bytes).
34
+ * Exactly 43 characters, because that is the only length it has.
35
+ *
36
+ * `api/server/services/HostedPreview/__tests__/telemetryRedaction.spec.js` mints credentials with the real minting
37
+ * code and requires every one to come out as the marker, so a change to either side fails there.
38
+ *
20
39
  * WHAT IT DOES NOT. A prefix that is itself percent-encoded (`%70vw_`) is not recognised: nothing in this
21
- * repository writes one, and a scan that decoded every string first would cost every sink on every record. The
22
- * request log's own `/[credential]` rewrite (`requestLogger.js`) covers the other credential prefixes and
23
- * stays as it is.
40
+ * repository writes one, and a scan that decoded every string first would cost every sink on every record. A
41
+ * credential cut off before its id is whole (`pinv_0123abc`) is an identifier, not yet the secret, and is left as it
42
+ * is. The request log's own `/[credential]` rewrite stays as it is, and is looser (any `wsi_`, `pinv_`, `usr_`,
43
+ * `adm_`, `adm2_` or `pvw_` path segment), because a path segment is a place a credential is known to be.
24
44
  *
25
45
  * COST. Linear in the input. The only nested repetition is `%(?:25)*XX`, and `XX` is never `25`, so the engine
26
46
  * cannot read one run of `25`s two ways; the tests feed it a megabyte of the worst shapes.
@@ -49,11 +69,36 @@ const TOKEN_CHAR = '(?:[A-Za-z0-9._-]|%(?:25)*(?:2[DdEe]|3[0-9]|4[1-9A-Fa-f]|5[0
49
69
  * nothing and redacting twice changes nothing.
50
70
  */
51
71
  const PREVIEW_TOKEN = new RegExp(`pvw(?:_|%(?:25)*5[Ff])${TOKEN_CHAR}+`, 'g');
72
+ /**
73
+ * A prefix's underscore, which (like the token's own characters) may be written as a percent-escape, once or several
74
+ * times; and the dot that ends an id.
75
+ */
76
+ const UNDERSCORE = '(?:_|%(?:25)*5[Ff])';
77
+ const DOT = '(?:\\.|%(?:25)*2[Ee])';
78
+ /**
79
+ * `wsi`, `pinv`, `usr` or `adm2`, an underscore, and then a lookahead that insists on what the minting code writes
80
+ * next: 32 lowercase hex characters and the dot that ends them. Everything the credential is made of follows, and the
81
+ * prefix is captured so the marker can say which kind it was. `usr_<40 hex>`, `usr_00000001` and `/usr_profile` have no
82
+ * dot after exactly 32 hex characters, so they match nothing.
83
+ */
84
+ const SIGNED_CREDENTIAL = new RegExp(`(wsi|pinv|usr|adm2)${UNDERSCORE}(?=[0-9a-f]{32}${DOT})${TOKEN_CHAR}+`, 'g');
85
+ /**
86
+ * The older operator code: `adm_` and exactly 43 base64url characters (32 random bytes), not followed by another one.
87
+ * A shorter or longer run of letters is a name, not this credential. The characters are the plain alphabet and not
88
+ * `TOKEN_CHAR`, whose dot would swallow the full stop at the end of a sentence.
89
+ */
90
+ const LEGACY_OPERATOR_CODE = new RegExp(`(adm)${UNDERSCORE}(?=[A-Za-z0-9_-]{43}(?![A-Za-z0-9_-]))[A-Za-z0-9_-]{43}`, 'g');
91
+ /** Cheap test before any of the expressions: a string with none of these cannot hold a credential. */
92
+ const CREDENTIAL_HINTS = ['pvw', 'wsi', 'pinv', 'usr', 'adm'];
93
+ const credentialMarker = (_match, prefix) => `${prefix}_[redacted]`;
52
94
  function redactPreviewTokens(value) {
53
- if (typeof value !== 'string' || value.indexOf('pvw') === -1) {
95
+ if (typeof value !== 'string' || !CREDENTIAL_HINTS.some((hint) => value.indexOf(hint) !== -1)) {
54
96
  return value;
55
97
  }
56
- return value.replace(PREVIEW_TOKEN, exports.PREVIEW_TOKEN_REDACTION);
98
+ return value
99
+ .replace(PREVIEW_TOKEN, exports.PREVIEW_TOKEN_REDACTION)
100
+ .replace(SIGNED_CREDENTIAL, credentialMarker)
101
+ .replace(LEGACY_OPERATOR_CODE, credentialMarker);
57
102
  }
58
103
  const DEFAULT_MAX_NODES = 50_000;
59
104
  const DEFAULT_MAX_DEPTH = 32;
@@ -133,3 +133,36 @@ export declare function parseCliHandoffDpopProofResponse(value: unknown): CliHan
133
133
  export declare const DELEGATED_AGENT_CLI_ID_PREFIX = "oversky-daemon-agent-cli-";
134
134
  export declare const WORKLOAD_CLI_ID_PREFIX = "oversky-daemon-workload-cli-";
135
135
  export declare function classifyCliFamilyId(id: unknown): 'agent' | 'workload' | 'person';
136
+ /**
137
+ * Who keeps a daemon running, which decides how it is signed in again.
138
+ * - `desktop`: the Skrr desktop app hosts it (Electron-as-Node under the
139
+ * app's LaunchAgent). The app mints the daemon's credential itself at
140
+ * `POST /api/daemons/token`, with a device proof, on every start of its
141
+ * daemon client (OSK-15990), so reopening the app IS the sign-in. Neither
142
+ * login command repairs it: `skrr daemon login` refuses an Electron-hosted
143
+ * daemon (its program is the app, not a `skrrd`), and a `skrrd` on PATH is
144
+ * usually not installed, or is a different build from the one running.
145
+ * - `service`: `skrrd install` (launchd/systemd/schtasks) or a hand start;
146
+ * `skrrd login` for that profile, server and working directory is the fix.
147
+ */
148
+ export type DaemonSupervisor = 'desktop' | 'service';
149
+ /**
150
+ * The ONE sentence for "only a new daemon sign-in repairs this hand-off
151
+ * refusal" (OSK-16216). The daemon fills it in with what it knows about
152
+ * itself and sends it as the loopback 503's `remedy`; the CLI uses it, with
153
+ * nothing filled in, when an older daemon sent none. Before this the two were
154
+ * written separately and disagreed — the CLI said `skrr daemon login`, the
155
+ * daemon said `skrrd --profile … login` — and neither was right for a daemon
156
+ * the desktop app runs.
157
+ *
158
+ * Returned without a leading capital or trailing period so callers can put it
159
+ * after "Fix: " or "— ".
160
+ */
161
+ export declare function daemonSignInRemedy(opts?: {
162
+ /** How the daemon is run; absent when the caller cannot tell. */
163
+ supervisor?: DaemonSupervisor;
164
+ /** The exact `skrrd … login` for this profile, when the daemon knows it. */
165
+ loginCommand?: string;
166
+ /** The refusal was DEVICE_PROOF_PIN_MISMATCH: say that a sign-in re-pins. */
167
+ repinsDeviceKey?: boolean;
168
+ }): string;
@@ -145,3 +145,29 @@ export function classifyCliFamilyId(id) {
145
145
  return 'workload';
146
146
  return 'person';
147
147
  }
148
+ /**
149
+ * The ONE sentence for "only a new daemon sign-in repairs this hand-off
150
+ * refusal" (OSK-16216). The daemon fills it in with what it knows about
151
+ * itself and sends it as the loopback 503's `remedy`; the CLI uses it, with
152
+ * nothing filled in, when an older daemon sent none. Before this the two were
153
+ * written separately and disagreed — the CLI said `skrr daemon login`, the
154
+ * daemon said `skrrd --profile … login` — and neither was right for a daemon
155
+ * the desktop app runs.
156
+ *
157
+ * Returned without a leading capital or trailing period so callers can put it
158
+ * after "Fix: " or "— ".
159
+ */
160
+ export function daemonSignInRemedy(opts = {}) {
161
+ const repin = opts.repinsDeviceKey === true;
162
+ if (opts.supervisor === 'desktop') {
163
+ return ('quit and reopen the Skrr desktop app on the machine running the daemon (install its update ' +
164
+ `first if one is offered): the app signs its daemon in again on start${repin ? ' and re-pins the device key' : ''}`);
165
+ }
166
+ if (opts.supervisor === 'service') {
167
+ const login = opts.loginCommand ? `\`${opts.loginCommand}\`` : '`skrr daemon login`';
168
+ return `run ${login}${repin ? ' — an interactive login re-pins the device key' : ''}`;
169
+ }
170
+ return ('sign the daemon in again on the machine running it: if the Skrr desktop app runs it, quit ' +
171
+ 'and reopen the app; otherwise run `skrr daemon login`' +
172
+ (repin ? ' (either one re-pins the device key)' : ''));
173
+ }
@@ -16,10 +16,30 @@
16
16
  * and `api/server/services/HostedPreview/__tests__/telemetryRedaction.spec.js` against tokens the issuer really
17
17
  * mints, so a change to either side fails there rather than in a trace nobody reads.
18
18
  *
19
+ * THE OTHER PATH CREDENTIALS (OSK-16174). Four more bearer credentials travel in a URL, and until they were added here
20
+ * only the request logger's path rewrite (`requestLogger.js`) knew them, so the same address that was scrubbed from a
21
+ * log line reached a trace and an error report in full: a workspace invitation (`wsi_`), a platform invitation
22
+ * (`pinv_`), a member's invitation link (`usr_`) and an operator's (`adm2_`, and the older `adm_`). Unlike `pvw_`, whose
23
+ * prefix is rare enough to match on its own, `usr_` and `adm_` begin ordinary words and identifiers (`/usr_local`,
24
+ * `adm_users`), so each of these is recognised by the SHAPE its minting code gives it, and a lookalike is left alone:
25
+ *
26
+ * wsi_ / pinv_ / usr_ / adm2_ `<prefix>_<32 hex>.<version>.<key id>.<43 base64url>`, from `buildCredential` in
27
+ * `api/models/WorkspaceInvite.js` and `PlatformInvitation.js` and `buildUserCode` and
28
+ * `buildAdminCode` in `InvitationCode.js`. The older member link, `usr_<32 hex>.<24
29
+ * base64url>`, has the same first two fields. Matched from the prefix to the end of the
30
+ * token's characters once the 32-hex id and its dot are there, so a credential cut off
31
+ * later in the log line is still redacted whole.
32
+ * adm_ `adm_<43 base64url>`, the older operator code (`generateCode`: 32 random bytes).
33
+ * Exactly 43 characters, because that is the only length it has.
34
+ *
35
+ * `api/server/services/HostedPreview/__tests__/telemetryRedaction.spec.js` mints credentials with the real minting
36
+ * code and requires every one to come out as the marker, so a change to either side fails there.
37
+ *
19
38
  * WHAT IT DOES NOT. A prefix that is itself percent-encoded (`%70vw_`) is not recognised: nothing in this
20
- * repository writes one, and a scan that decoded every string first would cost every sink on every record. The
21
- * request log's own `/[credential]` rewrite (`requestLogger.js`) covers the other credential prefixes and
22
- * stays as it is.
39
+ * repository writes one, and a scan that decoded every string first would cost every sink on every record. A
40
+ * credential cut off before its id is whole (`pinv_0123abc`) is an identifier, not yet the secret, and is left as it
41
+ * is. The request log's own `/[credential]` rewrite stays as it is, and is looser (any `wsi_`, `pinv_`, `usr_`,
42
+ * `adm_`, `adm2_` or `pvw_` path segment), because a path segment is a place a credential is known to be.
23
43
  *
24
44
  * COST. Linear in the input. The only nested repetition is `%(?:25)*XX`, and `XX` is never `25`, so the engine
25
45
  * cannot read one run of `25`s two ways; the tests feed it a megabyte of the worst shapes.
@@ -31,8 +51,11 @@
31
51
  /** What replaces a token. Fixed, so a trace can say a preview was involved but not which one. */
32
52
  export declare const PREVIEW_TOKEN_REDACTION: "pvw_[redacted]";
33
53
  /**
34
- * Replace every preview token in a string with {@link PREVIEW_TOKEN_REDACTION}. The rest of the string is
35
- * untouched, so a trace is still readable. Anything that is not a string comes back as it came.
54
+ * Replace every credential that travels in a URL with a marker: a Hosted Machine preview token with
55
+ * {@link PREVIEW_TOKEN_REDACTION}, and a workspace invitation, platform invitation, member link or operator code with
56
+ * its own prefix and `_[redacted]`. The rest of the string is untouched, so a trace is still readable. Anything
57
+ * that is not a string comes back as it came. (The name is the preview token's, which this began as; the sinks
58
+ * and the boundary specs import it by that name.)
36
59
  */
37
60
  export declare function redactPreviewTokens(value: string): string;
38
61
  export declare function redactPreviewTokens<T>(value: T): T;
@@ -16,10 +16,30 @@
16
16
  * and `api/server/services/HostedPreview/__tests__/telemetryRedaction.spec.js` against tokens the issuer really
17
17
  * mints, so a change to either side fails there rather than in a trace nobody reads.
18
18
  *
19
+ * THE OTHER PATH CREDENTIALS (OSK-16174). Four more bearer credentials travel in a URL, and until they were added here
20
+ * only the request logger's path rewrite (`requestLogger.js`) knew them, so the same address that was scrubbed from a
21
+ * log line reached a trace and an error report in full: a workspace invitation (`wsi_`), a platform invitation
22
+ * (`pinv_`), a member's invitation link (`usr_`) and an operator's (`adm2_`, and the older `adm_`). Unlike `pvw_`, whose
23
+ * prefix is rare enough to match on its own, `usr_` and `adm_` begin ordinary words and identifiers (`/usr_local`,
24
+ * `adm_users`), so each of these is recognised by the SHAPE its minting code gives it, and a lookalike is left alone:
25
+ *
26
+ * wsi_ / pinv_ / usr_ / adm2_ `<prefix>_<32 hex>.<version>.<key id>.<43 base64url>`, from `buildCredential` in
27
+ * `api/models/WorkspaceInvite.js` and `PlatformInvitation.js` and `buildUserCode` and
28
+ * `buildAdminCode` in `InvitationCode.js`. The older member link, `usr_<32 hex>.<24
29
+ * base64url>`, has the same first two fields. Matched from the prefix to the end of the
30
+ * token's characters once the 32-hex id and its dot are there, so a credential cut off
31
+ * later in the log line is still redacted whole.
32
+ * adm_ `adm_<43 base64url>`, the older operator code (`generateCode`: 32 random bytes).
33
+ * Exactly 43 characters, because that is the only length it has.
34
+ *
35
+ * `api/server/services/HostedPreview/__tests__/telemetryRedaction.spec.js` mints credentials with the real minting
36
+ * code and requires every one to come out as the marker, so a change to either side fails there.
37
+ *
19
38
  * WHAT IT DOES NOT. A prefix that is itself percent-encoded (`%70vw_`) is not recognised: nothing in this
20
- * repository writes one, and a scan that decoded every string first would cost every sink on every record. The
21
- * request log's own `/[credential]` rewrite (`requestLogger.js`) covers the other credential prefixes and
22
- * stays as it is.
39
+ * repository writes one, and a scan that decoded every string first would cost every sink on every record. A
40
+ * credential cut off before its id is whole (`pinv_0123abc`) is an identifier, not yet the secret, and is left as it
41
+ * is. The request log's own `/[credential]` rewrite stays as it is, and is looser (any `wsi_`, `pinv_`, `usr_`,
42
+ * `adm_`, `adm2_` or `pvw_` path segment), because a path segment is a place a credential is known to be.
23
43
  *
24
44
  * COST. Linear in the input. The only nested repetition is `%(?:25)*XX`, and `XX` is never `25`, so the engine
25
45
  * cannot read one run of `25`s two ways; the tests feed it a megabyte of the worst shapes.
@@ -43,11 +63,36 @@ const TOKEN_CHAR = '(?:[A-Za-z0-9._-]|%(?:25)*(?:2[DdEe]|3[0-9]|4[1-9A-Fa-f]|5[0
43
63
  * nothing and redacting twice changes nothing.
44
64
  */
45
65
  const PREVIEW_TOKEN = new RegExp(`pvw(?:_|%(?:25)*5[Ff])${TOKEN_CHAR}+`, 'g');
66
+ /**
67
+ * A prefix's underscore, which (like the token's own characters) may be written as a percent-escape, once or several
68
+ * times; and the dot that ends an id.
69
+ */
70
+ const UNDERSCORE = '(?:_|%(?:25)*5[Ff])';
71
+ const DOT = '(?:\\.|%(?:25)*2[Ee])';
72
+ /**
73
+ * `wsi`, `pinv`, `usr` or `adm2`, an underscore, and then a lookahead that insists on what the minting code writes
74
+ * next: 32 lowercase hex characters and the dot that ends them. Everything the credential is made of follows, and the
75
+ * prefix is captured so the marker can say which kind it was. `usr_<40 hex>`, `usr_00000001` and `/usr_profile` have no
76
+ * dot after exactly 32 hex characters, so they match nothing.
77
+ */
78
+ const SIGNED_CREDENTIAL = new RegExp(`(wsi|pinv|usr|adm2)${UNDERSCORE}(?=[0-9a-f]{32}${DOT})${TOKEN_CHAR}+`, 'g');
79
+ /**
80
+ * The older operator code: `adm_` and exactly 43 base64url characters (32 random bytes), not followed by another one.
81
+ * A shorter or longer run of letters is a name, not this credential. The characters are the plain alphabet and not
82
+ * `TOKEN_CHAR`, whose dot would swallow the full stop at the end of a sentence.
83
+ */
84
+ const LEGACY_OPERATOR_CODE = new RegExp(`(adm)${UNDERSCORE}(?=[A-Za-z0-9_-]{43}(?![A-Za-z0-9_-]))[A-Za-z0-9_-]{43}`, 'g');
85
+ /** Cheap test before any of the expressions: a string with none of these cannot hold a credential. */
86
+ const CREDENTIAL_HINTS = ['pvw', 'wsi', 'pinv', 'usr', 'adm'];
87
+ const credentialMarker = (_match, prefix) => `${prefix}_[redacted]`;
46
88
  export function redactPreviewTokens(value) {
47
- if (typeof value !== 'string' || value.indexOf('pvw') === -1) {
89
+ if (typeof value !== 'string' || !CREDENTIAL_HINTS.some((hint) => value.indexOf(hint) !== -1)) {
48
90
  return value;
49
91
  }
50
- return value.replace(PREVIEW_TOKEN, PREVIEW_TOKEN_REDACTION);
92
+ return value
93
+ .replace(PREVIEW_TOKEN, PREVIEW_TOKEN_REDACTION)
94
+ .replace(SIGNED_CREDENTIAL, credentialMarker)
95
+ .replace(LEGACY_OPERATOR_CODE, credentialMarker);
51
96
  }
52
97
  const DEFAULT_MAX_NODES = 50_000;
53
98
  const DEFAULT_MAX_DEPTH = 32;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@skrr-ai/auth-core",
3
- "version": "0.4.23",
3
+ "version": "0.4.25",
4
4
  "main": "dist/cjs/index.js",
5
5
  "types": "dist/esm/index.d.ts",
6
6
  "exports": {