callman-mcp 0.2.0 → 0.4.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 (63) hide show
  1. package/CHANGELOG.md +56 -0
  2. package/README.md +4 -4
  3. package/dist/client/api.d.ts +16 -1
  4. package/dist/client/api.d.ts.map +1 -1
  5. package/dist/client/api.js +22 -0
  6. package/dist/client/api.js.map +1 -1
  7. package/dist/client/types.d.ts +14 -0
  8. package/dist/client/types.d.ts.map +1 -1
  9. package/dist/domain/diagram/build.d.ts +122 -73
  10. package/dist/domain/diagram/build.d.ts.map +1 -1
  11. package/dist/domain/diagram/build.js +51 -167
  12. package/dist/domain/diagram/build.js.map +1 -1
  13. package/dist/domain/diagram/layout.d.ts +5 -4
  14. package/dist/domain/diagram/layout.d.ts.map +1 -1
  15. package/dist/domain/diagram/layout.js +18 -45
  16. package/dist/domain/diagram/layout.js.map +1 -1
  17. package/dist/domain/diagram/patch.d.ts +1011 -92
  18. package/dist/domain/diagram/patch.d.ts.map +1 -1
  19. package/dist/domain/diagram/patch.js +113 -273
  20. package/dist/domain/diagram/patch.js.map +1 -1
  21. package/dist/domain/diagram/style.d.ts +4 -12
  22. package/dist/domain/diagram/style.d.ts.map +1 -1
  23. package/dist/domain/diagram/style.js +8 -84
  24. package/dist/domain/diagram/style.js.map +1 -1
  25. package/dist/domain/diagram/summarize.d.ts +26 -24
  26. package/dist/domain/diagram/summarize.d.ts.map +1 -1
  27. package/dist/domain/diagram/summarize.js +21 -35
  28. package/dist/domain/diagram/summarize.js.map +1 -1
  29. package/dist/domain/requestIntegrations.d.ts +20 -20
  30. package/dist/domain/requestShape.d.ts +32 -32
  31. package/dist/resources/docs/diagramSchema.d.ts +1 -1
  32. package/dist/resources/docs/diagramSchema.d.ts.map +1 -1
  33. package/dist/resources/docs/diagramSchema.js +87 -10
  34. package/dist/resources/docs/diagramSchema.js.map +1 -1
  35. package/dist/resources/docs/overview.d.ts +1 -1
  36. package/dist/resources/docs/overview.d.ts.map +1 -1
  37. package/dist/resources/docs/overview.js +4 -1
  38. package/dist/resources/docs/overview.js.map +1 -1
  39. package/dist/resources/generated/aiPacks.d.ts +1 -1
  40. package/dist/resources/generated/aiPacks.js +2 -2
  41. package/dist/tools/catalog.d.ts.map +1 -1
  42. package/dist/tools/catalog.js +5 -0
  43. package/dist/tools/catalog.js.map +1 -1
  44. package/dist/tools/diagrams.d.ts.map +1 -1
  45. package/dist/tools/diagrams.js +547 -59
  46. package/dist/tools/diagrams.js.map +1 -1
  47. package/dist/tools/lookups.d.ts +5 -1
  48. package/dist/tools/lookups.d.ts.map +1 -1
  49. package/dist/tools/lookups.js +41 -0
  50. package/dist/tools/lookups.js.map +1 -1
  51. package/dist-cjs/client/api.js +22 -0
  52. package/dist-cjs/domain/diagram/build.js +55 -171
  53. package/dist-cjs/domain/diagram/layout.js +19 -45
  54. package/dist-cjs/domain/diagram/patch.js +111 -271
  55. package/dist-cjs/domain/diagram/style.js +11 -88
  56. package/dist-cjs/domain/diagram/summarize.js +23 -35
  57. package/dist-cjs/resources/docs/diagramSchema.js +87 -10
  58. package/dist-cjs/resources/docs/overview.js +4 -1
  59. package/dist-cjs/resources/generated/aiPacks.js +2 -2
  60. package/dist-cjs/tools/catalog.js +5 -0
  61. package/dist-cjs/tools/diagrams.js +539 -51
  62. package/dist-cjs/tools/lookups.js +46 -1
  63. package/package.json +2 -2
@@ -307,7 +307,7 @@ export declare const requestInputSchema: z.ZodObject<{
307
307
  enabled?: boolean | undefined;
308
308
  }[] | undefined;
309
309
  enabled?: boolean | undefined;
310
- valueFormat?: "raw" | "json" | undefined;
310
+ valueFormat?: "json" | "raw" | undefined;
311
311
  continueOnFailure?: boolean | undefined;
312
312
  }, {
313
313
  value: string;
@@ -321,7 +321,7 @@ export declare const requestInputSchema: z.ZodObject<{
321
321
  enabled?: boolean | undefined;
322
322
  }[] | undefined;
323
323
  enabled?: boolean | undefined;
324
- valueFormat?: "raw" | "json" | undefined;
324
+ valueFormat?: "json" | "raw" | undefined;
325
325
  continueOnFailure?: boolean | undefined;
326
326
  }>>>;
327
327
  postPublish: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -360,7 +360,7 @@ export declare const requestInputSchema: z.ZodObject<{
360
360
  enabled?: boolean | undefined;
361
361
  }[] | undefined;
362
362
  enabled?: boolean | undefined;
363
- valueFormat?: "raw" | "json" | undefined;
363
+ valueFormat?: "json" | "raw" | undefined;
364
364
  continueOnFailure?: boolean | undefined;
365
365
  }, {
366
366
  value: string;
@@ -374,7 +374,7 @@ export declare const requestInputSchema: z.ZodObject<{
374
374
  enabled?: boolean | undefined;
375
375
  }[] | undefined;
376
376
  enabled?: boolean | undefined;
377
- valueFormat?: "raw" | "json" | undefined;
377
+ valueFormat?: "json" | "raw" | undefined;
378
378
  continueOnFailure?: boolean | undefined;
379
379
  }>>>;
380
380
  }, "strict", z.ZodTypeAny, {
@@ -404,7 +404,7 @@ export declare const requestInputSchema: z.ZodObject<{
404
404
  enabled?: boolean | undefined;
405
405
  }[] | undefined;
406
406
  enabled?: boolean | undefined;
407
- valueFormat?: "raw" | "json" | undefined;
407
+ valueFormat?: "json" | "raw" | undefined;
408
408
  continueOnFailure?: boolean | undefined;
409
409
  } | null | undefined;
410
410
  postPublish?: {
@@ -419,7 +419,7 @@ export declare const requestInputSchema: z.ZodObject<{
419
419
  enabled?: boolean | undefined;
420
420
  }[] | undefined;
421
421
  enabled?: boolean | undefined;
422
- valueFormat?: "raw" | "json" | undefined;
422
+ valueFormat?: "json" | "raw" | undefined;
423
423
  continueOnFailure?: boolean | undefined;
424
424
  } | null | undefined;
425
425
  }, {
@@ -449,7 +449,7 @@ export declare const requestInputSchema: z.ZodObject<{
449
449
  enabled?: boolean | undefined;
450
450
  }[] | undefined;
451
451
  enabled?: boolean | undefined;
452
- valueFormat?: "raw" | "json" | undefined;
452
+ valueFormat?: "json" | "raw" | undefined;
453
453
  continueOnFailure?: boolean | undefined;
454
454
  } | null | undefined;
455
455
  postPublish?: {
@@ -464,7 +464,7 @@ export declare const requestInputSchema: z.ZodObject<{
464
464
  enabled?: boolean | undefined;
465
465
  }[] | undefined;
466
466
  enabled?: boolean | undefined;
467
- valueFormat?: "raw" | "json" | undefined;
467
+ valueFormat?: "json" | "raw" | undefined;
468
468
  continueOnFailure?: boolean | undefined;
469
469
  } | null | undefined;
470
470
  }>>>;
@@ -527,17 +527,17 @@ export declare const requestInputSchema: z.ZodObject<{
527
527
  value: z.ZodOptional<z.ZodString>;
528
528
  }, "strict", z.ZodTypeAny, {
529
529
  name: string;
530
+ source: "db_pre" | "db_post";
530
531
  field: string;
531
532
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
532
- source: "db_pre" | "db_post";
533
533
  value?: string | undefined;
534
534
  id?: string | undefined;
535
535
  valueType?: "static" | "response" | undefined;
536
536
  }, {
537
537
  name: string;
538
+ source: "db_pre" | "db_post";
538
539
  field: string;
539
540
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
540
- source: "db_pre" | "db_post";
541
541
  value?: string | undefined;
542
542
  id?: string | undefined;
543
543
  valueType?: "static" | "response" | undefined;
@@ -829,7 +829,7 @@ export declare const requestInputSchema: z.ZodObject<{
829
829
  enabled?: boolean | undefined;
830
830
  }[] | undefined;
831
831
  enabled?: boolean | undefined;
832
- valueFormat?: "raw" | "json" | undefined;
832
+ valueFormat?: "json" | "raw" | undefined;
833
833
  continueOnFailure?: boolean | undefined;
834
834
  } | null | undefined;
835
835
  postPublish?: {
@@ -844,7 +844,7 @@ export declare const requestInputSchema: z.ZodObject<{
844
844
  enabled?: boolean | undefined;
845
845
  }[] | undefined;
846
846
  enabled?: boolean | undefined;
847
- valueFormat?: "raw" | "json" | undefined;
847
+ valueFormat?: "json" | "raw" | undefined;
848
848
  continueOnFailure?: boolean | undefined;
849
849
  } | null | undefined;
850
850
  } | null | undefined;
@@ -863,9 +863,9 @@ export declare const requestInputSchema: z.ZodObject<{
863
863
  } | null | undefined;
864
864
  dbAssertions?: {
865
865
  name: string;
866
+ source: "db_pre" | "db_post";
866
867
  field: string;
867
868
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
868
- source: "db_pre" | "db_post";
869
869
  value?: string | undefined;
870
870
  id?: string | undefined;
871
871
  valueType?: "static" | "response" | undefined;
@@ -985,7 +985,7 @@ export declare const requestInputSchema: z.ZodObject<{
985
985
  enabled?: boolean | undefined;
986
986
  }[] | undefined;
987
987
  enabled?: boolean | undefined;
988
- valueFormat?: "raw" | "json" | undefined;
988
+ valueFormat?: "json" | "raw" | undefined;
989
989
  continueOnFailure?: boolean | undefined;
990
990
  } | null | undefined;
991
991
  postPublish?: {
@@ -1000,7 +1000,7 @@ export declare const requestInputSchema: z.ZodObject<{
1000
1000
  enabled?: boolean | undefined;
1001
1001
  }[] | undefined;
1002
1002
  enabled?: boolean | undefined;
1003
- valueFormat?: "raw" | "json" | undefined;
1003
+ valueFormat?: "json" | "raw" | undefined;
1004
1004
  continueOnFailure?: boolean | undefined;
1005
1005
  } | null | undefined;
1006
1006
  } | null | undefined;
@@ -1019,9 +1019,9 @@ export declare const requestInputSchema: z.ZodObject<{
1019
1019
  } | null | undefined;
