aegiscode 7.0.24 → 7.0.26

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 (113) hide show
  1. package/package.json +7 -3
  2. package/scripts/check.mjs +52 -1
  3. package/scripts/demo.mjs +94 -1
  4. package/scripts/predist.mjs +75 -1
  5. package/scripts/runtests.mjs +56 -1
  6. package/scripts/seal-gate.mjs +74 -1
  7. package/src/agents.js +139 -1
  8. package/src/app.js +2957 -1
  9. package/src/art.js +289 -1
  10. package/src/chatflow.js +3023 -1
  11. package/src/checkpoint.js +90 -1
  12. package/src/clipboard.js +424 -1
  13. package/src/cloudsync.js +528 -1
  14. package/src/commands.js +4089 -1
  15. package/src/config.js +581 -1
  16. package/src/connect.js +349 -1
  17. package/src/credentials.js +33 -1
  18. package/src/deps.js +232 -1
  19. package/src/devrun.js +187 -1
  20. package/src/diff.js +333 -1
  21. package/src/diffview.js +296 -1
  22. package/src/engine.js +297 -1
  23. package/src/entitlement.js +355 -1
  24. package/src/events.js +707 -1
  25. package/src/export.js +67 -1
  26. package/src/filepreview.js +153 -1
  27. package/src/fingerprint.js +592 -1
  28. package/src/format.js +259 -1
  29. package/src/fuzzy.js +119 -1
  30. package/src/history.js +423 -1
  31. package/src/init.js +175 -1
  32. package/src/input.js +139 -1
  33. package/src/keys.js +183 -1
  34. package/src/markdown.js +306 -1
  35. package/src/models.js +507 -1
  36. package/src/naming.js +57 -1
  37. package/src/overlays.js +462 -1
  38. package/src/panels.js +1418 -1
  39. package/src/ping.js +226 -1
  40. package/src/presence.js +238 -1
  41. package/src/render.js +516 -1
  42. package/src/screen.js +518 -1
  43. package/src/screens.js +896 -1
  44. package/src/secret.js +59 -1
  45. package/src/securefs.js +359 -1
  46. package/src/settings.js +155 -1
  47. package/src/shared.js +52 -1
  48. package/src/sharedpaths.js +53 -1
  49. package/src/signup.js +156 -1
  50. package/src/summarize.js +95 -1
  51. package/src/sysdiag.js +585 -1
  52. package/src/system.js +40 -1
  53. package/src/theme.js +570 -1
  54. package/src/title.js +220 -1
  55. package/src/todos.js +115 -1
  56. package/src/tokens.js +263 -1
  57. package/src/topup.js +210 -1
  58. package/src/update.js +191 -1
  59. package/vendor/client/aegis.js +2441 -1
  60. package/vendor/client/attest.js +518 -1
  61. package/vendor/client/authorship-key.js +410 -1
  62. package/vendor/client/auto-provision.js +134 -1
  63. package/vendor/client/brain-catalog.js +268 -1
  64. package/vendor/client/byok-catalog.js +199 -1
  65. package/vendor/client/catalog-client.js +487 -1
  66. package/vendor/client/conversation-export.js +177 -1
  67. package/vendor/client/credentials.js +494 -1
  68. package/vendor/client/device-fingerprint.js +141 -1
  69. package/vendor/client/drive-connect.js +110 -1
  70. package/vendor/client/drive-upload.js +234 -1
  71. package/vendor/client/env-file.js +1273 -1
  72. package/vendor/client/fingerprint.js +1064 -1
  73. package/vendor/client/foreign-memory.js +669 -1
  74. package/vendor/client/google-signin.js +133 -1
  75. package/vendor/client/hooks.js +430 -1
  76. package/vendor/client/model-discovery.js +373 -1
  77. package/vendor/client/naming.js +283 -1
  78. package/vendor/client/platform.js +937 -1
  79. package/vendor/client/prefs.js +351 -1
  80. package/vendor/client/presence-constants.js +107 -1
  81. package/vendor/client/presence.js +438 -1
  82. package/vendor/client/record-vault.js +1055 -3
  83. package/vendor/client/session-store.js +575 -1
  84. package/vendor/client/topup.js +297 -1
  85. package/vendor/client/touch.js +458 -1
  86. package/vendor/client/update.js +763 -1
  87. package/vendor/client/user-models.js +381 -1
  88. package/vendor/desktop/lib/local/agents.js +105 -1
  89. package/vendor/desktop/lib/local/attachments.js +276 -1
  90. package/vendor/desktop/lib/local/autonomous.js +1045 -1
  91. package/vendor/desktop/lib/local/claude-pro.js +1028 -1
  92. package/vendor/desktop/lib/local/context.js +125 -1
  93. package/vendor/desktop/lib/local/engine.js +3666 -1
  94. package/vendor/desktop/lib/local/entitlement.js +660 -1
  95. package/vendor/desktop/lib/local/git-scope.js +228 -1
  96. package/vendor/desktop/lib/local/local.js +2145 -1
  97. package/vendor/desktop/lib/local/prompt.js +280 -1
  98. package/vendor/desktop/lib/local/queue.js +560 -1
  99. package/vendor/desktop/lib/local/session-rounds.js +238 -1
  100. package/vendor/desktop/lib/local/spill.js +75 -1
  101. package/vendor/desktop/lib/local/turn-guard.js +300 -1
  102. package/vendor/desktop/lib/local/worktree-lock.js +235 -1
  103. package/vendor/desktop/lib/settings.js +890 -1
  104. package/vendor/desktop/renderer/usage.js +1239 -1
  105. package/vendor/hosts/install.js +638 -1
  106. package/vendor/hosts/openai-shim.js +515 -1
  107. package/vendor/hosts/spec.js +164 -1
  108. package/vendor/hosts/targets.js +346 -1
  109. package/vendor/mcp/server.js +221 -1
  110. package/vendor/mcp/tools.js +408 -1
  111. package/vendor/one/src/child.js +285 -1
  112. package/vendor/one/src/permissions.js +383 -1
  113. package/SOURCE-OFFER.txt +0 -9
