@withgateway/sdk 0.1.20 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/README.md +141 -2
  2. package/dist/cli.js +8683 -1343
  3. package/dist/cli.js.map +1 -1
  4. package/dist/cli.mjs +8683 -1344
  5. package/dist/cli.mjs.map +1 -1
  6. package/dist/index.d.mts +1 -1
  7. package/dist/index.d.ts +1 -1
  8. package/dist/index.js +979 -46
  9. package/dist/index.js.map +1 -1
  10. package/dist/index.mjs +943 -38
  11. package/dist/index.mjs.map +1 -1
  12. package/dist/tracing/index.js +9 -2
  13. package/dist/tracing/index.js.map +1 -1
  14. package/dist/tracing/index.mjs +9 -2
  15. package/dist/tracing/index.mjs.map +1 -1
  16. package/dist/worlds/index.d.mts +738 -28
  17. package/dist/worlds/index.d.ts +738 -28
  18. package/dist/worlds/index.js +940 -42
  19. package/dist/worlds/index.js.map +1 -1
  20. package/dist/worlds/index.mjs +934 -36
  21. package/dist/worlds/index.mjs.map +1 -1
  22. package/package.json +9 -2
  23. package/runtime/gatewaysdk/__init__.py +0 -0
  24. package/runtime/gatewaysdk/environment/__init__.py +108 -0
  25. package/runtime/gatewaysdk/environment/_bundle.py +281 -0
  26. package/runtime/gatewaysdk/environment/_harbor.py +276 -0
  27. package/runtime/gatewaysdk/environment/_materialize.py +97 -0
  28. package/runtime/gatewaysdk/environment/_tar.py +33 -0
  29. package/runtime/gatewaysdk/environment/_world.py +346 -0
  30. package/runtime/gatewaysdk/environment/core.py +527 -0
  31. package/runtime/gatewaysdk/environment/errors.py +58 -0
  32. package/runtime/gatewaysdk/environment/runtime.py +150 -0
  33. package/runtime/gatewaysdk/environment/schema/__init__.py +35 -0
  34. package/runtime/gatewaysdk/environment/schema/__main__.py +225 -0
  35. package/runtime/gatewaysdk/environment/schema/_slack_fidelity.py +116 -0
  36. package/runtime/gatewaysdk/environment/schema/_slack_scenario.py +183 -0
  37. package/runtime/gatewaysdk/environment/schema/api.py +1628 -0
  38. package/runtime/gatewaysdk/environment/schema/batch.py +755 -0
  39. package/runtime/gatewaysdk/environment/schema/compiler.py +615 -0
  40. package/runtime/gatewaysdk/environment/schema/conform.py +428 -0
  41. package/runtime/gatewaysdk/environment/schema/connector.py +777 -0
  42. package/runtime/gatewaysdk/environment/schema/connectors/apple-business-manager/handlers.py +17 -0
  43. package/runtime/gatewaysdk/environment/schema/connectors/apple-business-manager/parity.json +28 -0
  44. package/runtime/gatewaysdk/environment/schema/connectors/apple-business-manager/provenance.json +233 -0
  45. package/runtime/gatewaysdk/environment/schema/connectors/apple-business-manager/scope.toml +112 -0
  46. package/runtime/gatewaysdk/environment/schema/connectors/apple-business-manager/world.json +1380 -0
  47. package/runtime/gatewaysdk/environment/schema/connectors/base.json +28 -0
  48. package/runtime/gatewaysdk/environment/schema/connectors/custom/handlers.py +18 -0
  49. package/runtime/gatewaysdk/environment/schema/connectors/custom/world.json +123 -0
  50. package/runtime/gatewaysdk/environment/schema/connectors/github/handlers.py +81 -0
  51. package/runtime/gatewaysdk/environment/schema/connectors/github/parity.json +37 -0
  52. package/runtime/gatewaysdk/environment/schema/connectors/github/provenance.json +134 -0
  53. package/runtime/gatewaysdk/environment/schema/connectors/github/scope.toml +158 -0
  54. package/runtime/gatewaysdk/environment/schema/connectors/github/world.json +5869 -0
  55. package/runtime/gatewaysdk/environment/schema/connectors/google-calendar/handlers.py +23 -0
  56. package/runtime/gatewaysdk/environment/schema/connectors/google-calendar/world.json +209 -0
  57. package/runtime/gatewaysdk/environment/schema/connectors/google-drive/handlers.py +18 -0
  58. package/runtime/gatewaysdk/environment/schema/connectors/google-drive/world.json +286 -0
  59. package/runtime/gatewaysdk/environment/schema/connectors/jamf/handlers.py +34 -0
  60. package/runtime/gatewaysdk/environment/schema/connectors/jamf/parity.json +49 -0
  61. package/runtime/gatewaysdk/environment/schema/connectors/jamf/provenance.json +181 -0
  62. package/runtime/gatewaysdk/environment/schema/connectors/jamf/scope.toml +128 -0
  63. package/runtime/gatewaysdk/environment/schema/connectors/jamf/world.json +2218 -0
  64. package/runtime/gatewaysdk/environment/schema/connectors/jira/handlers.py +28 -0
  65. package/runtime/gatewaysdk/environment/schema/connectors/jira/world.json +389 -0
  66. package/runtime/gatewaysdk/environment/schema/connectors/kandji/handlers.py +38 -0
  67. package/runtime/gatewaysdk/environment/schema/connectors/kandji/parity.json +29 -0
  68. package/runtime/gatewaysdk/environment/schema/connectors/kandji/provenance.json +152 -0
  69. package/runtime/gatewaysdk/environment/schema/connectors/kandji/scope.toml +120 -0
  70. package/runtime/gatewaysdk/environment/schema/connectors/kandji/world.json +765 -0
  71. package/runtime/gatewaysdk/environment/schema/connectors/linear/handlers.py +20 -0
  72. package/runtime/gatewaysdk/environment/schema/connectors/linear/world.json +363 -0
  73. package/runtime/gatewaysdk/environment/schema/connectors/microsoft-teams/fidelity.json +45 -0
  74. package/runtime/gatewaysdk/environment/schema/connectors/microsoft-teams/handlers.py +1 -0
  75. package/runtime/gatewaysdk/environment/schema/connectors/microsoft-teams/provenance.json +851 -0
  76. package/runtime/gatewaysdk/environment/schema/connectors/microsoft-teams/scope.md +231 -0
  77. package/runtime/gatewaysdk/environment/schema/connectors/microsoft-teams/teams-types.json +1710 -0
  78. package/runtime/gatewaysdk/environment/schema/connectors/microsoft-teams/world.json +858 -0
  79. package/runtime/gatewaysdk/environment/schema/connectors/netsuite/handlers.py +32 -0
  80. package/runtime/gatewaysdk/environment/schema/connectors/netsuite/parity.json +50 -0
  81. package/runtime/gatewaysdk/environment/schema/connectors/netsuite/provenance.json +137 -0
  82. package/runtime/gatewaysdk/environment/schema/connectors/netsuite/scope.toml +78 -0
  83. package/runtime/gatewaysdk/environment/schema/connectors/netsuite/world.json +16243 -0
  84. package/runtime/gatewaysdk/environment/schema/connectors/salesforce/handlers.py +806 -0
  85. package/runtime/gatewaysdk/environment/schema/connectors/salesforce/parity.json +46 -0
  86. package/runtime/gatewaysdk/environment/schema/connectors/salesforce/provenance.json +143 -0
  87. package/runtime/gatewaysdk/environment/schema/connectors/salesforce/scope.toml +174 -0
  88. package/runtime/gatewaysdk/environment/schema/connectors/salesforce/world.json +4695 -0
  89. package/runtime/gatewaysdk/environment/schema/connectors/slack/MODEL.md +236 -0
  90. package/runtime/gatewaysdk/environment/schema/connectors/slack/capabilities.json +1039 -0
  91. package/runtime/gatewaysdk/environment/schema/connectors/slack/handlers.py +762 -0
  92. package/runtime/gatewaysdk/environment/schema/connectors/slack/parity.json +65 -0
  93. package/runtime/gatewaysdk/environment/schema/connectors/slack/provenance.json +294 -0
  94. package/runtime/gatewaysdk/environment/schema/connectors/slack/scope.toml +44 -0
  95. package/runtime/gatewaysdk/environment/schema/connectors/slack/world.json +4993 -0
  96. package/runtime/gatewaysdk/environment/schema/connectors/workday/handlers.py +75 -0
  97. package/runtime/gatewaysdk/environment/schema/connectors/workday/parity.json +36 -0
  98. package/runtime/gatewaysdk/environment/schema/connectors/workday/provenance.json +179 -0
  99. package/runtime/gatewaysdk/environment/schema/connectors/workday/scope.toml +180 -0
  100. package/runtime/gatewaysdk/environment/schema/connectors/workday/world.json +806 -0
  101. package/runtime/gatewaysdk/environment/schema/data.py +593 -0
  102. package/runtime/gatewaysdk/environment/schema/extract.py +263 -0
  103. package/runtime/gatewaysdk/environment/schema/host.py +2407 -0
  104. package/runtime/gatewaysdk/environment/schema/host_surfaces.py +275 -0
  105. package/runtime/gatewaysdk/environment/schema/platform.py +1272 -0
  106. package/runtime/gatewaysdk/environment/schema/scaffold.py +250 -0
  107. package/runtime/gatewaysdk/environment/schema/skill.py +118 -0
  108. package/runtime/gatewaysdk/environment/schema/skills/agents/connector-template-author.md +202 -0
  109. package/runtime/gatewaysdk/environment/schema/skills/connector-schema-authoring/CONNECTORS.md +331 -0
  110. package/runtime/gatewaysdk/environment/schema/skills/connector-schema-authoring/CONVENTIONS.md +100 -0
  111. package/runtime/gatewaysdk/environment/schema/skills/connector-schema-authoring/SKILL.md +313 -0
  112. package/runtime/gatewaysdk/environment/schema/skills/world-data-ingestion/ROWS.md +223 -0
  113. package/runtime/gatewaysdk/environment/schema/skills/world-data-ingestion/SKILL.md +293 -0
  114. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/SKILL.md +390 -0
  115. package/runtime/gatewaysdk/environment/schema/slack.py +757 -0
  116. package/runtime/gatewaysdk/environment/schema/snapshot.py +479 -0
  117. package/runtime/gatewaysdk/environment/schema/store.py +904 -0
  118. package/runtime/gatewaysdk/environment/schema/tasks.py +525 -0
  119. package/runtime/gatewaysdk/environment/schema/tools_world.py +322 -0
  120. package/runtime/gatewaysdk/environment/schema/validation.py +577 -0
  121. package/runtime/gatewaysdk/environment/schema/worker.py +78 -0
  122. package/runtime/gatewaysdk/environment/schema/workers.py +500 -0
  123. package/runtime/gatewaysdk/environment/schema/world_tests.py +336 -0
  124. package/skills/agents/connector-template-author.md +202 -0
  125. package/skills/connector-schema-authoring/CONNECTORS.md +331 -0
  126. package/skills/connector-schema-authoring/CONVENTIONS.md +100 -0
  127. package/skills/connector-schema-authoring/SKILL.md +313 -0
  128. package/skills/world-data-ingestion/ROWS.md +223 -0
  129. package/skills/world-data-ingestion/SKILL.md +293 -0
  130. package/skills/worlds-getting-started/SKILL.md +390 -0
