@superblocksteam/vite-plugin-file-sync 2.0.142-next.0 → 2.0.142-next.2

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 (59) hide show
  1. package/dist/ai-service/agent/prompts/api-prompts.d.ts.map +1 -1
  2. package/dist/ai-service/agent/prompts/api-prompts.js +12 -10
  3. package/dist/ai-service/agent/prompts/api-prompts.js.map +1 -1
  4. package/dist/ai-service/agent/tools/apis/get-api-docs.js +1 -1
  5. package/dist/ai-service/agent/tools/apis/get-api-docs.js.map +1 -1
  6. package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.d.ts.map +1 -1
  7. package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.js +31 -2
  8. package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.js.map +1 -1
  9. package/dist/ai-service/agent/tools/build-manage-checklist.d.ts.map +1 -1
  10. package/dist/ai-service/agent/tools/build-manage-checklist.js +6 -1
  11. package/dist/ai-service/agent/tools/build-manage-checklist.js.map +1 -1
  12. package/dist/ai-service/agent/tools/databases/dev-database-tasks.d.ts +6 -0
  13. package/dist/ai-service/agent/tools/databases/dev-database-tasks.d.ts.map +1 -1
  14. package/dist/ai-service/agent/tools/databases/dev-database-tasks.js +138 -18
  15. package/dist/ai-service/agent/tools/databases/dev-database-tasks.js.map +1 -1
  16. package/dist/ai-service/agent/tools2/tools/check-task.d.ts +1 -0
  17. package/dist/ai-service/agent/tools2/tools/check-task.d.ts.map +1 -1
  18. package/dist/ai-service/agent/tools2/tools/wait-for-task.d.ts +2 -0
  19. package/dist/ai-service/agent/tools2/tools/wait-for-task.d.ts.map +1 -1
  20. package/dist/ai-service/index.d.ts.map +1 -1
  21. package/dist/ai-service/index.js +37 -4
  22. package/dist/ai-service/index.js.map +1 -1
  23. package/dist/ai-service/llm/context-v2/context-metrics.d.ts +7 -1
  24. package/dist/ai-service/llm/context-v2/context-metrics.d.ts.map +1 -1
  25. package/dist/ai-service/llm/context-v2/context-metrics.js +32 -9
  26. package/dist/ai-service/llm/context-v2/context-metrics.js.map +1 -1
  27. package/dist/ai-service/llm/context-v2/manager.d.ts +1 -0
  28. package/dist/ai-service/llm/context-v2/manager.d.ts.map +1 -1
  29. package/dist/ai-service/llm/context-v2/manager.js +31 -2
  30. package/dist/ai-service/llm/context-v2/manager.js.map +1 -1
  31. package/dist/ai-service/migration-autodispatch-metrics.d.ts.map +1 -1
  32. package/dist/ai-service/migration-autodispatch-metrics.js +1 -0
  33. package/dist/ai-service/migration-autodispatch-metrics.js.map +1 -1
  34. package/dist/ai-service/migration-turns-log.d.ts +24 -0
  35. package/dist/ai-service/migration-turns-log.d.ts.map +1 -0
  36. package/dist/ai-service/migration-turns-log.js +67 -0
  37. package/dist/ai-service/migration-turns-log.js.map +1 -0
  38. package/dist/ai-service/tasks/factory.d.ts +2 -0
  39. package/dist/ai-service/tasks/factory.d.ts.map +1 -1
  40. package/dist/ai-service/tasks/factory.js +5 -0
  41. package/dist/ai-service/tasks/factory.js.map +1 -1
  42. package/dist/ai-service/tasks/task-store.d.ts.map +1 -1
  43. package/dist/ai-service/tasks/task-store.js +13 -1
  44. package/dist/ai-service/tasks/task-store.js.map +1 -1
  45. package/dist/ai-service/tasks/types.d.ts +12 -1
  46. package/dist/ai-service/tasks/types.d.ts.map +1 -1
  47. package/dist/ai-service/tasks/types.js.map +1 -1
  48. package/dist/ai-service/types.d.ts +18 -0
  49. package/dist/ai-service/types.d.ts.map +1 -1
  50. package/dist/ai-service/types.js +1 -1
  51. package/dist/ai-service/types.js.map +1 -1
  52. package/dist/migration/migration-routes.d.ts.map +1 -1
  53. package/dist/migration/migration-routes.js +44 -3
  54. package/dist/migration/migration-routes.js.map +1 -1
  55. package/dist/migration/migration-session-reconcile.d.ts +1 -0
  56. package/dist/migration/migration-session-reconcile.d.ts.map +1 -1
  57. package/dist/migration/migration-session-reconcile.js +15 -5
  58. package/dist/migration/migration-session-reconcile.js.map +1 -1
  59. package/package.json +8 -8
