agl 43.10.0 → 43.10.1

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 (53) hide show
  1. package/changelog.md +8 -0
  2. package/dist_serve/bundle.js +1 -1
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/classes.authstore.d.ts +6 -0
  6. package/dist_ts/classes.authstore.js +8 -1
  7. package/dist_ts/classes.controller.d.ts +6 -0
  8. package/dist_ts/classes.controller.js +19 -1
  9. package/dist_ts/classes.mcpcallerregistry.d.ts +19 -1
  10. package/dist_ts/classes.mcpcallerregistry.js +33 -7
  11. package/dist_ts/classes.terminalcallers.d.ts +40 -0
  12. package/dist_ts/classes.terminalcallers.js +90 -0
  13. package/dist_ts/classes.terminalmanager.d.ts +20 -1
  14. package/dist_ts/classes.terminalmanager.js +36 -2
  15. package/dist_ts/classes.ticketorderspread.d.ts +25 -0
  16. package/dist_ts/classes.ticketorderspread.js +52 -0
  17. package/dist_ts/classes.ticketstore.d.ts +27 -0
  18. package/dist_ts/classes.ticketstore.js +68 -15
  19. package/dist_ts/classes.workercallers.d.ts +5 -1
  20. package/dist_ts/classes.workercallers.js +19 -4
  21. package/dist_ts/fleet/classes.claudeworkers.d.ts +18 -5
  22. package/dist_ts/fleet/classes.claudeworkers.js +105 -31
  23. package/dist_ts/fleet/classes.workers.d.ts +5 -3
  24. package/dist_ts/fleet/classes.workers.js +17 -11
  25. package/dist_ts/fleet/interfaces.workers.d.ts +16 -2
  26. package/dist_ts/fleet/interfaces.workers.js +8 -1
  27. package/dist_ts_interfaces/mcprequests.d.ts +2 -1
  28. package/dist_ts_interfaces/mcprequests.js +3 -2
  29. package/dist_ts_migration/classes.documentmigrationrunner.d.ts +8 -1
  30. package/dist_ts_migration/classes.documentmigrationrunner.js +11 -2
  31. package/dist_ts_migration/index.d.ts +1 -0
  32. package/dist_ts_migration/index.js +2 -1
  33. package/dist_ts_migration/v43_ticketorderstride.d.ts +54 -0
  34. package/dist_ts_migration/v43_ticketorderstride.js +161 -0
  35. package/package.json +1 -1
  36. package/readme.md +18 -2
  37. package/ts/00_commitinfo_data.ts +1 -1
  38. package/ts/classes.authstore.ts +9 -0
  39. package/ts/classes.controller.ts +19 -0
  40. package/ts/classes.mcpcallerregistry.ts +49 -7
  41. package/ts/classes.terminalcallers.ts +91 -0
  42. package/ts/classes.terminalmanager.ts +41 -1
  43. package/ts/classes.ticketorderspread.ts +50 -0
  44. package/ts/classes.ticketstore.ts +61 -11
  45. package/ts/classes.workercallers.ts +19 -3
  46. package/ts/fleet/classes.claudeworkers.ts +101 -29
  47. package/ts/fleet/classes.workers.ts +15 -10
  48. package/ts/fleet/interfaces.workers.ts +16 -2
  49. package/ts_interfaces/mcprequests.ts +2 -1
  50. package/ts_migration/classes.documentmigrationrunner.ts +12 -1
  51. package/ts_migration/index.ts +1 -0
  52. package/ts_migration/v43_ticketorderstride.ts +156 -0
  53. package/ts_web/00_commitinfo_data.ts +1 -1
@@ -7,6 +7,11 @@ export declare const anonymousControllerMcpCaller: IControllerMcpCaller;
7
7
  export declare const controllerMcpCallerOf: (subjectArg: Exclude<TControllerMcpSubject, {
8
8
  kind: 'anonymous';
9
9
  }>) => IControllerMcpCaller;
