@camstack/develop 0.1.40 → 0.1.42

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.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.1.42] - 2026-11-01
11
+
12
+ ### Changed
13
+
14
+ - The login hints now name the browser approval for a terminal with no TTY
15
+ - A saved sign-in session file is written atomically and always ends up 0600, even over a loose existing file
16
+
17
+ ## [0.1.41] - 2026-10-30
18
+
19
+ ### Changed
20
+
21
+ - The mutation gate redacts tool arguments (credential-named keys, declared secrets, scrub patterns) before its audit line is written
22
+
10
23
  ## [0.1.40] - 2026-10-30
11
24
 
12
25
  ### Changed
@@ -5,6 +5,11 @@ export declare const REPO_LOCAL_LOGIN = "npx nx run camstack:build && node packa
5
5
  * binary is on PATH, otherwise the checkout-local form.
6
6
  */
7
7
  export declare function sessionLoginCommand(env?: Readonly<Record<string, string | undefined>>): string;
8
+ /**
9
+ * The sign-in that needs no password typed in a terminal: the CLI prints a
10
+ * short code, the operator approves it in the admin UI at `/approve`.
11
+ */
12
+ export declare const BROWSER_LOGIN_HINT = "No keyboard? `camstack login <host> --browser` prints a code to approve in the admin UI; `--token-file <path>` is the headless fallback.";
8
13
  /** The hub answered 401/403 to an admin-tier credential. */
9
14
  export declare function adminRejectedHint(command?: string): string;
10
15
  /** Why admin-tier ops are blocked locally. */
@@ -1 +1 @@
1
- {"version":3,"file":"login-hints.d.ts","sourceRoot":"","sources":["../../src/hub/login-hints.ts"],"names":[],"mappings":"AAuBA,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,qEAAqE,CAAA;AAElG;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAER;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAA8B,GAAG,MAAM,CAEjF;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAA8B,GAAG,MAAM,CAEnF"}
1
+ {"version":3,"file":"login-hints.d.ts","sourceRoot":"","sources":["../../src/hub/login-hints.ts"],"names":[],"mappings":"AAuBA,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,qEAAqE,CAAA;AAElG;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAER;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,6IAC6G,CAAA;AAE5I,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAA8B,GAAG,MAAM,CAEjF;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAA8B,GAAG,MAAM,CAEnF"}
@@ -31,11 +31,16 @@ export const REPO_LOCAL_LOGIN = 'npx nx run camstack:build && node packages/cli/
31
31
  export function sessionLoginCommand(env = process.env) {
32
32
  return onPath('camstack', env['PATH']) ? 'camstack login' : REPO_LOCAL_LOGIN;
33
33
  }
34
+ /**
35
+ * The sign-in that needs no password typed in a terminal: the CLI prints a
36
+ * short code, the operator approves it in the admin UI at `/approve`.
37
+ */
38
+ export const BROWSER_LOGIN_HINT = 'No keyboard? `camstack login <host> --browser` prints a code to approve in the admin UI; `--token-file <path>` is the headless fallback.';
34
39
  /** The hub answered 401/403 to an admin-tier credential. */
35
40
  export function adminRejectedHint(command = sessionLoginCommand()) {
36
- return `the hub rejected this credential (revoked or expired). Run \`${command}\` in a terminal with an admin account.`;
41
+ return `the hub rejected this credential (revoked or expired). Run \`${command}\` in a terminal with an admin account. ${BROWSER_LOGIN_HINT}`;
37
42
  }
38
43
  /** Why admin-tier ops are blocked locally. */
39
44
  export function adminCredentialHint(command = sessionLoginCommand()) {
40
- return `this credential is not admin-scoped. Run \`${command}\` with an admin account (the MCP never handles a password).`;
45
+ return `this credential is not admin-scoped. Run \`${command}\` with an admin account (the MCP never handles a password). ${BROWSER_LOGIN_HINT}`;
41
46
  }
@@ -1 +1 @@
1
- {"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/hub/session-store.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAEjG;AAeD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAA4B,GAAG,SAAS,WAAW,EAAE,CAEtF;AAoCD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,WAAW,GAAG,IAAI,CAYpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAalE;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,GAAE,MAA4B,GAChC,WAAW,GAAG,IAAI,CASpB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAK3F;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAA4B,EACjC,GAAG,GAAE,MAAmB,GACvB,IAAI,CAQN;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,OAAO,CAK1F"}
1
+ {"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/hub/session-store.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAEjG;AAeD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAA4B,GAAG,SAAS,WAAW,EAAE,CAEtF;AAoCD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,WAAW,GAAG,IAAI,CAYpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAalE;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,GAAE,MAA4B,GAChC,WAAW,GAAG,IAAI,CASpB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAe3F;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAA4B,EACjC,GAAG,GAAE,MAAmB,GACvB,IAAI,CAQN;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,OAAO,CAK1F"}
@@ -5,6 +5,7 @@
5
5
  * SAME code. The cache holds the login JWT and its refresh token from `camstack login`,
