@flow-engineer/flow 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/LICENSE +202 -21
  2. package/README.md +190 -17
  3. package/coding-agents/auth-skill.md +137 -0
  4. package/coding-agents/context-skill.md +94 -0
  5. package/coding-agents/skill.md +245 -11
  6. package/coding-agents/test-skill.md +13 -11
  7. package/coding-agents/tools-skill.md +78 -1
  8. package/dist/cli/src/auth.d.ts +11 -0
  9. package/dist/cli/src/auth.js +147 -0
  10. package/dist/cli/src/commands.d.ts +119 -0
  11. package/dist/cli/src/commands.js +212 -0
  12. package/dist/cli/src/index.d.ts +2 -0
  13. package/dist/cli/src/index.js +5 -0
  14. package/dist/cli/src/run.d.ts +28 -0
  15. package/dist/cli/src/run.js +523 -0
  16. package/dist/cli/src/terminal.d.ts +3 -0
  17. package/dist/cli/src/terminal.js +135 -0
  18. package/dist/flow-messaging/src/client.d.ts +7 -1
  19. package/dist/flow-messaging/src/client.js +13 -1
  20. package/dist/flow-messaging/src/index.d.ts +38 -3
  21. package/dist/flow-messaging/src/index.js +242 -40
  22. package/dist/mcp/src/client.d.ts +54 -0
  23. package/dist/mcp/src/client.js +175 -0
  24. package/dist/mcp/src/describe.d.ts +41 -0
  25. package/dist/mcp/src/describe.js +110 -0
  26. package/dist/mcp/src/index.d.ts +4 -0
  27. package/dist/mcp/src/index.js +7 -0
  28. package/dist/mcp/src/server.d.ts +70 -0
  29. package/dist/mcp/src/server.js +252 -0
  30. package/dist/mcp/src/terminal.d.ts +24 -0
  31. package/dist/mcp/src/terminal.js +54 -0
  32. package/dist/simulators/src/index.d.ts +1 -1
  33. package/dist/simulators/src/page.html +267 -49
  34. package/dist/simulators/src/server.d.ts +27 -0
  35. package/dist/simulators/src/server.js +264 -40
  36. package/dist/src/agent.d.ts +69 -3
  37. package/dist/src/agent.js +162 -8
  38. package/dist/src/channels.d.ts +2 -0
  39. package/dist/src/conversation.d.ts +16 -1
  40. package/dist/src/conversation.js +140 -12
  41. package/dist/src/events.d.ts +1 -1
  42. package/dist/src/index.d.ts +2 -2
  43. package/dist/src/index.js +1 -1
  44. package/dist/src/model.d.ts +27 -0
  45. package/dist/src/model.js +85 -13
  46. package/dist/src/names.d.ts +5 -0
  47. package/dist/src/names.js +5 -0
  48. package/dist/src/skills.d.ts +4 -0
  49. package/dist/src/skills.js +23 -0
  50. package/dist/src/store.d.ts +2 -0
  51. package/dist/src/store.js +18 -0
  52. package/dist/src/tools.d.ts +69 -0
  53. package/dist/src/tools.js +17 -1
  54. package/dist/src/traces.js +32 -4
  55. package/dist/src/types.d.ts +2 -0
  56. package/dist/testing/src/account.d.ts +4 -0
  57. package/dist/testing/src/account.js +891 -0
  58. package/dist/testing/src/chat.d.ts +3 -0
  59. package/dist/testing/src/chat.js +125 -0
  60. package/dist/testing/src/check.d.ts +4 -0
  61. package/dist/testing/src/check.js +90 -0
  62. package/dist/testing/src/chinwag.js +1 -1
  63. package/dist/testing/src/cli.js +105 -18
  64. package/dist/testing/src/client.d.ts +2 -0
  65. package/dist/testing/src/client.js +4 -3
  66. package/dist/testing/src/flow-login.d.ts +176 -0
  67. package/dist/testing/src/flow-login.js +274 -0
  68. package/dist/testing/src/new.d.ts +15 -2
  69. package/dist/testing/src/new.js +80 -21
  70. package/dist/testing/src/plugin.d.ts +4 -0
  71. package/dist/testing/src/plugin.js +116 -0
  72. package/docs/agents.md +160 -0
  73. package/examples/cafe/src/agent.ts +6 -2
  74. package/examples/cafe/src/channels.ts +20 -0
  75. package/examples/cafe/src/cli.ts +24 -0
  76. package/examples/cafe/src/main.ts +17 -3
  77. package/examples/cafe/src/mcp.ts +22 -0
  78. package/examples/cafe/src/tools.ts +13 -0
  79. package/flow-messaging/README.md +66 -27
  80. package/package.json +30 -2
  81. package/spec/agent-endpoint.openapi.yaml +2 -2
  82. package/spec/nudges.openapi.yaml +2 -2
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@flow-engineer/flow",
3
- "version": "0.2.0",
3
+ "version": "0.2.2",
4
4
  "description": "An open-source runtime for chat agents that feel like a person texting back.",
