@agentapps/station 0.0.0-stage → 0.2.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.
Files changed (75) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +58 -2
  3. package/dist/api-key-store.d.ts +46 -0
  4. package/dist/api-key-store.d.ts.map +1 -0
  5. package/dist/api-key-store.js +84 -0
  6. package/dist/api-key-store.js.map +1 -0
  7. package/dist/app-station.d.ts +129 -0
  8. package/dist/app-station.d.ts.map +1 -0
  9. package/dist/app-station.js +706 -0
  10. package/dist/app-station.js.map +1 -0
  11. package/dist/approval-manager.d.ts +75 -0
  12. package/dist/approval-manager.d.ts.map +1 -0
  13. package/dist/approval-manager.js +96 -0
  14. package/dist/approval-manager.js.map +1 -0
  15. package/dist/document-store.d.ts +86 -0
  16. package/dist/document-store.d.ts.map +1 -0
  17. package/dist/document-store.js +230 -0
  18. package/dist/document-store.js.map +1 -0
  19. package/dist/file-handlers/object-store.d.ts +113 -0
  20. package/dist/file-handlers/object-store.d.ts.map +1 -0
  21. package/dist/file-handlers/object-store.js +273 -0
  22. package/dist/file-handlers/object-store.js.map +1 -0
  23. package/dist/file-handlers/signed-url.d.ts +44 -0
  24. package/dist/file-handlers/signed-url.d.ts.map +1 -0
  25. package/dist/file-handlers/signed-url.js +68 -0
  26. package/dist/file-handlers/signed-url.js.map +1 -0
  27. package/dist/file-handlers/volume-handlers.d.ts +136 -0
  28. package/dist/file-handlers/volume-handlers.d.ts.map +1 -0
  29. package/dist/file-handlers/volume-handlers.js +426 -0
  30. package/dist/file-handlers/volume-handlers.js.map +1 -0
  31. package/dist/in-process-runtime.d.ts +49 -0
  32. package/dist/in-process-runtime.d.ts.map +1 -0
  33. package/dist/in-process-runtime.js +50 -0
  34. package/dist/in-process-runtime.js.map +1 -0
  35. package/dist/index.d.ts +27 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +34 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/local-process-runtime.d.ts +28 -0
  40. package/dist/local-process-runtime.d.ts.map +1 -0
  41. package/dist/local-process-runtime.js +134 -0
  42. package/dist/local-process-runtime.js.map +1 -0
  43. package/dist/oauth-manager.d.ts +90 -0
  44. package/dist/oauth-manager.d.ts.map +1 -0
  45. package/dist/oauth-manager.js +148 -0
  46. package/dist/oauth-manager.js.map +1 -0
  47. package/dist/oauth-pages.d.ts +9 -0
  48. package/dist/oauth-pages.d.ts.map +1 -0
  49. package/dist/oauth-pages.js +59 -0
  50. package/dist/oauth-pages.js.map +1 -0
  51. package/dist/permission-enforcer.d.ts +52 -0
  52. package/dist/permission-enforcer.d.ts.map +1 -0
  53. package/dist/permission-enforcer.js +144 -0
  54. package/dist/permission-enforcer.js.map +1 -0
  55. package/dist/policy-store.d.ts +34 -0
  56. package/dist/policy-store.d.ts.map +1 -0
  57. package/dist/policy-store.js +35 -0
  58. package/dist/policy-store.js.map +1 -0
  59. package/dist/secrets-manager.d.ts +32 -0
  60. package/dist/secrets-manager.d.ts.map +1 -0
  61. package/dist/secrets-manager.js +12 -0
  62. package/dist/secrets-manager.js.map +1 -0
  63. package/dist/server.d.ts +383 -0
  64. package/dist/server.d.ts.map +1 -0
  65. package/dist/server.js +1974 -0
  66. package/dist/server.js.map +1 -0
  67. package/dist/telemetry.d.ts +9 -0
  68. package/dist/telemetry.d.ts.map +1 -0
  69. package/dist/telemetry.js +9 -0
  70. package/dist/telemetry.js.map +1 -0
  71. package/dist/types.d.ts +47 -0
  72. package/dist/types.d.ts.map +1 -0
  73. package/dist/types.js +9 -0
  74. package/dist/types.js.map +1 -0
  75. package/package.json +40 -3
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Object store for the Agent Apps Station.
3
+ *
4
+ * An Object is an immutable binary blob an App uploads once and gets a URL
5
+ * for. Objects belong to one Installation and live on disk under
6
+ *
7
+ * {volumesBasePath}/ws_{workspaceId}/objects/{installationId}/{objectId}
8
+ * {volumesBasePath}/ws_{workspaceId}/objects/{installationId}/{objectId}.meta.json
9
+ *
10
+ * plus one index entry per object at
11
+ *
12
+ * {volumesBasePath}/_objects/{objectId}.json → { workspaceId, installationId }
13
+ *
14
+ * so the HTTP endpoint can locate an object from its id alone. Ids are random
15
+ * and unguessable (`obj_` + 32 hex chars). There is no update operation: a
16
+ * new version of a file is a new object.
17
+ *
18
+ * Visibility:
19
+ * - `private` (default): served to Apps of the same Workspace through
20
+ * `object_get`, and over HTTP only with a valid signed link token.
21
+ * - `public`: served over HTTP to anyone who holds the URL, permanently.
22
+ *
23
+ * Implements the `object_put`, `object_get`, `object_delete`, `object_list`
24
+ * and `object_link` Requests.
25
+ */
26
+ import type { ObjectInfo, ObjectVisibility } from '@agentapps/protocol';
27
+ /** Metadata persisted next to each object. */
28
+ export interface StoredObjectMeta extends ObjectInfo {
29
+ workspaceId: string;
30
+ installationId: string;
31
+ }
32
+ /** Scope of the Request: which Installation, in which Workspace, is asking. */
33
+ export interface ObjectRequestScope {
34
+ workspaceId: string;
35
+ installationId: string;
36
+ }
37
+ export interface ObjectStoreOptions {
38
+ /** Physical base path (same root the Volume uses). */
39
+ volumesBasePath: string;
40
+ /** Station secret for signing temporary links. */
41
+ stationSecret: string;
42
+ /** Public base URL of the Station, used to build object URLs. */
43
+ publicUrl: string;
44
+ }
45
+ /** Outcome of resolving an HTTP request for an object. */
46
+ export type ObjectServeResult = {
47
+ status: 200;
48
+ path: string;
49
+ meta: StoredObjectMeta;
50
+ } | {
51
+ status: 401 | 404;
52
+ error: string;
53
+ };
54
+ /** Generate an unguessable object id. */
55
+ export declare function generateObjectId(): string;
56
+ export declare class ObjectStore {
57
+ private readonly basePath;
58
+ private readonly secret;
59
+ private readonly publicUrl;
60
+ constructor(options: ObjectStoreOptions);
61
+ /** The permanent URL of an object. */
62
+ urlFor(objectId: string): string;
63
+ private dirFor;
64
+ private indexPath;
65
+ /** Store a new object and return its metadata. */
66
+ put(scope: ObjectRequestScope, data: Buffer, options: {
67
+ contentType: string;
68
+ filename?: string;
69
+ visibility?: ObjectVisibility;
70
+ metadata?: Record<string, string>;
71
+ }): Promise<StoredObjectMeta>;
72
+ /** Locate an object's metadata by id, whatever Installation owns it. */
73
+ describe(objectId: string): Promise<StoredObjectMeta | null>;
74
+ /**
75
+ * Read an object on behalf of an Installation. Any Installation of the same
76
+ * Workspace may read it; other Workspaces see nothing.
77
+ */
78
+ get(scope: ObjectRequestScope, objectId: string): Promise<{
79
+ meta: StoredObjectMeta;
80
+ data: Buffer;
81
+ } | null>;
82
+ /** Delete an object. Only the owning Installation may delete it. */
83
+ delete(scope: ObjectRequestScope, objectId: string): Promise<boolean>;
84
+ /** List the Installation's objects, newest first, with cursor pagination. */
85
+ list(scope: ObjectRequestScope, options?: {
86
+ limit?: number;
87
+ cursor?: string;
88
+ }): Promise<{
89
+ objects: StoredObjectMeta[];
90
+ nextCursor?: string;
91
+ }>;
92
+ /** Create a signed temporary link to an object of the same Workspace. */
93
+ link(scope: ObjectRequestScope, objectId: string, expiresIn: number): Promise<{
94
+ url: string;
95
+ expiresAt: string;
96
+ } | null>;
97
+ /**
98
+ * Resolve an HTTP request for `GET /objects/{id}[?token=…]`.
99
+ *
100
+ * Public objects are served to anyone. Private objects need a valid link
101
+ * token for that object; otherwise 401. Unknown ids are 404.
102
+ */
103
+ resolveForServing(objectId: string, token?: string): Promise<ObjectServeResult>;
104
+ }
105
+ /** Strip the store-only fields before an ObjectInfo leaves the Station. */
106
+ export declare function toObjectInfo(meta: StoredObjectMeta): ObjectInfo;
107
+ /**
108
+ * Answer one `object_*` Request with its `object_*_result`.
109
+ *
110
+ * @returns the result message, or `null` when the type is not an object Request.
111
+ */
112
+ export declare function handleObjectRequest(store: ObjectStore, scope: ObjectRequestScope, msg: Record<string, unknown>): Promise<Record<string, unknown> | null>;
113
+ //# sourceMappingURL=object-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"object-store.d.ts","sourceRoot":"","sources":["../../src/file-handlers/object-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,273 @@
1
+ /**
2
+ * Object store for the Agent Apps Station.
3
+ *
4
+ * An Object is an immutable binary blob an App uploads once and gets a URL
5
+ * for. Objects belong to one Installation and live on disk under
6
+ *
7
+ * {volumesBasePath}/ws_{workspaceId}/objects/{installationId}/{objectId}
8
+ * {volumesBasePath}/ws_{workspaceId}/objects/{installationId}/{objectId}.meta.json
9
+ *
10
+ * plus one index entry per object at
11
+ *
12
+ * {volumesBasePath}/_objects/{objectId}.json → { workspaceId, installationId }
13
+ *
14
+ * so the HTTP endpoint can locate an object from its id alone. Ids are random
15
+ * and unguessable (`obj_` + 32 hex chars). There is no update operation: a
16
+ * new version of a file is a new object.
17
+ *
18
+ * Visibility:
19
+ * - `private` (default): served to Apps of the same Workspace through
20
+ * `object_get`, and over HTTP only with a valid signed link token.
21
+ * - `public`: served over HTTP to anyone who holds the URL, permanently.
22
+ *
23
+ * Implements the `object_put`, `object_get`, `object_delete`, `object_list`
24
+ * and `object_link` Requests.
25
+ */
26
+ import { randomBytes } from 'node:crypto';
27
+ import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
28
+ import { join } from 'node:path';
29
+ import { OBJECT_REQUEST_TYPES } from '@agentapps/protocol';
30
+ import { createObjectLinkToken, validateObjectLinkToken } from './signed-url.js';
31
+ const ID_PREFIX = 'obj_';
32
+ const META_SUFFIX = '.meta.json';
33
+ /** Generate an unguessable object id. */
34
+ export function generateObjectId() {
35
+ return `${ID_PREFIX}${randomBytes(16).toString('hex')}`;
36
+ }
37
+ function isObjectId(value) {
38
+ return /^obj_[0-9a-f]{32}$/.test(value);
39
+ }
40
+ export class ObjectStore {
41
+ basePath;
42
+ secret;
43
+ publicUrl;
44
+ constructor(options) {
45
+ this.basePath = options.volumesBasePath;
46
+ this.secret = options.stationSecret;
47
+ this.publicUrl = options.publicUrl.replace(/\/+$/, '');
48
+ }
49
+ /** The permanent URL of an object. */
50
+ urlFor(objectId) {
51
+ return `${this.publicUrl}/objects/${objectId}`;
52
+ }
53
+ dirFor(scope) {
54
+ return join(this.basePath, `ws_${scope.workspaceId}`, 'objects', scope.installationId);
55
+ }
56
+ indexPath(objectId) {
57
+ return join(this.basePath, '_objects', `${objectId}.json`);
58
+ }
59
+ /** Store a new object and return its metadata. */
60
+ async put(scope, data, options) {
61
+ const objectId = generateObjectId();
62
+ const dir = this.dirFor(scope);
63
+ await mkdir(dir, { recursive: true });
64
+ await mkdir(join(this.basePath, '_objects'), { recursive: true });
65
+ const meta = {
66
+ objectId,
67
+ url: this.urlFor(objectId),
68
+ size: data.length,
69
+ contentType: options.contentType,
70
+ visibility: options.visibility ?? 'private',
71
+ createdAt: new Date().toISOString(),
72
+ ...(options.filename !== undefined ? { filename: options.filename } : {}),
73
+ ...(options.metadata !== undefined ? { metadata: options.metadata } : {}),
74
+ workspaceId: scope.workspaceId,
75
+ installationId: scope.installationId,
76
+ };
77
+ await writeFile(join(dir, objectId), data);
78
+ await writeFile(join(dir, `${objectId}${META_SUFFIX}`), JSON.stringify(meta));
79
+ await writeFile(this.indexPath(objectId), JSON.stringify({ workspaceId: scope.workspaceId, installationId: scope.installationId }));
80
+ return meta;
81
+ }
82
+ /** Locate an object's metadata by id, whatever Installation owns it. */
83
+ async describe(objectId) {
84
+ if (!isObjectId(objectId))
85
+ return null;
86
+ let owner;
87
+ try {
88
+ owner = JSON.parse(await readFile(this.indexPath(objectId), 'utf8'));
89
+ }
90
+ catch {
91
+ return null;
92
+ }
93
+ try {
94
+ const raw = await readFile(join(this.dirFor(owner), `${objectId}${META_SUFFIX}`), 'utf8');
95
+ return JSON.parse(raw);
96
+ }
97
+ catch {
98
+ return null;
99
+ }
100
+ }
101
+ /**
102
+ * Read an object on behalf of an Installation. Any Installation of the same
103
+ * Workspace may read it; other Workspaces see nothing.
104
+ */
105
+ async get(scope, objectId) {
106
+ const meta = await this.describe(objectId);
107
+ if (!meta || meta.workspaceId !== scope.workspaceId)
108
+ return null;
109
+ try {
110
+ const data = await readFile(join(this.dirFor(meta), objectId));
111
+ return { meta, data };
112
+ }
113
+ catch {
114
+ return null;
115
+ }
116
+ }
117
+ /** Delete an object. Only the owning Installation may delete it. */
118
+ async delete(scope, objectId) {
119
+ const meta = await this.describe(objectId);
120
+ if (!meta ||
121
+ meta.workspaceId !== scope.workspaceId ||
122
+ meta.installationId !== scope.installationId) {
123
+ return false;
124
+ }
125
+ const dir = this.dirFor(meta);
126
+ await rm(join(dir, objectId), { force: true });
127
+ await rm(join(dir, `${objectId}${META_SUFFIX}`), { force: true });
128
+ await rm(this.indexPath(objectId), { force: true });
129
+ return true;
130
+ }
131
+ /** List the Installation's objects, newest first, with cursor pagination. */
132
+ async list(scope, options = {}) {
133
+ const dir = this.dirFor(scope);
134
+ let names;
135
+ try {
136
+ names = await readdir(dir);
137
+ }
138
+ catch {
139
+ return { objects: [] };
140
+ }
141
+ const metas = [];
142
+ for (const name of names) {
143
+ if (!name.endsWith(META_SUFFIX))
144
+ continue;
145
+ try {
146
+ metas.push(JSON.parse(await readFile(join(dir, name), 'utf8')));
147
+ }
148
+ catch {
149
+ // A half-written meta file is skipped.
150
+ }
151
+ }
152
+ metas.sort((a, b) => (a.createdAt < b.createdAt ? 1 : a.createdAt > b.createdAt ? -1 : 0));
153
+ let start = 0;
154
+ if (options.cursor) {
155
+ const at = metas.findIndex((m) => m.objectId === options.cursor);
156
+ start = at >= 0 ? at + 1 : metas.length;
157
+ }
158
+ const limit = options.limit ?? 100;
159
+ const page = metas.slice(start, start + limit);
160
+ const last = page[page.length - 1];
161
+ const hasMore = start + limit < metas.length;
162
+ return { objects: page, ...(hasMore && last ? { nextCursor: last.objectId } : {}) };
163
+ }
164
+ /** Create a signed temporary link to an object of the same Workspace. */
165
+ async link(scope, objectId, expiresIn) {
166
+ const meta = await this.describe(objectId);
167
+ if (!meta || meta.workspaceId !== scope.workspaceId)
168
+ return null;
169
+ const expiresAt = new Date(Date.now() + expiresIn * 1000).toISOString();
170
+ const token = createObjectLinkToken({ objectId, expiresAt }, this.secret);
171
+ return { url: `${this.urlFor(objectId)}?token=${token}`, expiresAt };
172
+ }
173
+ /**
174
+ * Resolve an HTTP request for `GET /objects/{id}[?token=…]`.
175
+ *
176
+ * Public objects are served to anyone. Private objects need a valid link
177
+ * token for that object; otherwise 401. Unknown ids are 404.
178
+ */
179
+ async resolveForServing(objectId, token) {
180
+ const meta = await this.describe(objectId);
181
+ if (!meta)
182
+ return { status: 404, error: 'Object not found' };
183
+ if (meta.visibility !== 'public') {
184
+ if (!token)
185
+ return { status: 401, error: 'Private object: a link token is required' };
186
+ const check = validateObjectLinkToken(token, this.secret);
187
+ if (!check.valid || check.payload?.objectId !== objectId) {
188
+ return { status: 401, error: check.reason ?? 'Invalid token' };
189
+ }
190
+ }
191
+ return { status: 200, path: join(this.dirFor(meta), objectId), meta };
192
+ }
193
+ }
194
+ /** Strip the store-only fields before an ObjectInfo leaves the Station. */
195
+ export function toObjectInfo(meta) {
196
+ const { workspaceId: _ws, installationId: _inst, ...info } = meta;
197
+ return info;
198
+ }
199
+ /**
200
+ * Answer one `object_*` Request with its `object_*_result`.
201
+ *
202
+ * @returns the result message, or `null` when the type is not an object Request.
203
+ */
204
+ export async function handleObjectRequest(store, scope, msg) {
205
+ const type = msg.type;
206
+ if (!OBJECT_REQUEST_TYPES.has(type))
207
+ return null;
208
+ const requestId = msg.requestId;
209
+ const sessionId = msg.sessionId;
210
+ const base = {
211
+ id: `${type}-${requestId}`,
212
+ timestamp: new Date().toISOString(),
213
+ version: '2.0',
214
+ sessionId,
215
+ requestId,
216
+ type: `${type}_result`,
217
+ };
218
+ try {
219
+ switch (type) {
220
+ case 'object_put': {
221
+ const data = Buffer.from(msg.data ?? '', 'base64');
222
+ const meta = await store.put(scope, data, {
223
+ contentType: msg.contentType,
224
+ filename: msg.filename,
225
+ visibility: msg.visibility,
226
+ metadata: msg.metadata,
227
+ });
228
+ return { ...base, success: true, ...toObjectInfo(meta) };
229
+ }
230
+ case 'object_get': {
231
+ const found = await store.get(scope, msg.objectId);
232
+ if (!found)
233
+ return { ...base, success: false, error: 'Object not found' };
234
+ return {
235
+ ...base,
236
+ success: true,
237
+ ...toObjectInfo(found.meta),
238
+ data: found.data.toString('base64'),
239
+ };
240
+ }
241
+ case 'object_delete': {
242
+ const deleted = await store.delete(scope, msg.objectId);
243
+ return deleted
244
+ ? { ...base, success: true }
245
+ : { ...base, success: false, error: 'Object not found' };
246
+ }
247
+ case 'object_list': {
248
+ const page = await store.list(scope, {
249
+ limit: msg.limit,
250
+ cursor: msg.cursor,
251
+ });
252
+ return {
253
+ ...base,
254
+ success: true,
255
+ objects: page.objects.map(toObjectInfo),
256
+ ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),
257
+ };
258
+ }
259
+ case 'object_link': {
260
+ const link = await store.link(scope, msg.objectId, msg.expiresIn);
261
+ if (!link)
262
+ return { ...base, success: false, error: 'Object not found' };
263
+ return { ...base, success: true, ...link };
264
+ }
265
+ default:
266
+ return null;
267
+ }
268
+ }
269
+ catch (err) {
270
+ return { ...base, success: false, error: err instanceof Error ? err.message : String(err) };
271
+ }
272
+ }
273
+ //# sourceMappingURL=object-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"object-store.js","sourceRoot":"","sources":["../../src/file-handlers/object-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Signed temporary links for private Objects.
3
+ *
4
+ * A link token follows a JWT-like structure:
5
+ * token = base64url(payload) + "." + base64url(HMAC-SHA256(payload, secret))
6
+ *
7
+ * Payload: `{ objectId, expiresAt }`. The token is appended to the object's
8
+ * URL as `?token=…`; the Station serves a private object only when the token
9
+ * is valid, signed with its secret and not yet expired.
10
+ *
11
+ * The station secret is generated at startup (random) or configured via the
12
+ * `AGENTAPPS_STATION_SECRET` env var. Set it in deployments so links survive
13
+ * restarts.
14
+ */
15
+ /** Payload embedded in a link token. */
16
+ export interface ObjectLinkPayload {
17
+ /** Object the link permissions access to. */
18
+ objectId: string;
19
+ /** ISO 8601 expiry timestamp. */
20
+ expiresAt: string;
21
+ }
22
+ /** Result of validating a link token. */
23
+ export interface ObjectLinkValidationResult {
24
+ valid: boolean;
25
+ payload?: ObjectLinkPayload;
26
+ /** Reason the token was rejected (when `valid` is false). */
27
+ reason?: string;
28
+ }
29
+ /**
30
+ * Resolve the station secret used for HMAC signing.
31
+ *
32
+ * Priority: explicit override, `AGENTAPPS_STATION_SECRET`, then a random
33
+ * per-process secret.
34
+ */
35
+ export declare function getStationSecret(override?: string): string;
36
+ /** Create a signed link token for an object that expires at `expiresAt`. */
37
+ export declare function createObjectLinkToken(payload: ObjectLinkPayload, secret: string): string;
38
+ /**
39
+ * Validate a link token: structure, signature and expiry.
40
+ *
41
+ * @returns `{ valid, payload }` on success, `{ valid: false, reason }` otherwise.
42
+ */
43
+ export declare function validateObjectLinkToken(token: string, secret: string): ObjectLinkValidationResult;
44
+ //# sourceMappingURL=signed-url.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signed-url.d.ts","sourceRoot":"","sources":["../../src/file-handlers/signed-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,0BAA0B,CA0BjG"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Signed temporary links for private Objects.
3
+ *
4
+ * A link token follows a JWT-like structure:
5
+ * token = base64url(payload) + "." + base64url(HMAC-SHA256(payload, secret))
6
+ *
7
+ * Payload: `{ objectId, expiresAt }`. The token is appended to the object's
8
+ * URL as `?token=…`; the Station serves a private object only when the token
9
+ * is valid, signed with its secret and not yet expired.
10
+ *
11
+ * The station secret is generated at startup (random) or configured via the
12
+ * `AGENTAPPS_STATION_SECRET` env var. Set it in deployments so links survive
13
+ * restarts.
14
+ */
15
+ import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
16
+ /**
17
+ * Resolve the station secret used for HMAC signing.
18
+ *
19
+ * Priority: explicit override, `AGENTAPPS_STATION_SECRET`, then a random
20
+ * per-process secret.
21
+ */
22
+ export function getStationSecret(override) {
23
+ if (override)
24
+ return override;
25
+ const env = process.env.AGENTAPPS_STATION_SECRET;
26
+ if (env)
27
+ return env;
28
+ return randomBytes(32).toString('hex');
29
+ }
30
+ /** Create a signed link token for an object that expires at `expiresAt`. */
31
+ export function createObjectLinkToken(payload, secret) {
32
+ const payloadB64 = Buffer.from(JSON.stringify(payload), 'utf8').toString('base64url');
33
+ const signature = createHmac('sha256', secret).update(payloadB64).digest();
34
+ return `${payloadB64}.${signature.toString('base64url')}`;
35
+ }
36
+ /**
37
+ * Validate a link token: structure, signature and expiry.
38
+ *
39
+ * @returns `{ valid, payload }` on success, `{ valid: false, reason }` otherwise.
40
+ */
41
+ export function validateObjectLinkToken(token, secret) {
42
+ const parts = token.split('.');
43
+ if (parts.length !== 2)
44
+ return { valid: false, reason: 'Invalid token format' };
45
+ const [payloadB64, sigB64] = parts;
46
+ const expected = createHmac('sha256', secret).update(payloadB64).digest();
47
+ const provided = Buffer.from(sigB64, 'base64url');
48
+ if (expected.length !== provided.length || !timingSafeEqual(expected, provided)) {
49
+ return { valid: false, reason: 'Invalid signature' };
50
+ }
51
+ let payload;
52
+ try {
53
+ payload = JSON.parse(Buffer.from(payloadB64, 'base64url').toString('utf8'));
54
+ }
55
+ catch {
56
+ return { valid: false, reason: 'Invalid payload' };
57
+ }
58
+ if (typeof payload.objectId !== 'string' || typeof payload.expiresAt !== 'string') {
59
+ return { valid: false, reason: 'Invalid payload' };
60
+ }
61
+ const expiresAt = new Date(payload.expiresAt);
62
+ if (Number.isNaN(expiresAt.getTime()))
63
+ return { valid: false, reason: 'Invalid expiry' };
64
+ if (Date.now() >= expiresAt.getTime())
65
+ return { valid: false, reason: 'Token expired' };
66
+ return { valid: true, payload };
67
+ }
68
+ //# sourceMappingURL=signed-url.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signed-url.js","sourceRoot":"","sources":["../../src/file-handlers/signed-url.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,136 @@
1
+ /**
2
+ * Workspace Volume handlers for the Agent Apps Station.
3
+ *
4
+ * One Volume per Workspace (VOL-REQ-1), rooted at
5
+ *
6
+ * {VOLUMES_BASE_PATH}/ws_{workspaceId}/workspace/
7
+ *
8
+ * API mode answers the `file_volume_*` Requests (VOL-REQ-3) for Installations
9
+ * holding the `volume` Permission (VOL-REQ-2). Mount mode hands the same
10
+ * directory to the Instance (VOL-REQ-5), so both modes see the same files
11
+ * (VOL-REQ-6). All paths are relative to the root and never escape it
12
+ * (VOL-NFR-1).
13
+ */
14
+ import { type DirEntry, type FileStat } from '@agentapps/protocol';
15
+ /**
16
+ * Resolve the volumes base path from the environment or fall back to the
17
+ * default. Callers can also pass an explicit override.
18
+ *
19
+ * @spec VOL-REQ-1
20
+ */
21
+ export declare function getVolumesBasePath(override?: string): string;
22
+ /**
23
+ * Resolve a relative path (from the instance) to an absolute host path
24
+ * inside the Workspace's Volume root.
25
+ *
26
+ * Rejects with `INVALID_ARGUMENTS` (VOL-REQ-3): absolute paths (leading slash
27
+ * or backslash, or a drive letter), any literal `..` segment, and any path
28
+ * whose resolution escapes the root.
29
+ *
30
+ * @spec VOL-REQ-3
31
+ * @returns The absolute host path, or throws with code `INVALID_ARGUMENTS`.
32
+ */
33
+ export declare function resolveVolumePath(volumeRoot: string, relPath: string): string;
34
+ /**
35
+ * Build the Volume root for a Workspace: one per Workspace, shared by every
36
+ * Installation in it.
37
+ *
38
+ * {volumesBasePath}/ws_{workspaceId}/workspace/
39
+ *
40
+ * @spec VOL-REQ-1
41
+ */
42
+ export declare function buildVolumeRoot(volumesBasePath: string, workspaceId: string): string;
43
+ /**
44
+ * Decide the mount path handed to an Instance in mount mode.
45
+ *
46
+ * Returns the absolute Volume root when the App declares
47
+ * `runtime.mountVolume: true` AND the Installation holds the `volume`
48
+ * Permission; `undefined` otherwise, so no mount is provided without the
49
+ * Permission (VOL-REQ-2, VOL-REQ-4).
50
+ *
51
+ * @spec VOL-REQ-5
52
+ */
53
+ export declare function resolveMountPath(options: {
54
+ mountVolume: boolean | undefined;
55
+ permissions: {
56
+ volume?: boolean;
57
+ } | undefined;
58
+ volumesBasePath: string;
59
+ workspaceId: string;
60
+ }): string | undefined;
61
+ /** Context passed to every volume handler. */
62
+ export interface VolumeHandlerContext {
63
+ /** Physical base path for all volumes. */
64
+ volumesBasePath: string;
65
+ /** Workspace ID from the session. */
66
+ workspaceId: string;
67
+ /** Session ID from the request message. */
68
+ sessionId: string;
69
+ /** The Installation's Effective Permissions; `volume` gates every request (VOL-REQ-2). */
70
+ permissions: {
71
+ volume?: boolean;
72
+ } | undefined;
73
+ }
74
+ /** Result wrapper — either success with data or failure with error code. */
75
+ interface VolumeResult<T> {
76
+ success: boolean;
77
+ data?: T;
78
+ error?: string;
79
+ errorCode?: string;
80
+ }
81
+ /**
82
+ * List directory entries.
83
+ *
84
+ * `path` is relative to the volume root. An empty string lists the root.
85
+ *
86
+ * @spec VOL-REQ-3
87
+ */
88
+ export declare function volumeReadDir(ctx: VolumeHandlerContext, path: string): Promise<VolumeResult<DirEntry[]>>;
89
+ /**
90
+ * Read a file as base64-encoded bytes.
91
+ *
92
+ * @spec VOL-REQ-3
93
+ */
94
+ export declare function volumeReadFile(ctx: VolumeHandlerContext, path: string): Promise<VolumeResult<{
95
+ data: string;
96
+ size: number;
97
+ modifiedAt: string;
98
+ }>>;
99
+ /**
100
+ * Write base64-encoded bytes to a file. Creates parent directories.
101
+ *
102
+ * @spec VOL-REQ-3
103
+ */
104
+ export declare function volumeWriteFile(ctx: VolumeHandlerContext, path: string, dataBase64: string): Promise<VolumeResult<void>>;
105
+ /**
106
+ * Delete a file or directory. If the target is a directory and
107
+ * `recursive` is false, the delete fails.
108
+ *
109
+ * @spec VOL-REQ-3
110
+ */
111
+ export declare function volumeDelete(ctx: VolumeHandlerContext, path: string, recursive: boolean): Promise<VolumeResult<void>>;
112
+ /**
113
+ * Stat a path — returns type, size, createdAt, modifiedAt.
114
+ *
115
+ * @spec VOL-REQ-3
116
+ */
117
+ export declare function volumeStat(ctx: VolumeHandlerContext, path: string): Promise<VolumeResult<FileStat>>;
118
+ /**
119
+ * Create a directory and any missing parents.
120
+ *
121
+ * @spec VOL-REQ-3
122
+ */
123
+ export declare function volumeMkdir(ctx: VolumeHandlerContext, path: string): Promise<VolumeResult<void>>;
124
+ /**
125
+ * Dispatch a `file_volume_*` request message to the appropriate handler.
126
+ *
127
+ * @returns The response message to send back to the instance, or `null`
128
+ * if the message type is not a recognised volume request.
129
+ *
130
+ * @spec VOL-REQ-2
131
+ */
132
+ export declare function handleVolumeRequest(ctx: VolumeHandlerContext, msg: Record<string, unknown>): Promise<Record<string, unknown> | null>;
133
+ /** Set of all `file_volume_*` request request types. */
134
+ export declare const VOLUME_REQUEST_TYPES: Set<string>;
135
+ export {};
136
+ //# sourceMappingURL=volume-handlers.d.ts.map