1020
1020
  dbAssertions?: {
1021
1021
  name: string;
1022
+ source: "db_pre" | "db_post";
1022
1023
  field: string;
1023
1024
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
1024
- source: "db_pre" | "db_post";
1025
1025
  value?: string | undefined;
1026
1026
  id?: string | undefined;
1027
1027
  valueType?: "static" | "response" | undefined;
@@ -1319,7 +1319,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1319
1319
  enabled?: boolean | undefined;
1320
1320
  }[] | undefined;
1321
1321
  enabled?: boolean | undefined;
1322
- valueFormat?: "raw" | "json" | undefined;
1322
+ valueFormat?: "json" | "raw" | undefined;
1323
1323
  continueOnFailure?: boolean | undefined;
1324
1324
  }, {
1325
1325
  value: string;
@@ -1333,7 +1333,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1333
1333
  enabled?: boolean | undefined;
1334
1334
  }[] | undefined;
1335
1335
  enabled?: boolean | undefined;
1336
- valueFormat?: "raw" | "json" | undefined;
1336
+ valueFormat?: "json" | "raw" | undefined;
1337
1337
  continueOnFailure?: boolean | undefined;
1338
1338
  }>>>;
1339
1339
  postPublish: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -1372,7 +1372,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1372
1372
  enabled?: boolean | undefined;
1373
1373
  }[] | undefined;
1374
1374
  enabled?: boolean | undefined;
1375
- valueFormat?: "raw" | "json" | undefined;
1375
+ valueFormat?: "json" | "raw" | undefined;
1376
1376
  continueOnFailure?: boolean | undefined;
1377
1377
  }, {
1378
1378
  value: string;
@@ -1386,7 +1386,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1386
1386
  enabled?: boolean | undefined;
1387
1387
  }[] | undefined;
1388
1388
  enabled?: boolean | undefined;
1389
- valueFormat?: "raw" | "json" | undefined;
1389
+ valueFormat?: "json" | "raw" | undefined;
1390
1390
  continueOnFailure?: boolean | undefined;
1391
1391
  }>>>;
1392
1392
  }, "strict", z.ZodTypeAny, {
@@ -1416,7 +1416,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1416
1416
  enabled?: boolean | undefined;
1417
1417
  }[] | undefined;
1418
1418
  enabled?: boolean | undefined;
1419
- valueFormat?: "raw" | "json" | undefined;
1419
+ valueFormat?: "json" | "raw" | undefined;
1420
1420
  continueOnFailure?: boolean | undefined;
1421
1421
  } | null | undefined;
1422
1422
  postPublish?: {
@@ -1431,7 +1431,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1431
1431
  enabled?: boolean | undefined;
1432
1432
  }[] | undefined;
1433
1433
  enabled?: boolean | undefined;
1434
- valueFormat?: "raw" | "json" | undefined;
1434
+ valueFormat?: "json" | "raw" | undefined;
1435
1435
  continueOnFailure?: boolean | undefined;
1436
1436
  } | null | undefined;
1437
1437
  }, {
@@ -1461,7 +1461,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1461
1461
  enabled?: boolean | undefined;
1462
1462
  }[] | undefined;
1463
1463
  enabled?: boolean | undefined;
1464
- valueFormat?: "raw" | "json" | undefined;
1464
+ valueFormat?: "json" | "raw" | undefined;
1465
1465
  continueOnFailure?: boolean | undefined;
1466
1466
  } | null | undefined;
1467
1467
  postPublish?: {
@@ -1476,7 +1476,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1476
1476
  enabled?: boolean | undefined;
1477
1477
  }[] | undefined;
1478
1478
  enabled?: boolean | undefined;
1479
- valueFormat?: "raw" | "json" | undefined;
1479
+ valueFormat?: "json" | "raw" | undefined;
1480
1480
  continueOnFailure?: boolean | undefined;
1481
1481
  } | null | undefined;
1482
1482
  }>>>>;
@@ -1539,17 +1539,17 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1539
1539
  value: z.ZodOptional<z.ZodString>;
1540
1540
  }, "strict", z.ZodTypeAny, {
1541
1541
  name: string;
1542
+ source: "db_pre" | "db_post";
1542
1543
  field: string;
1543
1544
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
1544
- source: "db_pre" | "db_post";
1545
1545
  value?: string | undefined;
1546
1546
  id?: string | undefined;
1547
1547
  valueType?: "static" | "response" | undefined;
1548
1548
  }, {
1549
1549
  name: string;
1550
+ source: "db_pre" | "db_post";
1550
1551
  field: string;
1551
1552
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
1552
- source: "db_pre" | "db_post";
1553
1553
  value?: string | undefined;
1554
1554
  id?: string | undefined;
1555
1555
  valueType?: "static" | "response" | undefined;
@@ -1731,7 +1731,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1731
1731
  enabled?: boolean | undefined;
1732
1732
  }[] | undefined;
1733
1733
  enabled?: boolean | undefined;
1734
- valueFormat?: "raw" | "json" | undefined;
1734
+ valueFormat?: "json" | "raw" | undefined;
1735
1735
  continueOnFailure?: boolean | undefined;
1736
1736
  } | null | undefined;
1737
1737
  postPublish?: {
@@ -1746,7 +1746,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1746
1746
  enabled?: boolean | undefined;
1747
1747
  }[] | undefined;
1748
1748
  enabled?: boolean | undefined;
1749
- valueFormat?: "raw" | "json" | undefined;
1749
+ valueFormat?: "json" | "raw" | undefined;
1750
1750
  continueOnFailure?: boolean | undefined;
1751
1751
  } | null | undefined;
1752
1752
  } | null | undefined;
@@ -1765,9 +1765,9 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1765
1765
  } | null | undefined;
1766
1766
  dbAssertions?: {
1767
1767
  name: string;
1768
+ source: "db_pre" | "db_post";
1768
1769
  field: string;
1769
1770
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
1770
- source: "db_pre" | "db_post";
1771
1771
  value?: string | undefined;
1772
1772
  id?: string | undefined;
1773
1773
  valueType?: "static" | "response" | undefined;
@@ -1887,7 +1887,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1887
1887
  enabled?: boolean | undefined;
1888
1888
  }[] | undefined;
1889
1889
  enabled?: boolean | undefined;
1890
- valueFormat?: "raw" | "json" | undefined;
1890
+ valueFormat?: "json" | "raw" | undefined;
1891
1891
  continueOnFailure?: boolean | undefined;
1892
1892
  } | null | undefined;
1893
1893
  postPublish?: {
@@ -1902,7 +1902,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1902
1902
  enabled?: boolean | undefined;
1903
1903
  }[] | undefined;
1904
1904
  enabled?: boolean | undefined;
1905
- valueFormat?: "raw" | "json" | undefined;
1905
+ valueFormat?: "json" | "raw" | undefined;
1906
1906
  continueOnFailure?: boolean | undefined;
1907
1907
  } | null | undefined;
1908
1908
  } | null | undefined;
@@ -1921,9 +1921,9 @@ export declare const updateRequestInputSchema: z.ZodObject<{
1921
1921
  } | null | undefined;
