@withgateway/sdk 0.1.3

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 (40) hide show
  1. package/README.md +229 -0
  2. package/dist/context/index.d.mts +225 -0
  3. package/dist/context/index.d.ts +225 -0
  4. package/dist/context/index.js +440 -0
  5. package/dist/context/index.js.map +1 -0
  6. package/dist/context/index.mjs +411 -0
  7. package/dist/context/index.mjs.map +1 -0
  8. package/dist/experiments/index.d.mts +260 -0
  9. package/dist/experiments/index.d.ts +260 -0
  10. package/dist/experiments/index.js +407 -0
  11. package/dist/experiments/index.js.map +1 -0
  12. package/dist/experiments/index.mjs +374 -0
  13. package/dist/experiments/index.mjs.map +1 -0
  14. package/dist/index-Caw3XVub.d.mts +193 -0
  15. package/dist/index-Caw3XVub.d.ts +193 -0
  16. package/dist/index.d.mts +20 -0
  17. package/dist/index.d.ts +20 -0
  18. package/dist/index.js +1476 -0
  19. package/dist/index.js.map +1 -0
  20. package/dist/index.mjs +1434 -0
  21. package/dist/index.mjs.map +1 -0
  22. package/dist/memory/index.d.mts +124 -0
  23. package/dist/memory/index.d.ts +124 -0
  24. package/dist/memory/index.js +192 -0
  25. package/dist/memory/index.js.map +1 -0
  26. package/dist/memory/index.mjs +164 -0
  27. package/dist/memory/index.mjs.map +1 -0
  28. package/dist/security/index.d.mts +114 -0
  29. package/dist/security/index.d.ts +114 -0
  30. package/dist/security/index.js +297 -0
  31. package/dist/security/index.js.map +1 -0
  32. package/dist/security/index.mjs +275 -0
  33. package/dist/security/index.mjs.map +1 -0
  34. package/dist/tracing/index.d.mts +1 -0
  35. package/dist/tracing/index.d.ts +1 -0
  36. package/dist/tracing/index.js +226 -0
  37. package/dist/tracing/index.js.map +1 -0
  38. package/dist/tracing/index.mjs +202 -0
  39. package/dist/tracing/index.mjs.map +1 -0
  40. package/package.json +112 -0
