agl 43.14.0 → 44.0.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.
Files changed (89) hide show
  1. package/changelog.md +22 -0
  2. package/dist_serve/bundle.js +4473 -4235
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +29 -29
  5. package/dist_serve/bundle.js.third-party-notices.txt +29 -29
  6. package/dist_ts/00_commitinfo_data.js +2 -2
  7. package/dist_ts/aglapi/aglapisurface.document.js +37 -4
  8. package/dist_ts/classes.authstore.d.ts +60 -3
  9. package/dist_ts/classes.authstore.js +161 -13
  10. package/dist_ts/classes.controller.d.ts +63 -0
  11. package/dist_ts/classes.controller.js +502 -43
  12. package/dist_ts/classes.embeddeddb.js +7 -2
  13. package/dist_ts/classes.flexmodels.private.d.ts +39 -0
  14. package/dist_ts/classes.flexmodels.private.js +127 -1
  15. package/dist_ts/classes.flexprojectpreparation.d.ts +21 -0
  16. package/dist_ts/classes.flexprojectpreparation.js +69 -0
  17. package/dist_ts/classes.flexpromptqueue.d.ts +21 -1
  18. package/dist_ts/classes.flexpromptqueue.js +67 -7
  19. package/dist_ts/classes.flexrequestqueue.d.ts +11 -0
  20. package/dist_ts/classes.flexrequestqueue.js +40 -0
  21. package/dist_ts/classes.flexservice.d.ts +46 -14
  22. package/dist_ts/classes.flexservice.js +179 -55
  23. package/dist_ts/classes.flexstore.d.ts +68 -3
  24. package/dist_ts/classes.flexstore.js +277 -11
  25. package/dist_ts/classes.flexsubmissionmodels.d.ts +58 -0
  26. package/dist_ts/classes.flexsubmissionmodels.js +162 -0
  27. package/dist_ts/classes.flexsubmissionstore.d.ts +70 -0
  28. package/dist_ts/classes.flexsubmissionstore.js +323 -0
  29. package/dist_ts/classes.flexsupervisor.d.ts +10 -0
  30. package/dist_ts/classes.flexsupervisor.js +27 -1
  31. package/dist_ts/classes.harnessoperationmanager.d.ts +31 -0
  32. package/dist_ts/classes.harnessoperationmanager.js +69 -7
  33. package/dist_ts/classes.pendingpromptstore.d.ts +11 -3
  34. package/dist_ts/classes.pendingpromptstore.js +66 -10
  35. package/dist_ts/classes.sessionidentityservice.d.ts +18 -1
  36. package/dist_ts/classes.sessionidentityservice.js +34 -4
  37. package/dist_ts/classes.validation.d.ts +3 -0
  38. package/dist_ts/classes.validation.js +50 -1
  39. package/dist_ts/functions.deviceapi.js +3 -1
  40. package/dist_ts/interfaces.auth.d.ts +3 -1
  41. package/dist_ts/interfaces.auth.js +1 -1
  42. package/dist_ts/interfaces.flexipc.d.ts +29 -5
  43. package/dist_ts/interfaces.flexipc.js +13 -4
  44. package/dist_ts_authswitch/classes.authoritydatabase.d.ts +1 -0
  45. package/dist_ts_authswitch/classes.authoritydatabase.js +17 -5
  46. package/dist_ts_interfaces/flexadmission.d.ts +69 -0
  47. package/dist_ts_interfaces/flexadmission.js +2 -0
  48. package/dist_ts_interfaces/index.d.ts +1 -0
  49. package/dist_ts_interfaces/index.js +2 -1
  50. package/dist_ts_interfaces/interfaces.d.ts +10 -1
  51. package/dist_ts_interfaces/interfaces.js +2 -2
  52. package/dist_ts_interfaces/requests.d.ts +2 -1
  53. package/dist_ts_interfaces/requests.js +1 -1
  54. package/dist_ts_migration/v10_flexharnessv3migration.js +4 -1
  55. package/docs/nosqldb11-migration.md +59 -0
  56. package/package.json +10 -9
  57. package/readme.md +5 -1
  58. package/ts/00_commitinfo_data.ts +1 -1
  59. package/ts/aglapi/aglapisurface.document.ts +36 -3
  60. package/ts/classes.authstore.ts +179 -11
  61. package/ts/classes.controller.ts +498 -40
  62. package/ts/classes.embeddeddb.ts +6 -1
  63. package/ts/classes.flexmodels.private.ts +109 -0
  64. package/ts/classes.flexprojectpreparation.ts +69 -0
  65. package/ts/classes.flexpromptqueue.ts +69 -6
  66. package/ts/classes.flexrequestqueue.ts +47 -0
  67. package/ts/classes.flexservice.ts +187 -51
  68. package/ts/classes.flexstore.ts +352 -10
  69. package/ts/classes.flexsubmissionmodels.ts +89 -0
  70. package/ts/classes.flexsubmissionstore.ts +312 -0
  71. package/ts/classes.flexsupervisor.ts +26 -0
  72. package/ts/classes.harnessoperationmanager.ts +79 -6
  73. package/ts/classes.pendingpromptstore.ts +55 -6
  74. package/ts/classes.sessionidentityservice.ts +33 -2
  75. package/ts/classes.validation.ts +42 -0
  76. package/ts/functions.deviceapi.ts +2 -0
  77. package/ts/interfaces.auth.ts +3 -1
  78. package/ts/interfaces.flexipc.ts +38 -4
  79. package/ts_authswitch/classes.authoritydatabase.ts +19 -5
  80. package/ts_interfaces/flexadmission.ts +52 -0
  81. package/ts_interfaces/index.ts +2 -0
  82. package/ts_interfaces/interfaces.ts +10 -1
  83. package/ts_interfaces/requests.ts +3 -0
  84. package/ts_migration/v10_flexharnessv3migration.ts +3 -0
  85. package/ts_web/00_commitinfo_data.ts +1 -1
  86. package/ts_web/classes.browsersubmissions.ts +279 -0
  87. package/ts_web/classes.sessiondraftsync.ts +64 -1
  88. package/ts_web/elements.harnesscontrollerapp.ts +340 -5
  89. package/ts_web/functions.flexsubmissions.ts +88 -0
