@flowdular/sdk 0.1.0 → 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 (174) hide show
  1. package/.ai/skills/test-hardening/SKILL.md +1 -1
  2. package/README.md +69 -12
  3. package/assets/flowdular-banner.png +0 -0
  4. package/modules/agents/package.json +1 -1
  5. package/modules/auth/package.json +1 -1
  6. package/modules/auth/src/client/AuthenticationCore.tsrx +3 -1
  7. package/modules/auth/src/server/endpoints.ts +3 -1
  8. package/modules/auth/src/server/runtime.ts +4 -0
  9. package/modules/automations/package.json +1 -1
  10. package/modules/automations-workflows-integration/package.json +1 -1
  11. package/modules/profile/package.json +1 -1
  12. package/modules/sandbox/package.json +1 -1
  13. package/modules/system/package.json +1 -1
  14. package/modules/users/package.json +1 -1
  15. package/modules/workflows/package.json +1 -1
  16. package/package.json +5 -13
  17. package/packages/ai-provider/package.json +1 -1
  18. package/packages/cli-protocol/package.json +1 -1
  19. package/packages/client/package.json +1 -1
  20. package/packages/client/src/routing.ts +39 -2
  21. package/packages/client/src/shell/BrandMark.tsrx +5 -1
  22. package/packages/client/src/shell/navigation.ts +3 -1
  23. package/packages/client/src/state.ts +6 -2
  24. package/packages/contracts/package.json +1 -1
  25. package/packages/contracts/schemas/project.schema.json +16 -42
  26. package/packages/database/package.json +1 -1
  27. package/packages/database-pglite/package.json +1 -1
  28. package/packages/database-testing/package.json +1 -1
  29. package/packages/dev-console/package.json +1 -1
  30. package/packages/harness/package.json +1 -1
  31. package/packages/kernel/package.json +1 -1
  32. package/packages/server/package.json +1 -1
  33. package/packages/server/src/application-routes.ts +80 -8
  34. package/packages/server/src/index.ts +4 -1
  35. package/packages/server/src/web-html.ts +9 -5
  36. package/packages/server/src/web.ts +59 -7
  37. package/packages/ui/package.json +1 -1
  38. package/packages/coding-agent/package.json +0 -44
  39. package/packages/coding-agent/src/drivers/byok.ts +0 -322
  40. package/packages/coding-agent/src/drivers/claude-code.ts +0 -290
  41. package/packages/coding-agent/src/drivers/codex.ts +0 -281
  42. package/packages/coding-agent/src/index.ts +0 -56
  43. package/packages/coding-agent/src/registry.ts +0 -119
  44. package/packages/coding-agent/src/roles/contract.ts +0 -60
  45. package/packages/coding-agent/src/roles/defaults.ts +0 -134
  46. package/packages/coding-agent/src/roles/handoff.ts +0 -41
  47. package/packages/coding-agent/src/roles/registry.ts +0 -156
  48. package/packages/coding-agent/src/roles/skills.ts +0 -72
  49. package/packages/coding-agent/src/roles/sync.ts +0 -88
  50. package/packages/coding-agent/src/types.ts +0 -102
  51. package/packages/coding-agent/src/workspace.ts +0 -275
  52. package/packages/sandbox/README.md +0 -691
  53. package/packages/sandbox/bin/flowdular-sandbox.mjs +0 -393
  54. package/packages/sandbox/dist/client/assets/App-ClMOrpyg.js +0 -11
  55. package/packages/sandbox/dist/client/assets/PreviewHost-BHiHrfbQ.js +0 -1
  56. package/packages/sandbox/dist/client/assets/auto-buGEq6de.js +0 -3
  57. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-400-normal-BSMlKf0J.woff2 +0 -0
  58. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-400-normal-CEL4l2ZJ.woff +0 -0
  59. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-500-normal-Ael50iVv.woff +0 -0
  60. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-500-normal-Bq9vWWag.woff2 +0 -0
  61. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-400-normal-DMdlQ8Kv.woff +0 -0
  62. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-400-normal-xuaO2J-f.woff2 +0 -0
  63. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-500-normal-BIfNGwUT.woff +0 -0
  64. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-500-normal-BqneJy0T.woff2 +0 -0
  65. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-400-normal-CvHOgSBP.woff +0 -0
  66. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-400-normal-DMJ8VG8y.woff2 +0 -0
  67. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-500-normal-CB9ihrfo.woff +0 -0
  68. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-500-normal-DSY6xOcd.woff2 +0 -0
  69. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-400-normal-BmRBH3aV.woff2 +0 -0
  70. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-400-normal-D3D2R8hC.woff +0 -0
  71. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-500-normal-CAhNIIs5.woff2 +0 -0
  72. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-500-normal-CZ70TYgx.woff +0 -0
  73. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-400-normal-BulugwFq.woff2 +0 -0
  74. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-400-normal-DDuiU_S-.woff +0 -0
  75. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-500-normal-C8zxqsMH.woff +0 -0
  76. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-500-normal-DZ4AoWbu.woff2 +0 -0
  77. package/packages/sandbox/dist/client/assets/ibm-plex-sans-cyrillic-ext-wght-normal-d45eAU9y.woff2 +0 -0
  78. package/packages/sandbox/dist/client/assets/ibm-plex-sans-cyrillic-wght-normal-BAAhND-U.woff2 +0 -0
  79. package/packages/sandbox/dist/client/assets/ibm-plex-sans-greek-wght-normal-CmyJS8uq.woff2 +0 -0
  80. package/packages/sandbox/dist/client/assets/ibm-plex-sans-latin-ext-wght-normal-CIII54If.woff2 +0 -0
  81. package/packages/sandbox/dist/client/assets/ibm-plex-sans-latin-wght-normal-IvpUvPa2.woff2 +0 -0
  82. package/packages/sandbox/dist/client/assets/ibm-plex-sans-vietnamese-wght-normal-Dg1JeJN0.woff2 +0 -0
  83. package/packages/sandbox/dist/client/assets/index-CvwhlQ87.js +0 -4
  84. package/packages/sandbox/dist/client/assets/styles-BPWaGf55.js +0 -3
  85. package/packages/sandbox/dist/client/assets/styles-Dx1_KOag.css +0 -1
  86. package/packages/sandbox/dist/client/favicon.svg +0 -1
  87. package/packages/sandbox/dist/server/assets/auto-CVGNYyb3.js +0 -12785
  88. package/packages/sandbox/dist/server/assets/chunk-DDJLRBDX-3OUNo51g.js +0 -4125
  89. package/packages/sandbox/dist/server/assets/nodefs-DVSI7kG0.js +0 -24
  90. package/packages/sandbox/dist/server/assets/opfs-ahp-D56iokt1.js +0 -388
  91. package/packages/sandbox/dist/server/assets/token-Bvaq7Anz.js +0 -55
  92. package/packages/sandbox/dist/server/assets/token-util-BqSvdIPQ.js +0 -3
  93. package/packages/sandbox/dist/server/assets/token-util-CktFFT4z.js +0 -494
  94. package/packages/sandbox/dist/server/entry.js +0 -91671
  95. package/packages/sandbox/dist/server/favicon.svg +0 -1
  96. package/packages/sandbox/dist/server/index.html +0 -161
  97. package/packages/sandbox/index.html +0 -159
  98. package/packages/sandbox/octane.config.ts +0 -36
  99. package/packages/sandbox/package.json +0 -83
  100. package/packages/sandbox/public/favicon.svg +0 -1
  101. package/packages/sandbox/public/og.png +0 -0
  102. package/packages/sandbox/src/App.tsrx +0 -924
  103. package/packages/sandbox/src/client/ApprovalHandoff.tsrx +0 -39
  104. package/packages/sandbox/src/client/ChatPane.tsrx +0 -694
  105. package/packages/sandbox/src/client/ConnectView.tsrx +0 -86
  106. package/packages/sandbox/src/client/DiffPane.tsrx +0 -150
  107. package/packages/sandbox/src/client/EjectModal.tsrx +0 -571
  108. package/packages/sandbox/src/client/GateResults.tsrx +0 -60
  109. package/packages/sandbox/src/client/GitHubSettingsModal.tsrx +0 -219
  110. package/packages/sandbox/src/client/NewSessionForm.tsrx +0 -214
  111. package/packages/sandbox/src/client/SessionBar.tsrx +0 -151
  112. package/packages/sandbox/src/client/SessionPicker.tsrx +0 -472
  113. package/packages/sandbox/src/client/SpecEditor.tsrx +0 -109
  114. package/packages/sandbox/src/client/SpecReviewCard.tsrx +0 -321
  115. package/packages/sandbox/src/client/WorkCard.tsrx +0 -128
  116. package/packages/sandbox/src/client/WorkbenchModal.tsrx +0 -161
  117. package/packages/sandbox/src/client/WorkspaceMenu.tsrx +0 -100
  118. package/packages/sandbox/src/client/api.ts +0 -797
  119. package/packages/sandbox/src/client/attachments.ts +0 -73
  120. package/packages/sandbox/src/client/dashboard.ts +0 -46
  121. package/packages/sandbox/src/client/github-settings.ts +0 -48
  122. package/packages/sandbox/src/client/highlight.ts +0 -105
  123. package/packages/sandbox/src/client/i18n.ts +0 -32
  124. package/packages/sandbox/src/client/locales/en.json +0 -466
  125. package/packages/sandbox/src/client/locales/pl.json +0 -466
  126. package/packages/sandbox/src/client/session-labels.ts +0 -77
  127. package/packages/sandbox/src/client/state.ts +0 -108
  128. package/packages/sandbox/src/index.ts +0 -10
  129. package/packages/sandbox/src/preview/PreviewHost.tsrx +0 -373
  130. package/packages/sandbox/src/preview/load-module.ts +0 -16
  131. package/packages/sandbox/src/server/attachments.ts +0 -308
  132. package/packages/sandbox/src/server/auto-review.ts +0 -181
  133. package/packages/sandbox/src/server/checkpoints.ts +0 -90
  134. package/packages/sandbox/src/server/config.ts +0 -460
  135. package/packages/sandbox/src/server/dashboard.ts +0 -245
  136. package/packages/sandbox/src/server/delivery/configuration.ts +0 -193
  137. package/packages/sandbox/src/server/delivery/git-pr.ts +0 -1473
  138. package/packages/sandbox/src/server/delivery/index.ts +0 -83
  139. package/packages/sandbox/src/server/delivery/local.ts +0 -151
  140. package/packages/sandbox/src/server/delivery/official-modules.ts +0 -516
  141. package/packages/sandbox/src/server/delivery/plan.ts +0 -218
  142. package/packages/sandbox/src/server/delivery/policies.ts +0 -239
  143. package/packages/sandbox/src/server/delivery/record.ts +0 -41
  144. package/packages/sandbox/src/server/delivery/steps.ts +0 -464
  145. package/packages/sandbox/src/server/delivery/types.ts +0 -158
  146. package/packages/sandbox/src/server/dependencies.ts +0 -88
  147. package/packages/sandbox/src/server/diff.ts +0 -230
  148. package/packages/sandbox/src/server/gates.ts +0 -388
  149. package/packages/sandbox/src/server/index.ts +0 -139
  150. package/packages/sandbox/src/server/path-guard.ts +0 -282
  151. package/packages/sandbox/src/server/planning.ts +0 -749
  152. package/packages/sandbox/src/server/platform-client.ts +0 -189
  153. package/packages/sandbox/src/server/preview-database-host.ts +0 -340
  154. package/packages/sandbox/src/server/preview-database-protocol.ts +0 -163
  155. package/packages/sandbox/src/server/preview-database-proxy.ts +0 -356
  156. package/packages/sandbox/src/server/preview-database.ts +0 -109
  157. package/packages/sandbox/src/server/preview-ipc.ts +0 -15
  158. package/packages/sandbox/src/server/preview-modules.ts +0 -83
  159. package/packages/sandbox/src/server/preview-revision.ts +0 -44
  160. package/packages/sandbox/src/server/preview-runtime.ts +0 -467
  161. package/packages/sandbox/src/server/preview-worker-manager.ts +0 -436
  162. package/packages/sandbox/src/server/preview-worker.ts +0 -168
  163. package/packages/sandbox/src/server/reference.ts +0 -251
  164. package/packages/sandbox/src/server/routes.ts +0 -2258
  165. package/packages/sandbox/src/server/runtime.ts +0 -188
  166. package/packages/sandbox/src/server/session-owner.ts +0 -23
  167. package/packages/sandbox/src/server/sessions.ts +0 -849
  168. package/packages/sandbox/src/server/spec.ts +0 -471
  169. package/packages/sandbox/src/server/turn-lifecycle.ts +0 -56
  170. package/packages/sandbox/src/server/turns.ts +0 -993
  171. package/packages/sandbox/src/server/workspace-install.ts +0 -266
  172. package/packages/sandbox/src/server/workspace-root.ts +0 -73
  173. package/packages/sandbox/src/styles.css +0 -1573
  174. package/packages/sandbox/vite.config.ts +0 -133