@@ -0,0 +1,192 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/memory/index.ts
21
+ var memory_exports = {};
22
+ __export(memory_exports, {
23
+ GatewayMemory: () => GatewayMemory,
24
+ GatewayMemoryConflictError: () => GatewayMemoryConflictError,
25
+ GatewayMemoryError: () => GatewayMemoryError,
26
+ memory: () => memory
27
+ });
28
+ module.exports = __toCommonJS(memory_exports);
29
+ var GatewayMemoryError = class extends Error {
30
+ constructor(message, options) {
31
+ super(message);
32
+ this.name = "GatewayMemoryError";
33
+ this.cause = options?.cause;
34
+ }
35
+ };
36
+ var GatewayMemoryConflictError = class extends GatewayMemoryError {
37
+ latestCommit;
38
+ constructor(message, latestCommit) {
39
+ super(message);
40
+ this.name = "GatewayMemoryConflictError";
41
+ this.latestCommit = latestCommit;
42
+ }
43
+ };
44
+ var GatewayMemory = class _GatewayMemory {
45
+ host;
46
+ publicKey;
47
+ secretKey;
48
+ debug;
49
+ constructor(config) {
50
+ this.host = config.host.replace(/\/$/, "");
51
+ this.publicKey = config.publicKey;
52
+ this.secretKey = config.secretKey;
53
+ this.debug = config.debug ?? false;
54
+ }
55
+ static fromEnv(config = {}) {
56
+ const host = config.host ?? process.env.GATEWAY_HOST;
57
+ const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;
58
+ const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;
59
+ const missing = [
60
+ ["host", host],
61
+ ["publicKey", publicKey],
62
+ ["secretKey", secretKey]
63
+ ].filter(([, value]) => !value).map(([name]) => name);
64
+ if (missing.length > 0) {
65
+ throw new GatewayMemoryError(
66
+ `Missing Gateway memory configuration: ${missing.join(", ")}`
67
+ );
68
+ }
69
+ return new _GatewayMemory({
70
+ ...config,
71
+ host,
72
+ publicKey,
73
+ secretKey
74
+ });
75
+ }
76
+ async pull(identifier, options = {}) {
77
+ const query = new URLSearchParams();
78
+ if (options.version) query.set("version", options.version);
79
+ const suffix = query.toString() ? `?${query.toString()}` : "";
80
+ return this.requestJson(
81
+ "GET",
82
+ `/api/public/context/memory/${encodeIdentifier(identifier)}${suffix}`
83
+ );
84
+ }
85
+ async read(target, path, options = {}) {
86
+ const snapshot = typeof target === "string" ? await this.pull(target, options) : target;
87
+ const file = snapshot.files[path];
88
+ return file?.type === "file" ? file.content : null;
89
+ }
90
+ async write(target, path, content, options = {}) {
91
+ const snapshot = typeof target === "string" ? await this.pull(target) : target;
92
+ return this.push(snapshot.repo.repoHandle, {
93
+ files: {
94
+ [path]: {
95
+ content,
96
+ ...options.mimeType ? { mimeType: options.mimeType } : {}
97
+ }
98
+ },
99
+ parentCommit: options.parentCommit ?? snapshot.commit.commitHash,
100
+ message: options.message,
101
+ ...runtimeContextPayload(options)
102
+ });
103
+ }
104
+ async delete(target, path, options = {}) {
105
+ const snapshot = typeof target === "string" ? await this.pull(target) : target;
106
+ return this.push(snapshot.repo.repoHandle, {
107
+ files: { [path]: null },
108
+ parentCommit: options.parentCommit ?? snapshot.commit.commitHash,
109
+ message: options.message,
110
+ ...runtimeContextPayload(options)
111
+ });
112
+ }
113
+ async push(identifier, payload) {
114
+ return this.requestJson(
115
+ "POST",
116
+ `/api/public/context/memory/${encodeIdentifier(identifier)}`,
117
+ payload
118
+ );
119
+ }
120
+ async requestJson(method, path, payload) {
121
+ const response = await fetch(`${this.host}${path}`, {
122
+ method,
123
+ headers: {
124
+ Authorization: this.authHeader(),
125
+ ...payload ? { "Content-Type": "application/json" } : {}
126
+ },
127
+ ...payload ? { body: JSON.stringify(payload) } : {}
128
+ });
129
+ const text = await response.text();
130
+ const body = text ? safeJson(text) : {};
131
+ if (!response.ok) {
132
+ const message = typeof body.message === "string" ? body.message : `Gateway API ${response.status} on ${path}`;
133
+ if (response.status === 409) {
134
+ throw new GatewayMemoryConflictError(
135
+ message,
136
+ body.latestCommit ?? null
137
+ );
138
+ }
139
+ throw new GatewayMemoryError(message);
140
+ }
141
+ this.log("%s %s -> %s", method, path, response.status);
142
+ return body;
143
+ }
144
+ authHeader() {
145
+ return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(
146
+ "base64"
147
+ )}`;
148
+ }
149
+ log(message, ...args) {
150
+ if (this.debug) {
151
+ console.log(`[gateway.memory] ${message}`, ...args);
152
+ }
153
+ }
154
+ };
155
+ function runtimeContextPayload(options) {
156
+ return {
157
+ ...options.source ? { source: options.source } : {},
158
+ ...options.actorType ? { actorType: options.actorType } : {},
159
+ ...options.proposedBy ? { proposedBy: options.proposedBy } : {},
160
+ ...options.agentId ? { agentId: options.agentId } : {},
161
+ ...options.agentStableId ? { agentStableId: options.agentStableId } : {},
162
+ ...options.processId ? { processId: options.processId } : {},
163
+ ...options.traceId ? { traceId: options.traceId } : {},
164
+ ...options.spanId ? { spanId: options.spanId } : {},
165
+ ...options.sessionId ? { sessionId: options.sessionId } : {},
166
+ ...options.userId ? { userId: options.userId } : {},
167
+ ...options.teamId ? { teamId: options.teamId } : {},
168
+ ...options.metadata ? { metadata: options.metadata } : {}
169
+ };
170
+ }
171
+ function encodeIdentifier(identifier) {
172
+ return identifier.split("/").filter(Boolean).map((part) => encodeURIComponent(part)).join("/");
173
+ }
174
+ function safeJson(value) {
175
+ try {
176
+ const parsed = JSON.parse(value);
177
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
178
+ } catch {
179
+ return {};
180
+ }
181
+ }
182
+ var memory = {
183
+ fromEnv: GatewayMemory.fromEnv
184
+ };
185
+ // Annotate the CommonJS export names for ESM import in node:
186
+ 0 && (module.exports = {
187
+ GatewayMemory,
188
+ GatewayMemoryConflictError,
189
+ GatewayMemoryError,
190
+ memory
191
+ });
192
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/memory/index.ts"],"sourcesContent":["type MemoryWritePolicy = \"read_only\" | \"propose\" | \"commit\";\n\ntype MemoryFileEntry =\n | {\n type: \"file\";\n content: string;\n mimeType: string;\n mime_type: string;\n }\n | {\n type: \"agent\" | \"skill\";\n repoHandle: string;\n repo_handle: string;\n commitId?: string | null;\n commit_id?: string | null;\n };\n\ntype MemoryRepo = {\n id: string;\n repoHandle: string;\n repo_handle: string;\n ownerHandle: string;\n owner_handle: string;\n kind: \"memory\";\n description: string;\n readme: string;\n tags: string[];\n writePolicy: MemoryWritePolicy;\n write_policy: MemoryWritePolicy;\n isPublic: boolean;\n is_public: boolean;\n isArchived: boolean;\n is_archived: boolean;\n url?: string;\n createdAt: string;\n created_at: string;\n updatedAt: string;\n updated_at: string;\n};\n\ntype MemoryCommit = {\n id: string;\n commitHash: string;\n commit_hash: string;\n parentCommitHash: string | null;\n parent_commit_hash: string | null;\n createdAt: string;\n created_at: string;\n};\n\ntype MemorySnapshot = {\n repo: MemoryRepo;\n commit: MemoryCommit;\n files: Record<string, MemoryFileEntry>;\n};\n\ntype MemoryPushResponse = {\n url: string;\n status: \"committed\" | \"proposed\";\n repoId: string;\n repo_id: string;\n commitId: string | null;\n commit_id: string | null;\n commitHash: string | null;\n commit_hash: string | null;\n proposalId?: string | null;\n proposal_id?: string | null;\n};\n\ntype MemoryRuntimeContext = {\n source?: \"sdk\" | \"agent\" | \"dream\" | \"api\" | \"platform\";\n actorType?: \"api_key\" | \"agent\" | \"process\" | \"user\";\n proposedBy?: string;\n agentId?: string;\n agentStableId?: string;\n processId?: string;\n traceId?: string;\n spanId?: string;\n sessionId?: string;\n userId?: string;\n teamId?: string;\n metadata?: Record<string, unknown>;\n};\n\ntype MemoryPullOptions = {\n version?: string;\n};\n\ntype MemoryWriteOptions = MemoryRuntimeContext & {\n parentCommit?: string;\n message?: string;\n mimeType?: string;\n};\n\ntype MemoryDeleteOptions = MemoryRuntimeContext & {\n parentCommit?: string;\n message?: string;\n};\n\ntype GatewayMemoryConfig = {\n host: string;\n publicKey: string;\n secretKey: string;\n debug?: boolean;\n};\n\ntype GatewayMemoryFromEnvConfig = Partial<GatewayMemoryConfig>;\n\nexport class GatewayMemoryError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = \"GatewayMemoryError\";\n this.cause = options?.cause;\n }\n}\n\nexport class GatewayMemoryConflictError extends GatewayMemoryError {\n readonly latestCommit: unknown;\n\n constructor(message: string, latestCommit: unknown) {\n super(message);\n this.name = \"GatewayMemoryConflictError\";\n this.latestCommit = latestCommit;\n }\n}\n\nexport class GatewayMemory {\n private readonly host: string;\n private readonly publicKey: string;\n private readonly secretKey: string;\n private readonly debug: boolean;\n\n constructor(config: GatewayMemoryConfig) {\n this.host = config.host.replace(/\\/$/, \"\");\n this.publicKey = config.publicKey;\n this.secretKey = config.secretKey;\n this.debug = config.debug ?? false;\n }\n\n static fromEnv(config: GatewayMemoryFromEnvConfig = {}) {\n const host = config.host ?? process.env.GATEWAY_HOST;\n const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;\n const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;\n\n const missing = [\n [\"host\", host],\n [\"publicKey\", publicKey],\n [\"secretKey\", secretKey],\n ]\n .filter(([, value]) => !value)\n .map(([name]) => name);\n\n if (missing.length > 0) {\n throw new GatewayMemoryError(\n `Missing Gateway memory configuration: ${missing.join(\", \")}`,\n );\n }\n\n return new GatewayMemory({\n ...config,\n host: host!,\n publicKey: publicKey!,\n secretKey: secretKey!,\n });\n }\n\n async pull(\n identifier: string,\n options: MemoryPullOptions = {},\n ): Promise<MemorySnapshot> {\n const query = new URLSearchParams();\n if (options.version) query.set(\"version\", options.version);\n const suffix = query.toString() ? `?${query.toString()}` : \"\";\n return this.requestJson<MemorySnapshot>(\n \"GET\",\n `/api/public/context/memory/${encodeIdentifier(identifier)}${suffix}`,\n );\n }\n\n async read(\n target: string | MemorySnapshot,\n path: string,\n options: MemoryPullOptions = {},\n ): Promise<string | null> {\n const snapshot =\n typeof target === \"string\" ? await this.pull(target, options) : target;\n const file = snapshot.files[path];\n return file?.type === \"file\" ? file.content : null;\n }\n\n async write(\n target: string | MemorySnapshot,\n path: string,\n content: string,\n options: MemoryWriteOptions = {},\n ) {\n const snapshot =\n typeof target === \"string\" ? await this.pull(target) : target;\n return this.push(snapshot.repo.repoHandle, {\n files: {\n [path]: {\n content,\n ...(options.mimeType ? { mimeType: options.mimeType } : {}),\n },\n },\n parentCommit: options.parentCommit ?? snapshot.commit.commitHash,\n message: options.message,\n ...runtimeContextPayload(options),\n });\n }\n\n async delete(\n target: string | MemorySnapshot,\n path: string,\n options: MemoryDeleteOptions = {},\n ) {\n const snapshot =\n typeof target === \"string\" ? await this.pull(target) : target;\n return this.push(snapshot.repo.repoHandle, {\n files: { [path]: null },\n parentCommit: options.parentCommit ?? snapshot.commit.commitHash,\n message: options.message,\n ...runtimeContextPayload(options),\n });\n }\n\n private async push(\n identifier: string,\n payload: Record<string, unknown>,\n ): Promise<MemoryPushResponse> {\n return this.requestJson<MemoryPushResponse>(\n \"POST\",\n `/api/public/context/memory/${encodeIdentifier(identifier)}`,\n payload,\n );\n }\n\n private async requestJson<TResponse>(\n method: \"GET\" | \"POST\",\n path: string,\n payload?: Record<string, unknown>,\n ): Promise<TResponse> {\n const response = await fetch(`${this.host}${path}`, {\n method,\n headers: {\n Authorization: this.authHeader(),\n ...(payload ? { \"Content-Type\": \"application/json\" } : {}),\n },\n ...(payload ? { body: JSON.stringify(payload) } : {}),\n });\n\n const text = await response.text();\n const body = text ? safeJson(text) : {};\n if (!response.ok) {\n const message =\n typeof body.message === \"string\"\n ? body.message\n : `Gateway API ${response.status} on ${path}`;\n if (response.status === 409) {\n throw new GatewayMemoryConflictError(\n message,\n body.latestCommit ?? null,\n );\n }\n throw new GatewayMemoryError(message);\n }\n\n this.log(\"%s %s -> %s\", method, path, response.status);\n return body as TResponse;\n }\n\n private authHeader() {\n return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(\n \"base64\",\n )}`;\n }\n\n private log(message: string, ...args: unknown[]) {\n if (this.debug) {\n console.log(`[gateway.memory] ${message}`, ...args);\n }\n }\n}\n\nfunction runtimeContextPayload(options: MemoryRuntimeContext) {\n return {\n ...(options.source ? { source: options.source } : {}),\n ...(options.actorType ? { actorType: options.actorType } : {}),\n ...(options.proposedBy ? { proposedBy: options.proposedBy } : {}),\n ...(options.agentId ? { agentId: options.agentId } : {}),\n ...(options.agentStableId ? { agentStableId: options.agentStableId } : {}),\n ...(options.processId ? { processId: options.processId } : {}),\n ...(options.traceId ? { traceId: options.traceId } : {}),\n ...(options.spanId ? { spanId: options.spanId } : {}),\n ...(options.sessionId ? { sessionId: options.sessionId } : {}),\n ...(options.userId ? { userId: options.userId } : {}),\n ...(options.teamId ? { teamId: options.teamId } : {}),\n ...(options.metadata ? { metadata: options.metadata } : {}),\n };\n}\n\nfunction encodeIdentifier(identifier: string) {\n return identifier\n .split(\"/\")\n .filter(Boolean)\n .map((part) => encodeURIComponent(part))\n .join(\"/\");\n}\n\nfunction safeJson(value: string): Record<string, unknown> {\n try {\n const parsed = JSON.parse(value);\n return parsed && typeof parsed === \"object\" && !Array.isArray(parsed)\n ? (parsed as Record<string, unknown>)\n : {};\n } catch {\n return {};\n }\n}\n\nexport const memory = {\n fromEnv: GatewayMemory.fromEnv,\n};\n\nexport type {\n GatewayMemoryConfig,\n MemoryCommit as GatewayMemoryCommit,\n MemoryDeleteOptions as GatewayMemoryDeleteOptions,\n MemoryFileEntry as GatewayMemoryFileEntry,\n MemoryPullOptions as GatewayMemoryPullOptions,\n MemoryPushResponse as GatewayMemoryPushResponse,\n MemoryRepo as GatewayMemoryRepo,\n MemoryRuntimeContext as GatewayMemoryRuntimeContext,\n MemorySnapshot as GatewayMemorySnapshot,\n MemoryWriteOptions as GatewayMemoryWriteOptions,\n MemoryWritePolicy as GatewayMemoryWritePolicy,\n};\n"],"mappings":"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","names":[]}
@@ -0,0 +1,164 @@
1
+ // src/memory/index.ts
2
+ var GatewayMemoryError = class extends Error {
3
+ constructor(message, options) {
4
+ super(message);
5
+ this.name = "GatewayMemoryError";
6
+ this.cause = options?.cause;
7
+ }
8
+ };
9
+ var GatewayMemoryConflictError = class extends GatewayMemoryError {
10
+ latestCommit;
11
+ constructor(message, latestCommit) {
12
+ super(message);
13
+ this.name = "GatewayMemoryConflictError";
14
+ this.latestCommit = latestCommit;
15
+ }
16
+ };
17
+ var GatewayMemory = class _GatewayMemory {
18
+ host;
19
+ publicKey;
20
+ secretKey;
21
+ debug;
22
+ constructor(config) {
23
+ this.host = config.host.replace(/\/$/, "");
24
+ this.publicKey = config.publicKey;
25
+ this.secretKey = config.secretKey;
26
+ this.debug = config.debug ?? false;
27
+ }
28
+ static fromEnv(config = {}) {
29
+ const host = config.host ?? process.env.GATEWAY_HOST;
30
+ const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;
31
+ const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;
32
+ const missing = [
33
+ ["host", host],
34
+ ["publicKey", publicKey],
35
+ ["secretKey", secretKey]
36
+ ].filter(([, value]) => !value).map(([name]) => name);
37
+ if (missing.length > 0) {
38
+ throw new GatewayMemoryError(
39
+ `Missing Gateway memory configuration: ${missing.join(", ")}`
40
+ );
41
+ }
42
+ return new _GatewayMemory({
43
+ ...config,
44
+ host,
45
+ publicKey,
46
+ secretKey
47
+ });
48
+ }
49
+ async pull(identifier, options = {}) {
50
+ const query = new URLSearchParams();
51
+ if (options.version) query.set("version", options.version);
52
+ const suffix = query.toString() ? `?${query.toString()}` : "";
53
+ return this.requestJson(
54
+ "GET",
55
+ `/api/public/context/memory/${encodeIdentifier(identifier)}${suffix}`
56
+ );
57
+ }
58
+ async read(target, path, options = {}) {
59
+ const snapshot = typeof target === "string" ? await this.pull(target, options) : target;
60
+ const file = snapshot.files[path];
61
+ return file?.type === "file" ? file.content : null;
62
+ }
63
+ async write(target, path, content, options = {}) {
64
+ const snapshot = typeof target === "string" ? await this.pull(target) : target;
65
+ return this.push(snapshot.repo.repoHandle, {
66
+ files: {
67
+ [path]: {
68
+ content,
69
+ ...options.mimeType ? { mimeType: options.mimeType } : {}
70
+ }
71
+ },
72
+ parentCommit: options.parentCommit ?? snapshot.commit.commitHash,
73
+ message: options.message,
74
+ ...runtimeContextPayload(options)
75
+ });
76
+ }
77
+ async delete(target, path, options = {}) {
78
+ const snapshot = typeof target === "string" ? await this.pull(target) : target;
79
+ return this.push(snapshot.repo.repoHandle, {
80
+ files: { [path]: null },
81
+ parentCommit: options.parentCommit ?? snapshot.commit.commitHash,
82
+ message: options.message,
83
+ ...runtimeContextPayload(options)
84
+ });
85
+ }
86
+ async push(identifier, payload) {
87
+ return this.requestJson(
88
+ "POST",
89
+ `/api/public/context/memory/${encodeIdentifier(identifier)}`,
90
+ payload
91
+ );
92
+ }
93
+ async requestJson(method, path, payload) {
94
+ const response = await fetch(`${this.host}${path}`, {
95
+ method,
96
+ headers: {
97
+ Authorization: this.authHeader(),
98
+ ...payload ? { "Content-Type": "application/json" } : {}
99
+ },
100
+ ...payload ? { body: JSON.stringify(payload) } : {}
101
+ });
102
+ const text = await response.text();
103
+ const body = text ? safeJson(text) : {};
104
+ if (!response.ok) {
105
+ const message = typeof body.message === "string" ? body.message : `Gateway API ${response.status} on ${path}`;
106
+ if (response.status === 409) {
107
+ throw new GatewayMemoryConflictError(
108
+ message,
109
+ body.latestCommit ?? null
110
+ );
111
+ }
112
+ throw new GatewayMemoryError(message);
113
+ }
114
+ this.log("%s %s -> %s", method, path, response.status);
115
+ return body;
116
+ }
117
+ authHeader() {
118
+ return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(
119
+ "base64"
120
+ )}`;
121
+ }
122
+ log(message, ...args) {
123
+ if (this.debug) {
124
+ console.log(`[gateway.memory] ${message}`, ...args);
125
+ }
126
+ }
127
+ };
128
+ function runtimeContextPayload(options) {
129
+ return {
130
+ ...options.source ? { source: options.source } : {},
131
+ ...options.actorType ? { actorType: options.actorType } : {},
132
+ ...options.proposedBy ? { proposedBy: options.proposedBy } : {},
133
+ ...options.agentId ? { agentId: options.agentId } : {},
134
+ ...options.agentStableId ? { agentStableId: options.agentStableId } : {},
135
+ ...options.processId ? { processId: options.processId } : {},
136
+ ...options.traceId ? { traceId: options.traceId } : {},
137
+ ...options.spanId ? { spanId: options.spanId } : {},
138
+ ...options.sessionId ? { sessionId: options.sessionId } : {},
139
+ ...options.userId ? { userId: options.userId } : {},
140
+ ...options.teamId ? { teamId: options.teamId } : {},
141
+ ...options.metadata ? { metadata: options.metadata } : {}
142
+ };
143
+ }
144
+ function encodeIdentifier(identifier) {
145
+ return identifier.split("/").filter(Boolean).map((part) => encodeURIComponent(part)).join("/");
146
+ }
147
+ function safeJson(value) {
148
+ try {
149
+ const parsed = JSON.parse(value);
150
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
151
+ } catch {
152
+ return {};
153
+ }
154
+ }
155
+ var memory = {
156
+ fromEnv: GatewayMemory.fromEnv
157
+ };
158
+ export {
159
+ GatewayMemory,
160
+ GatewayMemoryConflictError,
161
+ GatewayMemoryError,
162
+ memory
163
+ };
164
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/memory/index.ts"],"sourcesContent":["type MemoryWritePolicy = \"read_only\" | \"propose\" | \"commit\";\n\ntype MemoryFileEntry =\n | {\n type: \"file\";\n content: string;\n mimeType: string;\n mime_type: string;\n }\n | {\n type: \"agent\" | \"skill\";\n repoHandle: string;\n repo_handle: string;\n commitId?: string | null;\n commit_id?: string | null;\n };\n\ntype MemoryRepo = {\n id: string;\n repoHandle: string;\n repo_handle: string;\n ownerHandle: string;\n owner_handle: string;\n kind: \"memory\";\n description: string;\n readme: string;\n tags: string[];\n writePolicy: MemoryWritePolicy;\n write_policy: MemoryWritePolicy;\n isPublic: boolean;\n is_public: boolean;\n isArchived: boolean;\n is_archived: boolean;\n url?: string;\n createdAt: string;\n created_at: string;\n updatedAt: string;\n updated_at: string;\n};\n\ntype MemoryCommit = {\n id: string;\n commitHash: string;\n commit_hash: string;\n parentCommitHash: string | null;\n parent_commit_hash: string | null;\n createdAt: string;\n created_at: string;\n};\n\ntype MemorySnapshot = {\n repo: MemoryRepo;\n commit: MemoryCommit;\n files: Record<string, MemoryFileEntry>;\n};\n\ntype MemoryPushResponse = {\n url: string;\n status: \"committed\" | \"proposed\";\n repoId: string;\n repo_id: string;\n commitId: string | null;\n commit_id: string | null;\n commitHash: string | null;\n commit_hash: string | null;\n proposalId?: string | null;\n proposal_id?: string | null;\n};\n\ntype MemoryRuntimeContext = {\n source?: \"sdk\" | \"agent\" | \"dream\" | \"api\" | \"platform\";\n actorType?: \"api_key\" | \"agent\" | \"process\" | \"user\";\n proposedBy?: string;\n agentId?: string;\n agentStableId?: string;\n processId?: string;\n traceId?: string;\n spanId?: string;\n sessionId?: string;\n userId?: string;\n teamId?: string;\n metadata?: Record<string, unknown>;\n};\n\ntype MemoryPullOptions = {\n version?: string;\n};\n\ntype MemoryWriteOptions = MemoryRuntimeContext & {\n parentCommit?: string;\n message?: string;\n mimeType?: string;\n};\n\ntype MemoryDeleteOptions = MemoryRuntimeContext & {\n parentCommit?: string;\n message?: string;\n};\n\ntype GatewayMemoryConfig = {\n host: string;\n publicKey: string;\n secretKey: string;\n debug?: boolean;\n};\n\ntype GatewayMemoryFromEnvConfig = Partial<GatewayMemoryConfig>;\n\nexport class GatewayMemoryError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = \"GatewayMemoryError\";\n this.cause = options?.cause;\n }\n}\n\nexport class GatewayMemoryConflictError extends GatewayMemoryError {\n readonly latestCommit: unknown;\n\n constructor(message: string, latestCommit: unknown) {\n super(message);\n this.name = \"GatewayMemoryConflictError\";\n this.latestCommit = latestCommit;\n }\n}\n\nexport class GatewayMemory {\n private readonly host: string;\n private readonly publicKey: string;\n private readonly secretKey: string;\n private readonly debug: boolean;\n\n constructor(config: GatewayMemoryConfig) {\n this.host = config.host.replace(/\\/$/, \"\");\n this.publicKey = config.publicKey;\n this.secretKey = config.secretKey;\n this.debug = config.debug ?? false;\n }\n\n static fromEnv(config: GatewayMemoryFromEnvConfig = {}) {\n const host = config.host ?? process.env.GATEWAY_HOST;\n const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;\n const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;\n\n const missing = [\n [\"host\", host],\n [\"publicKey\", publicKey],\n [\"secretKey\", secretKey],\n ]\n .filter(([, value]) => !value)\n .map(([name]) => name);\n\n if (missing.length > 0) {\n throw new GatewayMemoryError(\n `Missing Gateway memory configuration: ${missing.join(\", \")}`,\n );\n }\n\n return new GatewayMemory({\n ...config,\n host: host!,\n publicKey: publicKey!,\n secretKey: secretKey!,\n });\n }\n\n async pull(\n identifier: string,\n options: MemoryPullOptions = {},\n ): Promise<MemorySnapshot> {\n const query = new URLSearchParams();\n if (options.version) query.set(\"version\", options.version);\n const suffix = query.toString() ? `?${query.toString()}` : \"\";\n return this.requestJson<MemorySnapshot>(\n \"GET\",\n `/api/public/context/memory/${encodeIdentifier(identifier)}${suffix}`,\n );\n }\n\n async read(\n target: string | MemorySnapshot,\n path: string,\n options: MemoryPullOptions = {},\n ): Promise<string | null> {\n const snapshot =\n typeof target === \"string\" ? await this.pull(target, options) : target;\n const file = snapshot.files[path];\n return file?.type === \"file\" ? file.content : null;\n }\n\n async write(\n target: string | MemorySnapshot,\n path: string,\n content: string,\n options: MemoryWriteOptions = {},\n ) {\n const snapshot =\n typeof target === \"string\" ? await this.pull(target) : target;\n return this.push(snapshot.repo.repoHandle, {\n files: {\n [path]: {\n content,\n ...(options.mimeType ? { mimeType: options.mimeType } : {}),\n },\n },\n parentCommit: options.parentCommit ?? snapshot.commit.commitHash,\n message: options.message,\n ...runtimeContextPayload(options),\n });\n }\n\n async delete(\n target: string | MemorySnapshot,\n path: string,\n options: MemoryDeleteOptions = {},\n ) {\n const snapshot =\n typeof target === \"string\" ? await this.pull(target) : target;\n return this.push(snapshot.repo.repoHandle, {\n files: { [path]: null },\n parentCommit: options.parentCommit ?? snapshot.commit.commitHash,\n message: options.message,\n ...runtimeContextPayload(options),\n });\n }\n\n private async push(\n identifier: string,\n payload: Record<string, unknown>,\n ): Promise<MemoryPushResponse> {\n return this.requestJson<MemoryPushResponse>(\n \"POST\",\n `/api/public/context/memory/${encodeIdentifier(identifier)}`,\n payload,\n );\n }\n\n private async requestJson<TResponse>(\n method: \"GET\" | \"POST\",\n path: string,\n payload?: Record<string, unknown>,\n ): Promise<TResponse> {\n const response = await fetch(`${this.host}${path}`, {\n method,\n headers: {\n Authorization: this.authHeader(),\n ...(payload ? { \"Content-Type\": \"application/json\" } : {}),\n },\n ...(payload ? { body: JSON.stringify(payload) } : {}),\n });\n\n const text = await response.text();\n const body = text ? safeJson(text) : {};\n if (!response.ok) {\n const message =\n typeof body.message === \"string\"\n ? body.message\n : `Gateway API ${response.status} on ${path}`;\n if (response.status === 409) {\n throw new GatewayMemoryConflictError(\n message,\n body.latestCommit ?? null,\n );\n }\n throw new GatewayMemoryError(message);\n }\n\n this.log(\"%s %s -> %s\", method, path, response.status);\n return body as TResponse;\n }\n\n private authHeader() {\n return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(\n \"base64\",\n )}`;\n }\n\n private log(message: string, ...args: unknown[]) {\n if (this.debug) {\n console.log(`[gateway.memory] ${message}`, ...args);\n }\n }\n}\n\nfunction runtimeContextPayload(options: MemoryRuntimeContext) {\n return {\n ...(options.source ? { source: options.source } : {}),\n ...(options.actorType ? { actorType: options.actorType } : {}),\n ...(options.proposedBy ? { proposedBy: options.proposedBy } : {}),\n ...(options.agentId ? { agentId: options.agentId } : {}),\n ...(options.agentStableId ? { agentStableId: options.agentStableId } : {}),\n ...(options.processId ? { processId: options.processId } : {}),\n ...(options.traceId ? { traceId: options.traceId } : {}),\n ...(options.spanId ? { spanId: options.spanId } : {}),\n ...(options.sessionId ? { sessionId: options.sessionId } : {}),\n ...(options.userId ? { userId: options.userId } : {}),\n ...(options.teamId ? { teamId: options.teamId } : {}),\n ...(options.metadata ? { metadata: options.metadata } : {}),\n };\n}\n\nfunction encodeIdentifier(identifier: string) {\n return identifier\n .split(\"/\")\n .filter(Boolean)\n .map((part) => encodeURIComponent(part))\n .join(\"/\");\n}\n\nfunction safeJson(value: string): Record<string, unknown> {\n try {\n const parsed = JSON.parse(value);\n return parsed && typeof parsed === \"object\" && !Array.isArray(parsed)\n ? (parsed as Record<string, unknown>)\n : {};\n } catch {\n return {};\n }\n}\n\nexport const memory = {\n fromEnv: GatewayMemory.fromEnv,\n};\n\nexport type {\n GatewayMemoryConfig,\n MemoryCommit as GatewayMemoryCommit,\n MemoryDeleteOptions as GatewayMemoryDeleteOptions,\n MemoryFileEntry as GatewayMemoryFileEntry,\n MemoryPullOptions as GatewayMemoryPullOptions,\n MemoryPushResponse as GatewayMemoryPushResponse,\n MemoryRepo as GatewayMemoryRepo,\n MemoryRuntimeContext as GatewayMemoryRuntimeContext,\n MemorySnapshot as GatewayMemorySnapshot,\n MemoryWriteOptions as GatewayMemoryWriteOptions,\n MemoryWritePolicy as GatewayMemoryWritePolicy,\n};\n"],"mappings":";AA4GO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5C,YAAY,SAAiB,SAA+B;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,QAAQ,SAAS;AAAA,EACxB;AACF;AAEO,IAAM,6BAAN,cAAyC,mBAAmB;AAAA,EACxD;AAAA,EAET,YAAY,SAAiB,cAAuB;AAClD,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,eAAe;AAAA,EACtB;AACF;AAEO,IAAM,gBAAN,MAAM,eAAc;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,QAA6B;AACvC,SAAK,OAAO,OAAO,KAAK,QAAQ,OAAO,EAAE;AACzC,SAAK,YAAY,OAAO;AACxB,SAAK,YAAY,OAAO;AACxB,SAAK,QAAQ,OAAO,SAAS;AAAA,EAC/B;AAAA,EAEA,OAAO,QAAQ,SAAqC,CAAC,GAAG;AACtD,UAAM,OAAO,OAAO,QAAQ,QAAQ,IAAI;AACxC,UAAM,YAAY,OAAO,aAAa,QAAQ,IAAI;AAClD,UAAM,YAAY,OAAO,aAAa,QAAQ,IAAI;AAElD,UAAM,UAAU;AAAA,MACd,CAAC,QAAQ,IAAI;AAAA,MACb,CAAC,aAAa,SAAS;AAAA,MACvB,CAAC,aAAa,SAAS;AAAA,IACzB,EACG,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,EAC5B,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AAEvB,QAAI,QAAQ,SAAS,GAAG;AACtB,YAAM,IAAI;AAAA,QACR,yCAAyC,QAAQ,KAAK,IAAI,CAAC;AAAA,MAC7D;AAAA,IACF;AAEA,WAAO,IAAI,eAAc;AAAA,MACvB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,KACJ,YACA,UAA6B,CAAC,GACL;AACzB,UAAM,QAAQ,IAAI,gBAAgB;AAClC,QAAI,QAAQ,QAAS,OAAM,IAAI,WAAW,QAAQ,OAAO;AACzD,UAAM,SAAS,MAAM,SAAS,IAAI,IAAI,MAAM,SAAS,CAAC,KAAK;AAC3D,WAAO,KAAK;AAAA,MACV;AAAA,MACA,8BAA8B,iBAAiB,UAAU,CAAC,GAAG,MAAM;AAAA,IACrE;AAAA,EACF;AAAA,EAEA,MAAM,KACJ,QACA,MACA,UAA6B,CAAC,GACN;AACxB,UAAM,WACJ,OAAO,WAAW,WAAW,MAAM,KAAK,KAAK,QAAQ,OAAO,IAAI;AAClE,UAAM,OAAO,SAAS,MAAM,IAAI;AAChC,WAAO,MAAM,SAAS,SAAS,KAAK,UAAU;AAAA,EAChD;AAAA,EAEA,MAAM,MACJ,QACA,MACA,SACA,UAA8B,CAAC,GAC/B;AACA,UAAM,WACJ,OAAO,WAAW,WAAW,MAAM,KAAK,KAAK,MAAM,IAAI;AACzD,WAAO,KAAK,KAAK,SAAS,KAAK,YAAY;AAAA,MACzC,OAAO;AAAA,QACL,CAAC,IAAI,GAAG;AAAA,UACN;AAAA,UACA,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,QAC3D;AAAA,MACF;AAAA,MACA,cAAc,QAAQ,gBAAgB,SAAS,OAAO;AAAA,MACtD,SAAS,QAAQ;AAAA,MACjB,GAAG,sBAAsB,OAAO;AAAA,IAClC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OACJ,QACA,MACA,UAA+B,CAAC,GAChC;AACA,UAAM,WACJ,OAAO,WAAW,WAAW,MAAM,KAAK,KAAK,MAAM,IAAI;AACzD,WAAO,KAAK,KAAK,SAAS,KAAK,YAAY;AAAA,MACzC,OAAO,EAAE,CAAC,IAAI,GAAG,KAAK;AAAA,MACtB,cAAc,QAAQ,gBAAgB,SAAS,OAAO;AAAA,MACtD,SAAS,QAAQ;AAAA,MACjB,GAAG,sBAAsB,OAAO;AAAA,IAClC,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,KACZ,YACA,SAC6B;AAC7B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,8BAA8B,iBAAiB,UAAU,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,YACZ,QACA,MACA,SACoB;AACpB,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,IAAI,IAAI;AAAA,MAClD;AAAA,MACA,SAAS;AAAA,QACP,eAAe,KAAK,WAAW;AAAA,QAC/B,GAAI,UAAU,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,MAC1D;AAAA,MACA,GAAI,UAAU,EAAE,MAAM,KAAK,UAAU,OAAO,EAAE,IAAI,CAAC;AAAA,IACrD,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,UAAM,OAAO,OAAO,SAAS,IAAI,IAAI,CAAC;AACtC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,UACJ,OAAO,KAAK,YAAY,WACpB,KAAK,UACL,eAAe,SAAS,MAAM,OAAO,IAAI;AAC/C,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI;AAAA,UACR;AAAA,UACA,KAAK,gBAAgB;AAAA,QACvB;AAAA,MACF;AACA,YAAM,IAAI,mBAAmB,OAAO;AAAA,IACtC;AAEA,SAAK,IAAI,eAAe,QAAQ,MAAM,SAAS,MAAM;AACrD,WAAO;AAAA,EACT;AAAA,EAEQ,aAAa;AACnB,WAAO,SAAS,OAAO,KAAK,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS,EAAE,EAAE;AAAA,MACjE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,IAAI,YAAoB,MAAiB;AAC/C,QAAI,KAAK,OAAO;AACd,cAAQ,IAAI,oBAAoB,OAAO,IAAI,GAAG,IAAI;AAAA,IACpD;AAAA,EACF;AACF;AAEA,SAAS,sBAAsB,SAA+B;AAC5D,SAAO;AAAA,IACL,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnD,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;AAAA,IAC5D,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;AAAA,IAC/D,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,IACtD,GAAI,QAAQ,gBAAgB,EAAE,eAAe,QAAQ,cAAc,IAAI,CAAC;AAAA,IACxE,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;AAAA,IAC5D,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,IACtD,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnD,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;AAAA,IAC5D,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnD,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnD,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,EAC3D;AACF;AAEA,SAAS,iBAAiB,YAAoB;AAC5C,SAAO,WACJ,MAAM,GAAG,EACT,OAAO,OAAO,EACd,IAAI,CAAC,SAAS,mBAAmB,IAAI,CAAC,EACtC,KAAK,GAAG;AACb;AAEA,SAAS,SAAS,OAAwC;AACxD,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,WAAO,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,MAAM,IAC/D,SACD,CAAC;AAAA,EACP,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEO,IAAM,SAAS;AAAA,EACpB,SAAS,cAAc;AACzB;","names":[]}
@@ -0,0 +1,114 @@
1
+ type AgentDescriptor = {
2
+ id?: string;
3
+ name?: string;
4
+ version?: string;
5
+ };
6
+ type SecurityContext = {
7
+ executionId?: string;
8
+ userId?: string;
9
+ teamId?: string;
10
+ environment?: string;
11
+ contextLabel?: string;
12
+ contextBundleHash?: string;
13
+ traceId?: string;
14
+ sessionId?: string;
15
+ spanId?: string;
16
+ metadata?: Record<string, unknown>;
17
+ };
18
+ type ToolDescriptor = {
19
+ id: string;
20
+ name?: string;
21
+ description?: string;
22
+ metadata?: Record<string, unknown>;
23
+ };
24
+ type ToolsetResolveResponse = {
25
+ toolsetId: string;
26
+ mode: "observe" | "filter" | "enforce";
27
+ policyVersion: number;
28
+ ttlSeconds: number;
29
+ allowedToolIds: string[];
30
+ blockedToolIds: string[];
31
+ approvalToolIds: string[];
32
+ secretBindings: Record<string, string[]>;
33
+ failMode: "open" | "closed";
34
+ };
35
+ type ToolCallAuthorizeResponse = {
36
+ decisionId: string;
37
+ outcome: "allow" | "flag" | "block" | "approval_required";
38
+ reasonCode: string;
39
+ message: string;
40
+ policyVersion: number;
41
+ };
42
+ type ToolObject = {
43
+ description?: string;
44
+ execute?: (...args: unknown[]) => unknown;
45
+ [key: string]: unknown;
46
+ };
47
+ type ToolCollection = Record<string, ToolObject | ((...args: unknown[]) => unknown)>;
48
+ type SecureToolsOptions<TTools extends ToolCollection> = {
49
+ toolsetId: string;
50
+ toolsetName?: string;
51
+ provider?: string;
52
+ tools: TTools;
53
+ context?: SecurityContext;
54
+ toolIds?: Partial<Record<keyof TTools & string, string>>;
55
+ toolMetadata?: Partial<Record<keyof TTools & string, Record<string, unknown>>>;
56
+ };
57
+ type GatewaySecurityConfig = {
58
+ host: string;
59
+ publicKey: string;
60
+ secretKey: string;
61
+ agent?: AgentDescriptor;
62
+ debug?: boolean;
63
+ failOpen?: boolean;
64
+ };
65
+ type GatewaySecurityFromEnvConfig = Partial<Pick<GatewaySecurityConfig, "host" | "publicKey" | "secretKey">> & Pick<GatewaySecurityConfig, "agent" | "debug" | "failOpen">;
66
+ declare class GatewaySecurityError extends Error {
67
+ constructor(message: string, options?: {
68
+ cause?: unknown;
69
+ });
70
+ }
71
+ declare class GatewayToolBlockedError extends GatewaySecurityError {
72
+ readonly decision: ToolCallAuthorizeResponse;
73
+ readonly toolId: string;
74
+ constructor(toolId: string, decision: ToolCallAuthorizeResponse);
75
+ }
76
+ /**
77
+ * Thrown when Gateway's policy returns `approval_required` for a tool call.
78
+ * The SDK does NOT execute the tool — a human/system approval is needed first
79
+ * (the server engine and the runtime MCP PEP both honor this; this closes the
80
+ * SDK leg of the step-up gate so an approval decision can't be silently run).
81
+ */
82
+ declare class GatewayToolApprovalRequiredError extends GatewaySecurityError {
83
+ readonly decision: ToolCallAuthorizeResponse;
84
+ readonly toolId: string;
85
+ constructor(toolId: string, decision: ToolCallAuthorizeResponse);
86
+ }
87
+ declare class GatewaySecurity {
88
+ private readonly host;
89
+ private readonly publicKey;
90
+ private readonly secretKey;
91
+ private readonly agent;
92
+ private readonly debug;
93
+ private readonly failOpen;
94
+ constructor(config: GatewaySecurityConfig);
95
+ static fromEnv(config?: GatewaySecurityFromEnvConfig): GatewaySecurity;
96
+ secureTools<TTools extends ToolCollection>(options: SecureToolsOptions<TTools>): Promise<TTools>;
97
+ private resolveToolset;
98
+ private authorizeToolCall;
99
+ private wrapTool;
100
+ private wrapExecute;
101
+ private authorizeOrFallback;
102
+ private postJson;
103
+ private describeTool;
104
+ private shouldExposeTool;
105
+ private normalizeContext;
106
+ private authHeader;
107
+ private setSpanAttributes;
108
+ private log;
109
+ }
110
+ declare const gateway: {
111
+ fromEnv: typeof GatewaySecurity.fromEnv;
112
+ };
113
+
114
+ export { type AgentDescriptor as GatewayAgentDescriptor, GatewaySecurity, type GatewaySecurityConfig, type SecurityContext as GatewaySecurityContext, GatewaySecurityError, GatewayToolApprovalRequiredError, GatewayToolBlockedError, type ToolCallAuthorizeResponse as GatewayToolCallAuthorizeResponse, type ToolDescriptor as GatewayToolDescriptor, type ToolsetResolveResponse as GatewayToolsetResolveResponse, type SecureToolsOptions, gateway };
@@ -0,0 +1,114 @@
1
+ type AgentDescriptor = {
2
+ id?: string;
3
+ name?: string;
4
+ version?: string;
5
+ };
6
+ type SecurityContext = {
7
+ executionId?: string;
8
+ userId?: string;
9
+ teamId?: string;
10
+ environment?: string;
11
+ contextLabel?: string;
12
+ contextBundleHash?: string;
13
+ traceId?: string;
14
+ sessionId?: string;
15
+ spanId?: string;
16
+ metadata?: Record<string, unknown>;
17
+ };
18
+ type ToolDescriptor = {
19
+ id: string;
20
+ name?: string;
21
+ description?: string;
22
+ metadata?: Record<string, unknown>;
23
+ };
24
+ type ToolsetResolveResponse = {
25
+ toolsetId: string;
26
+ mode: "observe" | "filter" | "enforce";
27
+ policyVersion: number;
28
+ ttlSeconds: number;
29
+ allowedToolIds: string[];
30
+ blockedToolIds: string[];
31
+ approvalToolIds: string[];
32
+ secretBindings: Record<string, string[]>;
33
+ failMode: "open" | "closed";
34
+ };
35
+ type ToolCallAuthorizeResponse = {
36
+ decisionId: string;
37
+ outcome: "allow" | "flag" | "block" | "approval_required";
38
+ reasonCode: string;
39
+ message: string;
40
+ policyVersion: number;
41
+ };
42
+ type ToolObject = {
43
+ description?: string;
44
+ execute?: (...args: unknown[]) => unknown;
45
+ [key: string]: unknown;
46
+ };
47
+ type ToolCollection = Record<string, ToolObject | ((...args: unknown[]) => unknown)>;
48
+ type SecureToolsOptions<TTools extends ToolCollection> = {
49
+ toolsetId: string;
50
+ toolsetName?: string;
51
+ provider?: string;
52
+ tools: TTools;
53
+ context?: SecurityContext;
54
+ toolIds?: Partial<Record<keyof TTools & string, string>>;
55
+ toolMetadata?: Partial<Record<keyof TTools & string, Record<string, unknown>>>;
56
+ };
57
+ type GatewaySecurityConfig = {
58
+ host: string;
59
+ publicKey: string;
60
+ secretKey: string;
61
+ agent?: AgentDescriptor;
62
+ debug?: boolean;
63
+ failOpen?: boolean;
64
+ };
65
+ type GatewaySecurityFromEnvConfig = Partial<Pick<GatewaySecurityConfig, "host" | "publicKey" | "secretKey">> & Pick<GatewaySecurityConfig, "agent" | "debug" | "failOpen">;
66
+ declare class GatewaySecurityError extends Error {
67
+ constructor(message: string, options?: {
68
+ cause?: unknown;
69
+ });
70
+ }
71
+ declare class GatewayToolBlockedError extends GatewaySecurityError {
72
+ readonly decision: ToolCallAuthorizeResponse;
73
+ readonly toolId: string;
74
+ constructor(toolId: string, decision: ToolCallAuthorizeResponse);
75
+ }
76
+ /**
77
+ * Thrown when Gateway's policy returns `approval_required` for a tool call.
78
+ * The SDK does NOT execute the tool — a human/system approval is needed first
79
+ * (the server engine and the runtime MCP PEP both honor this; this closes the
80
+ * SDK leg of the step-up gate so an approval decision can't be silently run).
81
+ */
82
+ declare class GatewayToolApprovalRequiredError extends GatewaySecurityError {
83
+ readonly decision: ToolCallAuthorizeResponse;
84
+ readonly toolId: string;
85
+ constructor(toolId: string, decision: ToolCallAuthorizeResponse);
86
+ }
87
+ declare class GatewaySecurity {
88
+ private readonly host;
89
+ private readonly publicKey;
90
+ private readonly secretKey;
91
+ private readonly agent;
92
+ private readonly debug;
93
+ private readonly failOpen;
94
+ constructor(config: GatewaySecurityConfig);
95
+ static fromEnv(config?: GatewaySecurityFromEnvConfig): GatewaySecurity;
96
+ secureTools<TTools extends ToolCollection>(options: SecureToolsOptions<TTools>): Promise<TTools>;
97
+ private resolveToolset;
98
+ private authorizeToolCall;
99
+ private wrapTool;
100
+ private wrapExecute;
101
+ private authorizeOrFallback;
102
+ private postJson;
103
+ private describeTool;
104
+ private shouldExposeTool;
105
+ private normalizeContext;
106
+ private authHeader;
107
+ private setSpanAttributes;
108
+ private log;
109
+ }
110
+ declare const gateway: {
111
+ fromEnv: typeof GatewaySecurity.fromEnv;
112
+ };
113
+
114
+ export { type AgentDescriptor as GatewayAgentDescriptor, GatewaySecurity, type GatewaySecurityConfig, type SecurityContext as GatewaySecurityContext, GatewaySecurityError, GatewayToolApprovalRequiredError, GatewayToolBlockedError, type ToolCallAuthorizeResponse as GatewayToolCallAuthorizeResponse, type ToolDescriptor as GatewayToolDescriptor, type ToolsetResolveResponse as GatewayToolsetResolveResponse, type SecureToolsOptions, gateway };