6
6
  * never a password.
7
7
  */
8
+ import * as crypto from 'node:crypto';
8
9
  import * as fs from 'node:fs';
9
10
  import * as os from 'node:os';
10
11
  import * as path from 'node:path';
@@ -138,7 +139,18 @@ export function saveSession(session, dir = defaultSessionDir()) {
138
139
  if (!fs.existsSync(dir))
139
140
  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
140
141
  const file = sessionFileForServer(session.server, dir);
141
- fs.writeFileSync(file, JSON.stringify(session, null, 2), { mode: 0o600 });
142
+ // Write beside the target at 0600, then rename over it: `writeFileSync`'s mode does not
143
+ // apply to a file that already exists, so a loose pre-existing file would stay loose.
144
+ const temp = `${file}.${crypto.randomBytes(6).toString('hex')}.tmp`;
145
+ try {
146
+ fs.writeFileSync(temp, JSON.stringify(session, null, 2), { mode: 0o600 });
147
+ fs.chmodSync(temp, 0o600);
148
+ fs.renameSync(temp, file);
149
+ }
150
+ catch (err) {
151
+ fs.rmSync(temp, { force: true });
152
+ throw err;
153
+ }
142
154
  return file;
143
155
  }
144
156
  /** Record that a command just used this session; best effort, never throws. */
