@exaudeus/workrail 0.0.9 → 0.0.11

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 (30) hide show
  1. package/dist/application/app.js +1 -1
  2. package/dist/application/app.js.map +1 -1
  3. package/dist/application/services/enhanced-error-service.d.ts +81 -0
  4. package/dist/application/services/enhanced-error-service.d.ts.map +1 -0
  5. package/dist/application/services/enhanced-error-service.js +215 -0
  6. package/dist/application/services/enhanced-error-service.js.map +1 -0
  7. package/dist/application/use-cases/get-workflow.d.ts +17 -2
  8. package/dist/application/use-cases/get-workflow.d.ts.map +1 -1
  9. package/dist/application/use-cases/get-workflow.js +46 -3
  10. package/dist/application/use-cases/get-workflow.js.map +1 -1
  11. package/dist/application/use-cases/validate-workflow-json.d.ts.map +1 -1
  12. package/dist/application/use-cases/validate-workflow-json.js +2 -43
  13. package/dist/application/use-cases/validate-workflow-json.js.map +1 -1
  14. package/dist/application/validation.d.ts.map +1 -1
  15. package/dist/application/validation.js +2 -1
  16. package/dist/application/validation.js.map +1 -1
  17. package/dist/mcp-server.js +103 -10
  18. package/dist/mcp-server.js.map +1 -1
  19. package/dist/types/session-types.d.ts +354 -0
  20. package/dist/types/session-types.d.ts.map +1 -0
  21. package/dist/types/session-types.js +89 -0
  22. package/dist/types/session-types.js.map +1 -0
  23. package/dist/validation/response-validator.d.ts.map +1 -1
  24. package/dist/validation/response-validator.js +22 -2
  25. package/dist/validation/response-validator.js.map +1 -1
  26. package/dist/validation/schemas.d.ts.map +1 -1
  27. package/dist/validation/schemas.js +7 -1
  28. package/dist/validation/schemas.js.map +1 -1
  29. package/package.json +1 -1
  30. package/spec/mcp-api-v1.0.md +41 -20
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-types.js","sourceRoot":"","sources":["../../src/types/session-types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;;;AA8bhF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGnB;IACA;IACA;IAJlB,YACE,OAAe,EACC,IAAsB,EACtB,SAAkB,EAClB,OAA6B;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAkB;QACtB,cAAS,GAAT,SAAS,CAAS;QAClB,YAAO,GAAP,OAAO,CAAsB;QAG7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAVD,oCAUC;AAED,IAAY,gBAUX;AAVD,WAAY,gBAAgB;IAC1B,2DAAuC,CAAA;IACvC,uDAAmC,CAAA;IACnC,6DAAyC,CAAA;IACzC,qEAAiD,CAAA;IACjD,qDAAiC,CAAA;IACjC,mDAA+B,CAAA;IAC/B,yDAAqC,CAAA;IACrC,6DAAyC,CAAA;IACzC,qDAAiC,CAAA;AACnC,CAAC,EAVW,gBAAgB,gCAAhB,gBAAgB,QAU3B;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,sBAAsB,GAAkB;IACnD,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU;IACzC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IACzC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAC9C,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IAC9C,eAAe,EAAE,IAAI;IACrB,QAAQ,EAAE;QACR,eAAe,EAAE,EAAE;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;QACnC,eAAe,EAAE,IAAI;KACtB;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,sBAAsB,GAAyB;IAC1D,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU;IACzC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IACzC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAC9C,oBAAoB,EAAE;QACpB,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,GAAG;KACd;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,GAAG;QACV,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,GAAG;KACV;IACD,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEF;;GAEG;AACU,QAAA,qBAAqB,GAAiB;IACjD,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,OAAO;CACpB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"response-validator.d.ts","sourceRoot":"","sources":["../../src/validation/response-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAyCpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA2B1D,CAAC;AAKF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAI/C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;CAShD;AAED,eAAO,MAAM,iBAAiB,mBAA6C,CAAC"}
1
+ {"version":3,"file":"response-validator.d.ts","sourceRoot":"","sources":["../../src/validation/response-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAgEpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA2B1D,CAAC;AAKF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAI/C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;CAShD;AAED,eAAO,MAAM,iBAAiB,mBAA6C,CAAC"}
@@ -34,6 +34,26 @@ const workflowSchema = zod_1.z.object({
34
34
  steps: zod_1.z.array(workflowStepSchema),
35
35
  metaGuidance: zod_1.z.array(zod_1.z.string()).optional()
36
36
  });
37
+ // Mode parameter response schemas
38
+ const workflowMetadataSchema = zod_1.z.object({
39
+ id: zod_1.z.string().regex(idRegex),
40
+ name: zod_1.z.string(),
41
+ description: zod_1.z.string(),
42
+ version: zod_1.z.string(),
43
+ preconditions: zod_1.z.array(zod_1.z.string()).optional(),
44
+ clarificationPrompts: zod_1.z.array(zod_1.z.string()).optional(),
45
+ metaGuidance: zod_1.z.array(zod_1.z.string()).optional(),
46
+ totalSteps: zod_1.z.number()
47
+ });
48
+ const workflowPreviewSchema = workflowMetadataSchema.extend({
49
+ firstStep: workflowStepSchema.nullable()
50
+ });
51
+ // Union schema for workflow_get that handles all three response types
52
+ const workflowGetResponseSchema = zod_1.z.union([
53
+ workflowSchema, // Full workflow (for undefined mode or backward compatibility)
54
+ workflowMetadataSchema, // Metadata mode response
55
+ workflowPreviewSchema // Preview mode response
56
+ ]);
37
57
  // ---------------------------------------------------------------------------
38
58
  // Method result schemas
39
59
  // ---------------------------------------------------------------------------
@@ -42,8 +62,8 @@ exports.methodResultSchemas = {
42
62
  workflow_list: zod_1.z.object({
43
63
  workflows: zod_1.z.array(workflowSummarySchema)
44
64
  }),
45
- // workflow_get → Workflow object
46
- workflow_get: workflowSchema,
65
+ // workflow_get → Workflow | WorkflowMetadata | WorkflowPreview (union based on mode parameter)
66
+ workflow_get: workflowGetResponseSchema,
47
67
  // workflow_next → { step, guidance, isComplete }
48
68
  workflow_next: zod_1.z.object({
49
69
  step: workflowStepSchema.nullable(),
@@ -1 +1 @@
1
- {"version":3,"file":"response-validator.js","sourceRoot":"","sources":["../../src/validation/response-validator.ts"],"names":[],"mappings":";;;AAAA,6BAAoC;AACpC,yDAAwD;AAExD,MAAM,OAAO,GAAG,kBAAkB,CAAC;AAEnC,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAC9E,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,mBAAmB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,oBAAoB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAClC,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AACjE,QAAA,mBAAmB,GAA+B;IAC7D,mDAAmD;IACnD,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;QACtB,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;KAC1C,CAAC;IAEF,iCAAiC;IACjC,YAAY,EAAE,cAAc;IAE5B,iDAAiD;IACjD,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACjB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;YAClB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,oBAAoB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC5C,kBAAkB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACnD,CAAC;QACF,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE;KACxB,CAAC;IAEF,uDAAuD;IACvD,iBAAiB,EAAE,OAAC,CAAC,MAAM,CAAC;QAC1B,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE;QAClB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACtC,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KAC5C,CAAC;CACH,CAAC;AAEF,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAC9E,MAAa,iBAAiB;IACX,QAAQ,CAA6B;IAEtD,YAAY,OAAmC;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,MAAc,EAAE,MAAe;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,mCAAmC;QAExD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,+BAAe,CAAC,kBAAkB,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF;AAhBD,8CAgBC;AAEY,QAAA,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,2BAAmB,CAAC,CAAC"}
1
+ {"version":3,"file":"response-validator.js","sourceRoot":"","sources":["../../src/validation/response-validator.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CA2ClD,CAAC"}
1
+ {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAiDlD,CAAC"}
@@ -14,7 +14,13 @@ exports.methodParamSchemas = {
14
14
  workflow_get: {
15
15
  type: 'object',
16
16
  properties: {
17
- id: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' }
17
+ id: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' },
18
+ mode: {
19
+ type: 'string',
20
+ enum: ['metadata', 'preview'],
21
+ description: 'The level of detail to return: metadata (workflow info only) or preview (metadata + first step)',
22
+ default: 'preview'
23
+ }
18
24
  },
19
25
  required: ['id'],
20
26
  additionalProperties: false
@@ -1 +1 @@
1
- {"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,kBAAkB,GAAwB;IACrD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;SACpD;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAC3D,cAAc,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;gBACtD,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;aACZ;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;gBACxE,oBAAoB,EAAE,IAAI;aAC3B;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,oBAAoB,EAAE,KAAK;KAC5B;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;SAC7C;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC5C,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
1
+ {"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,kBAAkB,GAAwB;IACrD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YACnD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;gBAC7B,WAAW,EAAE,iGAAiG;gBAC9G,OAAO,EAAE,SAAS;aACnB;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAC3D,cAAc,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;gBACtD,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;aACZ;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;gBACxE,oBAAoB,EAAE,IAAI;aAC3B;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,oBAAoB,EAAE,KAAK;KAC5B;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;SAC7C;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC5C,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@exaudeus/workrail",
3
- "version": "0.0.9",
3
+ "version": "0.0.11",
4
4
  "description": "MCP server for structured workflow orchestration and step-by-step task guidance",
5
5
  "license": "MIT",
6
6
  "bin": {
@@ -144,7 +144,7 @@ Lists all available workflows.
144
144
 
145
145
  ### workflow_get
146
146
 
147
- Retrieves a specific workflow by ID.
147
+ Retrieves workflow information with configurable detail level. Supports progressive disclosure to prevent "workflow spoiling" while providing necessary context for workflow selection and initiation.
148
148
 
149
149
  #### Request
150
150
 
@@ -154,7 +154,8 @@ Retrieves a specific workflow by ID.
154
154
  "id": 2,
155
155
  "method": "workflow_get",
156
156
  "params": {
157
- "id": "string"
157
+ "id": "string",
158
+ "mode": "preview"
158
159
  }
159
160
  }
160
161
  ```
@@ -162,35 +163,55 @@ Retrieves a specific workflow by ID.
162
163
  #### Parameters
163
164
 
164
165
  - `id` (required): The workflow ID to retrieve
166
+ - `mode` (optional): The level of detail to return
167
+ - `"metadata"`: Returns workflow info without steps
168
+ - `"preview"`: Returns metadata plus the first eligible step (default)
165
169
 
166
- #### Response
170
+ #### Response Examples
167
171
 
172
+ **Preview Mode (default):**
168
173
  ```json
169
174
  {
170
175
  "jsonrpc": "2.0",
171
176
  "id": 2,
172
177
  "result": {
173
- "id": "string",
174
- "name": "string",
175
- "description": "string",
176
- "preconditions": ["string"],
177
- "clarificationPrompts": ["string"],
178
- "steps": [
179
- {
180
- "id": "string",
181
- "title": "string",
182
- "prompt": "string",
183
- "askForFiles": boolean,
184
- "requireConfirmation": boolean,
185
- "runCondition": object
186
- }
187
- ],
188
- "metaGuidance": ["string"]
178
+ "id": "coding-task-workflow",
179
+ "name": "Excellent Adaptive Coding Workflow",
180
+ "description": "A comprehensive workflow for AI-assisted coding",
181
+ "version": "0.1.0",
182
+ "preconditions": ["User has a clear task description"],
183
+ "clarificationPrompts": ["What is the complexity level?"],
184
+ "metaGuidance": ["Follow PREP -> IMPLEMENT -> VERIFY pattern"],
185
+ "totalSteps": 8,
186
+ "firstStep": {
187
+ "id": "phase-0-intelligent-triage",
188
+ "title": "Phase 0: Intelligent Task Triage & Complexity Analysis",
189
+ "prompt": "**ANALYZE**: Evaluate the provided task for complexity indicators...",
190
+ "agentRole": "You are a technical assessment specialist...",
191
+ "guidance": ["Be thorough in your analysis"],
192
+ "requireConfirmation": true
193
+ }
189
194
  }
190
195
  }
191
196
  ```
192
197
 
193
- The returned workflow object must validate against the `workflow.schema.json` specification.
198
+ **Metadata Mode:**
199
+ ```json
200
+ {
201
+ "jsonrpc": "2.0",
202
+ "id": 2,
203
+ "result": {
204
+ "id": "coding-task-workflow",
205
+ "name": "Excellent Adaptive Coding Workflow",
206
+ "description": "A comprehensive workflow for AI-assisted coding",
207
+ "version": "0.1.0",
208
+ "preconditions": ["User has a clear task description"],
209
+ "clarificationPrompts": ["What is the complexity level?"],
210
+ "metaGuidance": ["Follow PREP -> IMPLEMENT -> VERIFY pattern"],
211
+ "totalSteps": 8
212
+ }
213
+ }
214
+ ```
194
215
 
195
216
  #### Error Cases
196
217