@flowdular/sdk 0.1.0 → 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 (175) 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 +2 -2
  28. package/packages/database-pglite/src/driver.ts +21 -3
  29. package/packages/database-testing/package.json +1 -1
  30. package/packages/dev-console/package.json +1 -1
  31. package/packages/harness/package.json +1 -1
  32. package/packages/kernel/package.json +1 -1
  33. package/packages/server/package.json +1 -1
  34. package/packages/server/src/application-routes.ts +80 -8
  35. package/packages/server/src/index.ts +4 -1
  36. package/packages/server/src/web-html.ts +9 -5
  37. package/packages/server/src/web.ts +59 -7
  38. package/packages/ui/package.json +1 -1
  39. package/packages/coding-agent/package.json +0 -44
  40. package/packages/coding-agent/src/drivers/byok.ts +0 -322
  41. package/packages/coding-agent/src/drivers/claude-code.ts +0 -290
  42. package/packages/coding-agent/src/drivers/codex.ts +0 -281
  43. package/packages/coding-agent/src/index.ts +0 -56
  44. package/packages/coding-agent/src/registry.ts +0 -119
  45. package/packages/coding-agent/src/roles/contract.ts +0 -60
  46. package/packages/coding-agent/src/roles/defaults.ts +0 -134
  47. package/packages/coding-agent/src/roles/handoff.ts +0 -41
  48. package/packages/coding-agent/src/roles/registry.ts +0 -156
  49. package/packages/coding-agent/src/roles/skills.ts +0 -72
  50. package/packages/coding-agent/src/roles/sync.ts +0 -88
  51. package/packages/coding-agent/src/types.ts +0 -102
  52. package/packages/coding-agent/src/workspace.ts +0 -275
  53. package/packages/sandbox/README.md +0 -691
  54. package/packages/sandbox/bin/flowdular-sandbox.mjs +0 -393
  55. package/packages/sandbox/dist/client/assets/App-ClMOrpyg.js +0 -11
  56. package/packages/sandbox/dist/client/assets/PreviewHost-BHiHrfbQ.js +0 -1
  57. package/packages/sandbox/dist/client/assets/auto-buGEq6de.js +0 -3
  58. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-400-normal-BSMlKf0J.woff2 +0 -0
  59. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-400-normal-CEL4l2ZJ.woff +0 -0
  60. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-500-normal-Ael50iVv.woff +0 -0
  61. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-500-normal-Bq9vWWag.woff2 +0 -0
  62. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-400-normal-DMdlQ8Kv.woff +0 -0
  63. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-400-normal-xuaO2J-f.woff2 +0 -0
  64. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-500-normal-BIfNGwUT.woff +0 -0
  65. package/packages/sandbox/dist/client/assets/ibm-plex-mono-cyrillic-ext-500-normal-BqneJy0T.woff2 +0 -0
  66. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-400-normal-CvHOgSBP.woff +0 -0
  67. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-400-normal-DMJ8VG8y.woff2 +0 -0
  68. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-500-normal-CB9ihrfo.woff +0 -0
  69. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-500-normal-DSY6xOcd.woff2 +0 -0
  70. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-400-normal-BmRBH3aV.woff2 +0 -0
  71. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-400-normal-D3D2R8hC.woff +0 -0
  72. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-500-normal-CAhNIIs5.woff2 +0 -0
  73. package/packages/sandbox/dist/client/assets/ibm-plex-mono-latin-ext-500-normal-CZ70TYgx.woff +0 -0
  74. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-400-normal-BulugwFq.woff2 +0 -0
  75. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-400-normal-DDuiU_S-.woff +0 -0
  76. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-500-normal-C8zxqsMH.woff +0 -0
  77. package/packages/sandbox/dist/client/assets/ibm-plex-mono-vietnamese-500-normal-DZ4AoWbu.woff2 +0 -0
  78. package/packages/sandbox/dist/client/assets/ibm-plex-sans-cyrillic-ext-wght-normal-d45eAU9y.woff2 +0 -0
  79. package/packages/sandbox/dist/client/assets/ibm-plex-sans-cyrillic-wght-normal-BAAhND-U.woff2 +0 -0
  80. package/packages/sandbox/dist/client/assets/ibm-plex-sans-greek-wght-normal-CmyJS8uq.woff2 +0 -0
  81. package/packages/sandbox/dist/client/assets/ibm-plex-sans-latin-ext-wght-normal-CIII54If.woff2 +0 -0
  82. package/packages/sandbox/dist/client/assets/ibm-plex-sans-latin-wght-normal-IvpUvPa2.woff2 +0 -0
  83. package/packages/sandbox/dist/client/assets/ibm-plex-sans-vietnamese-wght-normal-Dg1JeJN0.woff2 +0 -0
  84. package/packages/sandbox/dist/client/assets/index-CvwhlQ87.js +0 -4
  85. package/packages/sandbox/dist/client/assets/styles-BPWaGf55.js +0 -3
  86. package/packages/sandbox/dist/client/assets/styles-Dx1_KOag.css +0 -1
  87. package/packages/sandbox/dist/client/favicon.svg +0 -1
  88. package/packages/sandbox/dist/server/assets/auto-CVGNYyb3.js +0 -12785
  89. package/packages/sandbox/dist/server/assets/chunk-DDJLRBDX-3OUNo51g.js +0 -4125
  90. package/packages/sandbox/dist/server/assets/nodefs-DVSI7kG0.js +0 -24
  91. package/packages/sandbox/dist/server/assets/opfs-ahp-D56iokt1.js +0 -388
  92. package/packages/sandbox/dist/server/assets/token-Bvaq7Anz.js +0 -55
  93. package/packages/sandbox/dist/server/assets/token-util-BqSvdIPQ.js +0 -3
  94. package/packages/sandbox/dist/server/assets/token-util-CktFFT4z.js +0 -494
  95. package/packages/sandbox/dist/server/entry.js +0 -91671
  96. package/packages/sandbox/dist/server/favicon.svg +0 -1
  97. package/packages/sandbox/dist/server/index.html +0 -161
  98. package/packages/sandbox/index.html +0 -159
  99. package/packages/sandbox/octane.config.ts +0 -36
  100. package/packages/sandbox/package.json +0 -83
  101. package/packages/sandbox/public/favicon.svg +0 -1
  102. package/packages/sandbox/public/og.png +0 -0
  103. package/packages/sandbox/src/App.tsrx +0 -924
  104. package/packages/sandbox/src/client/ApprovalHandoff.tsrx +0 -39
  105. package/packages/sandbox/src/client/ChatPane.tsrx +0 -694
  106. package/packages/sandbox/src/client/ConnectView.tsrx +0 -86
  107. package/packages/sandbox/src/client/DiffPane.tsrx +0 -150
  108. package/packages/sandbox/src/client/EjectModal.tsrx +0 -571
  109. package/packages/sandbox/src/client/GateResults.tsrx +0 -60
  110. package/packages/sandbox/src/client/GitHubSettingsModal.tsrx +0 -219
  111. package/packages/sandbox/src/client/NewSessionForm.tsrx +0 -214
  112. package/packages/sandbox/src/client/SessionBar.tsrx +0 -151
  113. package/packages/sandbox/src/client/SessionPicker.tsrx +0 -472
  114. package/packages/sandbox/src/client/SpecEditor.tsrx +0 -109
  115. package/packages/sandbox/src/client/SpecReviewCard.tsrx +0 -321
  116. package/packages/sandbox/src/client/WorkCard.tsrx +0 -128
  117. package/packages/sandbox/src/client/WorkbenchModal.tsrx +0 -161
  118. package/packages/sandbox/src/client/WorkspaceMenu.tsrx +0 -100
  119. package/packages/sandbox/src/client/api.ts +0 -797
  120. package/packages/sandbox/src/client/attachments.ts +0 -73
  121. package/packages/sandbox/src/client/dashboard.ts +0 -46
  122. package/packages/sandbox/src/client/github-settings.ts +0 -48
  123. package/packages/sandbox/src/client/highlight.ts +0 -105
  124. package/packages/sandbox/src/client/i18n.ts +0 -32
  125. package/packages/sandbox/src/client/locales/en.json +0 -466
  126. package/packages/sandbox/src/client/locales/pl.json +0 -466
  127. package/packages/sandbox/src/client/session-labels.ts +0 -77
  128. package/packages/sandbox/src/client/state.ts +0 -108
  129. package/packages/sandbox/src/index.ts +0 -10
  130. package/packages/sandbox/src/preview/PreviewHost.tsrx +0 -373
  131. package/packages/sandbox/src/preview/load-module.ts +0 -16
  132. package/packages/sandbox/src/server/attachments.ts +0 -308
  133. package/packages/sandbox/src/server/auto-review.ts +0 -181
  134. package/packages/sandbox/src/server/checkpoints.ts +0 -90
  135. package/packages/sandbox/src/server/config.ts +0 -460
  136. package/packages/sandbox/src/server/dashboard.ts +0 -245
  137. package/packages/sandbox/src/server/delivery/configuration.ts +0 -193
  138. package/packages/sandbox/src/server/delivery/git-pr.ts +0 -1473
  139. package/packages/sandbox/src/server/delivery/index.ts +0 -83
  140. package/packages/sandbox/src/server/delivery/local.ts +0 -151
  141. package/packages/sandbox/src/server/delivery/official-modules.ts +0 -516
  142. package/packages/sandbox/src/server/delivery/plan.ts +0 -218
  143. package/packages/sandbox/src/server/delivery/policies.ts +0 -239
  144. package/packages/sandbox/src/server/delivery/record.ts +0 -41
  145. package/packages/sandbox/src/server/delivery/steps.ts +0 -464
  146. package/packages/sandbox/src/server/delivery/types.ts +0 -158
  147. package/packages/sandbox/src/server/dependencies.ts +0 -88
  148. package/packages/sandbox/src/server/diff.ts +0 -230
  149. package/packages/sandbox/src/server/gates.ts +0 -388
  150. package/packages/sandbox/src/server/index.ts +0 -139
  151. package/packages/sandbox/src/server/path-guard.ts +0 -282
  152. package/packages/sandbox/src/server/planning.ts +0 -749
  153. package/packages/sandbox/src/server/platform-client.ts +0 -189
  154. package/packages/sandbox/src/server/preview-database-host.ts +0 -340
  155. package/packages/sandbox/src/server/preview-database-protocol.ts +0 -163
  156. package/packages/sandbox/src/server/preview-database-proxy.ts +0 -356
  157. package/packages/sandbox/src/server/preview-database.ts +0 -109
  158. package/packages/sandbox/src/server/preview-ipc.ts +0 -15
  159. package/packages/sandbox/src/server/preview-modules.ts +0 -83
  160. package/packages/sandbox/src/server/preview-revision.ts +0 -44
  161. package/packages/sandbox/src/server/preview-runtime.ts +0 -467
  162. package/packages/sandbox/src/server/preview-worker-manager.ts +0 -436
  163. package/packages/sandbox/src/server/preview-worker.ts +0 -168
  164. package/packages/sandbox/src/server/reference.ts +0 -251
  165. package/packages/sandbox/src/server/routes.ts +0 -2258
  166. package/packages/sandbox/src/server/runtime.ts +0 -188
  167. package/packages/sandbox/src/server/session-owner.ts +0 -23
  168. package/packages/sandbox/src/server/sessions.ts +0 -849
  169. package/packages/sandbox/src/server/spec.ts +0 -471
  170. package/packages/sandbox/src/server/turn-lifecycle.ts +0 -56
  171. package/packages/sandbox/src/server/turns.ts +0 -993
  172. package/packages/sandbox/src/server/workspace-install.ts +0 -266
  173. package/packages/sandbox/src/server/workspace-root.ts +0 -73
  174. package/packages/sandbox/src/styles.css +0 -1573
  175. 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
- }