@sensigo/realm-mcp 0.15.0 → 0.17.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.
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/server.js +1 -1
- package/dist/tools/get-run-state.d.ts +41 -3
- package/dist/tools/get-run-state.d.ts.map +1 -1
- package/dist/tools/get-run-state.js +45 -1
- package/dist/tools/get-run-state.js.map +1 -1
- package/dist/tools/start-run-batch.d.ts.map +1 -1
- package/dist/tools/start-run-batch.js +13 -8
- package/dist/tools/start-run-batch.js.map +1 -1
- package/dist/tools/start-run.d.ts.map +1 -1
- package/dist/tools/start-run.js +6 -2
- package/dist/tools/start-run.js.map +1 -1
- package/package.json +2 -2
package/dist/index.d.ts
CHANGED
|
@@ -2,5 +2,5 @@ export { createRealmMcpServer, createDefaultRegistry } from './server.js';
|
|
|
2
2
|
export type { RealmMcpServerOptions } from './server.js';
|
|
3
3
|
export { generateProtocol } from './protocol/generator.js';
|
|
4
4
|
export type { WorkflowProtocol, ProtocolStep } from './protocol/generator.js';
|
|
5
|
-
export declare const VERSION = "0.
|
|
5
|
+
export declare const VERSION = "0.17.0";
|
|
6
6
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// @sensigo/realm-mcp — MCP server for AI agent connections
|
|
2
2
|
export { createRealmMcpServer, createDefaultRegistry } from './server.js';
|
|
3
3
|
export { generateProtocol } from './protocol/generator.js';
|
|
4
|
-
export const VERSION = '0.
|
|
4
|
+
export const VERSION = '0.17.0';
|
|
5
5
|
//# sourceMappingURL=index.js.map
|
package/dist/server.js
CHANGED
|
@@ -42,7 +42,7 @@ export { createDefaultRegistry };
|
|
|
42
42
|
export function createRealmMcpServer(options) {
|
|
43
43
|
const server = new McpServer({
|
|
44
44
|
name: 'realm',
|
|
45
|
-
version: '0.
|
|
45
|
+
version: '0.17.0',
|
|
46
46
|
});
|
|
47
47
|
// When no registry is provided, use the default registry that pre-registers built-in
|
|
48
48
|
// adapters. When a registry is provided, the caller is responsible for its contents.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
-
import { JsonFileStore, JsonWorkflowStore, type RunPhase, type NextAction } from '@sensigo/realm';
|
|
2
|
+
import { JsonFileStore, JsonWorkflowStore, type RunPhase, type NextAction, type ClaimState } from '@sensigo/realm';
|
|
3
3
|
export interface HandleRunStateStores {
|
|
4
4
|
runStore?: JsonFileStore;
|
|
5
5
|
/**
|
|
@@ -18,8 +18,16 @@ export interface HandleRunStateStores {
|
|
|
18
18
|
* - `awaiting_human` — a human gate is open.
|
|
19
19
|
* - `workflow_unresolved` — no workflow store provided, or the workflow is not registered.
|
|
20
20
|
* - `skipped_terminal` — the run is terminal; nothing to do.
|
|
21
|
+
* - `claim_stale` — a non-terminal run has an in-progress claim past its deadline (a likely-dead
|
|
22
|
+
* runner / the after-claim wedge, issue #101). Surfaced even when a healthy sibling is in flight.
|
|
23
|
+
* - `claim_unknown_age` — a non-terminal run's only in-progress claims have no deadline (agent /
|
|
24
|
+
* finalizer-bearing / legacy) and there is nothing else to do — detect-only, human-judged.
|
|
25
|
+
* - `blocked_on_capability` — a non-terminal run has a step parked by a not-registered handler/adapter
|
|
26
|
+
* (issue #134): the step settled recoverably and is eligible again, awaiting a runner that provides
|
|
27
|
+
* the missing capability. Computed definition-free, so it also refines the `workflow_unresolved` path.
|
|
28
|
+
* Outranks `claim_stale` (a more specific, actionable diagnosis); ranks below `awaiting_human`.
|
|
21
29
|
*/
|
|
22
|
-
export type NextActionsStatus = 'ok' | 'auto_pending' | 'awaiting_human' | 'workflow_unresolved' | 'skipped_terminal';
|
|
30
|
+
export type NextActionsStatus = 'ok' | 'auto_pending' | 'awaiting_human' | 'workflow_unresolved' | 'skipped_terminal' | 'claim_stale' | 'claim_unknown_age' | 'blocked_on_capability';
|
|
23
31
|
export interface RunStateSummary {
|
|
24
32
|
run_id: string;
|
|
25
33
|
workflow_id: string;
|
|
@@ -44,10 +52,40 @@ export interface RunStateSummary {
|
|
|
44
52
|
}>;
|
|
45
53
|
abort_message?: string;
|
|
46
54
|
};
|
|
47
|
-
/**
|
|
55
|
+
/**
|
|
56
|
+
* Eligible agent/handler steps for this run. Empty unless `next_actions_status` is `'ok'` —
|
|
57
|
+
* except a `claim_stale` status may accompany still-actionable steps when a dead claim coexists
|
|
58
|
+
* with eligible work mid-fan-out (the dead claim overrides the status but does not hide the work).
|
|
59
|
+
*/
|
|
48
60
|
next_actions: NextAction[];
|
|
49
61
|
/** Diagnostic classification — distinguishes a genuinely-stuck run from "nothing pending". */
|
|
50
62
|
next_actions_status: NextActionsStatus;
|
|
63
|
+
/**
|
|
64
|
+
* Advisory (issue #101): non-healthy in-progress claims that are NOT the open-gate step —
|
|
65
|
+
* present on any non-terminal run whenever such claims exist. This surfaces an after-claim wedge
|
|
66
|
+
* even when the aggregate `next_actions_status` cannot show it: notably a `gate_waiting` run
|
|
67
|
+
* (status stays `awaiting_human`) that carries a crashed sibling claim on another fan-out branch.
|
|
68
|
+
* The `pending_gate` step is never included (it is legitimately pinned while its gate is open).
|
|
69
|
+
*/
|
|
70
|
+
stuck_claims?: Array<{
|
|
71
|
+
step: string;
|
|
72
|
+
state: ClaimState;
|
|
73
|
+
}>;
|
|
74
|
+
/**
|
|
75
|
+
* Advisory (issue #134): steps parked by a not-registered handler/adapter that are still eligible —
|
|
76
|
+
* present on any non-terminal run whenever such markers exist. Definition-free (via
|
|
77
|
+
* `findCapabilityBlockedSteps`), so it surfaces even on the `workflow_unresolved` path and behind a
|
|
78
|
+
* healthy in-progress sibling. May coexist with `stuck_claims` on a fan-out run. Names the missing
|
|
79
|
+
* requirement so an operator (or a pure-MCP consumer, via `execute_step` on the named step) can recover.
|
|
80
|
+
*/
|
|
81
|
+
capability_blocks?: Array<{
|
|
82
|
+
step: string;
|
|
83
|
+
requirement: {
|
|
84
|
+
kind: 'handler' | 'adapter';
|
|
85
|
+
name: string;
|
|
86
|
+
};
|
|
87
|
+
code: string;
|
|
88
|
+
}>;
|
|
51
89
|
}
|
|
52
90
|
/**
|
|
53
91
|
* Business logic for the get_run_state tool.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-run-state.d.ts","sourceRoot":"","sources":["../../src/tools/get-run-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACL,aAAa,EACb,iBAAiB,
|
|
1
|
+
{"version":3,"file":"get-run-state.d.ts","sourceRoot":"","sources":["../../src/tools/get-run-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACL,aAAa,EACb,iBAAiB,EAOjB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,kBAAkB,GAClB,aAAa,GACb,mBAAmB,GACnB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,gBAAgB,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACpF,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF;;;;OAIG;IACH,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,8FAA8F;IAC9F,mBAAmB,EAAE,iBAAiB,CAAC;IACvC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAC1D;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE;YAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3D,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACxB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAqG1B;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAuCxF"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// get-run-state tool — returns the current state summary of a run.
|
|
2
2
|
import { z } from 'zod';
|
|
3
|
-
import { JsonFileStore, WorkflowError, resolvePreExecutionAgentAction, buildNextActions, findEligibleSteps, } from '@sensigo/realm';
|
|
3
|
+
import { JsonFileStore, WorkflowError, resolvePreExecutionAgentAction, buildNextActions, findEligibleSteps, classifyInProgressClaims, findCapabilityBlockedSteps, } from '@sensigo/realm';
|
|
4
4
|
import { sseJsonStringify } from '../sse-json.js';
|
|
5
5
|
/**
|
|
6
6
|
* Business logic for the get_run_state tool.
|
|
@@ -9,6 +9,10 @@ import { sseJsonStringify } from '../sse-json.js';
|
|
|
9
9
|
export async function handleGetRunState(args, stores) {
|
|
10
10
|
const runStore = stores?.runStore ?? new JsonFileStore();
|
|
11
11
|
const run = await runStore.get(args.run_id);
|
|
12
|
+
// #134 capability-block detection — definition-free (reads capability_blocks + the four step sets),
|
|
13
|
+
// computed once and used both to refine the status (below) and as the advisory array (in the return).
|
|
14
|
+
// Terminal guard mirrors stuck_claims: a sealed run surfaces nothing to do.
|
|
15
|
+
const capabilityBlocks = run.terminal_state ? [] : findCapabilityBlockedSteps(run);
|
|
12
16
|
// Compute next_actions + diagnostic status (read-only). Precedence:
|
|
13
17
|
// terminal → skipped_terminal; gate open → awaiting_human; no/unresolved workflow →
|
|
14
18
|
// workflow_unresolved; else buildNextActions/findEligibleSteps → ok | auto_pending.
|
|
@@ -42,7 +46,37 @@ export async function handleGetRunState(args, stores) {
|
|
|
42
46
|
nextActionsStatus = 'ok';
|
|
43
47
|
}
|
|
44
48
|
}
|
|
49
|
+
// Wedge detection (issue #101) — definition-free (reads the stored per-claim deadline), so it
|
|
50
|
+
// also refines the `workflow_unresolved` path. Carves the wedge states OUT of the
|
|
51
|
+
// 'ok'/'auto_pending'/'workflow_unresolved' fall-through:
|
|
52
|
+
// - a `claim_stale` claim (past deadline → likely-dead runner) is surfaced even mid-fan-out;
|
|
53
|
+
// - when only unknown-age claims remain and there is nothing else to do, surface
|
|
54
|
+
// `claim_unknown_age` (detect-only). A `healthy` in-flight claim (a live runner) stays 'ok'.
|
|
55
|
+
if (run.in_progress_steps.length > 0) {
|
|
56
|
+
const claimStates = classifyInProgressClaims(run).map((c) => c.state);
|
|
57
|
+
if (claimStates.includes('claim_stale')) {
|
|
58
|
+
nextActionsStatus = 'claim_stale';
|
|
59
|
+
}
|
|
60
|
+
else if (nextActions.length === 0 && !claimStates.includes('healthy')) {
|
|
61
|
+
nextActionsStatus = 'claim_unknown_age';
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
// #134 capability block outranks the claim-wedge states (a missing capability is a more specific,
|
|
65
|
+
// actionable diagnosis than a stale/unknown-age claim) but ranks below `awaiting_human` — the gate
|
|
66
|
+
// path returns above without entering this else block, so it wins naturally.
|
|
67
|
+
if (capabilityBlocks.length > 0) {
|
|
68
|
+
nextActionsStatus = 'blocked_on_capability';
|
|
69
|
+
}
|
|
45
70
|
}
|
|
71
|
+
// Advisory wedge surfacing (issue #101), computed UNIFORMLY for every non-terminal path (gate,
|
|
72
|
+
// workflow_unresolved, running) — definition-free. It never alters next_actions_status: on the
|
|
73
|
+
// gate path the status MUST stay `awaiting_human` (drivers key on it), but a crashed non-gated
|
|
74
|
+
// sibling claim on another fan-out branch is still surfaced here. The open-gate step is excluded.
|
|
75
|
+
const stuckClaims = run.terminal_state
|
|
76
|
+
? []
|
|
77
|
+
: classifyInProgressClaims(run)
|
|
78
|
+
.filter((c) => c.state !== 'healthy' && c.step !== run.pending_gate?.step_name)
|
|
79
|
+
.map((c) => ({ step: c.step, state: c.state }));
|
|
46
80
|
return {
|
|
47
81
|
run_id: run.id,
|
|
48
82
|
workflow_id: run.workflow_id,
|
|
@@ -61,6 +95,16 @@ export async function handleGetRunState(args, stores) {
|
|
|
61
95
|
...(run.aborted_at !== undefined ? { abort_context: run.aborted_at } : {}),
|
|
62
96
|
next_actions: nextActions,
|
|
63
97
|
next_actions_status: nextActionsStatus,
|
|
98
|
+
...(stuckClaims.length > 0 ? { stuck_claims: stuckClaims } : {}),
|
|
99
|
+
...(capabilityBlocks.length > 0
|
|
100
|
+
? {
|
|
101
|
+
capability_blocks: capabilityBlocks.map((b) => ({
|
|
102
|
+
step: b.step,
|
|
103
|
+
requirement: b.requirement,
|
|
104
|
+
code: b.code,
|
|
105
|
+
})),
|
|
106
|
+
}
|
|
107
|
+
: {}),
|
|
64
108
|
};
|
|
65
109
|
}
|
|
66
110
|
/** Registers the get_run_state MCP tool on the server. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-run-state.js","sourceRoot":"","sources":["../../src/tools/get-run-state.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,aAAa,EAEb,aAAa,EACb,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,
|
|
1
|
+
{"version":3,"file":"get-run-state.js","sourceRoot":"","sources":["../../src/tools/get-run-state.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"start-run-batch.d.ts","sourceRoot":"","sources":["../../src/tools/start-run-batch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,
|
|
1
|
+
{"version":3,"file":"start-run-batch.d.ts","sourceRoot":"","sources":["../../src/tools/start-run-batch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAWL,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQtD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,gGAAgG;QAChG,OAAO,EAAE,OAAO,CAAC;QACjB,8FAA8F;QAC9F,SAAS,EAAE,QAAQ,CAAC;QACpB,+CAA+C;QAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,4GAA4G;QAC5G,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH;;;;OAIG;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IACxF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;IACjF,aAAa,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;CACrD,EACD,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAoI9B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAgErF"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// start-run-batch tool — atomically enqueues multiple runs of the same workflow.
|
|
2
2
|
import { z } from 'zod';
|
|
3
|
-
import { JsonWorkflowStore, JsonFileStore, WorkflowError, buildPreExecutionErrorEnvelope, validateInputSchema, hashParams, } from '@sensigo/realm';
|
|
3
|
+
import { JsonWorkflowStore, JsonFileStore, WorkflowError, buildPreExecutionErrorEnvelope, validateInputSchema, hashParams, unmetCapabilities, capabilityWarning, createDefaultRegistry, } from '@sensigo/realm';
|
|
4
4
|
import { sseJsonStringify } from '../sse-json.js';
|
|
5
5
|
/** Lightweight structured telemetry. stderr is safe under the MCP stdio/SSE transport. */
|
|
6
6
|
function logBatchDedup(fields) {
|
|
@@ -20,12 +20,17 @@ export async function handleStartRunBatch(args, stores) {
|
|
|
20
20
|
});
|
|
21
21
|
}
|
|
22
22
|
const definition = await workflowStore.get(args.workflow_id);
|
|
23
|
-
//
|
|
24
|
-
//
|
|
25
|
-
//
|
|
26
|
-
|
|
27
|
-
await stores.registryProvider(definition)
|
|
28
|
-
|
|
23
|
+
// Resolved BEFORE any runStore.create — a throwing registryProvider (broken project extensions) must
|
|
24
|
+
// fail the batch with NO runs created (fail-fast gate). Provider wins over the construction-time
|
|
25
|
+
// registry. Captured (not just awaited) so the #134 pre-flight can inspect the same effective registry.
|
|
26
|
+
const registry = stores?.registryProvider !== undefined
|
|
27
|
+
? await stores.registryProvider(definition)
|
|
28
|
+
: stores?.registry;
|
|
29
|
+
// #134 pre-flight (WARN-only, never refuse): capability gaps are workflow-invariant, so compute ONCE
|
|
30
|
+
// and attach to every item. Caveated — a batch item may ultimately be driven by a DIFFERENT runner
|
|
31
|
+
// than the one whose registry we see at creation time. The `?? createDefaultRegistry()` fallback is the
|
|
32
|
+
// HARD invariant that stops a filesystem-only workflow from false-warning when no registry is supplied.
|
|
33
|
+
const capabilityWarnings = unmetCapabilities(definition, registry ?? createDefaultRegistry()).map((req) => `${capabilityWarning(req)} (Based on the creation-time registry; the driving runner may differ.)`);
|
|
29
34
|
if (definition.params_schema !== undefined) {
|
|
30
35
|
const failures = [];
|
|
31
36
|
for (let i = 0; i < args.items.length; i++) {
|
|
@@ -84,7 +89,7 @@ export async function handleStartRunBatch(args, stores) {
|
|
|
84
89
|
const deduped = !created;
|
|
85
90
|
if (deduped)
|
|
86
91
|
dedupHits++;
|
|
87
|
-
const warnings = [];
|
|
92
|
+
const warnings = [...capabilityWarnings];
|
|
88
93
|
if (deduped) {
|
|
89
94
|
if (run.run_phase === 'running' || run.run_phase === 'gate_waiting') {
|
|
90
95
|
warnings.push(`Idempotency key matched a run still in phase '${run.run_phase}'.`);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"start-run-batch.js","sourceRoot":"","sources":["../../src/tools/start-run-batch.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,8BAA8B,EAC9B,mBAAmB,EACnB,UAAU,
|
|
1
|
+
{"version":3,"file":"start-run-batch.js","sourceRoot":"","sources":["../../src/tools/start-run-batch.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"start-run.d.ts","sourceRoot":"","sources":["../../src/tools/start-run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,aAAa,
|
|
1
|
+
{"version":3,"file":"start-run.d.ts","sourceRoot":"","sources":["../../src/tools/start-run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,aAAa,EAWb,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAQxB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CACjB,UAAU,EAAE,OAAO,gBAAgB,EAAE,kBAAkB,KACpD,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAKD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;IACjF,aAAa,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;CACrD,EACD,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA2FlD;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAwDhF"}
|
package/dist/tools/start-run.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// start-run tool — creates a new run and chains through initial auto steps.
|
|
2
2
|
import { z } from 'zod';
|
|
3
|
-
import { JsonWorkflowStore, JsonFileStore, executeChain, buildNextActions, findEligibleSteps, hashParams, WorkflowError, buildPreExecutionErrorEnvelope, } from '@sensigo/realm';
|
|
3
|
+
import { JsonWorkflowStore, JsonFileStore, executeChain, buildNextActions, findEligibleSteps, hashParams, WorkflowError, buildPreExecutionErrorEnvelope, unmetCapabilities, capabilityWarning, createDefaultRegistry, } from '@sensigo/realm';
|
|
4
4
|
import { sseJsonStringify } from '../sse-json.js';
|
|
5
5
|
/** Lightweight structured telemetry. stderr is safe under the MCP stdio/SSE transport. */
|
|
6
6
|
function logDedup(fields) {
|
|
@@ -32,7 +32,11 @@ export async function handleStartRun(args, stores) {
|
|
|
32
32
|
});
|
|
33
33
|
// The store reports `created`; the tool surfaces its inverse, `deduped`.
|
|
34
34
|
const deduped = !created;
|
|
35
|
-
|
|
35
|
+
// #134 pre-flight (WARN-only, never refuse): if the effective registry can't satisfy the workflow's
|
|
36
|
+
// auto-step handlers/adapters, warn so the operator can provision before a step blocks recoverably.
|
|
37
|
+
// The `?? createDefaultRegistry()` fallback is a HARD invariant — it mirrors the dispatch sites, so a
|
|
38
|
+
// filesystem-only workflow with no supplied registry does not false-warn.
|
|
39
|
+
const warnings = unmetCapabilities(definition, registry ?? createDefaultRegistry()).map(capabilityWarning);
|
|
36
40
|
if (deduped) {
|
|
37
41
|
// Observational only — a legitimate same-caller retry also hits an active run.
|
|
38
42
|
if (run.run_phase === 'running' || run.run_phase === 'gate_waiting') {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"start-run.js","sourceRoot":"","sources":["../../src/tools/start-run.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,8BAA8B,
|
|
1
|
+
{"version":3,"file":"start-run.js","sourceRoot":"","sources":["../../src/tools/start-run.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sensigo/realm-mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.0",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
},
|
|
47
47
|
"dependencies": {
|
|
48
48
|
"@modelcontextprotocol/sdk": "1.29.0",
|
|
49
|
-
"@sensigo/realm": "^0.
|
|
49
|
+
"@sensigo/realm": "^0.17.0",
|
|
50
50
|
"zod": "^3.25.7"
|
|
51
51
|
},
|
|
52
52
|
"devDependencies": {
|