@cotal-ai/workspace 0.137.0 → 0.138.0
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/build/Release/darwin-arm64/build.json +1 -1
- package/build/Release/darwin-x64/build.json +1 -1
- package/build/Release/win32-arm64/build.json +1 -1
- package/build/Release/win32-x64/build.json +1 -1
- package/dist/attach/attach-client.d.ts +120 -0
- package/dist/attach/attach-client.d.ts.map +1 -0
- package/dist/attach/attach-client.js +525 -0
- package/dist/attach/attach-client.js.map +1 -0
- package/dist/attach/attach-seat.d.ts +174 -0
- package/dist/attach/attach-seat.d.ts.map +1 -0
- package/dist/attach/attach-seat.js +732 -0
- package/dist/attach/attach-seat.js.map +1 -0
- package/dist/attach/index.d.ts +3 -0
- package/dist/attach/index.d.ts.map +1 -0
- package/dist/attach/index.js +3 -0
- package/dist/attach/index.js.map +1 -0
- package/dist/chat/admission.d.ts +34 -0
- package/dist/chat/admission.d.ts.map +1 -0
- package/dist/chat/admission.js +18 -0
- package/dist/chat/admission.js.map +1 -0
- package/dist/chat/engine.d.ts +111 -0
- package/dist/chat/engine.d.ts.map +1 -0
- package/dist/chat/engine.js +225 -0
- package/dist/chat/engine.js.map +1 -0
- package/dist/chat/index.d.ts +8 -0
- package/dist/chat/index.d.ts.map +1 -0
- package/dist/chat/index.js +8 -0
- package/dist/chat/index.js.map +1 -0
- package/dist/chat/native-session.d.ts +120 -0
- package/dist/chat/native-session.d.ts.map +1 -0
- package/dist/chat/native-session.js +487 -0
- package/dist/chat/native-session.js.map +1 -0
- package/dist/chat/open-session.d.ts +9 -0
- package/dist/chat/open-session.d.ts.map +1 -0
- package/dist/chat/open-session.js +120 -0
- package/dist/chat/open-session.js.map +1 -0
- package/dist/chat/session.d.ts +230 -0
- package/dist/chat/session.d.ts.map +1 -0
- package/dist/chat/session.js +2 -0
- package/dist/chat/session.js.map +1 -0
- package/dist/chat/static-session.d.ts +63 -0
- package/dist/chat/static-session.d.ts.map +1 -0
- package/dist/chat/static-session.js +237 -0
- package/dist/chat/static-session.js.map +1 -0
- package/dist/chat/user-session.d.ts +22 -0
- package/dist/chat/user-session.d.ts.map +1 -0
- package/dist/chat/user-session.js +182 -0
- package/dist/chat/user-session.js.map +1 -0
- package/package.json +12 -4
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"platform": "darwin",
|
|
4
4
|
"arch": "arm64",
|
|
5
5
|
"nodeApi": 8,
|
|
6
|
-
"source": "
|
|
6
|
+
"source": "85d0eba461d33193f598638c7af9ffe7b4f277d3",
|
|
7
7
|
"sourceHashes": {
|
|
8
8
|
"native/win32-process.c": "889b215135b60dd3a45096737a3219ce114bc424e4b6cce42624f0913f8447dc",
|
|
9
9
|
"native/win32-system-id.cpp": "2dd51f24425e8239aeac1aae01e67f43264f04f09cd9097a12d288be7a84e074",
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"platform": "darwin",
|
|
4
4
|
"arch": "x64",
|
|
5
5
|
"nodeApi": 8,
|
|
6
|
-
"source": "
|
|
6
|
+
"source": "85d0eba461d33193f598638c7af9ffe7b4f277d3",
|
|
7
7
|
"sourceHashes": {
|
|
8
8
|
"native/win32-process.c": "889b215135b60dd3a45096737a3219ce114bc424e4b6cce42624f0913f8447dc",
|
|
9
9
|
"native/win32-system-id.cpp": "2dd51f24425e8239aeac1aae01e67f43264f04f09cd9097a12d288be7a84e074",
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"platform": "win32",
|
|
4
4
|
"arch": "arm64",
|
|
5
5
|
"nodeApi": 8,
|
|
6
|
-
"source": "
|
|
6
|
+
"source": "85d0eba461d33193f598638c7af9ffe7b4f277d3",
|
|
7
7
|
"sourceHashes": {
|
|
8
8
|
"native/win32-process.c": "889b215135b60dd3a45096737a3219ce114bc424e4b6cce42624f0913f8447dc",
|
|
9
9
|
"native/win32-system-id.cpp": "2dd51f24425e8239aeac1aae01e67f43264f04f09cd9097a12d288be7a84e074",
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"platform": "win32",
|
|
4
4
|
"arch": "x64",
|
|
5
5
|
"nodeApi": 8,
|
|
6
|
-
"source": "
|
|
6
|
+
"source": "85d0eba461d33193f598638c7af9ffe7b4f277d3",
|
|
7
7
|
"sourceHashes": {
|
|
8
8
|
"native/win32-process.c": "889b215135b60dd3a45096737a3219ce114bc424e4b6cce42624f0913f8447dc",
|
|
9
9
|
"native/win32-system-id.cpp": "2dd51f24425e8239aeac1aae01e67f43264f04f09cd9097a12d288be7a84e074",
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import type { NatsConnection } from "@nats-io/transport-node";
|
|
2
|
+
import { type SessionGrant } from "@cotal-ai/core";
|
|
3
|
+
/**
|
|
4
|
+
* The detach key — Ctrl-] (0x1d) by default, as in telnet/ssh escape conventions. The `detach-key`
|
|
5
|
+
* preference rebinds it to another control key when Ctrl-] clashes with a keybinding inside the
|
|
6
|
+
* agent's TUI: `COTAL_DETACH_KEY`, then the saved preference (`cotal config set detach-key`). Both
|
|
7
|
+
* accept `ctrl-<char>` or `^<char>` (e.g. `ctrl-b`, `^_`). An unparseable `COTAL_DETACH_KEY` —
|
|
8
|
+
* including a set-but-empty or whitespace-only one — throws (named), never silently falling back;
|
|
9
|
+
* the caller turns that into a loud exit. A saved value was validated when it was written.
|
|
10
|
+
*/
|
|
11
|
+
export declare function detachKey(): {
|
|
12
|
+
byte: number;
|
|
13
|
+
label: string;
|
|
14
|
+
overridden: boolean;
|
|
15
|
+
from: string;
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* Whether a whole chunk `d` is exactly one press of the detach key `byte`, in any of three
|
|
19
|
+
* encodings: the legacy single control byte; the kitty keyboard protocol's `CSI <codepoint> ;
|
|
20
|
+
* <mods> u`; or xterm `modifyOtherKeys`'s `CSI 27 ; <mods> ; <codepoint> ~`. `<codepoint>` is the
|
|
21
|
+
* decimal codepoint kitty/xterm report for the unshifted key: `byte | 0x40` for the control
|
|
22
|
+
* punctuation (`@ [ \ ] ^ _`) and `byte | 0x60` for a letter (kitty reports the lowercase key even
|
|
23
|
+
* though Ctrl was held). `<mods>` is 1 + the modifier bitmask and must carry the Ctrl bit
|
|
24
|
+
* (`(mods - 1) & 4`), so plain Ctrl (5) and Ctrl+Shift (6) match but a modifier field without Ctrl
|
|
25
|
+
* does not, and a field of 0, which neither protocol emits, is not a press either (the test needs
|
|
26
|
+
* that floor: `(0 - 1) & 4` is 4 in ToInt32 arithmetic, so 0 would otherwise read as Ctrl). The match is on the WHOLE chunk:
|
|
27
|
+
* a sequence with company (a paste, a second keystroke, a trailing byte) is not a press, which is
|
|
28
|
+
* the same paste-safety property the one-byte test already had. This assumes one press arrives in
|
|
29
|
+
* one read, as measured on a pty (issue #598); a sequence split across two reads is not buffered
|
|
30
|
+
* and is not recognised. A kitty `CSI u` with an alternate-key `<codepoint>:<shifted>:<base>` triple
|
|
31
|
+
* is accepted by matching only the leading codepoint before an optional `:...` group; no other
|
|
32
|
+
* kitty event type (release, repeat) is recognised.
|
|
33
|
+
*/
|
|
34
|
+
export declare function isDetachPress(d: Buffer, byte: number): boolean;
|
|
35
|
+
/**
|
|
36
|
+
* A transport-agnostic terminal session. {@link attachClient} drives the terminal through this
|
|
37
|
+
* interface, so the SAME raw-mode / alt-screen / detach handling serves the mesh §13.6 session
|
|
38
|
+
* ({@link meshSessionTransport}). (The legacy loopback `ws://.../attach/` transport was removed with
|
|
39
|
+
* the P2 item 6 no-127.0.0.1 sweep.)
|
|
40
|
+
*/
|
|
41
|
+
export interface TerminalTransport {
|
|
42
|
+
/** Fires once the transport is connected and ready to carry the terminal. */
|
|
43
|
+
onReady(cb: () => void): void;
|
|
44
|
+
/** Remote → local: terminal output bytes. The transport awaits an async consumer before returning
|
|
45
|
+
* credit, so a slow local stdout applies real backpressure instead of acknowledging unread bytes. */
|
|
46
|
+
onData(cb: (bytes: Buffer) => void | Promise<void>): void;
|
|
47
|
+
/** The session ended: `err` on a transport error (rejects), else a clean detach/close (resolves),
|
|
48
|
+
* with the peer's distinct end `reason` when it sent one. */
|
|
49
|
+
onEnd(cb: (err?: Error, reason?: string) => void): void;
|
|
50
|
+
/** Local → remote: keystroke bytes. */
|
|
51
|
+
send(bytes: Buffer): void;
|
|
52
|
+
/** Local → remote: terminal resize. */
|
|
53
|
+
resize(cols: number, rows: number): void;
|
|
54
|
+
/** Detach: signal the remote and stop locally. */
|
|
55
|
+
close(): void;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* The operator's terminal, held ACROSS attach attempts. A reconnect re-establishes the SESSION,
|
|
59
|
+
* not the terminal: restoring raw mode and leaving the child's alternate screen between attempts
|
|
60
|
+
* would flash the shell's screen back and then repaint over it, which is exactly the garble the
|
|
61
|
+
* reconnect is supposed to spare the operator. So the two facts that outlive one session — the
|
|
62
|
+
* mode the terminal was in before we touched it, and whether the child has us in its alternate
|
|
63
|
+
* screen — live here, and the undo runs exactly once, when the attach really ends.
|
|
64
|
+
*
|
|
65
|
+
* `attachClient` creates its own when no hold is passed, which is the one-shot behaviour: enter on
|
|
66
|
+
* ready, undo on end.
|
|
67
|
+
*/
|
|
68
|
+
export interface TerminalHold {
|
|
69
|
+
/** Raw mode on, remembering what we found. Idempotent across reconnects. */
|
|
70
|
+
enterRaw(): void;
|
|
71
|
+
/** Is the child in its alternate screen right now? Carried across reconnects so the final undo
|
|
72
|
+
* leaves that buffer exactly when the child put us there. */
|
|
73
|
+
altScreen: boolean;
|
|
74
|
+
/** Undo every mode we changed, leave the alternate screen if the child put us there, and give
|
|
75
|
+
* the terminal back the raw mode it had. Idempotent. */
|
|
76
|
+
restore(): void;
|
|
77
|
+
}
|
|
78
|
+
export declare function holdTerminal(): TerminalHold;
|
|
79
|
+
/**
|
|
80
|
+
* Why a session ended, as {@link attachClient} resolves it. The reason is the peer's distinct `end`
|
|
81
|
+
* reason, the transport's own (`detached`, `peer-closed`, `connection-closed`), or the broken
|
|
82
|
+
* rail's protocol-fault name. `error` is set when the end was a fault rather than a clean close;
|
|
83
|
+
* it is DATA here rather than a rejection, because a caller that reconnects has to read the reason
|
|
84
|
+
* to decide, and an exception carries it only as prose.
|
|
85
|
+
*/
|
|
86
|
+
export interface AttachOutcome {
|
|
87
|
+
readonly reason: string;
|
|
88
|
+
readonly error?: Error;
|
|
89
|
+
/** Did any seat output actually reach the terminal? The manager replays its backlog snapshot on
|
|
90
|
+
* every open, so a session that carried nothing never got that far — which is how a caller that
|
|
91
|
+
* reconnects tells a session that worked from one that died on the way up. */
|
|
92
|
+
readonly carried: boolean;
|
|
93
|
+
}
|
|
94
|
+
/** Did the session end because the LINK broke (so re-establishing is the honest response)? */
|
|
95
|
+
export declare function isTransportEnd(reason: string): boolean;
|
|
96
|
+
/** A line the attach tells the operator while it runs. A `status` line is the loop's own progress;
|
|
97
|
+
* a `warning` is something about the operator's setup worth a look. */
|
|
98
|
+
export type AttachNotice = {
|
|
99
|
+
tone: "status" | "warning";
|
|
100
|
+
text: string;
|
|
101
|
+
};
|
|
102
|
+
/** The default notice sink: stderr, with a status line dimmed. */
|
|
103
|
+
export declare function writeNotice(notice: AttachNotice): void;
|
|
104
|
+
/**
|
|
105
|
+
* Drive a manager's attach session from the terminal: raw-mode stdin streams to the remote PTY,
|
|
106
|
+
* PTY output streams to stdout, and SIGWINCH-style resizes are forwarded. The detach key (Ctrl-]
|
|
107
|
+
* by default, {@link detachKey}) detaches without killing the agent. Transport-agnostic over the
|
|
108
|
+
* mesh §13.6 session. `notice` receives the line naming a rebound detach key.
|
|
109
|
+
*/
|
|
110
|
+
export declare function attachClient(transport: TerminalTransport, hold?: TerminalHold, takeStdin?: () => boolean, notice?: (notice: AttachNotice) => void): Promise<AttachOutcome>;
|
|
111
|
+
/**
|
|
112
|
+
* The mesh §13.6 SESSION transport: the item-6 replacement for the loopback WebSocket. Given a
|
|
113
|
+
* connection scoped to the session's eps rails and the redeemed grant, it opens the caller rail,
|
|
114
|
+
* asks the serving side to replay the reconstructed backlog (the `ready` handshake — PR #158 over
|
|
115
|
+
* the mesh), and speaks the core terminal-session frame codec. A `drop` frame is surfaced INLINE
|
|
116
|
+
* (never a silent loss); a peer `end`/close or a protocol fault ends the session with the distinct
|
|
117
|
+
* reason. No `127.0.0.1`, no bearer URL — the grant is holder-bound.
|
|
118
|
+
*/
|
|
119
|
+
export declare function meshSessionTransport(nc: NatsConnection, grant: SessionGrant): TerminalTransport;
|
|
120
|
+
//# sourceMappingURL=attach-client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"attach-client.d.ts","sourceRoot":"","sources":["../../src/attach/attach-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAgF,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAIjI;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAW9F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAmB9D;AA4DD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC9B;0GACsG;IACtG,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D;kEAC8D;IAC9D,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,uCAAuC;IACvC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uCAAuC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,IAAI,IAAI,CAAC;IACjB;kEAC8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB;6DACyD;IACzD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,YAAY,IAAI,YAAY,CAoB3C;AA6BD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB;;mFAE+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAqBD,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;wEACwE;AACxE,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,iBAAiB,EAC5B,IAAI,CAAC,EAAE,YAAY,EACnB,SAAS,CAAC,EAAE,MAAM,OAAO,EACzB,MAAM,GAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAkB,GACnD,OAAO,CAAC,aAAa,CAAC,CA2MxB;AAGD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,iBAAiB,CA6E/F"}
|