@@ -1,3 +1,112 @@
1
1
  // SPDX-License-Identifier: AGPL-3.0-or-later
2
2
  // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
3
- "use strict";function driveConnectUrl(e){return`${String(e||"").replace(/\/+$/,"")}/connect/drive`}async function driveStatus(e){const n=await e.driveToken(),o=Boolean(n&&n.connected),t=n&&n.google_linked;return{connected:o,googleLinked:o||!0===t,googleLinkedKnown:"boolean"==typeof t||o,email:n&&n.email||null}}async function waitForDriveConnected(e,n={}){const o=Number(n.timeoutMs)>0?Number(n.timeoutMs):18e4,t=Number(n.pollMs)>0?Number(n.pollMs):2e3,r=n.signal||null,i=Date.now()+o;for(;;){const n=await driveStatus(e);if(n.connected)return n;if(r&&r.aborted){const e=new Error("cancelled");throw e.name="AbortError",e}if(Date.now()>=i)throw new Error(`timed out after ${Math.round(o/1e3)}s waiting for Google Drive to connect`);await new Promise((e=>setTimeout(e,t)))}}module.exports={driveConnectUrl:driveConnectUrl,driveStatus:driveStatus,waitForDriveConnected:waitForDriveConnected};
3
+ // AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
4
+ // Conveying a modified copy, or running one as a network service, owes the
5
+ // corresponding source under this licence (§5/§13) — see LICENSING.md.
6
+ 'use strict';
7
+
8
+ /**
9
+ * drive-connect.js — the desktop half of aegis1's Google Drive OAuth.
10
+ *
11
+ * aegis1 already runs the full web side of this: `/connect/drive` sends the
12
+ * browser through Google's consent screen with the `drive.file` scope, saves
13
+ * the resulting tokens on whichever account that Google identity resolves
14
+ * to, and lands on a static "connected" page. `/api/drive/token` then hands
15
+ * back a fresh (server-refreshed) access token for that account, authenticated
16
+ * with the ordinary AEGIS API key — see `client/aegis.js`'s `driveToken()`.
17
+ *
18
+ * Unlike `/auth/google` (see `client/google-signin.js`), `/connect/drive` has
19
+ * no desktop round-trip: it never redirects back to a local callback, so
20
+ * there is nothing here to listen for. This module does the other honest
21
+ * thing instead — open the browser to it, and POLL the status endpoint
22
+ * (this machine's own API key) until the account shows connected, or give up
23
+ * after a timeout. The caller provides the actual browser-opening (Electron's
24
+ * `shell.openExternal`); this module is Electron-free so it can be driven by
25
+ * a test with a stub `aegis` client and no network.
26
+ *
27
+ * ONE PRECONDITION THIS MODULE DOES NOT ENFORCE, BECAUSE IT CANNOT:
28
+ * `/connect/drive` resolves the account by Google identity (google_id, then
29
+ * email), not by whatever account this machine's API key already belongs to.
30
+ * So polling only ever reports connected when THIS machine is already signed
31
+ * in with that same Google identity — otherwise the browser attaches the
32
+ * Drive tokens to a different account than the one being polled, and the
33
+ * poll simply times out. `desktop/lib/google-connect.js` is what sequences
34
+ * "sign in with Google first" ahead of this.
35
+ */
36
+
37
+ /** `${apiBase}/connect/drive` — the one URL this flow opens. */
38
+ function driveConnectUrl(apiBase) {
39
+ return `${String(apiBase || '').replace(/\/+$/, '')}/connect/drive`;
40
+ }
41
+
42
+ /**
43
+ * One status check: is a Drive token on file for this account, and is the
44
+ * account tied to a Google identity at all?
45
+ *
46
+ * `googleLinked` comes from the server (`/api/drive/token`'s `google_linked`,
47
+ * derived from `users.google_id`) and is NOT the same question as "does this
48
+ * machine have an API key". Every install auto-provisions an anonymous device
49
+ * key, so a key always exists while the account behind it may never have
50
+ * touched Google. Connecting Drive in that state attaches the tokens to
51
+ * whatever Google account the browser happens to hold — a different account
52
+ * than the one this machine polls — and the poll just times out. Callers need
53
+ * this flag to refuse that ordering.
54
+ *
55
+ * Older servers answer `google_linked` not at all; a connected account is
56
+ * proof enough (only a Google round-trip can store those tokens), so a
57
+ * missing flag next to a live token reads as linked rather than as a
58
+ * regression that would disable the button for everyone.
59
+ *
60
+ * @param {{driveToken: () => Promise<{connected:boolean, email?:string, google_linked?:boolean}>}} aegis
61
+ */
62
+ async function driveStatus(aegis) {
63
+ const data = await aegis.driveToken();
64
+ const connected = Boolean(data && data.connected);
65
+ const raw = data && data.google_linked;
66
+ // Did the server actually answer the question? A server that predates the
67
+ // field omits it entirely, and an account with no Drive token answers 404
68
+ // with no flag — both look exactly like an explicit `false` once collapsed
69
+ // to a boolean. Callers that must not block a real sign-in need to tell
70
+ // "not linked" apart from "nobody asked the server".
71
+ const known = typeof raw === 'boolean';
72
+ return {
73
+ connected,
74
+ googleLinked: connected || raw === true,
75
+ googleLinkedKnown: known || connected,
76
+ email: (data && data.email) || null,
77
+ };
78
+ }
79
+
80
+ /**
81
+ * Poll `driveStatus` until it reports connected, or time out.
82
+ *
83
+ * The browser round-trip has no signal of its own to wait on (unlike
84
+ * `startGoogleSignIn`'s local callback server), so this is the only way the
85
+ * caller learns the user actually finished the consent screen — or gave up
86
+ * on it, which is why this is bounded rather than polled forever.
87
+ *
88
+ * @param {object} aegis a client exposing `driveToken()`
89
+ * @param {{timeoutMs?:number, pollMs?:number, signal?:AbortSignal}} [opts]
90
+ */
91
+ async function waitForDriveConnected(aegis, opts = {}) {
92
+ const timeoutMs = Number(opts.timeoutMs) > 0 ? Number(opts.timeoutMs) : 3 * 60 * 1000;
93
+ const pollMs = Number(opts.pollMs) > 0 ? Number(opts.pollMs) : 2000;
94
+ const signal = opts.signal || null;
95
+ const deadline = Date.now() + timeoutMs;
96
+
97
+ for (;;) {
98
+ const status = await driveStatus(aegis);
99
+ if (status.connected) return status;
100
+ if (signal && signal.aborted) {
101
+ const e = new Error('cancelled');
102
+ e.name = 'AbortError';
103
+ throw e;
104
+ }
105
+ if (Date.now() >= deadline) {
106
+ throw new Error(`timed out after ${Math.round(timeoutMs / 1000)}s waiting for Google Drive to connect`);
107
+ }
108
+ await new Promise((resolve) => setTimeout(resolve, pollMs));
109
+ }
110
+ }
111
+
112
+ module.exports = { driveConnectUrl, driveStatus, waitForDriveConnected };
@@ -1,3 +1,236 @@
1
1
  // SPDX-License-Identifier: AGPL-3.0-or-later