@@ -1 +1 @@
1
- {"version":3,"file":"api-prompts.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA4O5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAC3C,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,MAAM,CAofT;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAiChE"}
1
+ {"version":3,"file":"api-prompts.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA4O5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAC3C,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,MAAM,CAsfT;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAiChE"}
@@ -299,7 +299,7 @@ Before writing ANY API, you MUST:
299
299
  - Do NOT read SDK documentation directly from filesystem files; fetch documentation through \`getSdkApiDocs\` only
300
300
 
301
301
  **Trace Metadata:**
302
- All integration client methods accept an optional \`metadata\` parameter as the last argument: \`{ label?: string, description?: string }\`. When \`includeDiagnostics\` is enabled, this metadata appears in the trace view. Always include a \`label\` on each integration call to make traces readable. Example: \`ctx.integrations.db.query(sql, Schema, params, { label: "Fetch active users" })\`.
302
+ All integration client methods accept an optional \`metadata\` parameter as the last argument: \`{ label?: string, description?: string }\`. When \`includeDiagnostics\` is enabled, this metadata appears in the trace view. Always include a \`label\` on each integration call to make traces readable. Example: \`ctx.integrations.orders_db.query(sql, Schema, params, { label: "Fetch active users" })\`.
303
303
 
304
304
  **CRITICAL - Method Validation:**
305
305
  Before calling ANY integration client method, you MUST:
@@ -319,22 +319,23 @@ Before creating APIs with new integrations:
319
319
  </integrations_and_data_sources>
320
320
 
321
321
  <integration_ids>
322
- **CRITICAL: Integration IDs**
322
+ **CRITICAL: Integration IDs and map keys**
323
323
 
324
324
  When using integrations in SDK APIs:
325
325
  1. **Use integration IDs** (UUIDs), not display names - IDs are stable identifiers that won't break if integrations are renamed
326
326
  2. **Get the ID from the integrations panel** - each integration has a unique ID visible in its settings
327
327
  3. **Store IDs in constants** with descriptive names at the top of the API file for clarity
328
+ 4. **Choose a descriptive \`integrations\` map key** — a valid JS identifier derived from the integration's display name / Native DB \`logicalName\` (lowercase snake_case). Normalize: lowercase → replace non-alphanumeric with \`_\` → collapse \`_\` → if empty/starts with a digit/reserved word, prefix \`db_\`. Examples: \`pokemon_tracker\` → \`pokemon_tracker\`; \`Orders DB\` → \`orders_db\`; \`2024-orders\` → \`db_2024_orders\`. If two integrations would share a key, disambiguate (e.g. \`orders_db\` / \`orders_db_2\`). Do **not** use a generic placeholder like \`db\` when the integration already has a meaningful name — that key is what appears in generated code and TraceView. SDK README examples that use \`db\` are placeholders only.
328
329
 
329
330
  Example:
330
331
  \`\`\`typescript
331
332
  // Store integration IDs in constants with descriptive names
332
- const PROD_POSTGRES = "a1b2c3d4-5678-90ab-cdef-ghijklmnopqr";
333
+ const ORDERS_DB = "a1b2c3d4-5678-90ab-cdef-ghijklmnopqr";
333
334
  const OPS_SLACK = "e5f6g7h8-1234-56ab-cdef-ghijklmnopqr";
334
335
 
335
336
  export default api({
336
337
  integrations: {
337
- db: postgres(PROD_POSTGRES),
338
+ orders_db: postgres(ORDERS_DB),
338
339
  notifier: slack(OPS_SLACK),
339
340
  },
340
341
  // ...
@@ -343,7 +344,7 @@ export default api({
343
344
 
344
345
  **NEVER use integration display names** like \`postgres("Production Postgres")\` - always use the UUID.
345
346
 
346
- **Access in run(): use \`ctx.integrations.<name>\` pattern.** In your API \`run\` function, access each integration by the **key name** you declared in \`integrations\`, not by integration ID. Example: \`integrations: { db: postgres(PROD_POSTGRES), notifier: slack(OPS_SLACK) }\` → use \`ctx.integrations.db\` and \`ctx.integrations.notifier\`. The integration ID (UUID) is only for the declaration (e.g. \`postgres(UUID)\`); access is always \`ctx.integrations.<key>\`.
347
+ **Access in run(): use \`ctx.integrations.<key>\` pattern.** In your API \`run\` function, access each integration by the **key name** you declared in \`integrations\`, not by integration ID. Example: \`integrations: { orders_db: postgres(ORDERS_DB), notifier: slack(OPS_SLACK) }\` → use \`ctx.integrations.orders_db\` and \`ctx.integrations.notifier\`. The integration ID (UUID) is only for the declaration (e.g. \`postgres(UUID)\`); access is always \`ctx.integrations.<key>\`.
347
348
  </integration_ids>
348
349
 
349
350
  <creating_and_editing_apis>
@@ -390,7 +391,7 @@ You must NEVER attempt to rely on frontend data for security-critical operations
390
391
  import { api, z, postgres } from "@superblocksteam/sdk-api";
391
392
 
392
393
  // Integration IDs from the integrations panel - store in constants with descriptive names
393
- const PROD_POSTGRES = "a1b2c3d4-5678-90ab-cdef-ghijklmnopqr";
394
+ const USERS_DB = "a1b2c3d4-5678-90ab-cdef-ghijklmnopqr";
394
395
 
395
396
  const UserSchema = z.object({
396
397
  id: z.string(),
@@ -407,9 +408,10 @@ export default api({
407
408
  // REQUIRED: plain-language summary for non-technical readers
408
409
  description: "Looks up users from the production database, with optional filtering by email or name. Returns a list of matching users.",
409
410
 
410
- // Declare integrations upfront using their IDs for type safety
411
+ // Declare integrations upfront using their IDs for type safety.
412
+ // Key = descriptive snake_case from the integration/database name (not a generic "db").
411
413
  integrations: {
412
- db: postgres(PROD_POSTGRES),
414
+ users_db: postgres(USERS_DB),
413
415
  },
414
416
 
415
417
  input: z.object({
@@ -422,10 +424,10 @@ export default api({
422
424
  }),
423
425
 
424
426
  async run(ctx, { email, name }) {
425
- // ctx.integrations.db is fully typed as PostgresClient
427
+ // ctx.integrations.users_db is fully typed as PostgresClient
426
428
  // All integration methods accept an optional metadata arg as the last parameter
427
429
  // for trace labeling: { label?: string, description?: string }
428
- const users = await ctx.integrations.db.query(
430
+ const users = await ctx.integrations.users_db.query(
429
431
  "SELECT id, email, name FROM users WHERE ($1::text IS NULL OR email = $1) AND ($2::text IS NULL OR name = $2)",
430
432
  UserSchema,
431
433
  [email, name],
@@ -1 +1 @@
1
- {"version":3,"file":"api-prompts.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0OD,CAAC;AACT,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAElC;IACC,MAAM,kBAAkB,GAAG,OAAO,EAAE,yBAAyB;QAC3D,CAAC,CAAC;;;;wBAIkB;QACpB,CAAC,CAAC;;;;;;;;;;;wBAWkB,CAAC;IAEvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwFP,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAuYZ,CAAC;AACT,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA2B4B,CAAC;IACtC,CAAC;IAED,OAAO,oRAAoR,CAAC;AAC9R,CAAC"}
1
+ {"version":3,"file":"api-prompts.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/prompts/api-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0OD,CAAC;AACT,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAElC;IACC,MAAM,kBAAkB,GAAG,OAAO,EAAE,yBAAyB;QAC3D,CAAC,CAAC;;;;wBAIkB;QACpB,CAAC,CAAC;;;;;;;;;;;wBAWkB,CAAC;IAEvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyFP,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAwYZ,CAAC;AACT,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA2B4B,CAAC;IACtC,CAAC;IAED,OAAO,oRAAoR,CAAC;AAC9R,CAAC"}
@@ -2004,7 +2004,7 @@ export function buildIntegrationDocumentation(integrationIds, services) {
2004
2004
  "",
2005
2005
  ]
2006
2006
  : []),
2007
- "**SDK access**: In your API `run` function, use the **key name** you declared: `ctx.integrations.<name>` (e.g. `ctx.integrations.db`). Do not use the integration ID when accessing—only when declaring the integration.",
2007
+ "**SDK access**: In your API `run` function, use the **key name** you declared: `ctx.integrations.<key>` (e.g. `ctx.integrations.orders_db`). Prefer a descriptive key derived from the integration/database name, not a generic `db`. Do not use the integration ID when accessing—only when declaring the integration.",
2008
2008
  "",
2009
2009
  "### TypeScript Type Definition",
2010
2010
  "```typescript",
