@cubis/foundry 0.3.49 → 0.3.51
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.
- package/README.md +5 -0
- package/bin/cubis.js +470 -107
- package/mcp/Dockerfile +1 -0
- package/mcp/dist/index.js +277 -49
- package/mcp/src/index.ts +37 -15
- package/mcp/src/server.ts +17 -12
- package/mcp/src/telemetry/tokenBudget.ts +8 -2
- package/mcp/src/tools/skillBrowseCategory.ts +6 -1
- package/mcp/src/tools/skillBudgetReport.ts +18 -5
- package/mcp/src/tools/skillGet.ts +12 -0
- package/mcp/src/tools/skillListCategories.ts +4 -0
- package/mcp/src/tools/skillSearch.ts +6 -1
- package/mcp/src/transports/streamableHttp.ts +247 -4
- package/mcp/src/utils/logger.ts +5 -1
- package/mcp/src/vault/manifest.ts +22 -5
- package/mcp/src/vault/scanner.ts +16 -3
- package/package.json +1 -1
- package/workflows/skills/postman/SKILL.md +67 -4
- package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +10 -1
- package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +10 -1
- package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md +10 -1
- package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +10 -1
- package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/postman/SKILL.md +67 -4
- package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/postman/SKILL.md +67 -4
- package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/postman/SKILL.md +67 -4
|
@@ -100,6 +100,15 @@ Stop at the earliest step that gives enough signal. Do not jump ahead.
|
|
|
100
100
|
4. `skill_get <id>` — load full skill content; only when committed to using it
|
|
101
101
|
5. `skill_budget_report` — verify token cost after loading; triggers the compact ctx stamp
|
|
102
102
|
|
|
103
|
+
### Postman Intent Trigger (Required)
|
|
104
|
+
|
|
105
|
+
When user intent includes Postman workflows (for example: workspace, collection, environment, runCollection, monitor, mock, or "run Postman tests"):
|
|
106
|
+
|
|
107
|
+
1. Run `skill_search "postman"` first.
|
|
108
|
+
2. If `postman` skill exists, load `skill_get "postman"` before workflow/agent routing.
|
|
109
|
+
3. Prefer Postman MCP tools (`postman.*`) over Newman/CLI fallback unless the user explicitly asks for fallback.
|
|
110
|
+
4. If `--postman` was installed but `postman` skill cannot be found, report installation drift and suggest reinstall with `cbx workflows install ... --postman`.
|
|
111
|
+
|
|
103
112
|
**Hard rules:**
|
|
104
113
|
|
|
105
114
|
- Never call `skill_get` without a prior `skill_search` or `skill_browse_category`
|
|
@@ -264,7 +273,7 @@ The Foundry MCP server provides progressive-disclosure skill discovery and integ
|
|
|
264
273
|
### Skill Vault
|
|
265
274
|
|
|
266
275
|
- **123** skills across **22** categories
|
|
267
|
-
- Estimated full catalog: ~
|
|
276
|
+
- Estimated full catalog: ~109,067 tokens
|
|
268
277
|
|
|
269
278
|
Categories:
|
|
270
279
|
- `ai`: 1 skill(s)
|
|
@@ -98,6 +98,15 @@ Stop at the earliest step that gives enough signal. Do not jump ahead.
|
|
|
98
98
|
4. `skill_get <id>` — load full skill content; only when committed to using it
|
|
99
99
|
5. `skill_budget_report` — verify token cost after loading; triggers the compact ctx stamp
|
|
100
100
|
|
|
101
|
+
### Postman Intent Trigger (Required)
|
|
102
|
+
|
|
103
|
+
When user intent includes Postman workflows (for example: workspace, collection, environment, runCollection, monitor, mock, or "run Postman tests"):
|
|
104
|
+
|
|
105
|
+
1. Run `skill_search "postman"` first.
|
|
106
|
+
2. If `postman` skill exists, load `skill_get "postman"` before workflow/agent routing.
|
|
107
|
+
3. Prefer Postman MCP tools (`postman.*`) over Newman/CLI fallback unless the user explicitly asks for fallback.
|
|
108
|
+
4. If `--postman` was installed but `postman` skill cannot be found, report installation drift and suggest reinstall with `cbx workflows install ... --postman`.
|
|
109
|
+
|
|
101
110
|
**Hard rules:**
|
|
102
111
|
|
|
103
112
|
- Never call `skill_get` without a prior `skill_search` or `skill_browse_category`
|
|
@@ -257,7 +266,7 @@ The Foundry MCP server provides progressive-disclosure skill discovery and integ
|
|
|
257
266
|
### Skill Vault
|
|
258
267
|
|
|
259
268
|
- **123** skills across **22** categories
|
|
260
|
-
- Estimated full catalog: ~
|
|
269
|
+
- Estimated full catalog: ~109,067 tokens
|
|
261
270
|
|
|
262
271
|
Categories:
|
|
263
272
|
- `ai`: 1 skill(s)
|
|
@@ -104,6 +104,15 @@ Stop at the earliest step that gives enough signal. Do not jump ahead.
|
|
|
104
104
|
4. `skill_get <id>` — load full skill content; only when committed to using it
|
|
105
105
|
5. `skill_budget_report` — verify token cost after loading; triggers the compact ctx stamp
|
|
106
106
|
|
|
107
|
+
### Postman Intent Trigger (Required)
|
|
108
|
+
|
|
109
|
+
When user intent includes Postman workflows (for example: workspace, collection, environment, runCollection, monitor, mock, or "run Postman tests"):
|
|
110
|
+
|
|
111
|
+
1. Run `skill_search "postman"` first.
|
|
112
|
+
2. If `postman` skill exists, load `skill_get "postman"` before workflow/agent routing.
|
|
113
|
+
3. Prefer Postman MCP tools (`postman.*`) over Newman/CLI fallback unless the user explicitly asks for fallback.
|
|
114
|
+
4. If `--postman` was installed but `postman` skill cannot be found, report installation drift and suggest reinstall with `cbx workflows install ... --postman`.
|
|
115
|
+
|
|
107
116
|
**Hard rules:**
|
|
108
117
|
|
|
109
118
|
- Never call `skill_get` without a prior `skill_search` or `skill_browse_category`
|
|
@@ -263,7 +272,7 @@ The Foundry MCP server provides progressive-disclosure skill discovery and integ
|
|
|
263
272
|
### Skill Vault
|
|
264
273
|
|
|
265
274
|
- **123** skills across **22** categories
|
|
266
|
-
- Estimated full catalog: ~
|
|
275
|
+
- Estimated full catalog: ~109,067 tokens
|
|
267
276
|
|
|
268
277
|
Categories:
|
|
269
278
|
- `ai`: 1 skill(s)
|
package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md
CHANGED
|
@@ -104,6 +104,15 @@ Stop at the earliest step that gives enough signal. Do not jump ahead.
|
|
|
104
104
|
4. `skill_get <id>` — load full skill content; only when committed to using it
|
|
105
105
|
5. `skill_budget_report` — verify token cost after loading; triggers the compact ctx stamp
|
|
106
106
|
|
|
107
|
+
### Postman Intent Trigger (Required)
|
|
108
|
+
|
|
109
|
+
When user intent includes Postman workflows (for example: workspace, collection, environment, runCollection, monitor, mock, or "run Postman tests"):
|
|
110
|
+
|
|
111
|
+
1. Run `skill_search "postman"` first.
|
|
112
|
+
2. If `postman` skill exists, load `skill_get "postman"` before workflow/agent routing.
|
|
113
|
+
3. Prefer Postman MCP tools (`postman.*`) over Newman/CLI fallback unless the user explicitly asks for fallback.
|
|
114
|
+
4. If `--postman` was installed but `postman` skill cannot be found, report installation drift and suggest reinstall with `cbx workflows install ... --postman`.
|
|
115
|
+
|
|
107
116
|
**Hard rules:**
|
|
108
117
|
|
|
109
118
|
- Never call `skill_get` without a prior `skill_search` or `skill_browse_category`
|
|
@@ -263,7 +272,7 @@ The Foundry MCP server provides progressive-disclosure skill discovery and integ
|
|
|
263
272
|
### Skill Vault
|
|
264
273
|
|
|
265
274
|
- **123** skills across **22** categories
|
|
266
|
-
- Estimated full catalog: ~
|
|
275
|
+
- Estimated full catalog: ~109,067 tokens
|
|
267
276
|
|
|
268
277
|
Categories:
|
|
269
278
|
- `ai`: 1 skill(s)
|
package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/postman/SKILL.md
CHANGED
|
@@ -1,17 +1,80 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: postman
|
|
3
|
-
description:
|
|
3
|
+
description: Use Postman MCP tools for workspace, collection, environment, and run workflows with explicit default-workspace handling.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Postman MCP
|
|
7
7
|
|
|
8
8
|
Use this skill when you need to work with Postman through MCP tools.
|
|
9
9
|
|
|
10
|
+
## MCP-First Rule
|
|
11
|
+
|
|
12
|
+
- Prefer Postman MCP tools (`postman.*`) for all Postman operations.
|
|
13
|
+
- Do not use Newman/Postman CLI fallback unless the user explicitly asks for fallback.
|
|
14
|
+
- If required Postman MCP tools are unavailable, stop and report the MCP discovery issue with remediation steps.
|
|
15
|
+
|
|
10
16
|
## Required Environment Variables
|
|
11
17
|
|
|
12
|
-
-
|
|
18
|
+
- Active profile key alias must be set (typically `POSTMAN_API_KEY_DEFAULT`).
|
|
19
|
+
- `POSTMAN_API_KEY_<PROFILE>` aliases are also valid if the active profile uses them.
|
|
20
|
+
|
|
21
|
+
## Preflight Checklist
|
|
22
|
+
|
|
23
|
+
1. Read Postman status first:
|
|
24
|
+
- Call `postman_get_status` (`scope: auto` unless user requires a scope).
|
|
25
|
+
2. Validate connectivity and mode:
|
|
26
|
+
- If not configured, report missing env alias/config and stop.
|
|
27
|
+
- If mode is not `full`, call `postman_set_mode` with `mode: full`.
|
|
28
|
+
3. Discover upstream tools:
|
|
29
|
+
- Prefer `postman.getEnabledTools` when available.
|
|
30
|
+
- Confirm required tool names before proceeding (for example `getWorkspaces`, `getCollections`, `runCollection`).
|
|
31
|
+
|
|
32
|
+
## Default Workspace ID Policy
|
|
33
|
+
|
|
34
|
+
Resolve workspace in this order:
|
|
35
|
+
|
|
36
|
+
1. User-provided workspace ID.
|
|
37
|
+
2. `postman_get_status.defaultWorkspaceId`.
|
|
38
|
+
3. Auto-detect from `postman.getWorkspaces`:
|
|
39
|
+
- If exactly one workspace exists, use it and state that choice.
|
|
40
|
+
4. If multiple workspaces and no default:
|
|
41
|
+
- Ask user to choose one.
|
|
42
|
+
- Recommend persisting it with:
|
|
43
|
+
- `cbx workflows config --scope global --workspace-id <workspace-id>`
|
|
44
|
+
|
|
45
|
+
When a Postman tool requires a workspace argument, always pass the resolved workspace ID explicitly.
|
|
46
|
+
|
|
47
|
+
## Common Workflows
|
|
48
|
+
|
|
49
|
+
### List/Inspect
|
|
50
|
+
|
|
51
|
+
- `postman.getWorkspaces`
|
|
52
|
+
- `postman.getCollections` (with resolved workspace ID)
|
|
53
|
+
- `postman.getEnvironments` (with resolved workspace ID)
|
|
54
|
+
|
|
55
|
+
### Collection Run
|
|
56
|
+
|
|
57
|
+
1. Resolve workspace ID (policy above).
|
|
58
|
+
2. Resolve `collectionId` and optional `environmentId`.
|
|
59
|
+
3. Call `postman.runCollection`.
|
|
60
|
+
4. Return a concise run summary:
|
|
61
|
+
- total requests
|
|
62
|
+
- passed/failed tests
|
|
63
|
+
- failing request/test names
|
|
64
|
+
- proposed fix path for failures
|
|
65
|
+
|
|
66
|
+
## Failure Handling
|
|
67
|
+
|
|
68
|
+
If dynamic Postman tools are missing (only `postman_get_*` / `postman_set_mode` visible):
|
|
69
|
+
|
|
70
|
+
1. Verify env alias expected by config is set.
|
|
71
|
+
2. Resync catalog:
|
|
72
|
+
- `cbx mcp tools sync --service postman --scope global`
|
|
73
|
+
- `cbx mcp tools list --service postman --scope global`
|
|
74
|
+
3. Recreate runtime if needed:
|
|
75
|
+
- `cbx mcp runtime up --scope global --name cbx-mcp --replace --port 3310 --skills-root ~/.agents/skills`
|
|
13
76
|
|
|
14
|
-
## Notes
|
|
77
|
+
## Security Notes
|
|
15
78
|
|
|
16
79
|
- Use environment variables for secrets. Do not inline API keys.
|
|
17
|
-
-
|
|
80
|
+
- Never print or persist raw key values in logs, docs, or responses.
|
package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/postman/SKILL.md
CHANGED
|
@@ -1,17 +1,80 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: postman
|
|
3
|
-
description:
|
|
3
|
+
description: Use Postman MCP tools for workspace, collection, environment, and run workflows with explicit default-workspace handling.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Postman MCP
|
|
7
7
|
|
|
8
8
|
Use this skill when you need to work with Postman through MCP tools.
|
|
9
9
|
|
|
10
|
+
## MCP-First Rule
|
|
11
|
+
|
|
12
|
+
- Prefer Postman MCP tools (`postman.*`) for all Postman operations.
|
|
13
|
+
- Do not use Newman/Postman CLI fallback unless the user explicitly asks for fallback.
|
|
14
|
+
- If required Postman MCP tools are unavailable, stop and report the MCP discovery issue with remediation steps.
|
|
15
|
+
|
|
10
16
|
## Required Environment Variables
|
|
11
17
|
|
|
12
|
-
-
|
|
18
|
+
- Active profile key alias must be set (typically `POSTMAN_API_KEY_DEFAULT`).
|
|
19
|
+
- `POSTMAN_API_KEY_<PROFILE>` aliases are also valid if the active profile uses them.
|
|
20
|
+
|
|
21
|
+
## Preflight Checklist
|
|
22
|
+
|
|
23
|
+
1. Read Postman status first:
|
|
24
|
+
- Call `postman_get_status` (`scope: auto` unless user requires a scope).
|
|
25
|
+
2. Validate connectivity and mode:
|
|
26
|
+
- If not configured, report missing env alias/config and stop.
|
|
27
|
+
- If mode is not `full`, call `postman_set_mode` with `mode: full`.
|
|
28
|
+
3. Discover upstream tools:
|
|
29
|
+
- Prefer `postman.getEnabledTools` when available.
|
|
30
|
+
- Confirm required tool names before proceeding (for example `getWorkspaces`, `getCollections`, `runCollection`).
|
|
31
|
+
|
|
32
|
+
## Default Workspace ID Policy
|
|
33
|
+
|
|
34
|
+
Resolve workspace in this order:
|
|
35
|
+
|
|
36
|
+
1. User-provided workspace ID.
|
|
37
|
+
2. `postman_get_status.defaultWorkspaceId`.
|
|
38
|
+
3. Auto-detect from `postman.getWorkspaces`:
|
|
39
|
+
- If exactly one workspace exists, use it and state that choice.
|
|
40
|
+
4. If multiple workspaces and no default:
|
|
41
|
+
- Ask user to choose one.
|
|
42
|
+
- Recommend persisting it with:
|
|
43
|
+
- `cbx workflows config --scope global --workspace-id <workspace-id>`
|
|
44
|
+
|
|
45
|
+
When a Postman tool requires a workspace argument, always pass the resolved workspace ID explicitly.
|
|
46
|
+
|
|
47
|
+
## Common Workflows
|
|
48
|
+
|
|
49
|
+
### List/Inspect
|
|
50
|
+
|
|
51
|
+
- `postman.getWorkspaces`
|
|
52
|
+
- `postman.getCollections` (with resolved workspace ID)
|
|
53
|
+
- `postman.getEnvironments` (with resolved workspace ID)
|
|
54
|
+
|
|
55
|
+
### Collection Run
|
|
56
|
+
|
|
57
|
+
1. Resolve workspace ID (policy above).
|
|
58
|
+
2. Resolve `collectionId` and optional `environmentId`.
|
|
59
|
+
3. Call `postman.runCollection`.
|
|
60
|
+
4. Return a concise run summary:
|
|
61
|
+
- total requests
|
|
62
|
+
- passed/failed tests
|
|
63
|
+
- failing request/test names
|
|
64
|
+
- proposed fix path for failures
|
|
65
|
+
|
|
66
|
+
## Failure Handling
|
|
67
|
+
|
|
68
|
+
If dynamic Postman tools are missing (only `postman_get_*` / `postman_set_mode` visible):
|
|
69
|
+
|
|
70
|
+
1. Verify env alias expected by config is set.
|
|
71
|
+
2. Resync catalog:
|
|
72
|
+
- `cbx mcp tools sync --service postman --scope global`
|
|
73
|
+
- `cbx mcp tools list --service postman --scope global`
|
|
74
|
+
3. Recreate runtime if needed:
|
|
75
|
+
- `cbx mcp runtime up --scope global --name cbx-mcp --replace --port 3310 --skills-root ~/.agents/skills`
|
|
13
76
|
|
|
14
|
-
## Notes
|
|
77
|
+
## Security Notes
|
|
15
78
|
|
|
16
79
|
- Use environment variables for secrets. Do not inline API keys.
|
|
17
|
-
-
|
|
80
|
+
- Never print or persist raw key values in logs, docs, or responses.
|
package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/postman/SKILL.md
CHANGED
|
@@ -1,17 +1,80 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: postman
|
|
3
|
-
description:
|
|
3
|
+
description: Use Postman MCP tools for workspace, collection, environment, and run workflows with explicit default-workspace handling.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Postman MCP
|
|
7
7
|
|
|
8
8
|
Use this skill when you need to work with Postman through MCP tools.
|
|
9
9
|
|
|
10
|
+
## MCP-First Rule
|
|
11
|
+
|
|
12
|
+
- Prefer Postman MCP tools (`postman.*`) for all Postman operations.
|
|
13
|
+
- Do not use Newman/Postman CLI fallback unless the user explicitly asks for fallback.
|
|
14
|
+
- If required Postman MCP tools are unavailable, stop and report the MCP discovery issue with remediation steps.
|
|
15
|
+
|
|
10
16
|
## Required Environment Variables
|
|
11
17
|
|
|
12
|
-
-
|
|
18
|
+
- Active profile key alias must be set (typically `POSTMAN_API_KEY_DEFAULT`).
|
|
19
|
+
- `POSTMAN_API_KEY_<PROFILE>` aliases are also valid if the active profile uses them.
|
|
20
|
+
|
|
21
|
+
## Preflight Checklist
|
|
22
|
+
|
|
23
|
+
1. Read Postman status first:
|
|
24
|
+
- Call `postman_get_status` (`scope: auto` unless user requires a scope).
|
|
25
|
+
2. Validate connectivity and mode:
|
|
26
|
+
- If not configured, report missing env alias/config and stop.
|
|
27
|
+
- If mode is not `full`, call `postman_set_mode` with `mode: full`.
|
|
28
|
+
3. Discover upstream tools:
|
|
29
|
+
- Prefer `postman.getEnabledTools` when available.
|
|
30
|
+
- Confirm required tool names before proceeding (for example `getWorkspaces`, `getCollections`, `runCollection`).
|
|
31
|
+
|
|
32
|
+
## Default Workspace ID Policy
|
|
33
|
+
|
|
34
|
+
Resolve workspace in this order:
|
|
35
|
+
|
|
36
|
+
1. User-provided workspace ID.
|
|
37
|
+
2. `postman_get_status.defaultWorkspaceId`.
|
|
38
|
+
3. Auto-detect from `postman.getWorkspaces`:
|
|
39
|
+
- If exactly one workspace exists, use it and state that choice.
|
|
40
|
+
4. If multiple workspaces and no default:
|
|
41
|
+
- Ask user to choose one.
|
|
42
|
+
- Recommend persisting it with:
|
|
43
|
+
- `cbx workflows config --scope global --workspace-id <workspace-id>`
|
|
44
|
+
|
|
45
|
+
When a Postman tool requires a workspace argument, always pass the resolved workspace ID explicitly.
|
|
46
|
+
|
|
47
|
+
## Common Workflows
|
|
48
|
+
|
|
49
|
+
### List/Inspect
|
|
50
|
+
|
|
51
|
+
- `postman.getWorkspaces`
|
|
52
|
+
- `postman.getCollections` (with resolved workspace ID)
|
|
53
|
+
- `postman.getEnvironments` (with resolved workspace ID)
|
|
54
|
+
|
|
55
|
+
### Collection Run
|
|
56
|
+
|
|
57
|
+
1. Resolve workspace ID (policy above).
|
|
58
|
+
2. Resolve `collectionId` and optional `environmentId`.
|
|
59
|
+
3. Call `postman.runCollection`.
|
|
60
|
+
4. Return a concise run summary:
|
|
61
|
+
- total requests
|
|
62
|
+
- passed/failed tests
|
|
63
|
+
- failing request/test names
|
|
64
|
+
- proposed fix path for failures
|
|
65
|
+
|
|
66
|
+
## Failure Handling
|
|
67
|
+
|
|
68
|
+
If dynamic Postman tools are missing (only `postman_get_*` / `postman_set_mode` visible):
|
|
69
|
+
|
|
70
|
+
1. Verify env alias expected by config is set.
|
|
71
|
+
2. Resync catalog:
|
|
72
|
+
- `cbx mcp tools sync --service postman --scope global`
|
|
73
|
+
- `cbx mcp tools list --service postman --scope global`
|
|
74
|
+
3. Recreate runtime if needed:
|
|
75
|
+
- `cbx mcp runtime up --scope global --name cbx-mcp --replace --port 3310 --skills-root ~/.agents/skills`
|
|
13
76
|
|
|
14
|
-
## Notes
|
|
77
|
+
## Security Notes
|
|
15
78
|
|
|
16
79
|
- Use environment variables for secrets. Do not inline API keys.
|
|
17
|
-
-
|
|
80
|
+
- Never print or persist raw key values in logs, docs, or responses.
|