@artooi/ag-ui-web-component 0.26.1 → 0.28.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/CHANGELOG.md +291 -1
- package/README.md +191 -8
- package/dist/ag-ui-web-component.bundle.js +50 -50
- package/dist/ag-ui-web-component.bundle.js.map +4 -4
- package/dist/core/ag_ui_chat.d.ts +61 -3
- package/dist/core/ag_ui_chat.d.ts.map +1 -1
- package/dist/core/agui_client.d.ts +8 -1
- package/dist/core/agui_client.d.ts.map +1 -1
- package/dist/core/conversation_store.d.ts +58 -3
- package/dist/core/conversation_store.d.ts.map +1 -1
- package/dist/core/create_http_agent.d.ts +13 -0
- package/dist/core/create_http_agent.d.ts.map +1 -1
- package/dist/core/remote_conversation_store.d.ts +29 -1
- package/dist/core/remote_conversation_store.d.ts.map +1 -1
- package/dist/core/utils.d.ts +42 -0
- package/dist/core/utils.d.ts.map +1 -1
- package/dist/index.js +602 -104
- package/dist/index.js.map +4 -4
- package/dist/tools/is_destructive.d.ts +8 -2
- package/dist/tools/is_destructive.d.ts.map +1 -1
- package/dist/tools/parse_tool_catalog.d.ts +11 -4
- package/dist/tools/parse_tool_catalog.d.ts.map +1 -1
- package/dist/ui/render_markdown.d.ts +23 -5
- package/dist/ui/render_markdown.d.ts.map +1 -1
- package/dist/ui/resize_handle.d.ts +5 -1
- package/dist/ui/resize_handle.d.ts.map +1 -1
- package/dist/ui/ui_strings.d.ts +13 -7
- package/dist/ui/ui_strings.d.ts.map +1 -1
- package/dist/ui/voice_input.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/core/ag_ui_chat.ts +444 -45
- package/src/core/agui_client.ts +43 -2
- package/src/core/conversation_store.ts +146 -49
- package/src/core/create_http_agent.ts +24 -2
- package/src/core/remote_conversation_store.ts +45 -3
- package/src/core/utils.ts +83 -1
- package/src/tools/is_destructive.ts +8 -2
- package/src/tools/parse_tool_catalog.ts +18 -6
- package/src/ui/render_markdown.ts +111 -21
- package/src/ui/resize_handle.ts +32 -2
- package/src/ui/ui_strings.ts +19 -8
- package/src/ui/voice_input.ts +43 -0
- package/src/version.ts +1 -1
|
@@ -92,6 +92,22 @@ export declare class AgUiChat extends HTMLElement {
|
|
|
92
92
|
* `Authorization` are configured independently and neither drops the other.
|
|
93
93
|
*/
|
|
94
94
|
getHeaders: (() => Record<string, string>) | null;
|
|
95
|
+
/**
|
|
96
|
+
* Origins, besides the page's own, that this element may send {@link headers}
|
|
97
|
+
* and {@link getHeaders} credentials to without saying so on the console.
|
|
98
|
+
*
|
|
99
|
+
* Seven attributes name a URL, and every one of them carries these headers.
|
|
100
|
+
* They are plain HTML, so a page that builds one from a query parameter or
|
|
101
|
+
* from tenant-authored configuration has handed an attacker the destination,
|
|
102
|
+
* and the token leaves on the element's first request. Naming the origins you
|
|
103
|
+
* expect turns that from silent into either confirmed or reported.
|
|
104
|
+
*
|
|
105
|
+
* A notice rather than a refusal: a cross-origin agent is a documented
|
|
106
|
+
* deployment, so refusing would break working installations to defend against
|
|
107
|
+
* a page that is already interpolating untrusted data into its own markup.
|
|
108
|
+
* Leaving this empty costs nothing but one console line per foreign origin.
|
|
109
|
+
*/
|
|
110
|
+
trustedOrigins: readonly string[];
|
|
95
111
|
/**
|
|
96
112
|
* Permit `<img>` in rendered assistant markdown. **Off by default**: a
|
|
97
113
|
* model-controlled image URL is fetched with no user interaction, which
|
|
@@ -218,7 +234,18 @@ export declare class AgUiChat extends HTMLElement {
|
|
|
218
234
|
/** Attributes the element reacts to after it has been connected. */
|
|
219
235
|
static get observedAttributes(): string[];
|
|
220
236
|
attributeChangedCallback(name: string, previous: string | null, value: string | null): void;
|
|
221
|
-
/**
|
|
237
|
+
/**
|
|
238
|
+
* Declare a frontend tool the agent may call.
|
|
239
|
+
*
|
|
240
|
+
* **A handler's thrown message leaves the browser.** When a handler rejects,
|
|
241
|
+
* its `Error.message` is posted back as that call's tool result — into the
|
|
242
|
+
* conversation, on to the AG-UI endpoint, persisted server-side, and
|
|
243
|
+
* forwarded to the model provider on every later round. That is deliberate,
|
|
244
|
+
* since it is what lets the agent recover from a failure it caused; but it
|
|
245
|
+
* means an internal hostname, a signed URL or a stack-derived path in a
|
|
246
|
+
* rethrown error is disclosed to parties the host never chose. Throw the
|
|
247
|
+
* message you would be content for the model to read, and log the detail.
|
|
248
|
+
*/
|
|
222
249
|
registerTool(tool: ClientTool): void;
|
|
223
250
|
/**
|
|
224
251
|
* AG-UI **shared state** for this conversation — the protocol's own state
|
|
@@ -242,6 +269,33 @@ export declare class AgUiChat extends HTMLElement {
|
|
|
242
269
|
/** The AG-UI endpoint URL, read from the `endpoint` attribute. */
|
|
243
270
|
get endpoint(): string;
|
|
244
271
|
set endpoint(value: string);
|
|
272
|
+
/**
|
|
273
|
+
* Who the stored conversation belongs to, from the `user-key` attribute.
|
|
274
|
+
*
|
|
275
|
+
* Set it to whatever identifies the signed-in principal — a user id, an
|
|
276
|
+
* account id, a hash of one. The value joins the storage namespace, so two
|
|
277
|
+
* principals in the same tab cannot read each other's transcript, and
|
|
278
|
+
* **changing it purges what the previous one left behind**.
|
|
279
|
+
*
|
|
280
|
+
* That purge is the reason this is a live attribute rather than a
|
|
281
|
+
* connect-time one. `sessionStorage` survives same-tab navigation, so it
|
|
282
|
+
* survives a logout; and a single-page app signs out through its own router
|
|
283
|
+
* without remounting anything, so there is no other moment at which the
|
|
284
|
+
* element could find out. The host naming the new principal — or dropping the
|
|
285
|
+
* attribute — is the signal.
|
|
286
|
+
*
|
|
287
|
+
* Absent means exactly today's behaviour, which is why nothing breaks by
|
|
288
|
+
* leaving it off: the conversation is scoped to the element and to nobody in
|
|
289
|
+
* particular, and on a shared workstation it carries into whoever signs in
|
|
290
|
+
* next in the same tab.
|
|
291
|
+
*
|
|
292
|
+
* The first value to arrive is treated as a host naming the user who was
|
|
293
|
+
* already there, not as a handover: the conversation in progress moves into
|
|
294
|
+
* the principal's namespace rather than being destroyed, so an element
|
|
295
|
+
* configured by an async auth handshake keeps what is on screen.
|
|
296
|
+
*/
|
|
297
|
+
get userKey(): string;
|
|
298
|
+
set userKey(value: string);
|
|
245
299
|
/**
|
|
246
300
|
* Cookie policy for **every** request this element makes, as `fetch`'s own
|
|
247
301
|
* `credentials` mode (`"omit"` / `"same-origin"` / `"include"`). Mirrored to
|
|
@@ -352,8 +406,12 @@ export declare class AgUiChat extends HTMLElement {
|
|
|
352
406
|
*/
|
|
353
407
|
toggleCheckpoints(): void;
|
|
354
408
|
/**
|
|
355
|
-
* Start a fresh conversation:
|
|
356
|
-
*
|
|
409
|
+
* Start a fresh conversation: drop the in-memory run state, clear the
|
|
410
|
+
* transcript, and mint a new thread id.
|
|
411
|
+
*
|
|
412
|
+
* The conversation being left is kept, and stays in the history drawer to
|
|
413
|
+
* return to. Deleting one is the drawer row's own action; a button that
|
|
414
|
+
* starts something new must not be the button that destroys what was there.
|
|
357
415
|
*/
|
|
358
416
|
newChat(): void;
|
|
359
417
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ag_ui_chat.d.ts","sourceRoot":"","sources":["../../src/core/ag_ui_chat.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ag_ui_chat.d.ts","sourceRoot":"","sources":["../../src/core/ag_ui_chat.ts"],"names":[],"mappings":"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"}
|
|
@@ -87,7 +87,14 @@ export interface AgUiClientHandlers {
|
|
|
87
87
|
onActivityChanged(messageId: string, activityType: string, content: unknown): void;
|
|
88
88
|
/** Fired when a reasoning model starts emitting its chain-of-thought. */
|
|
89
89
|
onReasoningStart(): void;
|
|
90
|
-
/**
|
|
90
|
+
/**
|
|
91
|
+
* Fired on every reasoning token, and once more when the block ends.
|
|
92
|
+
*
|
|
93
|
+
* ``buffer`` is the text accumulated *before* the token that triggered the
|
|
94
|
+
* call, which is what the protocol client passes -- so the stream trails by
|
|
95
|
+
* one delta and the final call, at the end of the block, is what completes
|
|
96
|
+
* it. Render the buffer wholesale rather than appending it.
|
|
97
|
+
*/
|
|
91
98
|
onReasoningDelta(buffer: string): void;
|
|
92
99
|
/** Fired when the reasoning block ends (before the answer text streams). */
|
|
93
100
|
onReasoningEnd(): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAe,IAAI,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEpG;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,UAAU,EAAE,SAAS,SAAS,EAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,IAAI,IAAI,CAAC;IACnB,uEAAuE;IACvE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8EAA8E;IAC9E,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5E;;;;;;;;;OASG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnF,yEAAyE;IACzE,gBAAgB,IAAI,IAAI,CAAC;IACzB
|
|
1
|
+
{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"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"}
|
|
@@ -32,12 +32,24 @@ export interface ThreadMeta {
|
|
|
32
32
|
* is a small local hint a server store can derive from history and no-op.
|
|
33
33
|
*
|
|
34
34
|
* Thread enumeration backs the chat-history drawer; deleting a thread reuses
|
|
35
|
-
* {@link clear} and "new chat"
|
|
36
|
-
*
|
|
35
|
+
* {@link clear}, and "new chat" is {@link newThread} — which leaves the
|
|
36
|
+
* conversation it moves off of intact, for the drawer to offer back.
|
|
37
37
|
*/
|
|
38
38
|
export interface ClientConversationStore {
|
|
39
39
|
/** The active conversation id, generated and persisted on first read. */
|
|
40
40
|
threadId(): string;
|
|
41
|
+
/**
|
|
42
|
+
* Start a fresh conversation, make it active, and return its id.
|
|
43
|
+
*
|
|
44
|
+
* Existing threads are left where they are: "new chat" adds one, and
|
|
45
|
+
* {@link clear} is the only method that takes one away.
|
|
46
|
+
*
|
|
47
|
+
* Optional, so a store written before this method existed still works. The
|
|
48
|
+
* caller then mints the id itself and hands it to {@link setActiveThread},
|
|
49
|
+
* which loses only the store's own record that the thread is new (see
|
|
50
|
+
* {@link isUnsent}).
|
|
51
|
+
*/
|
|
52
|
+
newThread?(): string;
|
|
41
53
|
/** Load the persisted message history, or `null` when none exists. */
|
|
42
54
|
loadMessages(threadId: string): Promise<readonly Message[] | null>;
|
|
43
55
|
/** Persist the message history (and refresh the thread's drawer metadata). */
|
|
@@ -72,6 +84,23 @@ export interface ClientConversationStore {
|
|
|
72
84
|
*/
|
|
73
85
|
isUnsent?(threadId: string): boolean;
|
|
74
86
|
}
|
|
87
|
+
/**
|
|
88
|
+
* `sessionStorage.setItem` that survives a store which refuses to write.
|
|
89
|
+
*
|
|
90
|
+
* `setItem` throws on an exhausted quota (a long conversation, or one turn
|
|
91
|
+
* carrying a large tool result) and in privacy modes that deny storage
|
|
92
|
+
* altogether. Every write here is a *durability* concern — surviving a reload —
|
|
93
|
+
* and none of them is worth an exception, because of where they are called
|
|
94
|
+
* from: the element persists the transcript from inside the run loop, so an
|
|
95
|
+
* unguarded throw escapes as a run error and tells the user the agent failed
|
|
96
|
+
* when nothing but the browser's storage did. On the cancel path it escapes as
|
|
97
|
+
* an unhandled rejection instead.
|
|
98
|
+
*
|
|
99
|
+
* So a failed write loses the reload, never the conversation on screen, and
|
|
100
|
+
* says so once. Recovery is in the user's hands already: deleting the oversized
|
|
101
|
+
* thread from the history drawer is a `removeItem`, which frees the quota.
|
|
102
|
+
*/
|
|
103
|
+
export declare function writeStoredItem(key: string, value: string): void;
|
|
75
104
|
/**
|
|
76
105
|
* Default {@link ClientConversationStore}: per-tab `sessionStorage`.
|
|
77
106
|
*
|
|
@@ -83,12 +112,38 @@ export interface ClientConversationStore {
|
|
|
83
112
|
* An optional `namespace` scopes every key to one element, so two
|
|
84
113
|
* `<ag-ui-chat>` instances on the same origin keep separate active-thread
|
|
85
114
|
* pointers and drawer indexes instead of clobbering each other. The default
|
|
86
|
-
* empty namespace keeps the origin-global keys
|
|
115
|
+
* empty namespace keeps the origin-global keys, which a namespaced store adopts
|
|
116
|
+
* on construction; see {@link SessionStorageStore.adopt}.
|
|
87
117
|
*/
|
|
88
118
|
export declare class SessionStorageStore implements ClientConversationStore {
|
|
89
119
|
#private;
|
|
90
120
|
constructor(namespace?: string);
|
|
121
|
+
/**
|
|
122
|
+
* Move every key a store owns out of `from`'s namespace and into `to`'s.
|
|
123
|
+
*
|
|
124
|
+
* Two callers, one move. The constructor adopts the pre-namespacing global
|
|
125
|
+
* keys (`from` = `""`); `<ag-ui-chat>` adopts an element-scoped conversation
|
|
126
|
+
* into a principal-scoped one the first time a `user-key` arrives, which is a
|
|
127
|
+
* host naming the user who was already there rather than a handover.
|
|
128
|
+
*
|
|
129
|
+
* Only this store's own suffixes move — the element's `collapsed` / `size` /
|
|
130
|
+
* `theme` keys share the global root and are deliberately left where they
|
|
131
|
+
* are. A value already present at the destination wins: the destination is
|
|
132
|
+
* the durable record and the source is the stray this move exists to clear.
|
|
133
|
+
*/
|
|
134
|
+
static adopt(from: string, to: string): void;
|
|
135
|
+
/**
|
|
136
|
+
* Forget everything a store holds for `namespace`.
|
|
137
|
+
*
|
|
138
|
+
* The logout primitive: `<ag-ui-chat>` calls it when its `user-key` changes,
|
|
139
|
+
* and a host driving its own store can call it from its own sign-out path.
|
|
140
|
+
* Deliberately narrow — it removes only keys under this exact namespace whose
|
|
141
|
+
* suffix parses as one this store writes, so it can never reach another
|
|
142
|
+
* element's conversation or the host's own `sessionStorage` entries.
|
|
143
|
+
*/
|
|
144
|
+
static purge(namespace: string): void;
|
|
91
145
|
threadId(): string;
|
|
146
|
+
newThread(): string;
|
|
92
147
|
isUnsent(threadId: string): boolean;
|
|
93
148
|
loadMessages(threadId: string): Promise<readonly Message[] | null>;
|
|
94
149
|
saveMessages(threadId: string, messages: readonly Message[]): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/conversation_store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,IAAI,MAAM,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IACnE,0EAA0E;IAC1E,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;IAChF,+EAA+E;IAC/E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gEAAgE;IAChE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;
|
|
1
|
+
{"version":3,"file":"conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/conversation_store.ts"],"names":[],"mappings":"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"}
|
|
@@ -30,6 +30,19 @@ export interface HttpAgentOptions {
|
|
|
30
30
|
* server streams `STATE_SNAPSHOT` / `STATE_DELTA`.
|
|
31
31
|
*/
|
|
32
32
|
initialState?: Readonly<Record<string, unknown>>;
|
|
33
|
+
/**
|
|
34
|
+
* Origins, besides the document's own, this agent may carry the host's
|
|
35
|
+
* credentials to.
|
|
36
|
+
*
|
|
37
|
+
* Running the agent on another subdomain is a normal deployment and stays
|
|
38
|
+
* supported, so a cross-origin endpoint is not refused — it is *announced*,
|
|
39
|
+
* once per origin, on the console. Listing an origin here says the
|
|
40
|
+
* destination was chosen deliberately and silences the notice for it.
|
|
41
|
+
*
|
|
42
|
+
* Entries are compared as serialized origins (`https://agent.example.com`,
|
|
43
|
+
* scheme and port included), which is what `URL.origin` produces.
|
|
44
|
+
*/
|
|
45
|
+
trustedOrigins?: readonly string[];
|
|
33
46
|
}
|
|
34
47
|
/**
|
|
35
48
|
* Build an AG-UI {@link HttpAgent} pointed at `endpoint`.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create_http_agent.d.ts","sourceRoot":"","sources":["../../src/core/create_http_agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"create_http_agent.d.ts","sourceRoot":"","sources":["../../src/core/create_http_agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAqCxE;AAED,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,aAAa,CAAC"}
|
|
@@ -23,12 +23,40 @@ type CredentialsProvider = () => RequestCredentials | undefined;
|
|
|
23
23
|
* the fallback when a request fails. Rename and delete apply optimistically via
|
|
24
24
|
* a local overlay, so the drawer reflects them before the fire-and-forget
|
|
25
25
|
* round-trip lands.
|
|
26
|
+
*
|
|
27
|
+
* Pass `cacheMessages: false` to keep message bodies out of the browser
|
|
28
|
+
* entirely; see the constructor.
|
|
26
29
|
*/
|
|
27
30
|
export declare class RemoteConversationStore implements ClientConversationStore {
|
|
28
31
|
#private;
|
|
29
|
-
|
|
32
|
+
/**
|
|
33
|
+
* @param cacheMessages Whether to mirror message bodies into the local store.
|
|
34
|
+
*
|
|
35
|
+
* `true` (the default, and the behaviour this class has always had) keeps a
|
|
36
|
+
* local copy of every turn, so the transcript still replays when the thread
|
|
37
|
+
* endpoint is unreachable. `false` is for the deployment that chose a
|
|
38
|
+
* server-backed store precisely so transcripts do not sit in the browser:
|
|
39
|
+
* regulated content, a shared workstation, an operator who has to be able to
|
|
40
|
+
* say where the conversation lives. It is not the same as passing a local
|
|
41
|
+
* store that does nothing — the local store also owns the active thread id,
|
|
42
|
+
* the navigation checkpoint and the "nothing sent here yet" marker, all of
|
|
43
|
+
* which must keep working — so the opt-out is scoped to the bodies alone.
|
|
44
|
+
*
|
|
45
|
+
* The cost is deliberate and worth stating: with no local copy there is
|
|
46
|
+
* nothing to fall back to, so a failed request shows an empty transcript
|
|
47
|
+
* rather than a stale one, and the drawer's offline list loses its previews
|
|
48
|
+
* (a preview is an excerpt of a message, which is the very thing being kept
|
|
49
|
+
* off the client).
|
|
50
|
+
*/
|
|
51
|
+
constructor(url: string, headers?: HeadersProvider, local?: ClientConversationStore, credentials?: CredentialsProvider, cacheMessages?: boolean);
|
|
30
52
|
threadId(): string;
|
|
31
53
|
setActiveThread(threadId: string): void;
|
|
54
|
+
/**
|
|
55
|
+
* Delegated to the local store, which owns the active id — and deliberately
|
|
56
|
+
* silent on the wire: the server learns of a thread when its first message is
|
|
57
|
+
* persisted, so an abandoned new chat costs no round-trip and leaves no row.
|
|
58
|
+
*/
|
|
59
|
+
newThread(): string;
|
|
32
60
|
/** Delegated, so wrapping a store does not lose what it knows about its own ids. */
|
|
33
61
|
isUnsent(threadId: string): boolean;
|
|
34
62
|
saveMessages(threadId: string, messages: readonly Message[]): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"remote_conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/remote_conversation_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAWjC,sFAAsF;AACtF,KAAK,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;GAIG;AACH,KAAK,mBAAmB,GAAG,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAEhE
|
|
1
|
+
{"version":3,"file":"remote_conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/remote_conversation_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAWjC,sFAAsF;AACtF,KAAK,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;GAIG;AACH,KAAK,mBAAmB,GAAG,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;;IASrE;;;;;;;;;;;;;;;;;;OAkBG;IACH,YACE,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAA4B,EACrC,KAAK,GAAE,uBAAmD,EAC1D,WAAW,GAAE,mBAAqC,EAClD,aAAa,UAAO,EAOrB;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED;;;;OAIG;IACH,SAAS,IAAI,MAAM,CAElB;IAED,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElC;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAWjE;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAE5D;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE9E;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIlD;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI5B;IAEK,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAMlD;IAEK,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAsBvE;CAoEF"}
|
package/dist/core/utils.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { ClientConversationStore } from "./conversation_store.js";
|
|
1
2
|
/**
|
|
2
3
|
* Overlay a `credentials` mode onto a fetch `init`, or hand the `init` back
|
|
3
4
|
* untouched when none is configured.
|
|
@@ -7,4 +8,45 @@
|
|
|
7
8
|
* where the point is to leave the browser's own default in place.
|
|
8
9
|
*/
|
|
9
10
|
export declare function withCredentials(init: RequestInit | undefined, credentials: RequestCredentials | undefined): RequestInit | undefined;
|
|
11
|
+
/**
|
|
12
|
+
* Start a new conversation in `store` and return its id.
|
|
13
|
+
*
|
|
14
|
+
* `newThread` is optional on the interface, so a store that predates it is
|
|
15
|
+
* driven the only other way the interface allows: mint an id here and make it
|
|
16
|
+
* active. That path loses the store's own note that the thread is new, so a
|
|
17
|
+
* remote store would go on to ask the server for a conversation that cannot
|
|
18
|
+
* exist yet — which is why every store in this package implements the method.
|
|
19
|
+
*
|
|
20
|
+
* What neither path does is clear the thread being left behind. Starting a
|
|
21
|
+
* conversation is not a reason to destroy the previous one.
|
|
22
|
+
*/
|
|
23
|
+
export declare function mintThread(store: ClientConversationStore): string;
|
|
24
|
+
/**
|
|
25
|
+
* Announce host credentials about to leave the document's origin.
|
|
26
|
+
*
|
|
27
|
+
* `endpoint` and its six sibling URL attributes are plain HTML, and a page that
|
|
28
|
+
* interpolates one from a query parameter or from tenant-authored
|
|
29
|
+
* configuration has handed an attacker the destination. The browser preflights
|
|
30
|
+
* the custom header, any server willing to answer `Access-Control-Allow-Headers`
|
|
31
|
+
* receives it, and the token leaves on the element's very first request —
|
|
32
|
+
* before the user has done anything. Nothing else in this package compares a
|
|
33
|
+
* configured URL against an expected origin, so without this the delivery is
|
|
34
|
+
* silent, which is the only part of that sequence worth changing.
|
|
35
|
+
*
|
|
36
|
+
* A warning rather than a refusal because a cross-origin agent is a documented
|
|
37
|
+
* deployment: refusing would break working installations to defend against a
|
|
38
|
+
* page that is already interpolating untrusted data into its own markup. What
|
|
39
|
+
* it removes is the silence.
|
|
40
|
+
*
|
|
41
|
+
* `warned` is supplied by the caller rather than held here, per this package's
|
|
42
|
+
* rule against shared mutable state: two elements on one page must each get
|
|
43
|
+
* their own notice, and the set lives exactly as long as its owner.
|
|
44
|
+
*
|
|
45
|
+
* Every configured URL goes through this, not the agent endpoint alone. The
|
|
46
|
+
* tool catalog, the skills list, the thread and attachment endpoints and the
|
|
47
|
+
* upload target are all named by the same kind of host attribute and all carry
|
|
48
|
+
* the same headers, so covering one of them and not the rest would report the
|
|
49
|
+
* least interesting of the seven.
|
|
50
|
+
*/
|
|
51
|
+
export declare function warnOnCrossOriginCredentials(url: string | URL, credentialNames: readonly string[], trustedOrigins: readonly string[], warned: Set<string>): void;
|
|
10
52
|
//# sourceMappingURL=utils.d.ts.map
|
package/dist/core/utils.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,WAAW,GAAG,SAAS,CAEzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAOjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,eAAe,EAAE,SAAS,MAAM,EAAE,EAClC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAClB,IAAI,CAwBN"}
|