@arke-institute/rhiza 0.7.0 → 0.7.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.
package/dist/logging/writer.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Log Writer - SDK utilities for writing klados logs
|
|
3
3
|
*
|
|
4
|
-
* Uses fire-and-forget additive updates for log relationships
|
|
5
|
-
*
|
|
4
|
+
* Uses fire-and-forget additive updates for log relationships.
|
|
5
|
+
* Status updates use CAS retry to ensure immediate visibility.
|
|
6
6
|
*/
|
|
7
7
|
import type { ArkeClient } from '@arke-institute/sdk';
|
|
8
8
|
import type { KladosLogEntry, LogMessage, HandoffRecord } from '../types';
|
|
@@ -66,7 +66,8 @@ export interface UpdateLogStatusOptions {
|
|
|
66
66
|
/**
|
|
67
67
|
* Update log entry status (e.g., to done or error)
|
|
68
68
|
*
|
|
69
|
-
*
|
|
69
|
+
* Returns a promise that resolves when the additive update is queued.
|
|
70
|
+
* The actual update is eventually consistent.
|
|
70
71
|
*/
|
|
71
|
-
export declare function updateLogStatus(client: ArkeClient, logFileId: string, status: 'running' | 'done' | 'error', options?: UpdateLogStatusOptions): void
|
|
72
|
+
export declare function updateLogStatus(client: ArkeClient, logFileId: string, status: 'running' | 'done' | 'error', options?: UpdateLogStatusOptions): Promise<void>;
|
|
72
73
|
//# sourceMappingURL=writer.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/logging/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EAEd,UAAU,EACV,aAAa,EACd,MAAM,UAAU,CAAC;AA+BlB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IAEnB,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IAExB,4BAA4B;IAC5B,KAAK,EAAE,cAAc,CAAC;IAEtB,kCAAkC;IAClC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,
|
|
1
|
+
{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/logging/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EAEd,UAAU,EACV,aAAa,EACd,MAAM,UAAU,CAAC;AA+BlB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IAEnB,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IAExB,4BAA4B;IAC5B,KAAK,EAAE,cAAc,CAAC;IAEtB,kCAAkC;IAClC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAyGzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EAAE,GACxB,IAAI,CAYN;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,EACpC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmCf"}
|
package/dist/logging/writer.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Log Writer - SDK utilities for writing klados logs
|
|
3
3
|
*
|
|
4
|
-
* Uses fire-and-forget additive updates for log relationships
|
|
5
|
-
*
|
|
4
|
+
* Uses fire-and-forget additive updates for log relationships.
|
|
5
|
+
* Status updates use CAS retry to ensure immediate visibility.
|
|
6
6
|
*/
|
|
7
7
|
/**
|
|
8
8
|
* Queue additive updates (fire-and-forget)
|
|
@@ -89,21 +89,25 @@ export async function writeKladosLog(options) {
|
|
|
89
89
|
}
|
|
90
90
|
// 5. Update parent logs to add sent_to relationship pointing to this log
|
|
91
91
|
// This enables traversal using only outgoing relationships (no indexing lag)
|
|
92
|
-
//
|
|
92
|
+
// IMPORTANT: Must await these updates - they're critical for tree traversal
|
|
93
93
|
if (hasParentLogs) {
|
|
94
94
|
const parentLogIds = entry.received.from_logs;
|
|
95
95
|
// Batch all parent updates into a single additive call (max 100 per call)
|
|
96
96
|
const BATCH_SIZE = 100;
|
|
97
97
|
for (let i = 0; i < parentLogIds.length; i += BATCH_SIZE) {
|
|
98
98
|
const batch = parentLogIds.slice(i, i + BATCH_SIZE);
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
99
|
+
await client.api.POST('/updates/additive', {
|
|
100
|
+
body: {
|
|
101
|
+
updates: batch.map(parentLogId => ({
|
|
102
|
+
entity_id: parentLogId,
|
|
103
|
+
relationships_add: [{
|
|
104
|
+
predicate: 'sent_to',
|
|
105
|
+
peer: logEntityId,
|
|
106
|
+
}],
|
|
107
|
+
note: 'Add sent_to relationship from parent log',
|
|
108
|
+
})),
|
|
109
|
+
},
|
|
110
|
+
});
|
|
107
111
|
}
|
|
108
112
|
}
|
|
109
113
|
return { logId: entry.id, fileId: logEntityId };
|
|
@@ -130,9 +134,10 @@ export function updateLogWithHandoffs(client, logFileId, handoffs) {
|
|
|
130
134
|
/**
|
|
131
135
|
* Update log entry status (e.g., to done or error)
|
|
132
136
|
*
|
|
133
|
-
*
|
|
137
|
+
* Returns a promise that resolves when the additive update is queued.
|
|
138
|
+
* The actual update is eventually consistent.
|
|
134
139
|
*/
|
|
135
|
-
export function updateLogStatus(client, logFileId, status, options) {
|
|
140
|
+
export async function updateLogStatus(client, logFileId, status, options) {
|
|
136
141
|
const { logError, messages } = options ?? {};
|
|
137
142
|
const completedAt = new Date().toISOString();
|
|
138
143
|
// Build the nested property update
|
|
@@ -149,13 +154,18 @@ export function updateLogStatus(client, logFileId, status, options) {
|
|
|
149
154
|
if (messages) {
|
|
150
155
|
logDataUpdate.messages = messages;
|
|
151
156
|
}
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
157
|
+
// Await additive update to ensure request is sent before worker terminates
|
|
158
|
+
await client.api.POST('/updates/additive', {
|
|
159
|
+
body: {
|
|
160
|
+
updates: [{
|
|
161
|
+
entity_id: logFileId,
|
|
162
|
+
properties: {
|
|
163
|
+
status, // Top-level for easy querying
|
|
164
|
+
log_data: logDataUpdate,
|
|
165
|
+
},
|
|
166
|
+
note: `Update log status to ${status}`,
|
|
167
|
+
}],
|
|
168
|
+
},
|
|
169
|
+
});
|
|
160
170
|
}
|
|
161
171
|
//# sourceMappingURL=writer.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/logging/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,MAAkB,EAClB,OASE;IAEF,gCAAgC;IAChC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE;QACnC,IAAI,EAAE,EAAE,OAAO,EAAE;KAClB,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAkCD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAwB;IAExB,MAAM,EACJ,MAAM,EACN,eAAe,EACf,KAAK,EACL,QAAQ,EACR,OAAO,EACP,YAAY,GACb,GAAG,OAAO,CAAC;IAEZ,8BAA8B;IAC9B,MAAM,MAAM,GAAW;QACrB,KAAK;QACL,QAAQ,EAAE,OAAO;QACjB,aAAa,EAAE,YAAY;QAC3B,QAAQ;KACT,CAAC;IAEF,iCAAiC;IACjC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE;QACjF,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE;gBACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,MAA4C;aACvD;SACF;KACF,CAAC,CAAC;IAEH,IAAI,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,kCAAkC,eAAe,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAC1H,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC;IACjC,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAEtF,2DAA2D;IAC3D,MAAM,aAAa,GAGd,EAAE,CAAC;IAER,sDAAsD;IACtD,2DAA2D;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAU,EAAE,CAAC;YACpD,aAAa,CAAC,IAAI,CAAC;gBACjB,SAAS,EAAE,eAAe;gBAC1B,IAAI,EAAE,WAAW;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,oBAAoB,CAAC,MAAM,EAAE,CAAC;gBAC5B,SAAS,EAAE,WAAW;gBACtB,iBAAiB,EAAE,aAAa;gBAChC,IAAI,EAAE,wCAAwC;aAC/C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,oBAAoB,CAAC,MAAM,EAAE,CAAC;gBAC5B,SAAS,EAAE,eAAe;gBAC1B,iBAAiB,EAAE,CAAC;wBAClB,SAAS,EAAE,WAAW;wBACtB,IAAI,EAAE,WAAW;qBAClB,CAAC;gBACF,IAAI,EAAE,8CAA8C;aACrD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,yEAAyE;IACzE,6EAA6E;IAC7E,
|
|
1
|
+
{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/logging/writer.ts"],"names":[],"mappings":"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"}
|