1922
1922
  dbAssertions?: {
1923
1923
  name: string;
1924
+ source: "db_pre" | "db_post";
1924
1925
  field: string;
1925
1926
  operator: "equals" | "not_equals" | "exists" | "gt" | "lt";
1926
- source: "db_pre" | "db_post";
1927
1927
  value?: string | undefined;
1928
1928
  id?: string | undefined;
1929
1929
  valueType?: "static" | "response" | undefined;
@@ -1,2 +1,2 @@
1
- export declare const DIAGRAM_SCHEMA_DOC = "# Diagrams (create_diagram, update_diagram, patch_diagram)\n\nA diagram is a **DiagramDocument** (schemaVersion 1): typed nodes with positions and sizes,\nedges between nodes, a title. You write the compact form below; the server assigns ids,\nsizes from the component catalog, edge styles from the semantic, and lays the nodes out.\nEvery object is strict: a misspelled or unknown key is an error that names the valid keys,\nnever silently dropped.\n\n## Compact input\n```jsonc\n{\n \"name\": \"Order platform\", // library entry name\n \"title\": \"Order platform \u2014 runtime view\",\n \"nodes\": [\n { \"id\": \"k8s\", \"type\": \"frame\", \"label\": \"Kubernetes\", // a container\n \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } },\n { \"id\": \"gw\", \"type\": \"net.api-gateway\", \"label\": \"API Gateway\" },\n { \"id\": \"orders\",\"type\": \"net.service\", \"label\": \"Orders service\", \"parent\": \"k8s\" },\n { \"id\": \"db\", \"type\": \"db.postgres\", \"label\": \"orders db\" },\n { \"id\": \"bus\", \"type\": \"mq.kafka\", \"label\": \"events\" }\n ],\n \"edges\": [\n { \"source\": \"gw\", \"target\": \"orders\", \"label\": \"REST\", \"semantic\": \"sync\" },\n { \"source\": \"orders\", \"target\": \"db\", \"semantic\": \"sync\", \"color\": \"#10B981\" },\n { \"source\": \"orders\", \"target\": \"bus\", \"label\": \"OrderCreated\" } // \u2192 bus automatically\n ]\n}\n```\n\n## Nodes\n| Field | Type | Notes |\n| --- | --- | --- |\n| `id` | string | Stable id you reference from `parent` and edges; generated (n1, n2\u2026) when omitted |\n| `type` | string | MUST be a catalog type \u2014 `callman://diagram/components` (or one category: `callman://diagram/components/aws`). Unknown types are rejected with suggestions; `strictTypes: false` draws them as rectangles |\n| `label` | string | 1\u20133 words reads best |\n| `parent` | node id | Puts the node inside a container: `frame`, `pool.horizontal` or `pool.vertical` |\n| `position` | {x, y} | Top-left, relative to the parent container. Omit to auto-layout |\n| `size` | {width, height} | Defaults to the catalog size |\n| `style` | object | See **Styling** |\n| `rotation` | number | Degrees, clockwise |\n| `locked` / `hidden` | boolean | Locked nodes cannot be moved in the studio |\n| `data` | object | Free-form metadata kept with the node; not rendered |\n\n`line`, `arrow` and `line.dashed` are connectors in the studio's palette, not nodes \u2014 draw\nconnections as edges.\n\n## Edges\n| Field | Type | Notes |\n| --- | --- | --- |\n| `source`, `target` | node id | A container id is allowed |\n| `label` | string | |\n| `semantic` | sync \u00B7 async \u00B7 fallback \u00B7 bus | `sync` solid (request/response, default), `async` dashed (event, callback), `fallback` dotted (retry / optional path), `bus` heavy (message bus / stream \u2014 automatic when an end is a messaging component) |\n| `color` | CSS color | Line color, independent of the semantic |\n| `routing` | orthogonal \u00B7 straight \u00B7 curved | Default orthogonal (auto-routed right angles) |\n| `markerEnd` / `markerStart` | none \u00B7 classic \u00B7 classicThin \u00B7 open \u00B7 block \u00B7 diamond \u00B7 oval | Default: classicThin at the target, none at the source. Set `markerStart` for a two-way line |\n\nThe semantic owns the line pattern and width; there is no separate dash or width field on edges.\n\n## Styling (node `style`)\n| Key | Type | Notes |\n| --- | --- | --- |\n| `fill` | CSS color | Background. A translucent `rgba(r,g,b,0.07)` tints a container without hiding its children |\n| `stroke` | CSS color | Border |\n| `textColor` | CSS color | Label |\n| `strokeWidth` | number (px) | Border width |\n| `dashed` | boolean | Containers (frame) are dashed by default |\n| `dashPattern` | string | SVG dash array when dashed: `\"6 4\"` dashed, `\"1 3\"` dotted |\n| `radius` | number (px) | Corner radius (`rounded: true` for the default radius) |\n| `fontSize` | number (px) | |\n| `fontFamily` | string | |\n| `bold`, `italic`, `underline` | boolean | |\n| `align` | left \u00B7 center \u00B7 right | |\n| `verticalAlign` | top \u00B7 middle \u00B7 bottom | |\n| `shadow` | boolean | |\n| `opacity` | 0\u2013100 | |\n\nColors are CSS strings \u2014 `\"#3B82F6\"`, `\"rgb(59,130,246)\"`, `\"rgba(59,130,246,0.08)\"`, `\"tomato\"`.\nPick mid-tone colors: the studio has light and dark themes.\n\nColor-coding containers is the quickest way to make zones read at a glance:\n```jsonc\n{ \"op\": \"updateNode\", \"id\": \"k8s\", \"changes\": { \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } } }\n```\n\n## Layout\nPositions are optional; when any node lacks one the whole diagram is laid out\n(`direction`: DOWN, RIGHT, UP, LEFT). Give explicit `position: {x,y}` only when the user\nasks for a specific arrangement. Keep diagrams readable: 8\u201325 nodes, short labels, one edge\nper relationship.\n\n## Editing: patch_diagram ops\n```jsonc\n{ \"op\": \"addNode\", \"node\": { \"type\": \"db.redis\", \"label\": \"cache\", \"parent\": \"k8s\" } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"label\": \"Orders API\", \"style\": { \"fill\": \"#EFF6FF\" } } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": { \"fill\": null } } } // remove one style key\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": null } } // clear the style\n{ \"op\": \"removeNode\", \"id\": \"bus\" } // its edges are removed, its children move to the top level\n{ \"op\": \"addEdge\", \"edge\": { \"source\": \"orders\", \"target\": \"n6\", \"semantic\": \"async\", \"color\": \"#F59E0B\" } }\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"label\": \"gRPC\", \"semantic\": \"fallback\" } } // color is kept\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"color\": null } } // back to the default color\n{ \"op\": \"removeEdge\", \"id\": \"e3\" }\n{ \"op\": \"setTitle\", \"title\": \"New title\" }\n```\n- updateNode `changes` accepts: type, label, parent (null/\"\" = top level), position, size,\n style, rotation, locked, hidden, data. `style` and `data` MERGE into what the node has;\n a key set to null is removed.\n- updateEdge `changes` accepts: source, target, label (\"\" removes it), semantic, color,\n routing, markerEnd, markerStart.\n- Moving a node (position, size or parent) or re-pointing an edge drops the saved route of\n the edges involved; the studio re-routes them (`reroutedEdges` in the result).\n- `relayout`: `new` (default \u2014 only new nodes get a place), `all` (re-run layout), `none`.\n- `get_diagram` (view `graph`) returns nodes and edges in this same shape \u2014 ids, parents,\n styles, colors \u2014 so read it before a patch.\n\n## Stored document (get_diagram view: \"full\")\n```ts\ninterface DiagramDocument {\n schemaVersion: 1; id: string;\n meta: { title: string; createdAt: string; updatedAt: string };\n canvas?: { background?: \"grid\" | \"dots\" | \"blank\"; gridSize?: number };\n nodes: { id; type; position: {x,y}; size: {width,height}; label?; parentId?; rotation?;\n locked?; hidden?; style?: DiagramStyle; data? }[];\n edges: { id; source?; target?; label?; routing?; style?: DiagramStyle; markerStart?; markerEnd?;\n waypoints?; sourceAnchor?; targetAnchor? }[];\n}\n// Stored colors are { raw: \"#3B82F6\" } (or a theme { token }); bold/italic/underline are\n// the bitmask fontStyle (1 | 2 | 4). The tools convert both ways \u2014 write plain colors.\n```\nEdge meaning is derived from `style` (dashed + dashPattern + strokeWidth) \u2014 set it with\n`semantic`, never directly.\n";
1
+ export declare const DIAGRAM_SCHEMA_DOC = "# Diagrams (create_diagram, update_diagram, patch_diagram)\n\nA diagram is a **DiagramDocument** (schemaVersion 1): typed nodes with positions and sizes,\nedges between nodes, a title. You write the compact form below; the server assigns ids,\nsizes from the component catalog, edge styles from the semantic, and lays the nodes out.\nEvery object is strict: a misspelled or unknown key is an error that names the valid keys,\nnever silently dropped.\n\n## Compact input\n```jsonc\n{\n \"name\": \"Order platform\", // library entry name\n \"title\": \"Order platform \u2014 runtime view\",\n \"nodes\": [\n { \"id\": \"k8s\", \"type\": \"frame\", \"label\": \"Kubernetes\", // a container\n \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } },\n { \"id\": \"gw\", \"type\": \"net.api-gateway\", \"label\": \"API Gateway\" },\n { \"id\": \"orders\",\"type\": \"net.service\", \"label\": \"Orders service\", \"parent\": \"k8s\" },\n { \"id\": \"db\", \"type\": \"db.postgres\", \"label\": \"orders db\" },\n { \"id\": \"bus\", \"type\": \"mq.kafka\", \"label\": \"events\" }\n ],\n \"edges\": [\n { \"source\": \"gw\", \"target\": \"orders\", \"label\": \"REST\", \"semantic\": \"sync\" },\n { \"source\": \"orders\", \"target\": \"db\", \"semantic\": \"sync\", \"color\": \"#10B981\" },\n { \"source\": \"orders\", \"target\": \"bus\", \"label\": \"OrderCreated\" } // \u2192 bus automatically\n ]\n}\n```\n\n## Nodes\n| Field | Type | Notes |\n| --- | --- | --- |\n| `id` | string | Stable id you reference from `parent` and edges; generated (n1, n2\u2026) when omitted |\n| `type` | string | MUST be a catalog type \u2014 `callman://diagram/components` (or one category: `callman://diagram/components/aws`). Unknown types are rejected with suggestions; `strictTypes: false` draws them as rectangles |\n| `label` | string | 1\u20133 words reads best |\n| `parent` | node id | Puts the node inside a container: `frame`, `pool.horizontal` or `pool.vertical` |\n| `position` | {x, y} | Top-left, relative to the parent container. Omit to auto-layout |\n| `size` | {width, height} | Defaults to the catalog size |\n| `style` | object | See **Styling** |\n| `rotation` | number | Degrees, clockwise |\n| `locked` / `hidden` | boolean | Locked nodes cannot be moved in the studio |\n| `data` | object | Free-form metadata kept with the node; not rendered |\n\n`line`, `arrow` and `line.dashed` are connectors in the studio's palette, not nodes \u2014 draw\nconnections as edges.\n\n## Edges\n| Field | Type | Notes |\n| --- | --- | --- |\n| `source`, `target` | node id | A container id is allowed |\n| `label` | string | |\n| `semantic` | sync \u00B7 async \u00B7 fallback \u00B7 bus | `sync` solid (request/response, default), `async` dashed (event, callback), `fallback` dotted (retry / optional path), `bus` heavy (message bus / stream \u2014 automatic when an end is a messaging component) |\n| `color` | CSS color | Line color, independent of the semantic |\n| `routing` | orthogonal \u00B7 straight \u00B7 curved | Default orthogonal (auto-routed right angles) |\n| `markerEnd` / `markerStart` | none \u00B7 classic \u00B7 classicThin \u00B7 open \u00B7 block \u00B7 diamond \u00B7 oval | Default: classicThin at the target, none at the source. Set `markerStart` for a two-way line |\n\nThe semantic owns the line pattern and width; there is no separate dash or width field on edges.\n\n## Styling (node `style`)\n| Key | Type | Notes |\n| --- | --- | --- |\n| `fill` | CSS color | Background. A translucent `rgba(r,g,b,0.07)` tints a container without hiding its children |\n| `stroke` | CSS color | Border |\n| `textColor` | CSS color | Label |\n| `strokeWidth` | number (px) | Border width |\n| `dashed` | boolean | Containers (frame) are dashed by default |\n| `dashPattern` | string | SVG dash array when dashed: `\"6 4\"` dashed, `\"1 3\"` dotted |\n| `radius` | number (px) | Corner radius (`rounded: true` for the default radius) |\n| `fontSize` | number (px) | |\n| `fontFamily` | string | |\n| `bold`, `italic`, `underline` | boolean | |\n| `align` | left \u00B7 center \u00B7 right | |\n| `verticalAlign` | top \u00B7 middle \u00B7 bottom | |\n| `shadow` | boolean | |\n| `opacity` | 0\u2013100 | |\n\nColors are CSS strings \u2014 `\"#3B82F6\"`, `\"rgb(59,130,246)\"`, `\"rgba(59,130,246,0.08)\"`, `\"tomato\"`.\nPick mid-tone colors: the studio has light and dark themes.\n\nColor-coding containers is the quickest way to make zones read at a glance:\n```jsonc\n{ \"op\": \"updateNode\", \"id\": \"k8s\", \"changes\": { \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } } }\n```\n\n## Layout\nPositions are optional; when any node lacks one the whole diagram is laid out\n(`direction`: DOWN, RIGHT, UP, LEFT). Give explicit `position: {x,y}` only when the user\nasks for a specific arrangement. Keep diagrams readable: 8\u201325 nodes, short labels, one edge\nper relationship.\n\n## Editing: patch_diagram ops\nOps describe CHANGES; the rest of the diagram stays exactly as it is. The op list below is the\nsame vocabulary the desktop's AI assistant uses \u2014 one implementation (callman-core) applies both.\n```jsonc\n{ \"op\": \"addNode\", \"node\": { \"type\": \"db.redis\", \"label\": \"cache\", \"parent\": \"k8s\" } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"label\": \"Orders API\", \"style\": { \"fill\": \"#EFF6FF\" } } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": { \"fill\": null } } } // remove one style key\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": null } } // clear the style\n{ \"op\": \"removeNode\", \"id\": \"bus\" } // its edges are removed, its children move to the top level\n{ \"op\": \"addEdge\", \"edge\": { \"source\": \"orders\", \"target\": \"cache\", \"semantic\": \"async\", \"color\": \"#F59E0B\" } }\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"label\": \"gRPC\", \"semantic\": \"fallback\" } } // color is kept\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"color\": null } } // back to the default color\n{ \"op\": \"removeEdge\", \"id\": \"e3\" }\n{ \"op\": \"setTitle\", \"title\": \"New title\" }\n{ \"op\": \"moveNode\", \"id\": \"orders\", \"position\": { \"x\": 320, \"y\": 80 } }\n{ \"op\": \"reparent\", \"id\": \"orders\", \"parent\": \"k8s\" } // null = top level\n{ \"op\": \"setEdgeRoute\", \"id\": \"e2\", \"routing\": \"smart\", \"sourceSide\": \"right\", \"targetSide\": \"left\" }\n{ \"op\": \"reorder\", \"id\": \"k8s\", \"index\": \"back\" }\n{ \"op\": \"setCanvas\", \"canvas\": { \"background\": \"grid\", \"defaultRouting\": \"orthogonal\" } }\n{ \"op\": \"group\", \"ids\": [\"orders\", \"db\"], \"label\": \"Order domain\" } // a new frame around them\n{ \"op\": \"ungroup\", \"id\": \"k8s\" } // members stay where they are\n{ \"op\": \"relayout\", \"scope\": \"new\" } // hint: place only the new nodes (or \"all\")\n```\n- updateNode `changes` accepts: type, label, parent (null/\"\" = top level), position, size,\n style, rotation, locked, hidden, collapsed, data. `style` and `data` MERGE into what the\n node has; a key set to null is removed.\n- updateEdge `changes` accepts: source, target, label (\"\" removes it), semantic, color,\n routing, markerEnd, markerStart, sourceSide, targetSide (null = floating).\n- Ids: a node written without an id gets a slug of its label (`orders-service`, `-2` on a\n clash); the result's `idMap` reports any id that had to change.\n- Moving a node (position, size or parent) or re-pointing an edge drops the saved route of\n the edges involved; the studio re-routes them (`reroutedEdges` in the result).\n- `relayout`: `new` (default \u2014 only new nodes get a place), `all` (re-run layout), `none`.\n- `get_diagram` (view `graph`) returns nodes and edges in this same shape \u2014 ids, parents,\n styles, colors, routing, sides \u2014 so read it before a patch.\n- If someone saved the diagram between your read and your patch, the ops are re-applied on\n the newer version automatically (they describe intent, not a whole document).\n\n## Mermaid\n- `get_diagram` view `mermaid` renders any diagram as a Mermaid flowchart (`id@{ shape, label }`\n nodes, `subgraph` containers, `e1@-->` edge ids, `-->`/`-.->`/`==>` for sync/async/bus).\n- `create_diagram` / `update_diagram` accept `source: { format: \"mermaid\", text }` instead of\n nodes: a flowchart/graph becomes nodes and edges (laid out automatically) and the text stays\n attached as the diagram's source \u2014 later ops keep it in sync (the desktop shows both).\n Bracket shapes map to component types (`[( )]` \u2192 database, `{ }` \u2192 decision, `([ ])` \u2192\n terminator \u2026); `click`, `%%` comments and unknown statements are kept untouched.\n- Any other Mermaid type (sequenceDiagram, classDiagram, erDiagram \u2026) is stored as source only:\n `get_diagram` view `source` returns it, the desktop previews it, and structural ops are\n refused with `DIAGRAM_SOURCE_UNSUPPORTED_TYPE`.\n\n## BPMN\n- A BPMN diagram keeps its truth in BPMN 2.0 XML: `create_diagram` with `kind: \"bpmn\"` (or nodes\n typed bpmn.*) writes the XML from your nodes and edges; `source: { format: \"bpmn\", text }` stores a\n file you already have (from Camunda Modeler, for example). The desktop opens it in its BPMN editor.\n- Node `type` is one of the bpmn.* types listed under DIAGRAM OPS above (bpmn.start-event,\n bpmn.user-task, bpmn.service-task, bpmn.exclusive-gateway, bpmn.parallel-gateway, bpmn.subprocess,\n bpmn.pool, bpmn.lane, bpmn.boundary-event \u2026). `data.bpmn` carries the BPMN facts:\n `eventDefinition` (message | timer | error | signal | \u2026), `attachedTo` (boundary events),\n `cancelActivity`, `isExpanded`. Edges are sequence flows; `data.bpmn` may set\n `flow: \"message\"` (between pools), `conditionExpression` and `isDefault`.\n- Pools and lanes are containers (`parent`); a boundary event's parent is its host's parent.\n New nodes need no position: they are placed after their predecessor.\n- `patch_diagram` works as on any diagram: every op lands on the XML as a minimal edit \u2014 extension\n elements, annotations and the modeler's formatting stay untouched. `get_diagram` view `source`\n returns the XML; view `graph` shows the derived nodes/edges with their `bpmn` facts.\n\n## Database diagrams (ERD)\n- A database diagram keeps its truth in a JSON database model (`source.format: \"database\"`):\n tables (`entities`) with columns, keys, indexes and comments, and relationships between them;\n the nodes on the canvas hold only positions and visibility. The desktop opens it on an ERD\n canvas; `get_diagram` view `schema` shows tables with their columns and the relationships as\n `table.column` pairs \u2014 read it before editing.\n- Create one with `create_diagram`: `tables` + `relationships` (`{ name, schema?, columns:\n [{ name, dataType, primaryKey?, nullable?, unique?, defaultValue?, comment? }] }` and\n `{ source: \"orders.user_id\", target: \"users.id\", cardinality: \"N:1\" }` \u2014 source is the child /\n foreign-key side), or nodes typed db.table / db.view / db.collection with the columns in\n `data.db.columns`, or `fromConnection` to read a real database through one of the\n workspace's connections (`introspect_database` reads the same schema without drawing it).\n- Edit with the schema ops of `patch_diagram`:\n```jsonc\n{ \"op\": \"addTable\", \"table\": { \"name\": \"payments\", \"columns\": [{ \"name\": \"id\", \"dataType\": \"uuid\", \"primaryKey\": true }, { \"name\": \"order_id\", \"dataType\": \"bigint\" }, { \"name\": \"amount\", \"dataType\": \"numeric(12,2)\" }] } }\n{ \"op\": \"addColumn\", \"table\": \"users\", \"column\": { \"name\": \"profile_id\", \"dataType\": \"uuid\", \"nullable\": true }, \"after\": \"id\" }\n{ \"op\": \"alterColumn\", \"table\": \"users\", \"column\": \"email\", \"changes\": { \"unique\": true, \"nullable\": false } }\n{ \"op\": \"removeColumn\", \"table\": \"users\", \"column\": \"nickname\" }\n{ \"op\": \"setPrimaryKey\", \"table\": \"order_items\", \"columns\": [\"order_id\", \"line\"] }\n{ \"op\": \"renameTable\", \"table\": \"users\", \"name\": \"accounts\", \"schema\": \"auth\" }\n{ \"op\": \"setTableComment\", \"table\": \"users\", \"comment\": \"People who can sign in\" }\n{ \"op\": \"addRelationship\", \"source\": \"payments.order_id\", \"target\": \"orders.id\", \"cardinality\": \"N:1\" }\n{ \"op\": \"updateRelationship\", \"relationship\": \"fk-payments-orders\", \"changes\": { \"cardinality\": \"1:1\", \"label\": \"settles\" } }\n{ \"op\": \"removeRelationship\", \"relationship\": \"fk-payments-orders\" }\n{ \"op\": \"removeTable\", \"table\": \"audit_log\" } // its relationships go with it\n{ \"op\": \"hideTable\", \"table\": \"migrations\" } // canvas only; showTable brings it back\n```\n Tables are named (`users`, `public.users`), columns as `table.column`; ids stay stable\n across renames. New tables are placed to the right of the existing ones (or laid out with\n `relayout: \"all\"`). moveNode, hideTable/showTable and setCanvas change the canvas only;\n group / ungroup / reparent do not apply.\n\n## Stored document (get_diagram view: \"full\")\n```ts\ninterface DiagramDocument {\n schemaVersion: 1; id: string;\n meta: { title: string; createdAt: string; updatedAt: string; revision?: number };\n canvas?: { background?: \"grid\" | \"dots\" | \"blank\"; gridSize?: number;\n defaultRouting?: \"orthogonal\" | \"straight\" | \"curved\" | \"smart\";\n layout?: { algorithm; direction }; viewport?: { x; y; zoom } };\n nodes: { id; type; position: {x,y}; size: {width,height}; label?; parentId?; rotation?;\n locked?; hidden?; collapsed?; collapsedSize?; style?: DiagramStyle; data? }[];\n edges: { id; source?; target?; label?; labelPosition?; routing?; sourceHandle?; targetHandle?;\n style?: DiagramStyle; markerStart?; markerEnd?; waypoints? }[];\n source?: { format: \"mermaid\" | \"bpmn\" | \"database\"; text; diagramType; grammar?; valid? };\n}\n// Stored colors are { raw: \"#3B82F6\" } (or a theme { token }); bold/italic/underline are\n// the bitmask fontStyle (1 | 2 | 4). The tools convert both ways \u2014 write plain colors.\n```\nEdge meaning is derived from `style` (dashed + dashPattern + strokeWidth) \u2014 set it with\n`semantic`, never directly.\n";
2
2
  //# sourceMappingURL=diagramSchema.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"diagramSchema.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,oyPAkI9B,CAAC"}