@@ -1 +1 @@
1
- {"version":3,"file":"get-api-docs.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-api-docs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get-api-docs.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-api-docs.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"get-sdk-api-docs.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAqInF,eAAO,MAAM,wBAAwB;;;QAkEpC,CAAC"}
1
+ {"version":3,"file":"get-sdk-api-docs.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAoKnF,eAAO,MAAM,wBAAwB;;;QAoEpC,CAAC"}
@@ -16,6 +16,35 @@ async function getSdkRootReadmeDocumentation() {
16
16
  return "";
17
17
  }
18
18
  }
19
+ /**
20
+ * README examples often use a generic `db` integrations key. Prepend explicit
21
+ * naming guidance so Clark sees descriptive keys (e.g. Native DB logicalName)
22
+ * before those generic examples.
23
+ */
24
+ const SDK_INTEGRATIONS_KEY_GUIDANCE = [
25
+ "## Integrations map keys (CRITICAL — read before README examples)",
26
+ "",
27
+ "SDK README snippets below often use a generic `db` key for brevity. Treat those as **placeholders only**. When the integration already has a meaningful display name / Native DB `logicalName`, you MUST use a descriptive `integrations` map key instead — that key is what appears in generated code and TraceView.",
28
+ "",
29
+ "**Derive a valid JS identifier (lowercase snake_case):**",
30
+ "1. Lowercase the display name / `logicalName`.",
31
+ "2. Replace spaces, hyphens, and other non-alphanumeric characters with `_`; collapse repeated `_`.",
32
+ "3. If the result starts with a digit, prefix `db_` (e.g. `2024_orders` → `db_2024_orders`).",
33
+ "4. If the result is empty or a JS reserved word (`default`, `class`, `function`, …), prefix `db_`.",
34
+ "5. Examples: `pokemon_tracker` → `pokemon_tracker`; `Orders DB` → `orders_db`; `Order's DB!` → `orders_db`.",
35
+ "",
36
+ "**Collisions:** If two integrations would derive the same key, disambiguate (e.g. append `_2` or a short plugin/type suffix like `_pg`) so every object key is unique. Duplicate keys silently drop a binding.",
37
+ "",
38
+ "In `run()`, access via `ctx.integrations.<key>` (e.g. `ctx.integrations.pokemon_tracker`). Use the integration ID only in the declaration (`postgres(UUID)`), never for access.",
39
+ ].join("\n");
40
+ function withIntegrationsKeyGuidance(documentation) {
41
+ const guidance = SDK_INTEGRATIONS_KEY_GUIDANCE.trim();
42
+ const base = documentation.trim();
43
+ if (!base) {
44
+ return guidance;
45
+ }
46
+ return `${guidance}\n\n${base}`;
47
+ }
19
48
  function normalizeSemVer(version) {
20
49
  return version && /^\d+\.\d+\.\d+$/.test(version)
21
50
  ? version
@@ -120,13 +149,13 @@ ALWAYS call this tool:
120
149
  const requestedPluginIds = resolveRequestedPluginIds(integrationIds, pluginIds, services);
121
150
  if (requestedPluginIds.length === 0) {
122
151
  return {
123
- documentation: await getSdkRootReadmeDocumentation(),
152
+ documentation: withIntegrationsKeyGuidance(await getSdkRootReadmeDocumentation()),
124
153
  plugins: [],
125
154
  };
126
155
  }
127
156
  const { documentation, plugins: resolvedPlugins } = await buildSdkPluginReadmeDocumentation(requestedPluginIds, services);
128
157
  return {
129
- documentation,
158
+ documentation: withIntegrationsKeyGuidance(documentation),
130
159
  plugins: resolvedPlugins,
131
160
  };
132
161
  },