10
+ /** A process as the kernel identifies it for as long as the host runs: its PID and its start time in clock ticks. */
11
+ export interface IControllerMcpCallerProcess {
12
+ pid: number;
13
+ startTicks: string;
14
+ }
10
15
  /** Minted credentials, keyed by digest so the raw value is never retained. */
11
16
  export declare class ControllerMcpCallerRegistry {
12
17
  private readonly callersByCredentialKey;
@@ -15,8 +20,21 @@ export declare class ControllerMcpCallerRegistry {
15
20
  }>): string;
16
21
  mintWorker(subjectArg: IWorkerCallerSubject): string;
17
22
  private store;
18
- /** An unknown, malformed or revoked credential degrades to anonymous, never to an error. */
23
+ /**
24
+ * An unknown, malformed or revoked credential degrades to anonymous, never to an error. This names the subject a
25
+ * credential was minted for; whether its presenter may act as it is admission's question (`ControllerWorkerCallers.admit`).
26
+ */
19
27
  resolve(credentialArg: string | undefined): IControllerMcpCaller;
28
+ /**
29
+ * Records the PTY child a terminal start spawned with `credentialArg` in its environment as the process that
30
+ * credential is honoured inside (AGL-1891). Until it is made, the credential is honoured for no process; a revoked
31
+ * credential, or one minted for anything but a terminal, records nothing.
32
+ */
33
+ bindTerminalProcess(credentialArg: string, processArg: IControllerMcpCallerProcess): void;
34
+ /** The PTY child a terminal's credential is honoured inside, once its start recorded it; nothing for any other credential. */
35
+ terminalProcess(credentialArg: string): IControllerMcpCallerProcess | undefined;
36
+ /** The PTY children of every terminal whose credential is live and recorded one. */
37
+ terminalProcesses(): IControllerMcpCallerProcess[];
20
38
  revokeCredential(credentialArg: string): void;
21
39
  revokeTerminal(projectIdArg: string, resourceIdArg: string): void;
22
40
  revokeSession(projectIdArg: string, sessionIdArg: IControllerRuntimeId): void;
@@ -5,6 +5,10 @@ import {} from '../dist_ts_interfaces/index.js';
5
5
  * process is a controller child — terminals, the OpenCode server — so no credential can outlive
6
6
  * the controller generation that minted it, and nothing here belongs in persistence.
7
7
  *
8
+ * A terminal's credential also records the terminal's PTY child once it runs (`bindTerminalProcess`):
9
+ * every process started in the terminal inherits the credential, a daemon that leaves it as well, so
10
+ * admission honours it only for a process that still runs inside the terminal (AGL-1891).
11
+ *
8
12
  * A credential is secret material. It never reaches audit records, error text, responses or logs:
9
13
  * only the derived {@link IControllerMcpCaller.auditPeerId} does, and that is a one-way digest.
10
14
  */