1
+ {"version":3,"file":"diagramSchema.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,mmdA+M9B,CAAC"}
@@ -89,39 +89,116 @@ asks for a specific arrangement. Keep diagrams readable: 8–25 nodes, short lab
89
89
  per relationship.
90
90
 
91
91
  ## Editing: patch_diagram ops
92
+ Ops describe CHANGES; the rest of the diagram stays exactly as it is. The op list below is the
93
+ same vocabulary the desktop's AI assistant uses — one implementation (callman-core) applies both.
92
94
  \`\`\`jsonc
93
95
  { "op": "addNode", "node": { "type": "db.redis", "label": "cache", "parent": "k8s" } }
94
96
  { "op": "updateNode", "id": "orders", "changes": { "label": "Orders API", "style": { "fill": "#EFF6FF" } } }
95
97
  { "op": "updateNode", "id": "orders", "changes": { "style": { "fill": null } } } // remove one style key
96
98
  { "op": "updateNode", "id": "orders", "changes": { "style": null } } // clear the style
97
99
  { "op": "removeNode", "id": "bus" } // its edges are removed, its children move to the top level
98
- { "op": "addEdge", "edge": { "source": "orders", "target": "n6", "semantic": "async", "color": "#F59E0B" } }
100
+ { "op": "addEdge", "edge": { "source": "orders", "target": "cache", "semantic": "async", "color": "#F59E0B" } }
99
101
  { "op": "updateEdge", "id": "e2", "changes": { "label": "gRPC", "semantic": "fallback" } } // color is kept
100
102
  { "op": "updateEdge", "id": "e2", "changes": { "color": null } } // back to the default color
101
103
  { "op": "removeEdge", "id": "e3" }
102
104
  { "op": "setTitle", "title": "New title" }
105
+ { "op": "moveNode", "id": "orders", "position": { "x": 320, "y": 80 } }
106
+ { "op": "reparent", "id": "orders", "parent": "k8s" } // null = top level
107
+ { "op": "setEdgeRoute", "id": "e2", "routing": "smart", "sourceSide": "right", "targetSide": "left" }
108
+ { "op": "reorder", "id": "k8s", "index": "back" }
109
+ { "op": "setCanvas", "canvas": { "background": "grid", "defaultRouting": "orthogonal" } }
110
+ { "op": "group", "ids": ["orders", "db"], "label": "Order domain" } // a new frame around them
111
+ { "op": "ungroup", "id": "k8s" } // members stay where they are
112
+ { "op": "relayout", "scope": "new" } // hint: place only the new nodes (or "all")
103
113
  \`\`\`
104
114
  - updateNode \`changes\` accepts: type, label, parent (null/"" = top level), position, size,
105
- style, rotation, locked, hidden, data. \`style\` and \`data\` MERGE into what the node has;
106
- a key set to null is removed.
115
+ style, rotation, locked, hidden, collapsed, data. \`style\` and \`data\` MERGE into what the
116
+ node has; a key set to null is removed.
107
117
  - updateEdge \`changes\` accepts: source, target, label ("" removes it), semantic, color,
108
- routing, markerEnd, markerStart.
118
+ routing, markerEnd, markerStart, sourceSide, targetSide (null = floating).
119
+ - Ids: a node written without an id gets a slug of its label (\`orders-service\`, \`-2\` on a
120
+ clash); the result's \`idMap\` reports any id that had to change.
109
121
  - Moving a node (position, size or parent) or re-pointing an edge drops the saved route of
110
122
  the edges involved; the studio re-routes them (\`reroutedEdges\` in the result).
111
123
  - \`relayout\`: \`new\` (default — only new nodes get a place), \`all\` (re-run layout), \`none\`.
112
124
  - \`get_diagram\` (view \`graph\`) returns nodes and edges in this same shape — ids, parents,
113
- styles, colors — so read it before a patch.
125
+ styles, colors, routing, sides — so read it before a patch.
126
+ - If someone saved the diagram between your read and your patch, the ops are re-applied on
127
+ the newer version automatically (they describe intent, not a whole document).
128
+
129
+ ## Mermaid
130
+ - \`get_diagram\` view \`mermaid\` renders any diagram as a Mermaid flowchart (\`id@{ shape, label }\`
131
+ nodes, \`subgraph\` containers, \`e1@-->\` edge ids, \`-->\`/\`-.->\`/\`==>\` for sync/async/bus).
132
+ - \`create_diagram\` / \`update_diagram\` accept \`source: { format: "mermaid", text }\` instead of
133
+ nodes: a flowchart/graph becomes nodes and edges (laid out automatically) and the text stays
134
+ attached as the diagram's source — later ops keep it in sync (the desktop shows both).
135
+ Bracket shapes map to component types (\`[( )]\` → database, \`{ }\` → decision, \`([ ])\` →
136
+ terminator …); \`click\`, \`%%\` comments and unknown statements are kept untouched.
137
+ - Any other Mermaid type (sequenceDiagram, classDiagram, erDiagram …) is stored as source only:
138
+ \`get_diagram\` view \`source\` returns it, the desktop previews it, and structural ops are
139
+ refused with \`DIAGRAM_SOURCE_UNSUPPORTED_TYPE\`.
140
+
141
+ ## BPMN
142
+ - A BPMN diagram keeps its truth in BPMN 2.0 XML: \`create_diagram\` with \`kind: "bpmn"\` (or nodes
143
+ typed bpmn.*) writes the XML from your nodes and edges; \`source: { format: "bpmn", text }\` stores a
144
+ file you already have (from Camunda Modeler, for example). The desktop opens it in its BPMN editor.
145
+ - Node \`type\` is one of the bpmn.* types listed under DIAGRAM OPS above (bpmn.start-event,
146
+ bpmn.user-task, bpmn.service-task, bpmn.exclusive-gateway, bpmn.parallel-gateway, bpmn.subprocess,
147
+ bpmn.pool, bpmn.lane, bpmn.boundary-event …). \`data.bpmn\` carries the BPMN facts:
148
+ \`eventDefinition\` (message | timer | error | signal | …), \`attachedTo\` (boundary events),
149
+ \`cancelActivity\`, \`isExpanded\`. Edges are sequence flows; \`data.bpmn\` may set
150
+ \`flow: "message"\` (between pools), \`conditionExpression\` and \`isDefault\`.
151
+ - Pools and lanes are containers (\`parent\`); a boundary event's parent is its host's parent.
152
+ New nodes need no position: they are placed after their predecessor.
153
+ - \`patch_diagram\` works as on any diagram: every op lands on the XML as a minimal edit — extension
154
+ elements, annotations and the modeler's formatting stay untouched. \`get_diagram\` view \`source\`
155
+ returns the XML; view \`graph\` shows the derived nodes/edges with their \`bpmn\` facts.
156
+
157
+ ## Database diagrams (ERD)
158
+ - A database diagram keeps its truth in a JSON database model (\`source.format: "database"\`):
159
+ tables (\`entities\`) with columns, keys, indexes and comments, and relationships between them;
160
+ the nodes on the canvas hold only positions and visibility. The desktop opens it on an ERD
161
+ canvas; \`get_diagram\` view \`schema\` shows tables with their columns and the relationships as
162
+ \`table.column\` pairs — read it before editing.
163
+ - Create one with \`create_diagram\`: \`tables\` + \`relationships\` (\`{ name, schema?, columns:
164
+ [{ name, dataType, primaryKey?, nullable?, unique?, defaultValue?, comment? }] }\` and
165
+ \`{ source: "orders.user_id", target: "users.id", cardinality: "N:1" }\` — source is the child /
166
+ foreign-key side), or nodes typed db.table / db.view / db.collection with the columns in
167
+ \`data.db.columns\`, or \`fromConnection\` to read a real database through one of the
168
+ workspace's connections (\`introspect_database\` reads the same schema without drawing it).
169
+ - Edit with the schema ops of \`patch_diagram\`:
170
+ \`\`\`jsonc
171
+ { "op": "addTable", "table": { "name": "payments", "columns": [{ "name": "id", "dataType": "uuid", "primaryKey": true }, { "name": "order_id", "dataType": "bigint" }, { "name": "amount", "dataType": "numeric(12,2)" }] } }
172
+ { "op": "addColumn", "table": "users", "column": { "name": "profile_id", "dataType": "uuid", "nullable": true }, "after": "id" }
173
+ { "op": "alterColumn", "table": "users", "column": "email", "changes": { "unique": true, "nullable": false } }
174
+ { "op": "removeColumn", "table": "users", "column": "nickname" }
175
+ { "op": "setPrimaryKey", "table": "order_items", "columns": ["order_id", "line"] }
176
+ { "op": "renameTable", "table": "users", "name": "accounts", "schema": "auth" }
177
+ { "op": "setTableComment", "table": "users", "comment": "People who can sign in" }
178
+ { "op": "addRelationship", "source": "payments.order_id", "target": "orders.id", "cardinality": "N:1" }
179
+ { "op": "updateRelationship", "relationship": "fk-payments-orders", "changes": { "cardinality": "1:1", "label": "settles" } }
180
+ { "op": "removeRelationship", "relationship": "fk-payments-orders" }
181
+ { "op": "removeTable", "table": "audit_log" } // its relationships go with it
182
+ { "op": "hideTable", "table": "migrations" } // canvas only; showTable brings it back
183
+ \`\`\`
184
+ Tables are named (\`users\`, \`public.users\`), columns as \`table.column\`; ids stay stable
185
+ across renames. New tables are placed to the right of the existing ones (or laid out with
186
+ \`relayout: "all"\`). moveNode, hideTable/showTable and setCanvas change the canvas only;
187
+ group / ungroup / reparent do not apply.
114
188
 
115
189
  ## Stored document (get_diagram view: "full")
116
190
  \`\`\`ts
117
191
  interface DiagramDocument {
118
192
  schemaVersion: 1; id: string;
119
- meta: { title: string; createdAt: string; updatedAt: string };
120
- canvas?: { background?: "grid" | "dots" | "blank"; gridSize?: number };
193
+ meta: { title: string; createdAt: string; updatedAt: string; revision?: number };
194
+ canvas?: { background?: "grid" | "dots" | "blank"; gridSize?: number;
195
+ defaultRouting?: "orthogonal" | "straight" | "curved" | "smart";
196
+ layout?: { algorithm; direction }; viewport?: { x; y; zoom } };
121
197
  nodes: { id; type; position: {x,y}; size: {width,height}; label?; parentId?; rotation?;
122
- locked?; hidden?; style?: DiagramStyle; data? }[];
123
- edges: { id; source?; target?; label?; routing?; style?: DiagramStyle; markerStart?; markerEnd?;
124
- waypoints?; sourceAnchor?; targetAnchor? }[];
198
+ locked?; hidden?; collapsed?; collapsedSize?; style?: DiagramStyle; data? }[];
199
+ edges: { id; source?; target?; label?; labelPosition?; routing?; sourceHandle?; targetHandle?;
200
+ style?: DiagramStyle; markerStart?; markerEnd?; waypoints? }[];
201
+ source?: { format: "mermaid" | "bpmn" | "database"; text; diagramType; grammar?; valid? };
125
202
  }
126
203
  // Stored colors are { raw: "#3B82F6" } (or a theme { token }); bold/italic/underline are
127
204
  // the bitmask fontStyle (1 | 2 | 4). The tools convert both ways — write plain colors.
@@ -1 +1 @@
1
- {"version":3,"file":"diagramSchema.js","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkIjC,CAAC"}
1
+ {"version":3,"file":"diagramSchema.js","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+MjC,CAAC"}
@@ -1,2 +1,2 @@
1
- export declare const OVERVIEW_DOC = "# Working with Callman through MCP\n\nCallman is an API client and test platform (collections of HTTP requests, environments,\nmulti-step test scenarios, system-design diagrams). This server exposes it to you through\ntools; everything you do goes to the same server the Callman desktop app uses, as the user\nwhose token is configured, limited to that token's permissions and the user's workspace role.\n\n## Start here\n1. `whoami` \u2014 proves the connection and tells you the workspaces, features and which tools\n this token can use.\n2. Look before you create: `list_collections` / `get_collection_tree` / `search_requests`.\n Creating a collection whose name exists is refused on purpose.\n3. Arguments are strict: a misspelled or unknown argument is an error that lists the valid\n ones \u2014 read it and retry; nothing is silently ignored.\n4. Names work as references everywhere an id does (collection, folder, request, environment,\n scenario, diagram, workspace). Ambiguous names come back as a candidate list \u2014 pick one.\n5. Preview big writes with `dryRun: true` (bulk create, imports, scenarios, diagrams).\n6. Deletions need `confirm: true` and an exact name or id. Ask the user unless they explicitly\n requested the deletion.\n\n## Workspaces\nThe token works in EVERY workspace the user belongs to (with their role in each):\n- Lists and searches (`list_collections`, `search_requests`, `list_environments`,\n `list_connections`, `list_scenarios`) cover all workspaces unless you pass `workspace`;\n every row says which workspace it is in.\n- A name (collection, request, environment) is looked up in the default workspace first, then\n in all others; a unique match anywhere is used and the result says where it was found. The\n same name in several workspaces comes back as candidates tagged with their workspace \u2014 pass\n `workspace` or the id.\n- Creating needs one target: `workspace`, or the collection it goes into, or the session\n default. `use_workspace` changes the default for the session (it never hides the others).\n- Environments, connections and global variables belong to one workspace: a request uses the\n ones of its own workspace.\n\n## Requests\n- Use `{{variable}}` for hosts and secrets (`{{baseUrl}}/users`) and put the values in an\n environment (`create_environment` / `set_environment_variables`). Use `:id` for path\n variables. See `callman://docs/request-schema`.\n- get_request returns a request in the same shape create/update take \u2014 read, change, send back.\n- Bodies: a JSON value, a raw string, or `{ mode: raw|formdata|urlencoded|json }`.\n- Database / Kafka / Redis steps and DB assertions are request fields; connections are\n referenced by id or name (`list_connections`).\n- Contract checks (field rules, data-driven rows) \u2014 `callman://docs/contracts`.\n- Scripts run in a sandbox with the `pm.*` API \u2014 `callman://docs/scripting/pm-api`.\n- `run_request` / `run_collection` execute on the user's machine with real variable values;\n you only get results and the names of variables scripts changed.\n\n## Secrets\nEnvironment values come back masked (`\u2022\u2022\u2022\u2022ab`) unless the token holds `environments:reveal`\nand you ask for `reveal: true`. Never write a masked environment value back \u2014 it is refused.\nRequest auth secrets and sensitive headers are masked the same way; sending a masked request\nsecret back UNCHANGED keeps the stored one, anything else masked is refused.\n\n## Scenarios\nMulti-step flows as a graph of typed nodes (request, condition, assertion, set-vars, poll,\ndb, kafka, script, wait, end \u2026). Read `callman://docs/scenario-nodes` before building one;\npartial node configs are merged over defaults. Runs happen on the server (`run_scenario`).\n\n## Diagrams\nSystem-design diagrams use a fixed component catalog \u2014 `callman://diagram/components`.\nBuild with `create_diagram` (auto layout), edit with `patch_diagram`, share with\n`share_diagram`. See `callman://docs/diagram-schema`.\n\n## After writing\nThe desktop app refreshes when the user switches back to it. Tell the user what you created\nand where (collection / folder names).\n";
1
+ export declare const OVERVIEW_DOC = "# Working with Callman through MCP\n\nCallman is an API client and test platform (collections of HTTP requests, environments,\nmulti-step test scenarios, system-design diagrams). This server exposes it to you through\ntools; everything you do goes to the same server the Callman desktop app uses, as the user\nwhose token is configured, limited to that token's permissions and the user's workspace role.\n\n## Start here\n1. `whoami` \u2014 proves the connection and tells you the workspaces, features and which tools\n this token can use.\n2. Look before you create: `list_collections` / `get_collection_tree` / `search_requests`.\n Creating a collection whose name exists is refused on purpose.\n3. Arguments are strict: a misspelled or unknown argument is an error that lists the valid\n ones \u2014 read it and retry; nothing is silently ignored.\n4. Names work as references everywhere an id does (collection, folder, request, environment,\n scenario, diagram, workspace). Ambiguous names come back as a candidate list \u2014 pick one.\n5. Preview big writes with `dryRun: true` (bulk create, imports, scenarios, diagrams).\n6. Deletions need `confirm: true` and an exact name or id. Ask the user unless they explicitly\n requested the deletion.\n\n## Workspaces\nThe token works in EVERY workspace the user belongs to (with their role in each):\n- Lists and searches (`list_collections`, `search_requests`, `list_environments`,\n `list_connections`, `list_scenarios`) cover all workspaces unless you pass `workspace`;\n every row says which workspace it is in.\n- A name (collection, request, environment) is looked up in the default workspace first, then\n in all others; a unique match anywhere is used and the result says where it was found. The\n same name in several workspaces comes back as candidates tagged with their workspace \u2014 pass\n `workspace` or the id.\n- Creating needs one target: `workspace`, or the collection it goes into, or the session\n default. `use_workspace` changes the default for the session (it never hides the others).\n- Environments, connections and global variables belong to one workspace: a request uses the\n ones of its own workspace.\n\n## Requests\n- Use `{{variable}}` for hosts and secrets (`{{baseUrl}}/users`) and put the values in an\n environment (`create_environment` / `set_environment_variables`). Use `:id` for path\n variables. See `callman://docs/request-schema`.\n- get_request returns a request in the same shape create/update take \u2014 read, change, send back.\n- Bodies: a JSON value, a raw string, or `{ mode: raw|formdata|urlencoded|json }`.\n- Database / Kafka / Redis steps and DB assertions are request fields; connections are\n referenced by id or name (`list_connections`).\n- Contract checks (field rules, data-driven rows) \u2014 `callman://docs/contracts`.\n- Scripts run in a sandbox with the `pm.*` API \u2014 `callman://docs/scripting/pm-api`.\n- `run_request` / `run_collection` execute on the user's machine with real variable values;\n you only get results and the names of variables scripts changed.\n\n## Secrets\nEnvironment values come back masked (`\u2022\u2022\u2022\u2022ab`) unless the token holds `environments:reveal`\nand you ask for `reveal: true`. Never write a masked environment value back \u2014 it is refused.\nRequest auth secrets and sensitive headers are masked the same way; sending a masked request\nsecret back UNCHANGED keeps the stored one, anything else masked is refused.\n\n## Scenarios\nMulti-step flows as a graph of typed nodes (request, condition, assertion, set-vars, poll,\ndb, kafka, script, wait, end \u2026). Read `callman://docs/scenario-nodes` before building one;\npartial node configs are merged over defaults. Runs happen on the server (`run_scenario`).\n\n## Diagrams\nSystem-design diagrams use a fixed component catalog \u2014 `callman://diagram/components`.\nBuild with `create_diagram` (auto layout), edit with `patch_diagram`, share with\n`share_diagram`. See `callman://docs/diagram-schema`. The user's library has private\nfolders: `list_diagrams` shows the tree as paths (\"Architecture/Payments\"); file a\ndiagram with `folder` on `create_diagram` / `update_diagram`; manage folders with\n`create_diagram_folder`, `update_diagram_folder`, `delete_diagram_folder`.\n\n## After writing\nThe desktop app refreshes when the user switches back to it. Tell the user what you created\nand where (collection / folder names).\n";
2
2
  //# sourceMappingURL=overview.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,8mIAkExB,CAAC"}