package/dist/index.d.ts CHANGED
@@ -16,7 +16,7 @@ export { authRejectedHint, credentialTier, jwtClaims, jwtExpiryMs, jwtPayloadIsA
16
16
  export type { CachedSessionLike, CredentialInputs, CredentialSource, CredentialTier, ResolvedCredentials, TokenFileContents, } from './hub/credentials.js';
17
17
  export { clearSession, defaultSession, defaultSessionDir, isSessionFile, listSessions, loadSession, saveSession, sessionFileForServer, sessionRecency, slugForServer, touchSession, } from './hub/session-store.js';
18
18
  export type { SessionFile } from './hub/session-store.js';
19
- export { adminCredentialHint, adminRejectedHint, REPO_LOCAL_LOGIN, sessionLoginCommand, } from './hub/login-hints.js';
19
+ export { adminCredentialHint, adminRejectedHint, BROWSER_LOGIN_HINT, REPO_LOCAL_LOGIN, sessionLoginCommand, } from './hub/login-hints.js';
20
20
  export { forceRefreshSession, refreshOnUnauthorized, resolveFreshCredentials, } from './hub/session-refresh.js';
21
21
  export type { FreshCredentialInputs, RefreshOptions, } from './hub/session-refresh.js';
22
22
  export { DEFAULT_HUB_PORT, HubAddressError, normalizeHubAddress, validateHubAddress, } from './hub/hub-address.js';
@@ -28,7 +28,7 @@ export { createHubClient, encodeTrpcInput, HubHttpError, HubRpcError, nodeHubTra
28
28
  export type { HubClient, HubClientOptions, HubHttpMethod, HubTransport, HubTransportRequest, HubTransportResponse, } from './hub/hub-client.js';
29
29
  export { scrubSecrets, scrubValue } from './mcp/scrub.js';
30
30
  export { text, textError } from './mcp/text.js';
31
- export { REDACTED, redactDeclaredSecrets, toToolOutput, truncateOutput, } from './mcp/redact.js';
31
+ export { REDACTED, redactDeclaredSecrets, redactToolArgs, toToolOutput, truncateOutput, } from './mcp/redact.js';
32
32
  export { CORE_QUERY_METHODS, loadApiIndex, parseApiIndex, type ApiIndex, type ApiMethod, type MethodAuth, type MethodKind, } from './mcp/api-index.js';
33
33
  export { connectHub, tryConnectHub, type ConnectOutcome, type HubConnectOptions, type HubConnection, type NoSessionOutcome, } from './mcp/hub-connection.js';
34
34
  export { gateQuery, isSecretBearing, type GateDecision, } from './mcp/query-gate.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -15,7 +15,7 @@ export { listSkills, readSkill, resolveSkillsDir } from './skills.js';
15
15
  // shared by the CLI, scripts/hub/hub.mjs and the operator MCP (D835).
16
16
  export { authRejectedHint, credentialTier, jwtClaims, jwtExpiryMs, jwtPayloadIsAdmin, MissingCredentialsError, readTokenFile, resolveCredentials, withAuthHint, } from './hub/credentials.js';
17
17
  export { clearSession, defaultSession, defaultSessionDir, isSessionFile, listSessions, loadSession, saveSession, sessionFileForServer, sessionRecency, slugForServer, touchSession, } from './hub/session-store.js';
18
- export { adminCredentialHint, adminRejectedHint, REPO_LOCAL_LOGIN, sessionLoginCommand, } from './hub/login-hints.js';
18
+ export { adminCredentialHint, adminRejectedHint, BROWSER_LOGIN_HINT, REPO_LOCAL_LOGIN, sessionLoginCommand, } from './hub/login-hints.js';
19
19
  export { forceRefreshSession, refreshOnUnauthorized, resolveFreshCredentials, } from './hub/session-refresh.js';
20
20
  export { DEFAULT_HUB_PORT, HubAddressError, normalizeHubAddress, validateHubAddress, } from './hub/hub-address.js';
21
21
  export { resolveHubUrl } from './hub/hub-url.js';
@@ -26,7 +26,7 @@ export { createHubClient, encodeTrpcInput, HubHttpError, HubRpcError, nodeHubTra
26
26
  // operator MCP.
27
27
  export { scrubSecrets, scrubValue } from './mcp/scrub.js';
28
28
  export { text, textError } from './mcp/text.js';
29
- export { REDACTED, redactDeclaredSecrets, toToolOutput, truncateOutput, } from './mcp/redact.js';
29
+ export { REDACTED, redactDeclaredSecrets, redactToolArgs, toToolOutput, truncateOutput, } from './mcp/redact.js';
30
30
  export { CORE_QUERY_METHODS, loadApiIndex, parseApiIndex, } from './mcp/api-index.js';
31
31
  export { connectHub, tryConnectHub, } from './mcp/hub-connection.js';
32
32
  export { gateQuery, isSecretBearing, } from './mcp/query-gate.js';
@@ -31,6 +31,8 @@ export interface MutationGateOptions {
31
31
  /** Injectable for tests; defaults to 128 random bits. */
32
32
  readonly newToken?: () => string;
33
33
  readonly ttlMs?: number;
34
+ /** How arguments are redacted before the audit sink sees them. Default: `redactToolArgs`. */
35
+ readonly redactArgs?: (args: unknown) => unknown;
34
36
  }
35
37
  export interface IssuedToken {
36
38
  readonly confirmToken: string;
@@ -44,6 +46,7 @@ export declare class MutationGate {
44
46
  private readonly now;
45
47
  private readonly newToken;
46
48
  private readonly ttlMs;
49
+ private readonly redactArgs;
47
50
  constructor(options: MutationGateOptions);
48
51
  get enabled(): boolean;
49
52
  record(tool: string, phase: AuditPhase, args: unknown, detail: string): void;
@@ -1 +1 @@
1
- {"version":3,"file":"mutation-gate.d.ts","sourceRoot":"","sources":["../../src/mcp/mutation-gate.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mutation-gate.d.ts","sourceRoot":"","sources":["../../src/mcp/mutation-gate.ts"],"names":[],"mappings":"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"}
@@ -15,7 +15,8 @@
15
15
  * refused ones included — is written to the audit sink.
16
16
  */
17
17
  import { createHash, randomBytes } from 'node:crypto';
18
- import { scrubValue } from './scrub.js';
18
+ import { redactToolArgs } from './redact.js';
19
+ import { scrubSecrets, scrubValue } from './scrub.js';
19
20
  /** How long a dry run stays confirmable. Short on purpose: the world moves. */
20
21
  export const CONFIRM_TTL_MS = 5 * 60_000;
21
22
  /** Outstanding dry runs kept at once; the oldest is dropped beyond this. */
@@ -49,12 +50,14 @@ export class MutationGate {
49
50
  now;
50
51
  newToken;
51
52
  ttlMs;
53
+ redactArgs;
52
54
  constructor(options) {
53
55
  this.options = options;
54
56
  this.audit = options.audit ?? stderrAudit;
55
57
  this.now = options.now ?? Date.now;
56
58
  this.newToken = options.newToken ?? (() => `cfm_${randomBytes(16).toString('hex')}`);
57
59
  this.ttlMs = options.ttlMs ?? CONFIRM_TTL_MS;
60
+ this.redactArgs = options.redactArgs ?? redactToolArgs;
58
61
  }
59
62
  get enabled() {
60
63
  return this.options.allowMutations;
@@ -65,8 +68,8 @@ export class MutationGate {
65
68
  tool,
66
69
  phase,
67
70
  argsDigest: digestArgs(tool, args),
68
- detail,
69
- args,
71
+ detail: scrubSecrets(detail),
72
+ args: this.redactArgs(args),
70
73
  });
71
74
  }
72
75
  /** Issue the token of a dry run. Throws when mutations are disabled. */
@@ -82,7 +85,11 @@ export class MutationGate {
82
85
  }
83
86
  const confirmToken = this.newToken();
84
87
  const expiresAt = this.now() + this.ttlMs;
85
- this.outstanding.set(confirmToken, { tool, digest: digestArgs(tool, args), expiresAt });
88
+ this.outstanding.set(confirmToken, {
89
+ tool,
90
+ digest: digestArgs(tool, args),
91
+ expiresAt,
92
+ });
86
93
  return { confirmToken, expiresAt };
87
94
  }
88
95
  /** Check and CONSUME a presented token. */
@@ -104,7 +111,10 @@ export class MutationGate {
104
111
  };
105
112
  }
106
113
  if (found.tool !== tool) {
107
- return { ok: false, reason: `confirm_token was issued for ${found.tool}, not ${tool}` };
114
+ return {
115
+ ok: false,
116
+ reason: `confirm_token was issued for ${found.tool}, not ${tool}`,
117
+ };
108
118
  }
109
119
  if (found.digest !== digestArgs(tool, args)) {
110
120
  return {
@@ -30,4 +30,10 @@ export interface Truncated {
30
30
  export declare function truncateOutput(value: unknown, limits?: TruncateLimits): unknown;
31
31
  /** Redact then bound — the only way a hub payload becomes tool output. */
32
32
  export declare function toToolOutput(value: unknown, limits?: TruncateLimits): unknown;
33
+ /**
34
+ * What a tool's ARGUMENTS may become before any log line: declared secrets,
35
+ * credential-named keys, then the pattern scrub — the same layers the output
36
+ * goes through, so a secret that must not come back must not be logged either.
37
+ */
38
+ export declare function redactToolArgs(args: unknown): unknown;
33
39
  //# sourceMappingURL=redact.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/mcp/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,QAAQ,aAAa,CAAA;AAUlC,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW7D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAsBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,cAA+B,GAAG,OAAO,CAU/F;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,cAA+B,GAAG,OAAO,CAE7F"}
1
+ {"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/mcp/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,QAAQ,aAAa,CAAA;AAUlC,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW7D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAsBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,cAA+B,GAAG,OAAO,CAU/F;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,cAA+B,GAAG,OAAO,CAE7F;AAkBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAErD"}
@@ -8,6 +8,7 @@
8
8
  * `value`/`default` is the secret, whatever the key is called.
9
9
  * The output layer (`text()`) then adds the name/pattern scrub on top.
10
10
  */
11
+ import { scrubValue } from './scrub.js';
11
12
  export const REDACTED = '[SECRET]';
12
13
  function isRecord(value) {
13
14
  return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -76,3 +77,26 @@ export function truncateOutput(value, limits = DEFAULT_LIMITS) {
76
77
  export function toToolOutput(value, limits = DEFAULT_LIMITS) {
77
78
  return truncateOutput(redactDeclaredSecrets(value), limits);
78
79
  }
80
+ /** Key names that read as a credential, beyond what `scrubValue` already catches. */
81
+ const CREDENTIAL_KEY = /pass(word|wd|phrase)?|token|secret|api[_-]?key|credential|private[_-]?key|authorization|cookie/i;
82
+ function redactCredentialKeys(value) {
83
+ if (Array.isArray(value))
84
+ return value.map((v) => redactCredentialKeys(v));
85
+ if (!isRecord(value))
86
+ return value;
87
+ const out = {};
88
+ for (const [key, child] of Object.entries(value)) {
89
+ // `confirm_token` is the gate's own one-shot handle, bound to the arguments.
90
+ out[key] =
91
+ key !== 'confirm_token' && CREDENTIAL_KEY.test(key) ? REDACTED : redactCredentialKeys(child);
92
+ }
93
+ return out;
94
+ }
95
+ /**
96
+ * What a tool's ARGUMENTS may become before any log line: declared secrets,
97
+ * credential-named keys, then the pattern scrub — the same layers the output
98
+ * goes through, so a secret that must not come back must not be logged either.
99
+ */
100
+ export function redactToolArgs(args) {
101
+ return scrubValue(redactCredentialKeys(redactDeclaredSecrets(args)));
102
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/develop",
3
- "version": "0.1.40",
3
+ "version": "0.1.42",
4
4
  "description": "CamStack developer tooling — catalogue, scaffold, validate, and example lookup shared by the CLI and MCP server.",
5
5
  "keywords": [
6
6
  "camstack",