5
- "license": "MIT",
5
+ "license": "Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
8
8
  "url": "git+https://github.com/flow-engineer/flow.git"
@@ -29,6 +29,14 @@
29
29
  "types": "./dist/testing/src/index.d.ts",
30
30
  "default": "./dist/testing/src/index.js"
31
31
  },
32
+ "./mcp": {
33
+ "types": "./dist/mcp/src/index.d.ts",
34
+ "default": "./dist/mcp/src/index.js"
35
+ },
36
+ "./cli": {
37
+ "types": "./dist/cli/src/index.d.ts",
38
+ "default": "./dist/cli/src/index.js"
39
+ },
32
40
  "./package.json": "./package.json"
33
41
  },
34
42
  "bin": {
@@ -42,6 +50,7 @@
42
50
  "examples/cafe/tests",
43
51
  "examples/http-agent",
44
52
  "flow-messaging/README.md",
53
+ "docs/agents.md",
45
54
  "coding-agents",
46
55
  "spec",
47
56
  "README.md",
@@ -60,7 +69,26 @@
60
69
  "yaml": "^2.9.1",
61
70
  "zod": "^4.6.5"
62
71
  },
72
+ "peerDependencies": {
73
+ "@modelcontextprotocol/client": "2.3.1",
74
+ "@modelcontextprotocol/server": "2.3.1",
75
+ "@stricli/core": "1.3.0"
76
+ },
77
+ "peerDependenciesMeta": {
78
+ "@modelcontextprotocol/client": {
79
+ "optional": true
80
+ },
81
+ "@modelcontextprotocol/server": {
82
+ "optional": true
83
+ },
84
+ "@stricli/core": {
85
+ "optional": true
86
+ }
87
+ },
63
88
  "devDependencies": {
89
+ "@modelcontextprotocol/client": "2.3.1",
90
+ "@modelcontextprotocol/server": "2.3.1",
91
+ "@stricli/core": "1.3.0",
64
92
  "@types/node": "^26.6.5",
65
93
  "typescript": "^7.0.2"
66
94
  }
package/spec/agent-endpoint.openapi.yaml CHANGED
@@ -3,8 +3,8 @@ info:
3
3
  title: Flow Framework agent endpoint
4
4
  version: 0.1.0
5
5
  license:
6
- name: MIT
7
- identifier: MIT
6
+ name: Apache-2.0
7
+ identifier: Apache-2.0
8
8
  description: |
9
9
  The HTTP endpoint an agent on any framework, in any language, exposes so Flow Framework's test suite
10
10
  can talk to it: `flow test --agent-url <url>`. Implement this one operation and the test
package/spec/nudges.openapi.yaml CHANGED
@@ -3,8 +3,8 @@ info:
3
3
  title: Flow Framework nudges over HTTP
4
4
  version: 0.1.0
5
5
  license:
6
- name: MIT
7
- identifier: MIT
6
+ name: Apache-2.0
7
+ identifier: Apache-2.0
8
8
  description: |
9
9
  The endpoint `nudgeHandler(agent, { token, base })` serves in the agent's own server, so a
10
10
  backend that is a separate service can send nudges (messages the business starts) without a