1
+ {"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,k4IAqExB,CAAC"}
@@ -59,7 +59,10 @@ partial node configs are merged over defaults. Runs happen on the server (\`run_
59
59
  ## Diagrams
60
60
  System-design diagrams use a fixed component catalog — \`callman://diagram/components\`.
61
61
  Build with \`create_diagram\` (auto layout), edit with \`patch_diagram\`, share with
62
- \`share_diagram\`. See \`callman://docs/diagram-schema\`.
62
+ \`share_diagram\`. See \`callman://docs/diagram-schema\`. The user's library has private
63
+ folders: \`list_diagrams\` shows the tree as paths ("Architecture/Payments"); file a
64
+ diagram with \`folder\` on \`create_diagram\` / \`update_diagram\`; manage folders with
65
+ \`create_diagram_folder\`, \`update_diagram_folder\`, \`delete_diagram_folder\`.
63
66
 
64
67
  ## After writing
65
68
  The desktop app refreshes when the user switches back to it. Tell the user what you created
@@ -1 +1 @@
1
- {"version":3,"file":"overview.js","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE3B,CAAC"}
1
+ {"version":3,"file":"overview.js","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqE3B,CAAC"}
@@ -1,3 +1,3 @@
1
- export declare const AI_PACKS_CORE_VERSION = "1.28.1";
1
+ export declare const AI_PACKS_CORE_VERSION = "1.30.0";
2
2
  export declare const AI_PACKS: Record<string, string>;
3
3
  //# sourceMappingURL=aiPacks.d.ts.map
@@ -1,5 +1,5 @@
1
- // GENERATED by scripts/build-static-resources.mjs from callman-core@1.28.1 ai-packs — do not edit.
2
- export const AI_PACKS_CORE_VERSION = "1.28.1";
1
+ // GENERATED by scripts/build-static-resources.mjs from callman-core@1.30.0 ai-packs — do not edit.
2
+ export const AI_PACKS_CORE_VERSION = "1.30.0";
3
3
  export const AI_PACKS = {
4
4
  "db-queries": "<!-- GENERATED FILE — do not edit by hand. Source: callman_core (npm run ai:packs). -->\n\n# Callman data access from scripts (`pm.db.query` / `pm.redis.command`)\n\n`pm.db.query({ connectionId, query })` — ALWAYS `await`. `query` is coerced to a string, `{{tokens}}` are resolved, then dispatched by the connection's type. `connectionId` may be omitted to use the request's configured DB connection. IMPORTANT: `pm.db.query` does NOT accept a `params`/bind array — inline values (quote strings) or use `{{env.X}}` tokens; SQL placeholders like `$1` or `?` are NOT bound.\n\n## MongoDB\n`query` MUST be a JSON STRING of a command object (use `JSON.stringify`), NOT a `db.coll.find(...)` shell string. The match key is `filter` (a top-level `query` key is rejected).\n\n```js\nconst body = pm.response.json();\nconst res = await pm.db.query({\n connectionId: \"…\",\n query: JSON.stringify({\n collection: \"users\",\n operation: \"findOne\", // find | findOne | aggregate | countDocuments | insertOne | insertMany | updateOne | updateMany | deleteOne | deleteMany | findOneAndUpdate | findOneAndReplace | findOneAndDelete\n filter: { email: body.data.user.email },\n }),\n});\npm.expect(res.rowCount).to.be.above(0); // existence check\n```\n\nPer-operation fields: `find`/`findOne` use `filter` (+ optional `projection`,`sort`,`limit`,`skip`); `aggregate` uses `pipeline` (array); `insertOne` uses `document`, `insertMany` uses `documents`; `updateOne`/`updateMany`/`findOneAndUpdate` use `filter`+`update` (Mongo update operators, e.g. `{ $set: { … } }`); `deleteOne`/`deleteMany` use `filter`; `findOneAndUpdate`/`findOneAndReplace` accept `returnDocument: \"before\"|\"after\"`. A 24-hex string in a filter is auto-coerced to ObjectId (or use `{ \"$oid\": \"…\" }`). Rows are in `res.rows`; write ops surface counts in `res.rowCount`.\n\n## PostgreSQL / MySQL / Oracle (SQL)\n`query` is plain SQL text. Because `pm.db.query` binds no params, inline the value and quote strings yourself (or use a `{{token}}`):\n\n```js\nconst email = pm.response.json().data.user.email;\nconst res = await pm.db.query({\n connectionId: \"…\",\n query: `SELECT id FROM users WHERE email = '${email}'`,\n});\npm.expect(res.rowCount).to.be.above(0);\n```\n\nNotes: a trailing `;` is stripped (except Oracle PL/SQL blocks, which keep it). **Oracle** returns column names UPPERCASE — read `res.rows[0].EMAIL`, not `.email`. `res.rowCount` is the row count for SELECT and the affected-row count for INSERT/UPDATE/DELETE.\n\n## SQL Server (mssql)\nSingle statement per query; a trailing `;` is stripped; `GO` batch separators are REJECTED (client-tool syntax, not T-SQL). Positional params bind as named inputs: `params[0]` → `@p1`, `params[1]` → `@p2`… (scenario db node only — `pm.db.query` has no params).\n\n```sql\nSELECT TOP 1 id, amount FROM dbo.orders WHERE customer_id = @p1 ORDER BY created_at DESC\n```\n\n## Redis (`pm.redis.command`)\n`command` is a single string. Supported commands: **GET, SET, DEL, EXISTS, TTL, HGET, HSET, HGETALL, HDEL, LPUSH, RPUSH, LRANGE, LLEN, SADD, SMEMBERS, SISMEMBER, INCR, DECR, INCRBY, EXPIRE, PERSIST, TYPE, ZADD, ZRANGE, ZSCORE, SCAN**. Quote a value that contains spaces.\n\nStructured replies land in `res.result` as real values: `HGETALL` → object, `LRANGE`/`SMEMBERS`/`ZRANGE` → array, `EXISTS`/`SISMEMBER`/`EXPIRE`/`PERSIST` → boolean; `res.resultText` is the stringified form. `SCAN pattern [count]` is Callman-managed: the cursor loop runs internally (capped at 1000 keys / 100 iterations) and returns `{ keys, count, truncated }` — no raw cursors.\n\n```js\nconst res = await pm.redis.command({ connectionId: \"…\", command: `GET session:${id}` });\npm.expect(res.success).to.be.true;\n// res.result / res.resultText hold the value; res.commandName, res.key are set.\n```\n",
5
5
  "diagram-components": "<!-- GENERATED FILE — do not edit by hand. Source: callman_core (npm run ai:packs). -->\n\n# Diagram components and edge notation\n\nA diagram node's `type` MUST be one of the keys below (`callman-core` `DIAGRAM_COMPONENT_CATALOG`). Sizes are the defaults the studio uses; `container` types hold children via `parentId`.\n\n## Edge notation\n\n| Semantic | Meaning | Style tuple |\n| --- | --- | --- |\n| `sync` | Request / response call | dashed=false, strokeWidth=1.5 |\n| `async` | Fire-and-forget, event or callback | dashed=true, dashPattern=\"6 4\", strokeWidth=1.5 |\n| `fallback` | Retry, fallback or optional path | dashed=true, dashPattern=\"1 3\", strokeWidth=1.25 |\n| `bus` | Message bus or stream | dashed=false, strokeWidth=3 |\n\n## Generic (`generic`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `line` | Line | 160×0 | connector, edge, link |\n| `arrow` | Arrow | 160×0 | connector, directed, link |\n| `line.dashed` | Dashed Line | 160×0 | dotted, connector |\n| `rect` | Rectangle | 140×64 | box, card |\n| `square` | Square | 90×90 | |\n| `ellipse` | Ellipse | 140×64 | oval |\n| `circle` | Circle | 90×90 | |\n| `diamond` | Diamond | 140×64 | rhombus |\n| `triangle` | Triangle | 140×64 | |\n| `hexagon` | Hexagon | 140×64 | |\n| `pentagon` | Pentagon | 140×64 | |\n| `octagon` | Octagon | 140×64 | |\n| `parallelogram` | Parallelogram | 140×64 | |\n| `trapezoid` | Trapezoid | 140×64 | |\n| `cylinder` | Cylinder | 140×64 | can, tube |\n| `cloud-shape` | Cloud | 140×64 | |\n| `callout` | Callout | 140×64 | speech, bubble |\n| `text` | Text | 120×36 | |\n| `sticky` | Sticky note | 140×100 | postit, comment |\n| `card` | Card | 140×64 | |\n| `frame` | Frame / Container (container) | 220×160 | group, container, boundary |\n| `pool.horizontal` | Pool (horizontal) (swimlane) | 360×220 | swimlane, lane, container, subsystem |\n| `pool.vertical` | Pool (vertical) (swimlane) | 220×360 | swimlane, lane, container, subsystem |\n| `image` | Image | 140×64 | picture |\n\n## Flowchart (`flowchart`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `flow.process` | Process | 140×64 | step, action |\n| `flow.alt-process` | Alternate Process | 140×64 | |\n| `flow.decision` | Decision | 140×100 | if, branch |\n| `flow.terminator` | Start / End | 130×56 | terminator, begin, stop |\n| `flow.data` | Data (I/O) | 140×64 | input, output, io |\n| `flow.document` | Document | 140×64 | |\n| `flow.multi-document` | Multi-Document | 140×64 | |\n| `flow.predefined` | Predefined Process | 140×64 | subroutine |\n| `flow.manual-input` | Manual Input | 140×64 | |\n| `flow.manual-op` | Manual Operation | 140×64 | |\n| `flow.preparation` | Preparation | 140×64 | |\n| `flow.stored-data` | Stored Data | 140×64 | |\n| `flow.database` | Database | 140×64 | db, store |\n| `flow.display` | Display | 140×64 | |\n| `flow.delay` | Delay | 140×64 | |\n| `flow.merge` | Merge | 140×64 | |\n| `flow.or` | Or | 140×64 | |\n| `flow.connector` | On-page Connector | 48×48 | |\n| `flow.off-page` | Off-page Connector | 140×64 | |\n| `flow.annotation` | Annotation | 140×64 | |\n\n## UML (`uml`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `uml.class` | Class | 140×64 | entity |\n| `uml.abstract` | Abstract Class | 140×64 | |\n| `uml.interface` | Interface | 140×64 | |\n| `uml.enum` | Enum | 140×64 | |\n| `uml.object` | Object | 140×64 | |\n| `uml.package` | Package | 140×64 | |\n| `uml.component` | Component | 140×64 | |\n| `uml.node` | Node / Deployment | 140×64 | |\n| `uml.actor` | Actor | 60×100 | user, role |\n| `uml.usecase` | Use Case | 140×64 | |\n| `uml.boundary` | Boundary | 140×64 | |\n| `uml.control` | Control | 140×64 | |\n| `uml.entity` | Entity | 140×64 | |\n| `uml.state` | State | 140×64 | |\n| `uml.initial` | Initial State | 36×36 | |\n| `uml.final` | Final State | 40×40 | |\n| `uml.decision` | Decision | 60×60 | |\n| `uml.note` | Note / Comment | 140×64 | comment |\n\n## ERD (`erd`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `erd.entity` | Entity | 140×64 | table |\n| `erd.weak-entity` | Weak Entity | 140×64 | |\n| `erd.attribute` | Attribute | 140×64 | |\n| `erd.key-attribute` | Key Attribute | 140×64 | pk, primary key |\n| `erd.multivalued` | Multivalued Attribute | 140×64 | |\n| `erd.derived` | Derived Attribute | 140×64 | |\n| `erd.relationship` | Relationship | 140×64 | |\n| `erd.identifying` | Identifying Relationship | 140×64 | |\n\n## Architecture (`networking`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `net.user` | User / Client | 60×100 | client, person |\n| `net.admin` | Admin | 60×100 | |\n| `net.browser` | Browser | 140×64 | |\n| `net.mobile` | Mobile Device | 90×130 | phone |\n| `net.desktop` | Desktop | 140×64 | |\n| `net.iot` | IoT Device | 140×64 | |\n| `net.server` | Server | 140×64 | |\n| `net.service` | Service | 140×64 | microservice |\n| `net.monolith` | Monolith | 140×64 | |\n| `net.api-gateway` | API Gateway | 140×64 | api, gateway |\n| `net.load-balancer` | Load Balancer | 140×64 | lb |\n| `net.reverse-proxy` | Reverse Proxy | 140×64 | proxy |\n| `net.firewall` | Firewall | 140×64 | waf |\n| `net.router` | Router | 140×64 | |\n| `net.switch` | Switch | 140×64 | |\n| `net.dns` | DNS | 140×64 | |\n| `net.cdn` | CDN | 140×64 | edge |\n| `net.cache` | Cache | 140×64 | |\n| `net.queue` | Queue | 140×64 | mq |\n| `net.websocket` | Web Socket | 140×64 | ws |\n| `net.rest` | REST endpoint | 140×64 | http, api |\n| `net.internet` | Internet / Cloud | 140×64 | wan |\n| `net.datacenter` | Datacenter | 140×64 | |\n| `net.container` | Container | 140×64 | |\n| `net.pod` | Pod | 140×64 | |\n| `net.vm` | Virtual Machine | 140×64 | vm |\n\n## Databases (`database`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `db.postgres` | PostgreSQL | 176×56 | postgres, pg |\n| `db.mysql` | MySQL | 176×56 | |\n| `db.mariadb` | MariaDB | 176×56 | |\n| `db.mongodb` | MongoDB | 176×56 | mongo |\n| `db.redis` | Redis | 176×56 | |\n| `db.sqlite` | SQLite | 176×56 | |\n| `db.mssql` | MS SQL Server | 176×56 | sqlserver, mssql |\n| `db.oracle` | Oracle | 176×56 | |\n| `db.cassandra` | Cassandra | 176×56 | |\n| `db.elasticsearch` | Elasticsearch | 176×56 | elastic, es |\n| `db.neo4j` | Neo4j | 176×56 | graph |\n| `db.couchdb` | CouchDB | 176×56 | couch |\n| `db.couchbase` | Couchbase | 176×56 | |\n| `db.clickhouse` | ClickHouse | 176×56 | |\n| `db.cockroachdb` | CockroachDB | 176×56 | cockroach |\n| `db.influxdb` | InfluxDB | 176×56 | influx, tsdb |\n| `db.snowflake` | Snowflake | 176×56 | |\n| `db.supabase` | Supabase | 176×56 | |\n\n## Messaging (`messaging`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `mq.kafka` | Apache Kafka | 176×56 | kafka |\n| `mq.rabbitmq` | RabbitMQ | 176×56 | rabbit, amqp |\n| `mq.nats` | NATS | 176×56 | |\n| `mq.pulsar` | Apache Pulsar | 176×56 | pulsar |\n| `mq.mqtt` | MQTT | 176×56 | |\n| `mq.pubsub` | Pub/Sub | 176×56 | pubsub |\n| `mq.activemq` | ActiveMQ | 176×56 | jms |\n\n## Languages (`language`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `lang.node` | Node.js | 176×56 | node, js runtime |\n| `lang.python` | Python | 176×56 | py |\n| `lang.java` | Java | 176×56 | jvm |\n| `lang.go` | Go | 176×56 | golang |\n| `lang.rust` | Rust | 176×56 | |\n| `lang.dotnet` | C# / .NET | 176×56 | csharp, c# |\n| `lang.typescript` | TypeScript | 176×56 | ts |\n| `lang.javascript` | JavaScript | 176×56 | js |\n| `lang.ruby` | Ruby | 176×56 | |\n| `lang.php` | PHP | 176×56 | |\n| `lang.kotlin` | Kotlin | 176×56 | |\n| `lang.swift` | Swift | 176×56 | |\n| `lang.scala` | Scala | 176×56 | |\n| `lang.elixir` | Elixir | 176×56 | |\n| `lang.cpp` | C++ | 176×56 | cpp |\n\n## Frameworks (`framework`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `fw.express` | Express | 176×56 | |\n| `fw.nestjs` | NestJS | 176×56 | nest |\n| `fw.spring` | Spring Boot | 176×56 | spring |\n| `fw.django` | Django | 176×56 | |\n| `fw.flask` | Flask | 176×56 | |\n| `fw.fastapi` | FastAPI | 176×56 | |\n| `fw.rails` | Rails | 176×56 | ruby on rails |\n| `fw.laravel` | Laravel | 176×56 | |\n| `fw.dotnet` | .NET | 176×56 | |\n| `fw.react` | React | 176×56 | |\n| `fw.vue` | Vue | 176×56 | vuejs |\n| `fw.angular` | Angular | 176×56 | |\n| `fw.next` | Next.js | 176×56 | nextjs |\n| `fw.nuxt` | Nuxt | 176×56 | nuxtjs |\n| `fw.svelte` | Svelte | 176×56 | sveltekit |\n| `fw.electron` | Electron | 176×56 | |\n| `fw.tailwind` | Tailwind | 176×56 | tailwindcss |\n| `fw.graphql` | GraphQL | 176×56 | |\n\n## DevOps / CI-CD (`devops`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `ops.docker` | Docker | 176×56 | |\n| `ops.k8s` | Kubernetes | 176×56 | k8s |\n| `ops.nginx` | Nginx | 176×56 | |\n| `ops.haproxy` | HAProxy | 176×56 | lb |\n| `ops.traefik` | Traefik | 176×56 | traefik |\n| `ops.terraform` | Terraform | 176×56 | iac |\n| `ops.ansible` | Ansible | 176×56 | |\n| `ops.jenkins` | Jenkins | 176×56 | ci |\n| `ops.gha` | GitHub Actions | 176×56 | ci, actions |\n| `ops.gitlab` | GitLab CI | 176×56 | ci |\n| `ops.argocd` | ArgoCD | 176×56 | gitops |\n| `ops.helm` | Helm | 176×56 | |\n| `ops.istio` | Istio | 176×56 | service mesh |\n| `ops.envoy` | Envoy | 176×56 | proxy |\n| `ops.consul` | Consul | 176×56 | |\n| `ops.vault` | Vault | 176×56 | secrets |\n| `ops.pm2` | PM2 | 176×56 | |\n| `ops.maven` | Maven | 176×56 | build |\n\n## Auth / Identity (`auth`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `auth.oidc` | OpenID Connect | 176×56 | oidc |\n| `auth.jwt` | JWT | 176×56 | token |\n| `auth.keycloak` | Keycloak | 176×56 | |\n| `auth.auth0` | Auth0 | 176×56 | |\n| `auth.okta` | Okta | 176×56 | |\n| `auth.firebase` | Firebase Auth | 176×56 | firebase |\n| `auth.oauth` | OAuth 2.0 | 176×56 | oauth |\n| `auth.saml` | SAML | 176×56 | |\n| `auth.ldap` | LDAP | 176×56 | |\n\n## Observability (`observability`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `obs.prometheus` | Prometheus | 176×56 | metrics |\n| `obs.grafana` | Grafana | 176×56 | dashboard |\n| `obs.datadog` | Datadog | 176×56 | |\n| `obs.sentry` | Sentry | 176×56 | errors |\n| `obs.elasticsearch` | Elasticsearch | 176×56 | elk |\n| `obs.logstash` | Logstash | 176×56 | elk |\n| `obs.kibana` | Kibana | 176×56 | elk |\n| `obs.jaeger` | Jaeger | 176×56 | tracing |\n| `obs.otel` | OpenTelemetry | 176×56 | otel, tracing |\n| `obs.newrelic` | New Relic | 176×56 | |\n\n## AWS (`aws`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `aws.ec2` | EC2 | 176×56 | aws |\n| `aws.lambda` | Lambda | 176×56 | aws |\n| `aws.s3` | S3 | 176×56 | aws |\n| `aws.ebs` | EBS | 176×56 | aws |\n| `aws.efs` | EFS | 176×56 | aws |\n| `aws.rds` | RDS | 176×56 | aws |\n| `aws.aurora` | Aurora | 176×56 | aws |\n| `aws.dynamodb` | DynamoDB | 176×56 | aws |\n| `aws.elasticache` | ElastiCache | 176×56 | aws |\n| `aws.redshift` | Redshift | 176×56 | aws |\n| `aws.vpc` | VPC | 176×56 | aws |\n| `aws.subnet` | Subnet | 176×56 | aws |\n| `aws.internet-gateway` | Internet Gateway | 176×56 | aws |\n| `aws.nat-gateway` | NAT Gateway | 176×56 | aws |\n| `aws.elb` | ELB | 176×56 | aws |\n| `aws.alb` | ALB | 176×56 | aws |\n| `aws.nlb` | NLB | 176×56 | aws |\n| `aws.api-gateway` | API Gateway | 176×56 | aws |\n| `aws.cloudfront` | CloudFront | 176×56 | aws |\n| `aws.route-53` | Route 53 | 176×56 | aws |\n| `aws.sqs` | SQS | 176×56 | aws |\n| `aws.sns` | SNS | 176×56 | aws |\n| `aws.eventbridge` | EventBridge | 176×56 | aws |\n| `aws.kinesis` | Kinesis | 176×56 | aws |\n| `aws.step-functions` | Step Functions | 176×56 | aws |\n| `aws.ecs` | ECS | 176×56 | aws |\n| `aws.eks` | EKS | 176×56 | aws |\n| `aws.fargate` | Fargate | 176×56 | aws |\n| `aws.ecr` | ECR | 176×56 | aws |\n| `aws.iam` | IAM | 176×56 | aws |\n| `aws.cognito` | Cognito | 176×56 | aws |\n| `aws.secrets-manager` | Secrets Manager | 176×56 | aws |\n| `aws.kms` | KMS | 176×56 | aws |\n| `aws.cloudwatch` | CloudWatch | 176×56 | aws |\n| `aws.cloudtrail` | CloudTrail | 176×56 | aws |\n| `aws.glue` | Glue | 176×56 | aws |\n| `aws.athena` | Athena | 176×56 | aws |\n| `aws.sagemaker` | SageMaker | 176×56 | aws |\n| `aws.appsync` | AppSync | 176×56 | aws |\n| `aws.amplify` | Amplify | 176×56 | aws |\n\n## Azure (`azure`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `azure.virtual-machine` | Virtual Machine | 176×56 | azure |\n| `azure.vm-scale-set` | VM Scale Set | 176×56 | azure |\n| `azure.app-service` | App Service | 176×56 | azure |\n| `azure.functions` | Functions | 176×56 | azure |\n| `azure.container-instances` | Container Instances | 176×56 | azure |\n| `azure.aks` | AKS | 176×56 | azure |\n| `azure.container-registry` | Container Registry | 176×56 | azure |\n| `azure.blob-storage` | Blob Storage | 176×56 | azure |\n| `azure.files` | Files | 176×56 | azure |\n| `azure.disk` | Disk | 176×56 | azure |\n| `azure.sql-database` | SQL Database | 176×56 | azure |\n| `azure.cosmos-db` | Cosmos DB | 176×56 | azure |\n| `azure.cache-for-redis` | Cache for Redis | 176×56 | azure |\n| `azure.synapse` | Synapse | 176×56 | azure |\n| `azure.virtual-network` | Virtual Network | 176×56 | azure |\n| `azure.load-balancer` | Load Balancer | 176×56 | azure |\n| `azure.application-gateway` | Application Gateway | 176×56 | azure |\n| `azure.front-door` | Front Door | 176×56 | azure |\n| `azure.service-bus` | Service Bus | 176×56 | azure |\n| `azure.event-hub` | Event Hub | 176×56 | azure |\n| `azure.event-grid` | Event Grid | 176×56 | azure |\n| `azure.key-vault` | Key Vault | 176×56 | azure |\n| `azure.entra-id` | Entra ID | 176×56 | azure |\n| `azure.monitor` | Monitor | 176×56 | azure |\n| `azure.application-insights` | Application Insights | 176×56 | azure |\n| `azure.logic-apps` | Logic Apps | 176×56 | azure |\n| `azure.api-management` | API Management | 176×56 | azure |\n\n## GCP (`gcp`)\n\n| Type | Label | Default size | Aliases |\n| --- | --- | --- | --- |\n| `gcp.compute-engine` | Compute Engine | 176×56 | gcp, google |\n| `gcp.app-engine` | App Engine | 176×56 | gcp, google |\n| `gcp.cloud-functions` | Cloud Functions | 176×56 | gcp, google |\n| `gcp.cloud-run` | Cloud Run | 176×56 | gcp, google |\n| `gcp.gke` | GKE | 176×56 | gcp, google |\n| `gcp.artifact-registry` | Artifact Registry | 176×56 | gcp, google |\n| `gcp.cloud-storage` | Cloud Storage | 176×56 | gcp, google |\n| `gcp.persistent-disk` | Persistent Disk | 176×56 | gcp, google |\n| `gcp.cloud-sql` | Cloud SQL | 176×56 | gcp, google |\n| `gcp.cloud-spanner` | Cloud Spanner | 176×56 | gcp, google |\n| `gcp.firestore` | Firestore | 176×56 | gcp, google |\n| `gcp.bigtable` | Bigtable | 176×56 | gcp, google |\n| `gcp.bigquery` | BigQuery | 176×56 | gcp, google |\n| `gcp.memorystore` | Memorystore | 176×56 | gcp, google |\n| `gcp.vpc` | VPC | 176×56 | gcp, google |\n| `gcp.cloud-load-balancing` | Cloud Load Balancing | 176×56 | gcp, google |\n| `gcp.cloud-cdn` | Cloud CDN | 176×56 | gcp, google |\n| `gcp.cloud-dns` | Cloud DNS | 176×56 | gcp, google |\n| `gcp.pub-sub` | Pub/Sub | 176×56 | gcp, google |\n| `gcp.dataflow` | Dataflow | 176×56 | gcp, google |\n| `gcp.cloud-tasks` | Cloud Tasks | 176×56 | gcp, google |\n| `gcp.iam` | IAM | 176×56 | gcp, google |\n| `gcp.secret-manager` | Secret Manager | 176×56 | gcp, google |\n| `gcp.cloud-kms` | Cloud KMS | 176×56 | gcp, google |\n| `gcp.cloud-monitoring` | Cloud Monitoring | 176×56 | gcp, google |\n| `gcp.vertex-ai` | Vertex AI | 176×56 | gcp, google |\n",
@@ -1 +1 @@
1
- {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/tools/catalog.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;AAExK,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IAEjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,gBAAgB,EA4E1C,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,EAAE,EAAE,eAAe,OAAO,KAAG,gBAAgB,EAUhG,CAAC"}
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/tools/catalog.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;AAExK,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IAEjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,gBAAgB,EAiF1C,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,EAAE,EAAE,eAAe,OAAO,KAAG,gBAAgB,EAUhG,CAAC"}