@@ -1,188 +0,0 @@
1
- import { randomBytes } from 'node:crypto';
2
- import {
3
- createByokDriver,
4
- createClaudeCodeDriver,
5
- createCodexDriver,
6
- createCodingAgentRegistry,
7
- loadAgentRoles,
8
- type AgentRoleDefinition,
9
- type CodingAgentDriver,
10
- type CodingAgentRegistry,
11
- } from '@flowdular/sdk/coding-agent';
12
- import {
13
- loadSandboxConfiguration,
14
- openSecret,
15
- saveSandboxConfiguration,
16
- type SandboxConfiguration,
17
- } from './config.ts';
18
- import { PlatformClient, type PlatformAuthority } from './platform-client.ts';
19
- import { SandboxSetupError } from './workspace-root.ts';
20
-
21
- export interface SandboxConnection {
22
- readonly connected: boolean;
23
- readonly authority: PlatformAuthority | null;
24
- readonly error: { readonly code: string; readonly message: string } | null;
25
- }
26
-
27
- export interface BrowserSession {
28
- readonly id: string;
29
- readonly token: string;
30
- readonly authority: PlatformAuthority;
31
- readonly createdAt: number;
32
- }
33
-
34
- /* Matches the cookie lifetime, so a session the browser still presents is
35
- also one the server still honours. */
36
- export const BROWSER_SESSION_TTL_MS = 12 * 60 * 60 * 1000;
37
-
38
- export interface SandboxRuntime {
39
- readonly workspaceRoot: string;
40
- configuration(): SandboxConfiguration;
41
- registry(): CodingAgentRegistry;
42
- roles(): readonly AgentRoleDefinition[];
43
- platform(): PlatformClient | null;
44
- connection(): SandboxConnection;
45
- refresh(): Promise<SandboxConnection>;
46
- update(patch: Partial<SandboxConfiguration>): Promise<SandboxConnection>;
47
- /* Self-hosted sandboxes keep one browser session per operator token. A
48
- loopback sandbox uses the configured connection directly. */
49
- openBrowserSession(token: string): Promise<BrowserSession>;
50
- browserSession(id: string | null): BrowserSession | null;
51
- closeBrowserSession(id: string): void;
52
- }
53
-
54
- async function buildDrivers(
55
- workspaceRoot: string,
56
- configuration: SandboxConfiguration,
57
- ): Promise<readonly CodingAgentDriver[]> {
58
- const drivers: CodingAgentDriver[] = [
59
- createClaudeCodeDriver({ defaultModel: configuration.driverModel }),
60
- createCodexDriver({ defaultModel: configuration.driverModel }),
61
- ];
62
- if (configuration.byok) {
63
- const credential = configuration.byok.credential
64
- ? await openSecret(workspaceRoot, configuration.byok.credential)
65
- : '';
66
- drivers.push(
67
- createByokDriver({
68
- configuration: {
69
- kind: configuration.byok.kind,
70
- model: configuration.byok.model,
71
- credential,
72
- ...(configuration.byok.resourceName
73
- ? { resourceName: configuration.byok.resourceName }
74
- : {}),
75
- ...(configuration.byok.baseURL
76
- ? { baseURL: configuration.byok.baseURL }
77
- : {}),
78
- },
79
- }),
80
- );
81
- }
82
- return drivers;
83
- }
84
-
85
- export async function createSandboxRuntime(
86
- workspaceRoot: string,
87
- ): Promise<SandboxRuntime> {
88
- let configuration = await loadSandboxConfiguration(workspaceRoot);
89
- let roles = await loadAgentRoles(workspaceRoot);
90
- let registry = createCodingAgentRegistry({
91
- mode: configuration.mode,
92
- drivers: await buildDrivers(workspaceRoot, configuration),
93
- });
94
- let platform: PlatformClient | null = null;
95
- let connection: SandboxConnection = {
96
- connected: false,
97
- authority: null,
98
- error: null,
99
- };
100
- const browserSessions = new Map<string, BrowserSession>();
101
-
102
- const rebuild = async (): Promise<SandboxConnection> => {
103
- roles = await loadAgentRoles(workspaceRoot);
104
- registry = createCodingAgentRegistry({
105
- mode: configuration.mode,
106
- drivers: await buildDrivers(workspaceRoot, configuration),
107
- });
108
- if (!configuration.platformToken) {
109
- platform = null;
110
- connection = {
111
- connected: false,
112
- authority: null,
113
- error: {
114
- code: 'PLATFORM_TOKEN_MISSING',
115
- message:
116
- 'Paste an API token from the Flowdular application to connect this sandbox.',
117
- },
118
- };
119
- return connection;
120
- }
121
- platform = new PlatformClient({
122
- platformUrl: configuration.platformUrl,
123
- token: await openSecret(workspaceRoot, configuration.platformToken),
124
- });
125
- try {
126
- const authority = await platform.authority();
127
- connection = { connected: true, authority, error: null };
128
- } catch (error) {
129
- connection = {
130
- connected: false,
131
- authority: null,
132
- error:
133
- error instanceof SandboxSetupError
134
- ? { code: error.code, message: error.message }
135
- : {
136
- code: 'PLATFORM_UNREACHABLE',
137
- message: `The sandbox could not reach ${configuration.platformUrl}.`,
138
- },
139
- };
140
- }
141
- return connection;
142
- };
143
-
144
- await rebuild();
145
-
146
- return {
147
- workspaceRoot,
148
- configuration: () => configuration,
149
- registry: () => registry,
150
- roles: () => roles,
151
- platform: () => platform,
152
- connection: () => connection,
153
- refresh: rebuild,
154
- update: async (patch) => {
155
- configuration = await saveSandboxConfiguration(workspaceRoot, {
156
- ...configuration,
157
- ...patch,
158
- version: 1,
159
- });
160
- return rebuild();
161
- },
162
- openBrowserSession: async (token) => {
163
- const client = new PlatformClient({
164
- platformUrl: configuration.platformUrl,
165
- token,
166
- });
167
- const authority = await client.authority();
168
- if (!authority.authority.granted) {
169
- throw new SandboxSetupError(
170
- 'SANDBOX_ACCESS_DENIED',
171
- 'This account has no active sandbox grant in the connected workspace.',
172
- );
173
- }
174
- const session: BrowserSession = {
175
- id: randomBytes(24).toString('base64url'),
176
- token,
177
- authority,
178
- createdAt: Date.now(),
179
- };
180
- browserSessions.set(session.id, session);
181
- return session;
182
- },
183
- browserSession: (id) => (id ? (browserSessions.get(id) ?? null) : null),
184
- closeBrowserSession: (id) => {
185
- browserSessions.delete(id);
186
- },
187
- };
188
- }
@@ -1,23 +0,0 @@
1
- import type { SandboxSession, SessionOwner } from './sessions.ts';
2
-
3
- export function ownsSession(
4
- session: SandboxSession,
5
- owner: SessionOwner | null,
6
- ): boolean {
7
- return Boolean(
8
- owner &&
9
- session.owner &&
10
- session.owner.accountId === owner.accountId &&
11
- session.owner.tenantId === owner.tenantId &&
12
- session.owner.platformUrl.replace(/\/+$/, '') ===
13
- owner.platformUrl.replace(/\/+$/, ''),
14
- );
15
- }
16
-
17
- export function canReadSession(
18
- session: SandboxSession,
19
- owner: SessionOwner | null,
20
- local: boolean,
21
- ): boolean {
22
- return ownsSession(session, owner) || (local && !session.owner);
23
- }