@@ -0,0 +1,88 @@
1
+ import * as plugins from './plugins.js';
2
+ import type * as interfaces from '../ts_interfaces/index.js';
3
+ import type { IBrowserSubmission } from './classes.browsersubmissions.js';
4
+
5
+ export type TFlexBrowserSubmission = IBrowserSubmission<
6
+ interfaces.IControllerFlexSubmissionInput,
7
+ interfaces.IControllerFlexSubmissionReceipt
8
+ >;
9
+
10
+ /** A receipt changes routing and releases ordered followers: never trust a malformed readback. */
11
+ export const checkedFlexSubmissionReceipt = (
12
+ valueArg: unknown,
13
+ inputArg: interfaces.IControllerFlexSubmissionInput,
14
+ ): interfaces.IControllerFlexSubmissionReceipt => {
15
+ const receipt = valueArg as Partial<interfaces.IControllerFlexSubmissionReceipt> | null;
16
+ const text = (value: unknown): value is string => typeof value === 'string' && value.length > 0;
17
+ const integer = (value: unknown): boolean => Number.isSafeInteger(value) && (value as number) >= 0;
18
+ if (!receipt || receipt.version !== 1 || receipt.projectId !== inputArg.projectId
19
+ || receipt.clientMessageId !== inputArg.clientMessageId || !text(receipt.operationId)
20
+ || receipt.sessionId?.harnessId !== 'flex' || !text(receipt.sessionId.nativeId)
21
+ || !text(receipt.sessionGenerationId) || !integer(receipt.serverSequence) || !integer(receipt.acceptedAt)
22
+ || (receipt.sessionGenerationSequence !== undefined && !integer(receipt.sessionGenerationSequence))
23
+ || !['waiting', 'handedOver', 'held', 'settled'].includes(receipt.state ?? '')
24
+ || !['pending', 'ready', 'uncertain', 'retired'].includes(receipt.creation ?? '')
25
+ || (receipt.sessionIdentityId !== undefined && !text(receipt.sessionIdentityId))
26
+ || (inputArg.conversation.kind === 'new' && receipt.clientConversationId !== inputArg.conversation.clientConversationId)
27
+ || (inputArg.conversation.kind === 'existing' && (
28
+ receipt.sessionId.nativeId !== inputArg.conversation.sessionId.nativeId
29
+ || receipt.sessionIdentityId !== inputArg.conversation.sessionIdentityId
30
+ ))) throw new Error('The controller returned an unverifiable submission receipt. Admission remains unconfirmed; this message will not be resent.');
31
+ return structuredClone(receipt as interfaces.IControllerFlexSubmissionReceipt);
32
+ };
33
+
34
+ /** Refusals the controller raises before its admission transaction for a state that passes. */
35
+ const transientFlexSubmissionCodes: ReadonlySet<string> = new Set(['flex_not_ready', 'operation_limit']);
36
+
37
+ export const flexSubmissionFailure = (errorArg: unknown): { definite: boolean; transient: boolean; message: string } => {
38
+ const code = errorArg instanceof plugins.typedrequest.TypedResponseError ? errorArg.errorData?.code : undefined;
39
+ // Only a named controller refusal proves non-admission. A fault, timeout, malformed answer or
40
+ // lost transport may follow the commit and must keep the exact ID fenced for readback.
41
+ const definite = typeof code === 'string' && new Set([
42
+ 'invalid_request', 'concurrent_change', 'session_not_found', 'project_not_found',
43
+ 'session_read_only', 'operation_limit', 'controller_upgrading', 'flex_not_ready',
44
+ 'provider_reauth_required', 'provider_unavailable', 'model_unavailable', 'delivery_unsupported',
45
+ 'attachments_unsupported', 'attachment_limit', 'message_rate_limited',
46
+ ]).has(code);
47
+ return {
48
+ definite,
49
+ // `concurrent_change` and `outcome_unknown` are never sent again; an unknown outcome is read back.
50
+ transient: definite && typeof code === 'string' && transientFlexSubmissionCodes.has(code),
51
+ message: definite
52
+ ? `${errorArg instanceof Error ? errorArg.message : 'The controller refused the message.'} Nothing was admitted. The captured message stays here; your next draft is unchanged.`
53
+ : 'Admission unconfirmed. Check its receipt after reconnecting; this message will not be resent.',
54
+ };
55
+ };
56
+
57
+ /** Local feedback stays distinct from durable acceptance and from native context retention. */
58
+ export const flexSubmissionMessage = (entryArg: TFlexBrowserSubmission): plugins.deesCatalog.IHarnessMessage => {
59
+ const receipt = entryArg.receipt;
60
+ let pending: plugins.deesCatalog.THarnessPendingState = 'submitting';
61
+ let error = entryArg.error;
62
+ if (entryArg.state === 'unknown') pending = 'uncertain';
63
+ if (entryArg.state === 'blocked') {
64
+ pending = 'held';
65
+ error = 'Not submitted. Waiting for the preceding message’s admission or conversation creation to be confirmed.';
66
+ }
67
+ if (entryArg.state === 'refused') pending = 'held';
68
+ if (receipt) {
69
+ if (receipt.creation === 'uncertain' || receipt.state === 'settled') {
70
+ pending = 'uncertain';
71
+ error = receipt.creation === 'uncertain'
72
+ ? 'Admission acknowledged; conversation creation is unconfirmed. This message will not be resent.'
73
+ : 'Admission acknowledged; awaiting the exact native message. Native acceptance alone does not prove retention in context.';
74
+ } else if (receipt.state === 'held' || receipt.creation === 'retired') {
75
+ pending = receipt.heldReason === 'uncertain' || receipt.heldReason === 'interrupted' ? 'uncertain' : 'held';
76
+ error = 'Admission acknowledged. The controller holds this message; open its conversation to inspect its durable state.';
77
+ } else {
78
+ pending = receipt.state === 'handedOver' && entryArg.snapshot.delivery === 'steer' ? 'steering' : 'queued';
79
+ }
80
+ }
81
+ return {
82
+ id: receipt ? JSON.stringify(['flex', receipt.operationId]) : entryArg.id,
83
+ role: 'user', text: entryArg.snapshot.text, createdAt: entryArg.createdAt, markdown: false,
84
+ attachments: entryArg.snapshot.attachments.map((attachment) => ({ ...attachment })),
85
+ pending, heldActions: [], pendingActionAvailable: false,
86
+ ...(error ? { error } : {}),
87
+ };
88
+ };