@@ -0,0 +1,20 @@
1
+ """Linear world tools; every mutation goes through the schema store."""
2
+
3
+ from gateway_env import store, tool
4
+
5
+
6
+ @tool(name="list_issues")
7
+ def list_issues(team_id):
8
+ return [i for i in store.list("linear_issues") if i["team_id"] == team_id]
9
+
10
+
11
+ @tool(name="create_issue")
12
+ def create_issue(issue):
13
+ return store.insert("linear_issues", issue, source={"record": "tool.create_issue"})
14
+
15
+
16
+ @tool(name="set_state")
17
+ def set_state(id, state):
18
+ return store.update(
19
+ "linear_issues", {"id": id}, {"state": state}, source={"record": "tool.set_state"}
20
+ )
@@ -0,0 +1,363 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:gateway:connector:linear",
4
+ "$defs": {
5
+ "Team": {
6
+ "type": "object",
7
+ "properties": {
8
+ "id": {
9
+ "$ref": "base.json#/$defs/Id"
10
+ },
11
+ "key": {
12
+ "$ref": "base.json#/$defs/Label"
13
+ },
14
+ "name": {
15
+ "$ref": "base.json#/$defs/Label"
16
+ }
17
+ },
18
+ "required": [
19
+ "id",
20
+ "key",
21
+ "name"
22
+ ],
23
+ "additionalProperties": false
24
+ },
25
+ "User": {
26
+ "type": "object",
27
+ "properties": {
28
+ "id": {
29
+ "$ref": "base.json#/$defs/Id"
30
+ },
31
+ "name": {
32
+ "$ref": "base.json#/$defs/Label"
33
+ },
34
+ "email": {
35
+ "$ref": "base.json#/$defs/Email"
36
+ }
37
+ },
38
+ "required": [
39
+ "id",
40
+ "name",
41
+ "email"
42
+ ],
43
+ "additionalProperties": false
44
+ },
45
+ "Project": {
46
+ "type": "object",
47
+ "properties": {
48
+ "id": {
49
+ "$ref": "base.json#/$defs/Id"
50
+ },
51
+ "team_id": {
52
+ "$ref": "base.json#/$defs/Id"
53
+ },
54
+ "name": {
55
+ "$ref": "base.json#/$defs/Label"
56
+ },
57
+ "state": {
58
+ "type": "string",
59
+ "enum": [
60
+ "planned",
61
+ "started",
62
+ "paused",
63
+ "completed",
64
+ "canceled"
65
+ ]
66
+ }
67
+ },
68
+ "required": [
69
+ "id",
70
+ "team_id",
71
+ "name",
72
+ "state"
73
+ ],
74
+ "additionalProperties": false
75
+ },
76
+ "Issue": {
77
+ "type": "object",
78
+ "properties": {
79
+ "id": {
80
+ "$ref": "base.json#/$defs/Id"
81
+ },
82
+ "team_id": {
83
+ "$ref": "base.json#/$defs/Id"
84
+ },
85
+ "identifier": {
86
+ "$ref": "base.json#/$defs/Label"
87
+ },
88
+ "title": {
89
+ "$ref": "base.json#/$defs/Label"
90
+ },
91
+ "description": {
92
+ "anyOf": [
93
+ {
94
+ "$ref": "base.json#/$defs/Text"
95
+ },
96
+ {
97
+ "type": "null"
98
+ }
99
+ ]
100
+ },
101
+ "state": {
102
+ "type": "string",
103
+ "enum": [
104
+ "backlog",
105
+ "todo",
106
+ "in_progress",
107
+ "done",
108
+ "canceled"
109
+ ]
110
+ },
111
+ "priority": {
112
+ "type": "integer",
113
+ "minimum": 0,
114
+ "maximum": 4
115
+ },
116
+ "assignee_id": {
117
+ "type": [
118
+ "string",
119
+ "null"
120
+ ],
121
+ "minLength": 1,
122
+ "maxLength": 128
123
+ },
124
+ "project_id": {
125
+ "type": [
126
+ "string",
127
+ "null"
128
+ ],
129
+ "minLength": 1,
130
+ "maxLength": 128
131
+ },
132
+ "created_at": {
133
+ "$ref": "base.json#/$defs/Timestamp"
134
+ }
135
+ },
136
+ "required": [
137
+ "id",
138
+ "team_id",
139
+ "identifier",
140
+ "title",
141
+ "state",
142
+ "priority",
143
+ "created_at"
144
+ ],
145
+ "additionalProperties": false
146
+ },
147
+ "Comment": {
148
+ "type": "object",
149
+ "properties": {
150
+ "id": {
151
+ "$ref": "base.json#/$defs/Id"
152
+ },
153
+ "issue_id": {
154
+ "$ref": "base.json#/$defs/Id"
155
+ },
156
+ "user_id": {
157
+ "$ref": "base.json#/$defs/Id"
158
+ },
159
+ "body": {
160
+ "$ref": "base.json#/$defs/Text"
161
+ },
162
+ "created_at": {
163
+ "$ref": "base.json#/$defs/Timestamp"
164
+ }
165
+ },
166
+ "required": [
167
+ "id",
168
+ "issue_id",
169
+ "user_id",
170
+ "body",
171
+ "created_at"
172
+ ],
173
+ "additionalProperties": false
174
+ }
175
+ },
176
+ "x-gateway": {
177
+ "version": 1,
178
+ "domain_version": "1.0.0",
179
+ "package": {
180
+ "id": "gateway-connector-linear",
181
+ "version": "1.0.0"
182
+ },
183
+ "entities": {
184
+ "linear_teams": {
185
+ "schema": {
186
+ "$ref": "#/$defs/Team"
187
+ },
188
+ "primary_key": [
189
+ "id"
190
+ ],
191
+ "unique": [
192
+ [
193
+ "key"
194
+ ]
195
+ ],
196
+ "relationships": []
197
+ },
198
+ "linear_users": {
199
+ "schema": {
200
+ "$ref": "#/$defs/User"
201
+ },
202
+ "primary_key": [
203
+ "id"
204
+ ],
205
+ "unique": [
206
+ [
207
+ "email"
208
+ ]
209
+ ],
210
+ "relationships": []
211
+ },
212
+ "linear_projects": {
213
+ "schema": {
214
+ "$ref": "#/$defs/Project"
215
+ },
216
+ "primary_key": [
217
+ "id"
218
+ ],
219
+ "unique": [],
220
+ "relationships": [
221
+ {
222
+ "fields": [
223
+ "team_id"
224
+ ],
225
+ "target": "linear_teams",
226
+ "on_delete": "restrict"
227
+ }
228
+ ]
229
+ },
230
+ "linear_issues": {
231
+ "schema": {
232
+ "$ref": "#/$defs/Issue"
233
+ },
234
+ "primary_key": [
235
+ "id"
236
+ ],
237
+ "unique": [
238
+ [
239
+ "identifier"
240
+ ]
241
+ ],
242
+ "relationships": [
243
+ {
244
+ "fields": [
245
+ "team_id"
246
+ ],
247
+ "target": "linear_teams",
248
+ "on_delete": "restrict"
249
+ },
250
+ {
251
+ "fields": [
252
+ "assignee_id"
253
+ ],
254
+ "target": "linear_users",
255
+ "on_delete": "restrict"
256
+ },
257
+ {
258
+ "fields": [
259
+ "project_id"
260
+ ],
261
+ "target": "linear_projects",
262
+ "on_delete": "restrict"
263
+ }
264
+ ]
265
+ },
266
+ "linear_comments": {
267
+ "schema": {
268
+ "$ref": "#/$defs/Comment"
269
+ },
270
+ "primary_key": [
271
+ "id"
272
+ ],
273
+ "unique": [],
274
+ "relationships": [
275
+ {
276
+ "fields": [
277
+ "issue_id"
278
+ ],
279
+ "target": "linear_issues",
280
+ "on_delete": "restrict"
281
+ },
282
+ {
283
+ "fields": [
284
+ "user_id"
285
+ ],
286
+ "target": "linear_users",
287
+ "on_delete": "restrict"
288
+ }
289
+ ]
290
+ }
291
+ },
292
+ "tools": {
293
+ "list_issues": {
294
+ "input": {
295
+ "type": "object",
296
+ "properties": {
297
+ "team_id": {
298
+ "$ref": "base.json#/$defs/Id"
299
+ }
300
+ },
301
+ "required": [
302
+ "team_id"
303
+ ],
304
+ "additionalProperties": false
305
+ },
306
+ "output": {
307
+ "type": "array",
308
+ "items": {
309
+ "$ref": "#/$defs/Issue"
310
+ }
311
+ },
312
+ "description": "Issues owned by one team."
313
+ },
314
+ "create_issue": {
315
+ "input": {
316
+ "type": "object",
317
+ "properties": {
318
+ "issue": {
319
+ "$ref": "#/$defs/Issue"
320
+ }
321
+ },
322
+ "required": [
323
+ "issue"
324
+ ],
325
+ "additionalProperties": false
326
+ },
327
+ "output": {
328
+ "$ref": "#/$defs/Issue"
329
+ },
330
+ "description": "Create an issue; team, assignee and project must exist."
331
+ },
332
+ "set_state": {
333
+ "input": {
334
+ "type": "object",
335
+ "properties": {
336
+ "id": {
337
+ "$ref": "base.json#/$defs/Id"
338
+ },
339
+ "state": {
340
+ "type": "string",
341
+ "enum": [
342
+ "backlog",
343
+ "todo",
344
+ "in_progress",
345
+ "done",
346
+ "canceled"
347
+ ]
348
+ }
349
+ },
350
+ "required": [
351
+ "id",
352
+ "state"
353
+ ],
354
+ "additionalProperties": false
355
+ },
356
+ "output": {
357
+ "$ref": "#/$defs/Issue"
358
+ },
359
+ "description": "Move an issue to a workflow state."
360
+ }
361
+ }
362
+ }
363
+ }
@@ -0,0 +1,45 @@
1
+ {
2
+ "connector": "microsoft-teams",
3
+ "domain_id": "urn:gateway:connector:microsoft-teams",
4
+ "domain_version": "1.0.0",
5
+ "api_version": "v1.0",
6
+ "shape": "base",
7
+ "label": "subset",
8
+ "assessment": "provisional",
9
+ "assessed_on": "2026-09-07",
10
+ "evidence": "provenance.json; independently authored synthetic fixtures",
11
+ "coverage": {
12
+ "entity_count": 17,
13
+ "type_count": 78,
14
+ "membership_variants": 7,
15
+ "event_variants": 30,
16
+ "scope_document": "scope.md"
17
+ },
18
+ "checks": {
19
+ "structural_validation": {
20
+ "status": "passed",
21
+ "command": "PYTHONPATH=gatewaysdk/sdk/src /private/tmp/gateway-teams-venv/bin/python -m pytest gatewaysdk/sdk/tests/environment -q",
22
+ "result": "716 passed in 88.94s",
23
+ "python": "3.12"
24
+ },
25
+ "synthetic_round_trip": {
26
+ "status": "passed",
27
+ "record_count": 46,
28
+ "evidence": "samples/schema-worlds/microsoft-teams/example.py",
29
+ "scope": "46 records, exact retry, SQL rejection, audit, deterministic export, current evidence digests"
30
+ },
31
+ "live_response_validation": {
32
+ "status": "skipped",
33
+ "reason": "No authorized live capture or sandbox; fixtures are synthetic."
34
+ },
35
+ "behavioral_equivalence": {"status": "not_applicable", "reason": "Empty tool catalog."},
36
+ "surface_parity": {"status": "not_applicable", "reason": "No MCP surface."},
37
+ "drift_monitoring": {"status": "not_implemented", "reason": "Pinned sources only."},
38
+ "packaging": {
39
+ "status": "passed",
40
+ "scope": "Built and installed merged SDK wheel; all nine templates initialize, check and materialize.",
41
+ "installed_wheel": "50 scaffold tests passed in 4.60s, including supporting artifacts, capability expansion and bytecode caches."
42
+ }
43
+ },
44
+ "limitations": "scope.md#enforcement-boundary-and-future-mapper-obligations; no live goldens or behavior claim"
45
+ }
@@ -0,0 +1 @@
1
+ """Microsoft Teams schema foundation. No simulated tools are declared."""