@@ -1 +1 @@
1
- {"version":3,"file":"get-sdk-api-docs.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,+BAA+B,GAEhC,MAAM,6DAA6D,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,yBAAyB,GAAG,OAAO,CACvC,OAAO,CAAC,OAAO,CAAC,uCAAuC,CAAC,CACzD,CAAC;AACF,MAAM,8BAA8B,GAAG,OAAO,CAC5C,yBAAyB,EACzB,kBAAkB,CACnB,CAAC;AACF,MAAM,wBAAwB,GAAG,OAAO,CACtC,yBAAyB,EACzB,WAAW,CACZ,CAAC;AAEF,KAAK,UAAU,6BAA6B;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,OAA2B;IAE3B,OAAO,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/C,CAAC,CAAE,OAAmE;QACtE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAE7C,KAAK,UAAU,4BAA4B,CACzC,QAAgB,EAChB,aAAsB,EACtB,UAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,MAAM,+BAA+B,CAAC,QAAQ,EAAE;YACrD,aAAa,EAAE,eAAe,CAAC,aAAa,CAAC;YAC7C,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC;YACvC,qBAAqB,EAAE,8BAA8B;SACtD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAClD,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iCAAiC,CAC9C,SAAmB,EACnB,QAAiC;IAKjC,MAAM,UAAU,GAAG,MAAM,6BAA6B,EAAE,CAAC;IACzD,MAAM,IAAI,GAAa,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,eAAe,GAIf,EAAE,CAAC;IAET,MAAM,UAAU,GACd,QAAQ,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAEzE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnB,MAAM,aAAa,GACjB,QAAQ,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,MAAM,4BAA4B,CACvD,QAAQ,EACR,aAAa,EACb,UAAU,CACX,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC1B,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,OAAO,EAAE,eAAe;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,cAAwB,EACxB,SAAmB,EACnB,QAAiC;IAEjC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CACvD,eAAe,EACf,CAAC,QAAiC,EAAE,EAAE,CAAC,CAAC;IACtC,QAAQ,EAAE,YAAY,CAAC,GAAG;IAC1B,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE;;;;;;;;;;;;;CAahB;IACG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC;aACd,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,sHAAsH,CACvH;aACA,QAAQ,EAAE;QACb,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,4GAA4G,CAC7G;aACA,QAAQ,EAAE;KACd,CAAC;IACF,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,EAAE,EAAE,EAAE;QACzD,MAAM,kBAAkB,GAAG,yBAAyB,CAClD,cAAc,EACd,SAAS,EACT,QAAQ,CACT,CAAC;QACF,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,aAAa,EAAE,MAAM,6BAA6B,EAAE;gBACpD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,GAC/C,MAAM,iCAAiC,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QACxE,OAAO;YACL,aAAa;YACb,OAAO,EAAE,eAAe;SACzB,CAAC;IACJ,CAAC;IACD,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAC/C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;YACvB,CAAC,CAAC,CAAC,CAAC;QACN,OAAO;YACL,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,GAAG,WAAW,UAAU,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;SAC/D,CAAC;IACJ,CAAC;CACF,CAAC,CACH,CAAC"}
1
+ {"version":3,"file":"get-sdk-api-docs.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"build-manage-checklist.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-manage-checklist.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAGD,eAAO,MAAM,wBAAwB,GACnC,gBAAgB,MAAM,KACrB,OAAO,CAAC;IACT,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,aAAa,EAAE,CAAC;CAC/B,CAgBA,CAAC;AAEF,eAAO,MAAM,+BAA+B;WAElB,KAAK;cAAY,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmSjE,CAAC"}
1
+ {"version":3,"file":"build-manage-checklist.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-manage-checklist.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAGD,eAAO,MAAM,wBAAwB,GACnC,gBAAgB,MAAM,KACrB,OAAO,CAAC;IACT,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,aAAa,EAAE,CAAC;CAC/B,CAgBA,CAAC;AAEF,eAAO,MAAM,+BAA+B;WAElB,KAAK;cAAY,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0SjE,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import z from "zod";
2
- import { addChecklistItem, clearChecklist, readPersistedChecklist, updateChecklistItem, } from "../../checklist/persisted-checklist-store.js";
2
+ import { addChecklistItem, clearChecklist, isV2ToV3MigrationInProgress, readPersistedChecklist, updateChecklistItem, } from "../../checklist/persisted-checklist-store.js";
3
3
  import { createToolFactory, ToolCategory } from "../tools2/types.js";
4
4
  // Export function to be used by other tools
5
5
  export const checkChecklistCompletion = async (appRootDirPath) => {
@@ -173,6 +173,11 @@ export const buildManageChecklistToolFactory = createToolFactory("build_manageCh
173
173
  };
174
174
  }
175
175
  case "clear": {
176
+ if (isV2ToV3MigrationInProgress(checklistState)) {
177
+ throw new Error("Cannot clear the checklist during an active 2.0 -> 3.0 migration. " +
178
+ "Mark items as 'failed' (with a failureReason) or 'cancelled' instead so the " +
179
+ "finalize checklist and Finish migration button remain intact.");
180
+ }
176
181
  await clearChecklist({
177
182
  appRootDirPath: services.appRootDirPath,
178
183
  });
@@ -1 +1 @@
1
- {"version":3,"file":"build-manage-checklist.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-manage-checklist.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"build-manage-checklist.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-manage-checklist.ts"],"names":[],"mappings":"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"}
@@ -76,6 +76,7 @@ declare const provisionHandleSchema: z.ZodObject<{
76
76
  integrationId: z.ZodOptional<z.ZodString>;
77
77
  lifecycleState: z.ZodOptional<z.ZodString>;
78
78
  logicalName: z.ZodOptional<z.ZodString>;
79
+ requestId: z.ZodOptional<z.ZodString>;
79
80
  requirement: z.ZodObject<{
80
81
  logicalName: z.ZodString;
81
82
  migrationDirectory: z.ZodOptional<z.ZodString>;
@@ -93,6 +94,7 @@ declare const provisionHandleSchema: z.ZodObject<{
93
94
  };
94
95
  bindingKey: string;
95
96
  integrationId?: string | undefined;
97
+ requestId?: string | undefined;
96
98
  lifecycleState?: string | undefined;
97
99
  logicalName?: string | undefined;
98
100
  engine?: string | undefined;
@@ -103,6 +105,7 @@ declare const provisionHandleSchema: z.ZodObject<{
103
105
  };
104
106
  bindingKey: string;
105
107
  integrationId?: string | undefined;
108
+ requestId?: string | undefined;
106
109
  lifecycleState?: string | undefined;
107
110
  logicalName?: string | undefined;
108
111
  engine?: string | undefined;
@@ -148,6 +151,7 @@ export declare const provisionDevDatabaseTaskMetadata: {
148
151
  integrationId: z.ZodOptional<z.ZodString>;
149
152
  lifecycleState: z.ZodOptional<z.ZodString>;
150
153
  logicalName: z.ZodOptional<z.ZodString>;
154
+ requestId: z.ZodOptional<z.ZodString>;
151
155
  requirement: z.ZodObject<{
152
156
  logicalName: z.ZodString;
153
157
  migrationDirectory: z.ZodOptional<z.ZodString>;
@@ -165,6 +169,7 @@ export declare const provisionDevDatabaseTaskMetadata: {
165
169
  };
166
170
  bindingKey: string;
167
171
  integrationId?: string | undefined;
172
+ requestId?: string | undefined;
168
173
  lifecycleState?: string | undefined;
169
174
  logicalName?: string | undefined;
170
175
  engine?: string | undefined;
@@ -175,6 +180,7 @@ export declare const provisionDevDatabaseTaskMetadata: {
175
180
  };
176
181
  bindingKey: string;
177
182
  integrationId?: string | undefined;
183
+ requestId?: string | undefined;
178
184
  lifecycleState?: string | undefined;
179
185
  logicalName?: string | undefined;
180
186
  engine?: string | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"dev-database-tasks.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/databases/dev-database-tasks.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dev-database-tasks.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/databases/dev-database-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAc,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,KAAK,EAAE;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACrC,WAAW,CAAC,KAAK,EAAE;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,sBAAsB,CAAC;KACrC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACrC,YAAY,CAAC,KAAK,EAAE;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACxC;AAED,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtD,8EAA8E;IAC9E,SAAS,EAAE,MAAM,qBAAqB,CAAC;CACxC;AAQD,QAAA,MAAM,yBAAyB;;;;;;;;;EAa7B,CAAC;AAEH,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAExE,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAExB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYzB,CAAC;AAEH,QAAA,MAAM,0BAA0B;;;;;;EAQ9B,CAAC;AAEH,QAAA,MAAM,2BAA2B;;;;;;;;;EAG/B,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBzC,CAAC;AAgPX;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG;IACrE,kCAAkC,EAAE,QAAQ,CAC1C,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,CAC1B,CAAC;IACF,4BAA4B,EAAE,QAAQ,CACpC,cAAc,EACd,eAAe,EACf,yBAAyB,CAC1B,CAAC;CACH,CA+LA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,uBAAuB,CAAC,kBAAkB,CAAC,EAC7D,QAAQ,EAAE,yBAAyB,EACnC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAClD,IAAI,CA2BN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,uBAAuB,CAAC,kBAAkB,CAAC,GAC5D,MAAM,IAAI,CAiCZ"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { getLogger } from "../../../../util/logger.js";
3
3
  import { DevDatabaseClientError } from "../../../dev-database-client.js";
4
+ import { scrubSecrets, stripUnsafeChars } from "../../../types.js";
4
5
  import { PermissionLevel, ToolCategory } from "../../tools2/types.js";
5
6
  // Master parity: the only user-controlled requirement fields are
6
7
  // `logicalName` and (optionally) `migrationDirectory`. Engine, extensions,
@@ -9,7 +10,10 @@ import { PermissionLevel, ToolCategory } from "../../tools2/types.js";
9
10
  // lifecycle policy, so exposing them on the LLM surface would let Clark
10
11
  // invent values the platform later overrides.
11
12
  const databaseRequirementSchema = z.object({
12
- logicalName: z.string().min(1).describe("The app-local database name"),
13
+ logicalName: z
14
+ .string()
15
+ .min(1)
16
+ .describe("The app-local database name. Becomes the lifecycle integration's display name. When wiring SDK APIs, derive a valid lowercase snake_case integrations map key from this name (replace non-alphanumeric with _, prefix db_ if empty/digit-leading/reserved; disambiguate collisions). Examples: 'pokemon_tracker' → pokemon_tracker; 'Orders DB' → orders_db. Do not use a generic key like 'db'."),
13
17
  migrationDirectory: z
14
18
  .string()
15
19
  .optional()
@@ -24,6 +28,11 @@ const provisionHandleSchema = z.object({
24
28
  integrationId: z.string().optional(),
25
29
  lifecycleState: z.string().optional(),
26
30
  logicalName: z.string().optional(),
31
+ // Correlates to the server-side lifecycle_request row for oncall/debug
32
+ // (mirrors ApplyMigrationsHandle). Persisted on the task handle so
33
+ // classified failures still carry a durable request id even when the
34
+ // user-facing error string omits it.
35
+ requestId: z.string().min(1).optional(),
27
36
  requirement: databaseRequirementSchema,
28
37
  });
29
38
  const applyMigrationsInputSchema = z.object({
@@ -60,7 +69,7 @@ export const provisionDevDatabaseTaskMetadata = {
60
69
  // only behavioral delta from master.
61
70
  description: "Create or reuse a lifecycle-managed dev database binding for this application on Amazon RDS as a BACKGROUND TASK. Clark provisions the database and returns lifecycle progress. Returns a taskId IMMEDIATELY while RDS provisioning runs in the background; the user already sees live progress in the chat's background-tasks indicator. " +
62
71
  "DO NOT call waitForTask right after this — that defeats the whole point of a background task and blocks your turn for minutes while RDS spins up. Instead: keep working on whatever does NOT depend on the database (scaffold the UI, draft API code that will use the binding, write or read SQL migration files, plan next steps). When you reach a step that genuinely cannot proceed without the connection details, FIRST call checkTask({ taskId }) — it returns instantly. Only fall back to waitForTask if checkTask still reports state='running' AND you literally have no other useful work to do. " +
63
- 'On completion the result includes bindingKey, integrationId, lifecycleState, connectionMetadata, and credentialRefs. Use integrationId only for tool inputs or generated source code such as postgres(...); do not repeat internal UUIDs in user-facing chat. This task ONLY creates the database server + an integration; it does NOT apply SQL migrations — query attempts will fail with `relation "X" does not exist` until you call startApplyDevDatabaseMigrations. Cancellation only stops local polling; the underlying RDS provisioning continues on the server.',
72
+ 'On completion the result includes bindingKey, integrationId, lifecycleState, connectionMetadata, and credentialRefs. Use integrationId only for tool inputs or generated source code such as postgres(...); do not repeat internal UUIDs in user-facing chat. When declaring the integration in an SDK API, derive a valid lowercase snake_case integrations map key from requirement.logicalName (normalize non-alphanumeric to _, prefix db_ if needed, disambiguate collisions; e.g. pokemon_tracker → pokemon_tracker: postgres(POKEMON_TRACKER), Orders DB → orders_db) so code and TraceView match the database name — never a generic key like db. This task ONLY creates the database server + an integration; it does NOT apply SQL migrations — query attempts will fail with `relation "X" does not exist` until you call startApplyDevDatabaseMigrations. Cancellation only stops local polling; the underlying RDS provisioning continues on the server.',
64
73
  externalHandleSchema: provisionHandleSchema,
65
74
  inputSchema: provisionInputSchema,
66
75
  name: "provisionDatabase",
@@ -102,15 +111,124 @@ function toToolError(error) {
102
111
  }
103
112
  return error instanceof Error ? error : new Error(String(error));
104
113
  }
105
- function lifecycleStatusFor(response) {
114
+ // Plain-language, action-first copy for the chat checklist row (clamped,
115
+ // no LLM in the loop). Keep free of internal tool/OPA jargon — builders
116
+ // are the audience, not oncall (ENG-4712 / Wylie review on #20678).
117
+ // Tables are split by action so shared codes (e.g. backend_locked) do not
118
+ // say "Database setup…" / "retry the provisioning task" on migrate fails.
119
+ const LIFECYCLE_FAILURE_USER_MESSAGE = {
120
+ "dev database provisioning": {
121
+ backend_locked: "Database setup is briefly busy. Try again in a moment.",
122
+ callback_failed: "Database setup didn't finish reporting status. Try again.",
123
+ credential_resolution_failed: "Database setup couldn't access required credentials. Contact your admin, then try again.",
124
+ migration_failed: "A database schema update failed. Check your migration SQL, then try again.",
125
+ policy_blocked: "Your organization blocked this database operation. Contact your admin.",
126
+ terraform_failed: "Cloud database setup failed. Check cloud credentials with your admin, then try again.",
127
+ unsupported_provider_capability: "This database operation isn't supported in your environment. Contact your admin.",
128
+ },
129
+ "applying migrations": {
130
+ backend_locked: "Database schema update is briefly busy. Try again in a moment.",
131
+ callback_failed: "Database schema update didn't finish reporting status. Try again.",
132
+ credential_resolution_failed: "Database schema update couldn't access required credentials. Contact your admin, then try again.",
133
+ migration_failed: "A database schema update failed. Check your migration SQL, then try again.",
134
+ policy_blocked: "Your organization blocked this database operation. Contact your admin.",
135
+ terraform_failed: "Cloud database setup failed. Check cloud credentials with your admin, then try again.",
136
+ unsupported_provider_capability: "This database operation isn't supported in your environment. Contact your admin.",
137
+ },
138
+ };
139
+ // Agent/oncall next-step hints (checkTask/waitForTask `detail` only).
140
+ // Only codes the worker already redacts/sanitizes before shipping to the
141
+ // control plane — never raw terraform/provider stderr (see ENG-4712).
142
+ const LIFECYCLE_FAILURE_AGENT_GUIDANCE = {
143
+ "dev database provisioning": {
144
+ backend_locked: "This is usually transient; retry the provisioning task.",
145
+ callback_failed: "The agent failed to report a terminal result; retry, and check the database-lifecycle worker if it persists.",
146
+ credential_resolution_failed: "Credentials could not be resolved for the worker; verify secrets configuration, then retry.",
147
+ migration_failed: "A schema migration failed during provisioning; inspect the migration SQL, fix it, then retry the provisioning task.",
148
+ policy_blocked: "An organization policy blocked this operation; adjust policy or agent capability coverage, then retry.",
149
+ terraform_failed: "Infrastructure provisioning failed on the agent; verify OPA/database-lifecycle worker setup and cloud credentials, then retry.",
150
+ unsupported_provider_capability: "The agent does not support this database operation; update OPA lifecycle configuration, then retry.",
151
+ },
152
+ "applying migrations": {
153
+ backend_locked: "This is usually transient; retry startApplyDevDatabaseMigrations.",
154
+ callback_failed: "The agent failed to report a terminal result; retry startApplyDevDatabaseMigrations, and check the database-lifecycle worker if it persists.",
155
+ credential_resolution_failed: "Credentials could not be resolved for the worker; verify secrets configuration, then retry startApplyDevDatabaseMigrations.",
156
+ migration_failed: "A schema migration failed; inspect the migration SQL, fix it, then retry startApplyDevDatabaseMigrations.",
157
+ policy_blocked: "An organization policy blocked this operation; adjust policy or agent capability coverage, then retry.",
158
+ terraform_failed: "Infrastructure provisioning failed on the agent; verify OPA/database-lifecycle worker setup and cloud credentials, then retry.",
159
+ unsupported_provider_capability: "The agent does not support this database operation; update OPA lifecycle configuration, then retry.",
160
+ },
161
+ };
162
+ /** Max length for code/message/requestId in agent-facing lifecycle failures.
163
+ * Matches `SAFE_INTERP_MAX_LEN` in build-install-packages.ts so a multi-KB
164
+ * provider error cannot crowd out the rest of the agent context. */
165
+ const LIFECYCLE_FAILURE_FIELD_MAX_LEN = 100;
166
+ function sanitizeLifecycleFailureField(value) {
167
+ // Defense-in-depth for LLM-facing task errors: server already redacts
168
+ // credential material, but worker messages can still carry newlines /
169
+ // backticks that would otherwise reach agent context verbatim.
170
+ const scrubbed = stripUnsafeChars(scrubSecrets(value)).trim();
171
+ return scrubbed.length > LIFECYCLE_FAILURE_FIELD_MAX_LEN
172
+ ? `${scrubbed.slice(0, LIFECYCLE_FAILURE_FIELD_MAX_LEN)}…`
173
+ : scrubbed;
174
+ }
175
+ function formatLifecycleTaskFailure(action, response,
176
+ // Durable id from the persisted task handle when progress omits it
177
+ // (Scout / Bugbot: ProvisionHandle.requestId must be read, not only written).
178
+ fallbackRequestId) {
179
+ const code = response.errorCode
180
+ ? sanitizeLifecycleFailureField(response.errorCode)
181
+ : "";
182
+ const message = response.errorMessage
183
+ ? sanitizeLifecycleFailureField(response.errorMessage)
184
+ : "";
185
+ const rawRequestId = response.requestId || fallbackRequestId || "";
186
+ const requestId = rawRequestId
187
+ ? sanitizeLifecycleFailureField(rawRequestId)
188
+ : "";
189
+ const requestSuffix = requestId ? `, request ${requestId}` : "";
190
+ // Prefer the classified reason the server already surfaces. Always keep
191
+ // requestId in `detail` when present so oncall can correlate to the
192
+ // lifecycle_request row (Scout review on #20678).
193
+ let detail;
194
+ if (code && message) {
195
+ detail = `${action} failed (${code}${requestSuffix}): ${message}`;
196
+ }
197
+ else if (message) {
198
+ detail = requestId
199
+ ? `${action} failed (request ${requestId}): ${message}`
200
+ : `${action} failed: ${message}`;
201
+ }
202
+ else if (code) {
203
+ detail = `${action} failed (${code}${requestSuffix})`;
204
+ }
205
+ else if (requestId) {
206
+ detail = `${action} failed (request ${requestId})`;
207
+ }
208
+ else {
209
+ detail = `${action} failed`;
210
+ }
211
+ const agentGuidance = code
212
+ ? LIFECYCLE_FAILURE_AGENT_GUIDANCE[action][code]
213
+ : undefined;
214
+ if (agentGuidance) {
215
+ detail = `${detail}. ${agentGuidance}`;
216
+ }
217
+ const userDefault = action === "applying migrations"
218
+ ? "A database schema update failed. Try again, or contact support if it keeps happening."
219
+ : "Database setup failed. Try again, or contact support if it keeps happening.";
220
+ const error = (code ? LIFECYCLE_FAILURE_USER_MESSAGE[action][code] : undefined) ??
221
+ userDefault;
222
+ return { error, detail };
223
+ }
224
+ function lifecycleStatusFor(response, fallbackRequestId) {
106
225
  switch (response.lifecycleState) {
107
226
  case "ready":
108
227
  return { state: "completed", result: response };
109
- case "failed":
110
- return {
111
- state: "failed",
112
- error: `dev database provisioning failed (request ${response.requestId})`,
113
- };
228
+ case "failed": {
229
+ const { error, detail } = formatLifecycleTaskFailure("dev database provisioning", response, fallbackRequestId);
230
+ return { state: "failed", error, detail };
231
+ }
114
232
  case "cancelled":
115
233
  return { state: "cancelled" };
116
234
  default:
@@ -118,15 +236,14 @@ function lifecycleStatusFor(response) {
118
236
  return { state: "running", message: response.lifecycleState };
119
237
  }
120
238
  }
121
- function migrationStatusFor(response) {
239
+ function migrationStatusFor(response, fallbackRequestId) {
122
240
  switch (response.migrationState) {
123
241
  case "migrated":
124
242
  return { state: "completed", result: response };
125
- case "failed":
126
- return {
127
- state: "failed",
128
- error: `applying migrations failed (request ${response.requestId})`,
129
- };
243
+ case "failed": {
244
+ const { error, detail } = formatLifecycleTaskFailure("applying migrations", response, fallbackRequestId);
245
+ return { state: "failed", error, detail };
246
+ }
130
247
  case "pending":
131
248
  default:
132
249
  return { state: "running", message: response.migrationState };
@@ -140,6 +257,9 @@ function updateProvisionHandleFromResponse(handle, response) {
140
257
  handle.integrationId = response.integrationId;
141
258
  handle.lifecycleState = response.lifecycleState;
142
259
  handle.logicalName = response.logicalName;
260
+ if (response.requestId) {
261
+ handle.requestId = response.requestId;
262
+ }
143
263
  }
144
264
  /**
145
265
  * Build the per-Clark dev-database task types. Closes over the
@@ -229,7 +349,7 @@ export function createDevDatabaseTaskTypes(deps) {
229
349
  throw toToolError(error);
230
350
  }
231
351
  updateProvisionHandleFromResponse(handle, response);
232
- return lifecycleStatusFor(response);
352
+ return lifecycleStatusFor(response, handle.requestId);
233
353
  },
234
354
  };
235
355
  const applyDevDatabaseMigrationsTaskType = {
@@ -292,7 +412,7 @@ export function createDevDatabaseTaskTypes(deps) {
292
412
  if (response.migrationState === "failed") {
293
413
  return {
294
414
  externalHandle: handle,
295
- initialStatus: migrationStatusFor(response),
415
+ initialStatus: migrationStatusFor(response, handle.requestId),
296
416
  label,
297
417
  };
298
418
  }
@@ -317,9 +437,9 @@ export function createDevDatabaseTaskTypes(deps) {
317
437
  // failure instead of spinning forever on migrationState.
318
438
  if (TERMINAL_LIFECYCLE_STATES.has(response.lifecycleState) &&
319
439
  response.lifecycleState !== "ready") {
320
- return lifecycleStatusFor(response);
440
+ return lifecycleStatusFor(response, handle.requestId);
321
441
  }
322
- return migrationStatusFor(response);
442
+ return migrationStatusFor(response, handle.requestId);
323
443
  },
324
444
  };
325
445
  return {