2
2
  // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
3
- "use strict";const DRIVE_FILES_URL="https://www.googleapis.com/drive/v3/files",DRIVE_UPLOAD_URL="https://www.googleapis.com/upload/drive/v3/files",FOLDER_MIME="application/vnd.google-apps.folder",BOUNDARY="aegiscode-drive-upload-boundary",DEFAULT_FOLDER="AEGIS Memory",DEFAULT_FILE="aegis-memory-backup.json",DEFAULT_CONVERSATIONS_FOLDER="conversations";function resolveFetch(e){const n=e||("function"==typeof fetch?fetch:null);if(!n)throw new Error("drive: this Node has no global fetch — upgrade to Node 22+");return n}function escapeQ(e){return String(e).replace(/\\/g,"\\\\").replace(/'/g,"\\'")}async function driveRequest(e,n,{method:t="GET",accessToken:o,body:r,headers:a}={}){const i=resolveFetch(e),d=await i(n,{method:t,headers:{Authorization:`Bearer ${o}`,...a||{}},body:r}),l=await d.text();let s=null;try{s=l?JSON.parse(l):null}catch{s=null}if(!d.ok){const e=s&&s.error&&(s.error.message||s.error)||l.slice(0,200)||`HTTP ${d.status}`,o=new Error(`drive: ${t} ${n.split("?")[0]} failed — ${"string"==typeof e?e:JSON.stringify(e)}`);throw o.status=d.status,o.data=s,o}return s||{}}async function findOne(e,n,t){const o=`${DRIVE_FILES_URL}?q=${encodeURIComponent(t)}&fields=${encodeURIComponent("files(id,name)")}&pageSize=1`,r=await driveRequest(e,o,{accessToken:n});return(Array.isArray(r.files)?r.files:[])[0]||null}async function findOrCreateFolder(e,n,{fetchImpl:t,parentId:o=null}={}){const r=`${o?`'${escapeQ(o)}' in parents and `:""}mimeType='${FOLDER_MIME}' and name='${escapeQ(n)}' and trashed=false`,a=await findOne(t,e,r);if(a)return a.id;const i={name:n,mimeType:FOLDER_MIME};return o&&(i.parents=[o]),(await driveRequest(t,DRIVE_FILES_URL,{method:"POST",accessToken:e,headers:{"Content-Type":"application/json"},body:JSON.stringify(i)})).id}async function findFileInFolder(e,n,t,{fetchImpl:o}={}){return findOne(o,e,`'${escapeQ(t)}' in parents and name='${escapeQ(n)}' and trashed=false`)}async function createFile(e,{name:n,folderId:t,content:o,mimeType:r},{fetchImpl:a}={}){const i=JSON.stringify({name:n,parents:[t]}),d=`--${BOUNDARY}\r\nContent-Type: application/json; charset=UTF-8\r\n\r\n${i}\r\n--${BOUNDARY}\r\nContent-Type: ${r}\r\n\r\n${o}\r\n--${BOUNDARY}--`;return driveRequest(a,`${DRIVE_UPLOAD_URL}?uploadType=multipart&fields=${encodeURIComponent("id,webViewLink")}`,{method:"POST",accessToken:e,headers:{"Content-Type":`multipart/related; boundary=${BOUNDARY}`},body:d})}async function updateFileContent(e,n,t,o,{fetchImpl:r}={}){return driveRequest(r,`${DRIVE_UPLOAD_URL}/${encodeURIComponent(n)}?uploadType=media&fields=${encodeURIComponent("id,webViewLink")}`,{method:"PATCH",accessToken:e,headers:{"Content-Type":o},body:t})}async function uploadMemoryBackup(e,n,t={}){const o=t.folderName||"AEGIS Memory",r=t.fileName||DEFAULT_FILE,a=t.mimeType||"application/json",i=t.fetchImpl,d=await findOrCreateFolder(e,o,{fetchImpl:i}),l=await findFileInFolder(e,r,d,{fetchImpl:i}),s=l?await updateFileContent(e,l.id,n,a,{fetchImpl:i}):await createFile(e,{name:r,folderId:d,content:n,mimeType:a},{fetchImpl:i});return{fileId:s.id||l&&l.id||null,webViewLink:s.webViewLink||null,updated:Boolean(l)}}async function uploadConversation(e,n={}){const t=n.name,o=n.content;if(!t)throw new Error("drive: uploadConversation needs a file name");if("string"!=typeof o)throw new Error("drive: uploadConversation needs the file content as a string");const r=n.folderName||"AEGIS Memory",a=void 0===n.subfolder?"conversations":n.subfolder,i=n.mimeType||"text/markdown",d=n.fetchImpl,l=await findOrCreateFolder(e,r,{fetchImpl:d}),s=a?await findOrCreateFolder(e,a,{fetchImpl:d,parentId:l}):l,c=await createFile(e,{name:t,folderId:s,content:o,mimeType:i},{fetchImpl:d});return{fileId:c.id||null,webViewLink:c.webViewLink||null,created:!0,folder:a?`${r}/${a}`:r,path:a?`${r}/${a}/${t}`:`${r}/${t}`}}module.exports={DEFAULT_FOLDER:"AEGIS Memory",DEFAULT_FILE:DEFAULT_FILE,DEFAULT_CONVERSATIONS_FOLDER:"conversations",findOrCreateFolder:findOrCreateFolder,findFileInFolder:findFileInFolder,createFile:createFile,updateFileContent:updateFileContent,uploadMemoryBackup:uploadMemoryBackup,uploadConversation:uploadConversation};
3
+ // AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
4
+ // Conveying a modified copy, or running one as a network service, owes the
5
+ // corresponding source under this licence (§5/§13) — see LICENSING.md.
6
+ 'use strict';
7
+
8
+ /**
9
+ * drive-upload.js — a Drive v3 REST client, scoped to exactly one job:
10
+ * keep a single memory-backup file, in a single app folder, up to date.
11
+ *
12
+ * This talks to Google's API directly with the access token
13
+ * `client/drive-connect.js` obtains (via `/api/drive/token`) — it never goes
14
+ * through aegis1, and aegis1 never sees the memory content this uploads.
15
+ *
16
+ * Scoped to `drive.file` (the scope `/connect/drive` requests): that grant
17
+ * only ever sees files this app itself creates, which is why every write
18
+ * here goes through `findOrCreateFolder`/`findFileInFolder` rather than
19
+ * assuming some well-known id — there is no well-known id this scope could
20
+ * resolve, and a file this app did not create is invisible to it even by
21
+ * name. One stable file is overwritten in place on every sync rather than
22
+ * creating a new one each time, so a daily backup habit does not pile up a
23
+ * thousand same-named files with no way to tell them apart.
24
+ */
25
+
26
+ const DRIVE_FILES_URL = 'https://www.googleapis.com/drive/v3/files';
27
+ const DRIVE_UPLOAD_URL = 'https://www.googleapis.com/upload/drive/v3/files';
28
+ const FOLDER_MIME = 'application/vnd.google-apps.folder';
29
+ const BOUNDARY = 'aegiscode-drive-upload-boundary';
30
+
31
+ const DEFAULT_FOLDER = 'AEGIS Memory';
32
+ const DEFAULT_FILE = 'aegis-memory-backup.json';
33
+ /** Conversations get their own subfolder so a saved chat never sits among the
34
+ * rolling memory files, and never collides with them by name. */
35
+ const DEFAULT_CONVERSATIONS_FOLDER = 'conversations';
36
+
37
+ function resolveFetch(fetchImpl) {
38
+ const f = fetchImpl || (typeof fetch === 'function' ? fetch : null);
39
+ if (!f) throw new Error('drive: this Node has no global fetch — upgrade to Node 22+');
40
+ return f;
41
+ }
42
+
43
+ /** Escape a value for Drive's `q=` string-literal quoting rules. */
44
+ function escapeQ(value) {
45
+ return String(value).replace(/\\/g, '\\\\').replace(/'/g, "\\'");
46
+ }
47
+
48
+ async function driveRequest(fetchImpl, url, { method = 'GET', accessToken, body, headers } = {}) {
49
+ const f = resolveFetch(fetchImpl);
50
+ const res = await f(url, {
51
+ method,
52
+ headers: { Authorization: `Bearer ${accessToken}`, ...(headers || {}) },
53
+ body,
54
+ });
55
+ const text = await res.text();
56
+ let data = null;
57
+ try {
58
+ data = text ? JSON.parse(text) : null;
59
+ } catch {
60
+ data = null;
61
+ }
62
+ if (!res.ok) {
63
+ const rawMsg = (data && data.error && (data.error.message || data.error)) || text.slice(0, 200) || `HTTP ${res.status}`;
64
+ const err = new Error(`drive: ${method} ${url.split('?')[0]} failed — ${typeof rawMsg === 'string' ? rawMsg : JSON.stringify(rawMsg)}`);
65
+ err.status = res.status;
66
+ err.data = data;
67
+ throw err;
68
+ }
69
+ return data || {};
70
+ }
71
+
72
+ /** The first file matching an exact query, or null. */
73
+ async function findOne(fetchImpl, accessToken, query) {
74
+ const url = `${DRIVE_FILES_URL}?q=${encodeURIComponent(query)}&fields=${encodeURIComponent('files(id,name)')}&pageSize=1`;
75
+ const data = await driveRequest(fetchImpl, url, { accessToken });
76
+ const files = Array.isArray(data.files) ? data.files : [];
77
+ return files[0] || null;
78
+ }
79
+
80
+ /**
81
+ * This app's folder by name, creating it the first time. Returns its id.
82
+ *
83
+ * `parentId`, when given, scopes BOTH the search and the create, so a subfolder
84
+ * is never confused with a same-named folder at the Drive root — without it,
85
+ * `conversations/` would match some unrelated folder of that name if the user
86
+ * ever made one.
87
+ */
88
+ async function findOrCreateFolder(accessToken, name, { fetchImpl, parentId = null } = {}) {
89
+ const parentClause = parentId ? `'${escapeQ(parentId)}' in parents and ` : '';
90
+ const query = `${parentClause}mimeType='${FOLDER_MIME}' and name='${escapeQ(name)}' and trashed=false`;
91
+ const existing = await findOne(fetchImpl, accessToken, query);
92
+ if (existing) return existing.id;
93
+ const metadata = { name, mimeType: FOLDER_MIME };
94
+ if (parentId) metadata.parents = [parentId];
95
+ const created = await driveRequest(fetchImpl, DRIVE_FILES_URL, {
96
+ method: 'POST',
97
+ accessToken,
98
+ headers: { 'Content-Type': 'application/json' },
99
+ body: JSON.stringify(metadata),
100
+ });
101
+ return created.id;
102
+ }
103
+
104
+ /** One file by name inside a given folder, or null. */
105
+ async function findFileInFolder(accessToken, name, folderId, { fetchImpl } = {}) {
106
+ const query = `'${escapeQ(folderId)}' in parents and name='${escapeQ(name)}' and trashed=false`;
107
+ return findOne(fetchImpl, accessToken, query);
108
+ }
109
+
110
+ /**
111
+ * Create a new file: a multipart/related body (metadata part naming the
112
+ * parent folder, content part carrying the bytes) — the shape Drive's
113
+ * `uploadType=multipart` requires for a create, since a plain media upload
114
+ * has nowhere to say which folder the file belongs in.
115
+ */
116
+ async function createFile(accessToken, { name, folderId, content, mimeType }, { fetchImpl } = {}) {
117
+ const metadata = JSON.stringify({ name, parents: [folderId] });
118
+ const body =
119
+ `--${BOUNDARY}\r\n` +
120
+ `Content-Type: application/json; charset=UTF-8\r\n\r\n${metadata}\r\n` +
121
+ `--${BOUNDARY}\r\n` +
122
+ `Content-Type: ${mimeType}\r\n\r\n${content}\r\n` +
123
+ `--${BOUNDARY}--`;
124
+ return driveRequest(
125
+ fetchImpl,
126
+ `${DRIVE_UPLOAD_URL}?uploadType=multipart&fields=${encodeURIComponent('id,webViewLink')}`,
127
+ {
128
+ method: 'POST',
129
+ accessToken,
130
+ headers: { 'Content-Type': `multipart/related; boundary=${BOUNDARY}` },
131
+ body,
132
+ }
133
+ );
134
+ }
135
+
136
+ /**
137
+ * Overwrite an existing file's content in place. A plain media upload is
138
+ * enough here — the name and parent folder never change on a resync, so
139
+ * there is nothing a metadata part would need to say.
140
+ */
141
+ async function updateFileContent(accessToken, fileId, content, mimeType, { fetchImpl } = {}) {
142
+ return driveRequest(
143
+ fetchImpl,
144
+ `${DRIVE_UPLOAD_URL}/${encodeURIComponent(fileId)}?uploadType=media&fields=${encodeURIComponent('id,webViewLink')}`,
145
+ {
146
+ method: 'PATCH',
147
+ accessToken,
148
+ headers: { 'Content-Type': mimeType },
149
+ body: content,
150
+ }
151
+ );
152
+ }
153
+
154
+ /**
155
+ * Upload (create or overwrite) one memory backup file in the user's Drive.
156
+ *
157
+ * @param {string} accessToken a live Drive access token (client/drive-connect.js / aegis.driveToken())
158
+ * @param {string} content the file's bytes — the caller serialises; this module never shapes the memory export itself
159
+ * @param {{folderName?:string, fileName?:string, mimeType?:string, fetchImpl?:Function}} [opts]
160
+ * @returns {Promise<{fileId:string, webViewLink:string|null, updated:boolean}>}
161
+ */
162
+ async function uploadMemoryBackup(accessToken, content, opts = {}) {
163
+ const folderName = opts.folderName || DEFAULT_FOLDER;
164
+ const fileName = opts.fileName || DEFAULT_FILE;
165
+ const mimeType = opts.mimeType || 'application/json';
166
+ const fetchImpl = opts.fetchImpl;
167
+
168
+ const folderId = await findOrCreateFolder(accessToken, folderName, { fetchImpl });
169
+ const existing = await findFileInFolder(accessToken, fileName, folderId, { fetchImpl });
170
+ const result = existing
171
+ ? await updateFileContent(accessToken, existing.id, content, mimeType, { fetchImpl })
172
+ : await createFile(accessToken, { name: fileName, folderId, content, mimeType }, { fetchImpl });
173
+
174
+ return {
175
+ fileId: result.id || (existing && existing.id) || null,
176
+ webViewLink: result.webViewLink || null,
177
+ updated: Boolean(existing),
178
+ };
179
+ }
180
+
181
+ /**
182
+ * Save ONE conversation as a new `.md` file in `AEGIS Memory/conversations/`.
183
+ *
184
+ * Deliberately the opposite of `uploadMemoryBackup`: this NEVER overwrites.
185
+ * A conversation is a thing that happened at a time; saving it twice should
186
+ * leave two dated files, not silently replace the first. (The memory backup is
187
+ * the other case exactly — one rolling file, updated in place, because it is a
188
+ * current state rather than an event.)
189
+ *
190
+ * The content already carries its authorship header
191
+ * (client/conversation-export.js) — this function moves bytes and decides where
192
+ * they land; it never shapes what the file says about who wrote it.
193
+ *
194
+ * @param {string} accessToken a live Drive access token
195
+ * @param {{name:string, content:string, folderName?:string, subfolder?:string,
196
+ * mimeType?:string, fetchImpl?:Function}} opts
197
+ * @returns {Promise<{fileId:string, webViewLink:string|null, created:true,
198
+ * folder:string, path:string}>}
199
+ */
200
+ async function uploadConversation(accessToken, opts = {}) {
201
+ const name = opts.name;
202
+ const content = opts.content;
203
+ if (!name) throw new Error('drive: uploadConversation needs a file name');
204
+ if (typeof content !== 'string') throw new Error('drive: uploadConversation needs the file content as a string');
205
+
206
+ const folderName = opts.folderName || DEFAULT_FOLDER;
207
+ const subfolder = opts.subfolder === undefined ? DEFAULT_CONVERSATIONS_FOLDER : opts.subfolder;
208
+ const mimeType = opts.mimeType || 'text/markdown';
209
+ const fetchImpl = opts.fetchImpl;
210
+
211
+ const rootId = await findOrCreateFolder(accessToken, folderName, { fetchImpl });
212
+ const folderId = subfolder
213
+ ? await findOrCreateFolder(accessToken, subfolder, { fetchImpl, parentId: rootId })
214
+ : rootId;
215
+
216
+ const result = await createFile(accessToken, { name, folderId, content, mimeType }, { fetchImpl });
217
+ return {
218
+ fileId: result.id || null,
219
+ webViewLink: result.webViewLink || null,
220
+ created: true,
221
+ folder: subfolder ? `${folderName}/${subfolder}` : folderName,
222
+ path: subfolder ? `${folderName}/${subfolder}/${name}` : `${folderName}/${name}`,
223
+ };
224
+ }
225
+
226
+ module.exports = {
227
+ DEFAULT_FOLDER,
228
+ DEFAULT_FILE,
229
+ DEFAULT_CONVERSATIONS_FOLDER,
230
+ findOrCreateFolder,
231
+ findFileInFolder,
232
+ createFile,
233
+ updateFileContent,
234
+ uploadMemoryBackup,
235
+ uploadConversation,
236
+ };