@@ -52,18 +56,40 @@ export class ControllerMcpCallerRegistry {
52
56
  store(subjectArg) {
53
57
  const credential = plugins.crypto.randomBytes(credentialByteLength).toString('base64url');
54
58
  this.callersByCredentialKey.set(credentialKey(credential), {
55
- subject: subjectArg,
56
- auditPeerId: auditPeerIdFor(subjectArg),
59
+ caller: { subject: subjectArg, auditPeerId: auditPeerIdFor(subjectArg) },
57
60
  });
58
61
  return credential;
59
62
  }
60
- /** An unknown, malformed or revoked credential degrades to anonymous, never to an error. */
63
+ /**
64
+ * An unknown, malformed or revoked credential degrades to anonymous, never to an error. This names the subject a
65
+ * credential was minted for; whether its presenter may act as it is admission's question (`ControllerWorkerCallers.admit`).
66
+ */
61
67
  resolve(credentialArg) {
62
68
  if (credentialArg === undefined)
63
69
  return anonymousControllerMcpCaller;
64
- return this.callersByCredentialKey.get(credentialKey(credentialArg))
70
+ return this.callersByCredentialKey.get(credentialKey(credentialArg))?.caller
65
71
  ?? anonymousControllerMcpCaller;
66
72
  }
73
+ /**
74
+ * Records the PTY child a terminal start spawned with `credentialArg` in its environment as the process that
75
+ * credential is honoured inside (AGL-1891). Until it is made, the credential is honoured for no process; a revoked
76
+ * credential, or one minted for anything but a terminal, records nothing.
77
+ */
78
+ bindTerminalProcess(credentialArg, processArg) {
79
+ const entry = this.callersByCredentialKey.get(credentialKey(credentialArg));
80
+ if (entry?.caller.subject.kind !== 'terminal')
81
+ return;
82
+ entry.process = Object.freeze({ pid: processArg.pid, startTicks: processArg.startTicks });
83
+ }
84
+ /** The PTY child a terminal's credential is honoured inside, once its start recorded it; nothing for any other credential. */
85
+ terminalProcess(credentialArg) {
86
+ const entry = this.callersByCredentialKey.get(credentialKey(credentialArg));
87
+ return entry?.caller.subject.kind === 'terminal' ? entry.process : undefined;
88
+ }
89
+ /** The PTY children of every terminal whose credential is live and recorded one. */
90
+ terminalProcesses() {
91
+ return [...this.callersByCredentialKey.values()].flatMap((entryArg) => (entryArg.caller.subject.kind === 'terminal' && entryArg.process ? [entryArg.process] : []));
92
+ }
67
93
  revokeCredential(credentialArg) {
68
94
  this.callersByCredentialKey.delete(credentialKey(credentialArg));
69
95
  }
@@ -88,8 +114,8 @@ export class ControllerMcpCallerRegistry {
88
114
  return this.callersByCredentialKey.size;
89
115
  }
90
116
  revokeWhere(predicateArg) {
91
- for (const [key, caller] of [...this.callersByCredentialKey]) {
92
- if (predicateArg(caller.subject))
117
+ for (const [key, entry] of [...this.callersByCredentialKey]) {
118
+ if (predicateArg(entry.caller.subject))
93
119
  this.callersByCredentialKey.delete(key);
94
120
  }
95
121
  }
@@ -102,4 +128,4 @@ export class ControllerMcpCallerRegistry {
102
128
  const callerContext = new plugins.asyncHooks.AsyncLocalStorage();
103
129
  export const runWithControllerMcpCaller = (callerArg, operationArg) => callerContext.run(callerArg, operationArg);
104
130
  export const currentControllerMcpCaller = () => (callerContext.getStore() ?? anonymousControllerMcpCaller);
105
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tY3BjYWxsZXJyZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NsYXNzZXMubWNwY2FsbGVycmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUtOLE1BQU0sMkJBQTJCLENBQUM7QUFFbkM7Ozs7Ozs7R0FPRztBQUNILE1BQU0sb0JBQW9CLEdBQUcsRUFBRSxDQUFDO0FBQ2hDLE1BQU0sZ0JBQWdCLEdBQUcsRUFBRSxDQUFDO0FBRTVCLE1BQU0sQ0FBQyxNQUFNLDRCQUE0QixHQUF5QixNQUFNLENBQUMsTUFBTSxDQUFDO0lBQzlFLE9BQU8sRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsSUFBSSxFQUFFLFdBQVcsRUFBRSxDQUEwQjtJQUN0RSxXQUFXLEVBQUUsZUFBZTtDQUM3QixDQUFDLENBQUM7QUFFSCxNQUFNLE1BQU0sR0FBRyxDQUFDLFFBQWdCLEVBQVUsRUFBRSxDQUFDLE9BQU8sQ0FBQyxNQUFNO0tBQ3hELFVBQVUsQ0FBQyxRQUFRLENBQUM7S0FDcEIsTUFBTSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUM7S0FDeEIsTUFBTSxFQUFFO0tBQ1IsUUFBUSxDQUFDLENBQUMsRUFBRSxnQkFBZ0IsQ0FBQztLQUM3QixRQUFRLENBQUMsV0FBVyxDQUFDLENBQUM7QUFFekIsTUFBTSxjQUFjLEdBQUcsQ0FBQyxVQUFpQyxFQUFVLEVBQUU7SUFDbkUsSUFBSSxVQUFVLENBQUMsSUFBSSxLQUFLLFNBQVM7UUFBRSxPQUFPLGVBQWUsTUFBTSxDQUFDLFVBQVUsQ0FBQyxpQkFBaUIsQ0FBQyxFQUFFLENBQUM7SUFDaEcsSUFBSSxVQUFVLENBQUMsSUFBSSxLQUFLLFVBQVU7UUFBRSxPQUFPLGdCQUFnQixNQUFNLENBQUMsVUFBVSxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7SUFDM0YsSUFBSSxVQUFV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
131
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tY3BjYWxsZXJyZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NsYXNzZXMubWNwY2FsbGVycmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUtOLE1BQU0sMkJBQTJCLENBQUM7QUFFbkM7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLG9CQUFvQixHQUFHLEVBQUUsQ0FBQztBQUNoQyxNQUFNLGdCQUFnQixHQUFHLEVBQUUsQ0FBQztBQUU1QixNQUFNLENBQUMsTUFBTSw0QkFBNEIsR0FBeUIsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUM5RSxPQUFPLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsQ0FBMEI7SUFDdEUsV0FBVyxFQUFFLGVBQWU7Q0FDN0IsQ0FBQyxDQUFDO0FBRUgsTUFBTSxNQUFNLEdBQUcsQ0FBQyxRQUFnQixFQUFVLEVBQUUsQ0FBQyxPQUFPLENBQUMsTUFBTTtLQUN4RCxVQUFVLENBQUMsUUFBUSxDQUFDO0tBQ3BCLE1BQU0sQ0FBQyxRQUFRLEVBQUUsTUFBTSxDQUFDO0tBQ3hCLE1BQU0sRUFBRTtLQUNSLFFBQVEsQ0FBQyxDQUFDLEVBQUUsZ0JBQWdCLENBQUM7S0FDN0IsUUFBUSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0FBRXpCLE1BQU0sY0FBYyxHQUFHLENBQUMsVUFBaUMsRUFBVSxFQUFFO0lBQ25FLElBQUksVUFBVSxDQUFDLElBQUksS0FBSyxTQUFTO1FBQUUsT0FBTyxlQUFlLE1BQU0sQ0FBQyxVQUFVLENBQUMsaUJBQWlCLENBQUMsRUFBRSxDQUFDO0lBQ2hHLElBQUksVUFBVSxDQUFDLElBQUksS0FBSyxVQUFVO1FBQUUsT0FBTyxnQkFBZ0IsTUFBTSxDQUFDLFVBQVUsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO0lBQzNGLElBQUks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
@@ -0,0 +1,40 @@
1
+ import { type ControllerMcpCallerRegistry } from './classes.mcpcallerregistry.js';
2
+ import { type proveConnectionProcessAncestry, type IWorkerCallerConnection } from './functions.workerprocessproof.js';
3
+ import type { IControllerMcpCaller } from '../dist_ts_interfaces/index.js';
4
+ export interface IControllerTerminalCallerOptions {
5
+ registry: ControllerMcpCallerRegistry;
6
+ /** The caller's process and its parent chain, proved to hold the request's loopback connection. */
7
+ proveAncestry: typeof proveConnectionProcessAncestry;
8
+ }
9
+ /**
10
+ * Who presents a terminal's MCP caller credential as the terminal (AGL-1891): only a process that runs inside it. The
11
+ * terminal's PTY child gets the credential in its environment, and every process started from it inherits it, a daemon
12
+ * too (Claude Code's background-job daemon started from a terminal shell carries it for its whole life, and so does
13
+ * every job it runs). So a call presenting it is admitted only from a bridge that told the controller its PID at its
14
+ * process enrollment (`{ bridgePid }`), holds the call's own loopback connection, and still descends from the PTY child
15
+ * the terminal's start recorded (PID and start), all read from the kernel at that call. Any other presenter calls
16
+ * anonymously, as with an unknown credential: a daemon that left the terminal (re-parented to init), a process that
17
+ * never ran in it, a bridge whose PID another process claims, and every process once the recorded child is gone.
18
+ */
19
+ export declare class ControllerTerminalCallers {
20
+ private readonly options;
21
+ /**
22
+ * The bridges whose enrollment proved them inside a terminal, by the key of the terminal's PTY child. Only a hint of
23
+ * whose connection a call may come over: admission proves every call afresh.
24
+ */
25
+ private readonly bridges;
26
+ constructor(options: IControllerTerminalCallerOptions);
27
+ /**
28
+ * At a bridge's process enrollment the fleet answered no credential (so the bridge calls with the one it inherited):
29
+ * remembers the bridge as a process of the terminal whose recorded PTY child it descends from, once it proved that it
30
+ * holds the enrollment's connection. A bridge inside no running terminal, or one whose proof is refused, is remembered
31
+ * nowhere. Only an unexpected failure to read the processes throws.
32
+ */
33
+ observe(bridgePidArg: number, connectionArg: IWorkerCallerConnection | undefined): Promise<void>;
34
+ /**
35
+ * The terminal caller `callerArg` (what `credentialArg` resolves to) when the call's connection is held by a bridge
36
+ * its enrollment proved inside that terminal, the same process still, and that bridge still descends from the
37
+ * terminal's recorded PTY child, unchanged since the spawn; the anonymous caller otherwise.
38
+ */
39
+ admit(credentialArg: string, callerArg: IControllerMcpCaller, connectionArg: IWorkerCallerConnection | undefined): Promise<IControllerMcpCaller>;
40
+ }
@@ -0,0 +1,90 @@
1
+ import { anonymousControllerMcpCaller, } from './classes.mcpcallerregistry.js';
2
+ import { isWorkerCallerProofRefusal, } from './functions.workerprocessproof.js';
3
+ /** The bridges remembered per terminal, the newest first; the oldest give way. */
4
+ const maximumBridgesPerTerminal = 16;
5
+ /** How far up a bridge's parent chain the terminal's PTY child is looked for. */
6
+ const ancestryDepth = 32;
7
+ const processKey = (processArg) => `${processArg.pid}:${processArg.startTicks}`;
8
+ const sameProcess = (leftArg, rightArg) => (leftArg.pid === rightArg.pid && leftArg.startTicks === rightArg.startTicks);
9
+ /**
10
+ * Who presents a terminal's MCP caller credential as the terminal (AGL-1891): only a process that runs inside it. The
11
+ * terminal's PTY child gets the credential in its environment, and every process started from it inherits it, a daemon
12
+ * too (Claude Code's background-job daemon started from a terminal shell carries it for its whole life, and so does
13
+ * every job it runs). So a call presenting it is admitted only from a bridge that told the controller its PID at its
14
+ * process enrollment (`{ bridgePid }`), holds the call's own loopback connection, and still descends from the PTY child
15
+ * the terminal's start recorded (PID and start), all read from the kernel at that call. Any other presenter calls
16
+ * anonymously, as with an unknown credential: a daemon that left the terminal (re-parented to init), a process that
17
+ * never ran in it, a bridge whose PID another process claims, and every process once the recorded child is gone.
18
+ */
19
+ export class ControllerTerminalCallers {
20
+ options;
21
+ /**
22
+ * The bridges whose enrollment proved them inside a terminal, by the key of the terminal's PTY child. Only a hint of
23
+ * whose connection a call may come over: admission proves every call afresh.
24
+ */
25
+ bridges = new Map();
26
+ constructor(options) {
27
+ this.options = options;
28
+ }
29
+ /**
30
+ * At a bridge's process enrollment the fleet answered no credential (so the bridge calls with the one it inherited):
31
+ * remembers the bridge as a process of the terminal whose recorded PTY child it descends from, once it proved that it
32
+ * holds the enrollment's connection. A bridge inside no running terminal, or one whose proof is refused, is remembered
33
+ * nowhere. Only an unexpected failure to read the processes throws.
34
+ */
35
+ async observe(bridgePidArg, connectionArg) {
36
+ const terminals = this.options.registry.terminalProcesses();
37
+ const live = new Set(terminals.map(processKey));
38
+ // A terminal that stopped revoked its credential: its bridges are forgotten with it.
39
+ for (const key of [...this.bridges.keys()])
40
+ if (!live.has(key))
41
+ this.bridges.delete(key);
42
+ if (terminals.length === 0)
43
+ return;
44
+ let chain;
45
+ try {
46
+ chain = await this.options.proveAncestry(connectionArg, bridgePidArg, ancestryDepth);
47
+ }
48
+ catch (errorArg) {
49
+ if (isWorkerCallerProofRefusal(errorArg))
50
+ return;
51
+ throw errorArg;
52
+ }
53
+ const terminal = chain.find(processArg => terminals.some(terminalArg => sameProcess(processArg, terminalArg)));
54
+ if (!terminal)
55
+ return;
56
+ const bridge = { pid: chain[0].pid, startTicks: chain[0].startTicks };
57
+ const key = processKey(terminal);
58
+ const remembered = (this.bridges.get(key) ?? []).filter(entryArg => entryArg.pid !== bridge.pid);
59
+ this.bridges.set(key, [bridge, ...remembered].slice(0, maximumBridgesPerTerminal));
60
+ }
61
+ /**
62
+ * The terminal caller `callerArg` (what `credentialArg` resolves to) when the call's connection is held by a bridge
63
+ * its enrollment proved inside that terminal, the same process still, and that bridge still descends from the
64
+ * terminal's recorded PTY child, unchanged since the spawn; the anonymous caller otherwise.
65
+ */
66
+ async admit(credentialArg, callerArg, connectionArg) {
67
+ const terminal = this.options.registry.terminalProcess(credentialArg);
68
+ if (!terminal)
69
+ return anonymousControllerMcpCaller;
70
+ for (const bridge of [...this.bridges.get(processKey(terminal)) ?? []]) {
71
+ let chain;
72
+ try {
73
+ chain = await this.options.proveAncestry(connectionArg, bridge.pid, ancestryDepth);
74
+ }
75
+ catch (errorArg) {
76
+ // Not this bridge's connection, or the bridge is gone: the next remembered one may hold it.
77
+ if (isWorkerCallerProofRefusal(errorArg))
78
+ continue;
79
+ throw errorArg;
80
+ }
81
+ // The connection is this PID's: it is the presenter, and no other bridge is asked.
82
+ if (sameProcess(chain[0], bridge) && chain.some(processArg => sameProcess(processArg, terminal))
83
+ && this.options.registry.resolve(credentialArg) === callerArg)
84
+ return callerArg;
85
+ return anonymousControllerMcpCaller;
86
+ }
87
+ return anonymousControllerMcpCaller;
88
+ }
89
+ }
90
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50ZXJtaW5hbGNhbGxlcnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLnRlcm1pbmFsY2FsbGVycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQ0wsNEJBQTRCLEdBQzdCLE1BQU0sZ0NBQWdDLENBQUM7QUFDeEMsT0FBTyxFQUNMLDBCQUEwQixHQUMzQixNQUFNLG1DQUFtQyxDQUFDO0FBRzNDLGtGQUFrRjtBQUNsRixNQUFNLHlCQUF5QixHQUFHLEVBQUUsQ0FBQztBQUNyQyxpRkFBaUY7QUFDakYsTUFBTSxhQUFhLEdBQUcsRUFBRSxDQUFDO0FBRXpCLE1BQU0sVUFBVSxHQUFHLENBQUMsVUFBdUMsRUFBVSxFQUFFLENBQUMsR0FBRyxVQUFVLENBQUMsR0FBRyxJQUFJLFVBQVUsQ0FBQyxVQUFVLEVBQUUsQ0FBQztBQUNySCxNQUFNLFdBQVcsR0FBRyxDQUFDLE9BQW9DLEVBQUUsUUFBcUMsRUFBVyxFQUFFLENBQUMsQ0FDNUcsT0FBTyxDQUFDLEdBQUcsS0FBSyxRQUFRLENBQUMsR0FBRyxJQUFJLE9BQU8sQ0FBQyxVQUFVLEtBQUssUUFBUSxDQUFDLFVBQVUsQ0FDM0UsQ0FBQztBQVFGOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sT0FBTyx5QkFBeUI7SUFPUCxPQUFPO0lBTnBDOzs7T0FHRztJQUNjLE9BQU8sR0FBRyxJQUFJLEdBQUcsRUFBeUMsQ0FBQztJQUU1RSxZQUE2QixPQUF5Qzt1QkFBekMsT0FBTztJQUFxQyxDQUFDO0lBRTFFOzs7OztPQUtHO0lBQ0ksS0FBSyxDQUFDLE9BQU8sQ0FBQyxZQUFvQixFQUFFLGFBQWtEO1FBQzNGLE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLGlCQUFpQixFQUFFLENBQUM7UUFDNUQsTUFBTSxJQUFJLEdBQUcsSUFBSSxHQUFHLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FB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
@@ -1,6 +1,7 @@
1
1
  import * as plugins from './plugins.js';
2
2
  import { type IControllerTerminal, type IControllerTerminalSnapshotFrame, type TControllerTerminalId, type TControllerTerminalAgentKind, type TControllerTerminalAgentFailure, type TControllerTerminalAgentLaunchMode } from '../dist_ts_interfaces/index.js';
3
3
  import type { IControllerResourceDocument } from './interfaces.projects.js';
4
+ import type { IControllerMcpCallerProcess } from './classes.mcpcallerregistry.js';
4
5
  export interface ITerminalOutputPayload {
5
6
  terminalId: TControllerTerminalId;
6
7
  /**
@@ -93,6 +94,17 @@ export interface IControllerTerminalManagerOptions {
93
94
  resourceId: string;
94
95
  agentSessionId?: string;
95
96
  }) => string | undefined;
97
+ /**
98
+ * Records the PTY child of a start whose environment carries a minted caller credential (AGL-1891): that credential,
99
+ * and the child's PID and start time, read from the kernel right after the spawn. Every process started in the
100
+ * terminal inherits the credential, a daemon that leaves the terminal as well, so the controller honours it only for
101
+ * a process that descends from this child; a start that records none (its child already exited) leaves the credential
102
+ * honoured for no process.
103
+ */
104
+ recordCallerProcess?: (inputArg: {
105
+ credential: string;
106
+ process: IControllerMcpCallerProcess;
107
+ }) => void;
96
108
  /**
97
109
  * Starts a Claude chat's use of the provider pool it runs on (`IControllerTerminalAgentMetadata.provider`) through
98
110
  * AGL's inference proxy. Without it, a chat on a pool does not start.
@@ -140,10 +152,17 @@ export declare class ControllerTerminalManager {
140
152
  /**
141
153
  * The sanitized shell environment plus this start's caller credential. The credential is written
142
154
  * explicitly here and is never inheritable, so a value present in the controller's own
143
- * environment can never reach a child and impersonate a terminal.
155
+ * environment can never reach a child and impersonate a terminal. Inside the terminal every
156
+ * process inherits it; the controller honours it only for those that still run there (AGL-1891).
144
157
  */
145
158
  private spawnEnvironmentFor;
146
159
  private spawnTerminal;
160
+ /**
161
+ * Records this start's PTY child as the process its caller credential `credentialArg` is honoured inside (AGL-1891):
162
+ * read once from the kernel right after the spawn, and only while it is this controller's own child. A child that
163
+ * already exited is not recorded, which leaves the credential honoured for no process.
164
+ */
165
+ private recordCallerProcess;
147
166
  /** OSC titles are untrusted display metadata: bounded, coalesced and never persisted. */
148
167
  private acceptAutomaticTitle;
149
168
  /** The live title is a display override only; callers retain the durable name after process exit. */