@stigmer/mcp-server 3.2.3 → 3.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.
- package/README.md +60 -13
- package/cli/mcp-server-stigmer.js +13 -9
- package/config.d.ts +12 -0
- package/config.d.ts.map +1 -1
- package/config.js +5 -0
- package/config.js.map +1 -1
- package/domains/agentexecutions/approve.d.ts +9 -0
- package/domains/agentexecutions/approve.d.ts.map +1 -0
- package/domains/agentexecutions/approve.js +46 -0
- package/domains/agentexecutions/approve.js.map +1 -0
- package/domains/agentexecutions/fetch.d.ts +28 -0
- package/domains/agentexecutions/fetch.d.ts.map +1 -0
- package/domains/agentexecutions/fetch.js +82 -0
- package/domains/agentexecutions/fetch.js.map +1 -0
- package/domains/agentexecutions/run.d.ts +27 -0
- package/domains/agentexecutions/run.d.ts.map +1 -0
- package/domains/agentexecutions/run.js +87 -0
- package/domains/agentexecutions/run.js.map +1 -0
- package/domains/agentexecutions/tools.d.ts +5 -0
- package/domains/agentexecutions/tools.d.ts.map +1 -0
- package/domains/agentexecutions/tools.js +97 -0
- package/domains/agentexecutions/tools.js.map +1 -0
- package/domains/datastores/apply.d.ts +4 -0
- package/domains/datastores/apply.d.ts.map +1 -0
- package/domains/datastores/apply.js +28 -0
- package/domains/datastores/apply.js.map +1 -0
- package/domains/datastores/delete.d.ts +3 -0
- package/domains/datastores/delete.d.ts.map +1 -0
- package/domains/datastores/delete.js +38 -0
- package/domains/datastores/delete.js.map +1 -0
- package/domains/datastores/fetch.d.ts +3 -0
- package/domains/datastores/fetch.d.ts.map +1 -0
- package/domains/datastores/fetch.js +23 -0
- package/domains/datastores/fetch.js.map +1 -0
- package/domains/datastores/resources.d.ts +5 -0
- package/domains/datastores/resources.d.ts.map +1 -0
- package/domains/datastores/resources.js +16 -0
- package/domains/datastores/resources.js.map +1 -0
- package/domains/datastores/tools.d.ts +5 -0
- package/domains/datastores/tools.d.ts.map +1 -0
- package/domains/datastores/tools.js +46 -0
- package/domains/datastores/tools.js.map +1 -0
- package/domains/environments/apply.d.ts +4 -0
- package/domains/environments/apply.d.ts.map +1 -0
- package/domains/environments/apply.js +30 -0
- package/domains/environments/apply.js.map +1 -0
- package/domains/environments/delete.d.ts +3 -0
- package/domains/environments/delete.d.ts.map +1 -0
- package/domains/environments/delete.js +36 -0
- package/domains/environments/delete.js.map +1 -0
- package/domains/environments/fetch.d.ts +6 -0
- package/domains/environments/fetch.d.ts.map +1 -0
- package/domains/environments/fetch.js +30 -0
- package/domains/environments/fetch.js.map +1 -0
- package/domains/environments/resources.d.ts +5 -0
- package/domains/environments/resources.d.ts.map +1 -0
- package/domains/environments/resources.js +16 -0
- package/domains/environments/resources.js.map +1 -0
- package/domains/environments/tools.d.ts +5 -0
- package/domains/environments/tools.d.ts.map +1 -0
- package/domains/environments/tools.js +51 -0
- package/domains/environments/tools.js.map +1 -0
- package/domains/executions/cancel.d.ts +9 -0
- package/domains/executions/cancel.d.ts.map +1 -0
- package/domains/executions/cancel.js +114 -0
- package/domains/executions/cancel.js.map +1 -0
- package/domains/executions/tools.d.ts +5 -0
- package/domains/executions/tools.d.ts.map +1 -0
- package/domains/executions/tools.js +28 -0
- package/domains/executions/tools.js.map +1 -0
- package/domains/records/calls.d.ts +48 -0
- package/domains/records/calls.d.ts.map +1 -0
- package/domains/records/calls.js +118 -0
- package/domains/records/calls.js.map +1 -0
- package/domains/records/errors.d.ts +24 -0
- package/domains/records/errors.d.ts.map +1 -0
- package/domains/records/errors.js +79 -0
- package/domains/records/errors.js.map +1 -0
- package/domains/records/tools.d.ts +7 -0
- package/domains/records/tools.d.ts.map +1 -0
- package/domains/records/tools.js +139 -0
- package/domains/records/tools.js.map +1 -0
- package/domains/resourceuri.d.ts.map +1 -1
- package/domains/resourceuri.js +2 -0
- package/domains/resourceuri.js.map +1 -1
- package/domains/search/tools.d.ts.map +1 -1
- package/domains/search/tools.js +10 -7
- package/domains/search/tools.js.map +1 -1
- package/domains/skills/tools.d.ts.map +1 -1
- package/domains/skills/tools.js +25 -1
- package/domains/skills/tools.js.map +1 -1
- package/domains/skills/versions.d.ts +9 -0
- package/domains/skills/versions.d.ts.map +1 -0
- package/domains/skills/versions.js +31 -0
- package/domains/skills/versions.js.map +1 -0
- package/domains/workflowexecutions/approvals.d.ts +17 -0
- package/domains/workflowexecutions/approvals.d.ts.map +1 -0
- package/domains/workflowexecutions/approvals.js +61 -0
- package/domains/workflowexecutions/approvals.js.map +1 -0
- package/domains/workflowexecutions/run.d.ts +12 -0
- package/domains/workflowexecutions/run.d.ts.map +1 -0
- package/domains/workflowexecutions/run.js +69 -0
- package/domains/workflowexecutions/run.js.map +1 -0
- package/domains/workflowexecutions/tools.d.ts.map +1 -1
- package/domains/workflowexecutions/tools.js +89 -6
- package/domains/workflowexecutions/tools.js.map +1 -1
- package/domains/workflows/tools.d.ts.map +1 -1
- package/domains/workflows/tools.js +69 -5
- package/domains/workflows/tools.js.map +1 -1
- package/domains/workflows/versions.d.ts +29 -0
- package/domains/workflows/versions.d.ts.map +1 -0
- package/domains/workflows/versions.js +99 -0
- package/domains/workflows/versions.js.map +1 -0
- package/gen/agent.d.ts +56 -0
- package/gen/agent.d.ts.map +1 -1
- package/gen/agent.js +24 -1
- package/gen/agent.js.map +1 -1
- package/gen/datastore.d.ts +861 -0
- package/gen/datastore.d.ts.map +1 -0
- package/gen/datastore.js +267 -0
- package/gen/datastore.js.map +1 -0
- package/gen/environment.d.ts +77 -0
- package/gen/environment.d.ts.map +1 -0
- package/gen/environment.js +62 -0
- package/gen/environment.js.map +1 -0
- package/gen/workflow.d.ts +4 -4
- package/index.d.ts +2 -2
- package/index.d.ts.map +1 -1
- package/index.js +4 -4
- package/index.js.map +1 -1
- package/package.json +3 -3
- package/server.d.ts +31 -1
- package/server.d.ts.map +1 -1
- package/server.js +53 -3
- package/server.js.map +1 -1
- package/src/config.ts +19 -0
- package/src/domains/agentexecutions/approve.ts +67 -0
- package/src/domains/agentexecutions/fetch.ts +112 -0
- package/src/domains/agentexecutions/run.ts +112 -0
- package/src/domains/agentexecutions/tools.ts +139 -0
- package/src/domains/apply.integration.test.ts +82 -6
- package/src/domains/datastores/apply.ts +33 -0
- package/src/domains/datastores/delete.ts +47 -0
- package/src/domains/datastores/fetch.ts +32 -0
- package/src/domains/datastores/resources.ts +21 -0
- package/src/domains/datastores/tools.ts +76 -0
- package/src/domains/deletes.integration.test.ts +49 -2
- package/src/domains/environments/apply.ts +40 -0
- package/src/domains/environments/delete.ts +45 -0
- package/src/domains/environments/fetch.ts +39 -0
- package/src/domains/environments/resources.ts +21 -0
- package/src/domains/environments/tools.ts +81 -0
- package/src/domains/executions/cancel.ts +148 -0
- package/src/domains/executions/tools.ts +45 -0
- package/src/domains/executions.integration.test.ts +376 -0
- package/src/domains/reads.integration.test.ts +51 -5
- package/src/domains/records/calls.ts +209 -0
- package/src/domains/records/errors.ts +98 -0
- package/src/domains/records/records.integration.test.ts +313 -0
- package/src/domains/records/tools.ts +210 -0
- package/src/domains/resources.integration.test.ts +38 -2
- package/src/domains/resourceuri.test.ts +11 -2
- package/src/domains/resourceuri.ts +2 -0
- package/src/domains/search/search.integration.test.ts +18 -2
- package/src/domains/search/tools.ts +12 -7
- package/src/domains/skills/tools.ts +34 -1
- package/src/domains/skills/versions.ts +47 -0
- package/src/domains/versions.integration.test.ts +212 -0
- package/src/domains/workflowexecutions/approvals.ts +102 -0
- package/src/domains/workflowexecutions/run.ts +87 -0
- package/src/domains/workflowexecutions/tools.ts +120 -6
- package/src/domains/workflows/tools.ts +90 -7
- package/src/domains/workflows/versions.ts +147 -0
- package/src/gen/agent.ts +28 -1
- package/src/gen/datastore.ts +264 -0
- package/src/gen/environment.ts +66 -0
- package/src/http.integration.test.ts +1 -0
- package/src/index.ts +12 -5
- package/src/server.ts +71 -5
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/domains/records/calls.ts"],"names":[],"mappings":"AAyCA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgBD,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7F,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IACJ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,GACA,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,MAAM,CAAC,CAQjB"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
// Record-RPC invocations for the five record tools — 1:1 projections
|
|
2
|
+
// of DatastoreRecordQueryController / DatastoreRecordCommandController
|
|
3
|
+
// (DD-005: the tool layer adds no semantics; validation, grants,
|
|
4
|
+
// scopes, constraints, and messages all live in record-RPC domain
|
|
5
|
+
// logic on the control plane).
|
|
6
|
+
//
|
|
7
|
+
// One file for the five thin calls rather than the resource domains'
|
|
8
|
+
// file-per-verb split: resource verbs each carry orchestration
|
|
9
|
+
// (reference resolution, YAML parsing, two-step deletes); record calls
|
|
10
|
+
// are each "build request, call, marshal" and the shared argument
|
|
11
|
+
// mapping (filter/value building) is the only substance.
|
|
12
|
+
import { create, fromJson } from "@bufbuild/protobuf";
|
|
13
|
+
import { ValueSchema } from "@bufbuild/protobuf/wkt";
|
|
14
|
+
import { DatastoreRecordCommandController, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_command_pb";
|
|
15
|
+
import { DatastoreRecordQueryController, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_query_pb";
|
|
16
|
+
import { DatastoreDescriptionSchema, DeleteRecordRequestSchema, DescribeDatastoreRequestSchema, FindRecordsRequestSchema, InsertRecordRequestSchema, RecordConditionOp, RecordConditionSchema, RecordEnvelopeSchema, RecordFilterSchema, RecordListSchema, RecordOrderBySchema, RecordSortDirection, UpdateRecordRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
|
|
17
|
+
import { withClient } from "../client.js";
|
|
18
|
+
import { toProtoJson } from "../marshal.js";
|
|
19
|
+
/** Model-facing operator spelling → proto enum. */
|
|
20
|
+
const CONDITION_OPS = {
|
|
21
|
+
eq: RecordConditionOp.eq,
|
|
22
|
+
neq: RecordConditionOp.neq,
|
|
23
|
+
gt: RecordConditionOp.gt,
|
|
24
|
+
gte: RecordConditionOp.gte,
|
|
25
|
+
lt: RecordConditionOp.lt,
|
|
26
|
+
lte: RecordConditionOp.lte,
|
|
27
|
+
in: RecordConditionOp.is_in,
|
|
28
|
+
not_in: RecordConditionOp.not_in,
|
|
29
|
+
is_null: RecordConditionOp.is_null,
|
|
30
|
+
not_null: RecordConditionOp.not_null,
|
|
31
|
+
};
|
|
32
|
+
export async function findRecords(serverAddress, token, args) {
|
|
33
|
+
const request = create(FindRecordsRequestSchema, {
|
|
34
|
+
datastore: args.datastore,
|
|
35
|
+
org: args.org ?? "",
|
|
36
|
+
collection: args.collection,
|
|
37
|
+
filter: buildFilter(args.conditions),
|
|
38
|
+
orderBy: buildOrderBy(args.order_by),
|
|
39
|
+
limit: args.limit ?? 0,
|
|
40
|
+
offset: args.offset ?? 0,
|
|
41
|
+
});
|
|
42
|
+
return withClient(DatastoreRecordQueryController, serverAddress, token, async (client, opts) => toProtoJson(RecordListSchema, await client.findRecords(request, opts)));
|
|
43
|
+
}
|
|
44
|
+
export async function insertRecord(serverAddress, token, args) {
|
|
45
|
+
const request = create(InsertRecordRequestSchema, {
|
|
46
|
+
datastore: args.datastore,
|
|
47
|
+
org: args.org ?? "",
|
|
48
|
+
collection: args.collection,
|
|
49
|
+
// google.protobuf.Struct fields are plain JSON objects in
|
|
50
|
+
// protobuf-es v2 — no conversion.
|
|
51
|
+
record: args.record,
|
|
52
|
+
});
|
|
53
|
+
return withClient(DatastoreRecordCommandController, serverAddress, token, async (client, opts) => toProtoJson(RecordEnvelopeSchema, await client.insertRecord(request, opts)));
|
|
54
|
+
}
|
|
55
|
+
export async function updateRecord(serverAddress, token, args) {
|
|
56
|
+
const request = create(UpdateRecordRequestSchema, {
|
|
57
|
+
datastore: args.datastore,
|
|
58
|
+
org: args.org ?? "",
|
|
59
|
+
collection: args.collection,
|
|
60
|
+
id: args.id,
|
|
61
|
+
fields: args.fields,
|
|
62
|
+
});
|
|
63
|
+
return withClient(DatastoreRecordCommandController, serverAddress, token, async (client, opts) => toProtoJson(RecordEnvelopeSchema, await client.updateRecord(request, opts)));
|
|
64
|
+
}
|
|
65
|
+
export async function deleteRecord(serverAddress, token, args) {
|
|
66
|
+
const request = create(DeleteRecordRequestSchema, {
|
|
67
|
+
datastore: args.datastore,
|
|
68
|
+
org: args.org ?? "",
|
|
69
|
+
collection: args.collection,
|
|
70
|
+
id: args.id,
|
|
71
|
+
});
|
|
72
|
+
return withClient(DatastoreRecordCommandController, serverAddress, token, async (client, opts) => toProtoJson(RecordEnvelopeSchema, await client.deleteRecord(request, opts)));
|
|
73
|
+
}
|
|
74
|
+
export async function describeDatastore(serverAddress, token, args) {
|
|
75
|
+
const request = create(DescribeDatastoreRequestSchema, {
|
|
76
|
+
datastore: args.datastore,
|
|
77
|
+
org: args.org ?? "",
|
|
78
|
+
});
|
|
79
|
+
return withClient(DatastoreRecordQueryController, serverAddress, token, async (client, opts) => toProtoJson(DatastoreDescriptionSchema, await client.describeDatastore(request, opts)));
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Build the typed AND-only filter (DD-005 SD-2). An unknown operator is
|
|
83
|
+
* left unspecified for the server to reject with its own domain
|
|
84
|
+
* message — the bridge never fabricates validation of its own.
|
|
85
|
+
*/
|
|
86
|
+
function buildFilter(conditions) {
|
|
87
|
+
if (conditions === undefined || conditions.length === 0) {
|
|
88
|
+
return undefined;
|
|
89
|
+
}
|
|
90
|
+
return create(RecordFilterSchema, {
|
|
91
|
+
conditions: conditions.map(buildCondition),
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
function buildCondition(arg) {
|
|
95
|
+
return create(RecordConditionSchema, {
|
|
96
|
+
field: arg.field,
|
|
97
|
+
op: CONDITION_OPS[arg.op] ?? RecordConditionOp.record_condition_op_unspecified,
|
|
98
|
+
value: arg.value !== undefined ? scalarValue(arg.value) : undefined,
|
|
99
|
+
values: (arg.values ?? []).map(scalarValue),
|
|
100
|
+
});
|
|
101
|
+
}
|
|
102
|
+
function buildOrderBy(orderBy) {
|
|
103
|
+
if (orderBy === undefined) {
|
|
104
|
+
return undefined;
|
|
105
|
+
}
|
|
106
|
+
return create(RecordOrderBySchema, {
|
|
107
|
+
field: orderBy.field,
|
|
108
|
+
direction: orderBy.direction === "desc"
|
|
109
|
+
? RecordSortDirection.desc
|
|
110
|
+
: orderBy.direction === "asc"
|
|
111
|
+
? RecordSortDirection.asc
|
|
112
|
+
: RecordSortDirection.record_sort_direction_unspecified,
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
function scalarValue(v) {
|
|
116
|
+
return fromJson(ValueSchema, v);
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=calls.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../src/domains/records/calls.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { ConnectError } from "@connectrpc/connect";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
/** The structured error payload record tools return for domain errors. */
|
|
4
|
+
export interface RecordToolError {
|
|
5
|
+
/** The server's relayable message, byte-for-byte. */
|
|
6
|
+
error: string;
|
|
7
|
+
/** gRPC status name in SCREAMING_SNAKE (e.g. ALREADY_EXISTS). */
|
|
8
|
+
code: string;
|
|
9
|
+
/** ErrorInfo reason (e.g. CONSTRAINT_VIOLATION), when present. */
|
|
10
|
+
reason?: string;
|
|
11
|
+
/** Violated constraint name from ErrorInfo metadata, when present. */
|
|
12
|
+
constraint?: string;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Run a record-tool body: a string payload becomes a text result; a
|
|
16
|
+
* domain error becomes an isError JSON result carrying the verbatim
|
|
17
|
+
* message + ErrorInfo companions; a transport error delegates to the
|
|
18
|
+
* shared classifier. The records analog of ../toolresult.ts
|
|
19
|
+
* textOrError, and the only try/catch in this domain.
|
|
20
|
+
*/
|
|
21
|
+
export declare function recordResult(toolContext: string, produce: () => Promise<string>): Promise<CallToolResult>;
|
|
22
|
+
/** Project a domain ConnectError into the structured tool payload. */
|
|
23
|
+
export declare function domainError(ce: ConnectError): RecordToolError;
|
|
24
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/domains/records/errors.ts"],"names":[],"mappings":"AAeA,OAAO,EAAQ,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAkBzE,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,eAAe,CAoB7D"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
// The records-domain error mapper (DD-005 SD-6) — a deliberate,
|
|
2
|
+
// documented divergence from the shared ../rpcerr.ts.
|
|
3
|
+
//
|
|
4
|
+
// Record-RPC domain errors carry agent-relayable messages that are
|
|
5
|
+
// cross-edition contract bytes (DD-002 SD-5): "that slot is already
|
|
6
|
+
// booked", "you are not allowed to insert records in bookings". The
|
|
7
|
+
// shared helper would rewrite them ("Check your API key permissions")
|
|
8
|
+
// and discards google.rpc.ErrorInfo. Here the domain codes pass the
|
|
9
|
+
// server's message through VERBATIM as isError JSON text
|
|
10
|
+
// `{error, code, reason, constraint}` — reason/constraint extracted
|
|
11
|
+
// from ErrorInfo — so the model can self-correct (retry another slot
|
|
12
|
+
// on CONSTRAINT_VIOLATION; stop and relay on PERMISSION_DENIED).
|
|
13
|
+
// Transport codes still delegate to the shared helper, whose advice is
|
|
14
|
+
// right for them.
|
|
15
|
+
import { Code, ConnectError } from "@connectrpc/connect";
|
|
16
|
+
import { ErrorInfoSchema } from "@stigmer/protos/google/rpc/error_details_pb";
|
|
17
|
+
import { rpcError } from "../rpcerr.js";
|
|
18
|
+
import { errorResult, textResult } from "../toolresult.js";
|
|
19
|
+
/**
|
|
20
|
+
* The gRPC codes whose messages are the record-RPC domain contract
|
|
21
|
+
* (DD-005 SD-6): declared constraint messages, fixed denial texts, and
|
|
22
|
+
* domain validation — all written to be relayed to end users verbatim.
|
|
23
|
+
*/
|
|
24
|
+
const DOMAIN_CODES = new Set([
|
|
25
|
+
Code.PermissionDenied,
|
|
26
|
+
Code.AlreadyExists,
|
|
27
|
+
Code.FailedPrecondition,
|
|
28
|
+
Code.InvalidArgument,
|
|
29
|
+
Code.NotFound,
|
|
30
|
+
]);
|
|
31
|
+
/**
|
|
32
|
+
* Run a record-tool body: a string payload becomes a text result; a
|
|
33
|
+
* domain error becomes an isError JSON result carrying the verbatim
|
|
34
|
+
* message + ErrorInfo companions; a transport error delegates to the
|
|
35
|
+
* shared classifier. The records analog of ../toolresult.ts
|
|
36
|
+
* textOrError, and the only try/catch in this domain.
|
|
37
|
+
*/
|
|
38
|
+
export async function recordResult(toolContext, produce) {
|
|
39
|
+
try {
|
|
40
|
+
return textResult(await produce());
|
|
41
|
+
}
|
|
42
|
+
catch (err) {
|
|
43
|
+
const ce = ConnectError.from(err);
|
|
44
|
+
if (DOMAIN_CODES.has(ce.code)) {
|
|
45
|
+
return {
|
|
46
|
+
content: [{ type: "text", text: JSON.stringify(domainError(ce)) }],
|
|
47
|
+
isError: true,
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
return errorResult(rpcError(ce, toolContext));
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** Project a domain ConnectError into the structured tool payload. */
|
|
54
|
+
export function domainError(ce) {
|
|
55
|
+
const payload = {
|
|
56
|
+
error: ce.rawMessage,
|
|
57
|
+
code: grpcStatusName(ce.code),
|
|
58
|
+
};
|
|
59
|
+
// The record RPCs attach one google.rpc.ErrorInfo per domain error
|
|
60
|
+
// (domain datastore.stigmer.ai); absence means an older server — the
|
|
61
|
+
// message alone still carries the contract.
|
|
62
|
+
const details = ce.findDetails(ErrorInfoSchema);
|
|
63
|
+
if (details.length > 0) {
|
|
64
|
+
const info = details[0];
|
|
65
|
+
if (info.reason !== "") {
|
|
66
|
+
payload.reason = info.reason;
|
|
67
|
+
}
|
|
68
|
+
const constraint = info.metadata["constraint"];
|
|
69
|
+
if (constraint !== undefined && constraint !== "") {
|
|
70
|
+
payload.constraint = constraint;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return payload;
|
|
74
|
+
}
|
|
75
|
+
/** Connect's PascalCase code name → the gRPC SCREAMING_SNAKE status name. */
|
|
76
|
+
function grpcStatusName(code) {
|
|
77
|
+
return Code[code].replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase();
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domains/records/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,sDAAsD;AACtD,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,oEAAoE;AACpE,sEAAsE;AACtE,oEAAoE;AACpE,yDAAyD;AACzD,oEAAoE;AACpE,qEAAqE;AACrE,iEAAiE;AACjE,uEAAuE;AACvE,kBAAkB;AAElB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,YAAY,GAAsB,IAAI,GAAG,CAAC;IAC9C,IAAI,CAAC,gBAAgB;IACrB,IAAI,CAAC,aAAa;IAClB,IAAI,CAAC,kBAAkB;IACvB,IAAI,CAAC,eAAe;IACpB,IAAI,CAAC,QAAQ;CACd,CAAC,CAAC;AAcH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,OAA8B;IAE9B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,EAAgB;IAC1C,MAAM,OAAO,GAAoB;QAC/B,KAAK,EAAE,EAAE,CAAC,UAAU;QACpB,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC;KAC9B,CAAC;IACF,mEAAmE;IACnE,qEAAqE;IACrE,4CAA4C;IAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YAClD,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,IAAU;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzE,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { type BackendTarget } from "../client.js";
|
|
3
|
+
/** Which roster the tools are being registered on (see file header). */
|
|
4
|
+
export type RecordToolAudience = "agent" | "direct";
|
|
5
|
+
/** Register the five record tools for one audience; returns the tool names. */
|
|
6
|
+
export declare function registerRecordTools(server: McpServer, target: BackendTarget, audience: RecordToolAudience): string[];
|
|
7
|
+
//# sourceMappingURL=tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/records/tools.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAWhE,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAyBpD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,EAAE,CA8IV"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
// MCP tools for the Datastore record domain — the five agent-facing
|
|
2
|
+
// record tools of DD-005: 1:1 projections of the record RPCs, with the
|
|
3
|
+
// records-own error mapper (errors.ts) and honest MCP annotations (the
|
|
4
|
+
// bridge's first use of annotations; the platform's own connect-time
|
|
5
|
+
// classifier honors destructiveHint fail-closed for external clients,
|
|
6
|
+
// while the runner-synthesized attachment is approval-free by
|
|
7
|
+
// construction and never passes through that classifier).
|
|
8
|
+
//
|
|
9
|
+
// Two audiences, one definition (registered per roster):
|
|
10
|
+
// - "agent" (the records-only roster the runner-synthesized
|
|
11
|
+
// attachment connects to): NO `org` argument — a session-bound
|
|
12
|
+
// caller's org is server-derived from the session, and an explicit
|
|
13
|
+
// org is rejected (T05 R3), so offering the argument would only
|
|
14
|
+
// invite rejected calls.
|
|
15
|
+
// - "direct" (the main roster external MCP clients see): optional
|
|
16
|
+
// `org`, which cloud direct principals must name (their credential
|
|
17
|
+
// carries no ambient org — the DD-006 session-14 amendment). OSS
|
|
18
|
+
// resolves an empty org to the local system org.
|
|
19
|
+
// `partition` is deliberately NOT a tool argument for either audience
|
|
20
|
+
// (DD-010: never from tool arguments); partition-explicit work is the
|
|
21
|
+
// console/CLI/SDK surface.
|
|
22
|
+
import { z } from "zod";
|
|
23
|
+
import { resolveToken } from "../client.js";
|
|
24
|
+
import { deleteRecord, describeDatastore, findRecords, insertRecord, updateRecord, } from "./calls.js";
|
|
25
|
+
import { recordResult } from "./errors.js";
|
|
26
|
+
const ENCODINGS = "Field value encodings: date YYYY-MM-DD, time HH:MM[:SS], timestamp RFC 3339 UTC " +
|
|
27
|
+
"(e.g. 2026-07-21T04:30:00Z).";
|
|
28
|
+
const scalar = z.union([z.string(), z.number(), z.boolean()]);
|
|
29
|
+
const conditionShape = z.object({
|
|
30
|
+
field: z
|
|
31
|
+
.string()
|
|
32
|
+
.describe("Declared field name, or a filterable system field (id, created_at, updated_at)."),
|
|
33
|
+
op: z
|
|
34
|
+
.enum(["eq", "neq", "gt", "gte", "lt", "lte", "in", "not_in", "is_null", "not_null"])
|
|
35
|
+
.describe("Comparison operator. eq/neq/in/not_in for string and enum fields; " +
|
|
36
|
+
"gt/gte/lt/lte for numeric and temporal fields; is_null/not_null for optional fields."),
|
|
37
|
+
value: scalar
|
|
38
|
+
.nullable()
|
|
39
|
+
.optional()
|
|
40
|
+
.describe("Comparison value for scalar operators, in the field's canonical encoding."),
|
|
41
|
+
values: z.array(scalar).optional().describe("Comparison values for in / not_in."),
|
|
42
|
+
});
|
|
43
|
+
/** Register the five record tools for one audience; returns the tool names. */
|
|
44
|
+
export function registerRecordTools(server, target, audience) {
|
|
45
|
+
// The org argument exists only on the direct roster (file header).
|
|
46
|
+
const orgShape = {};
|
|
47
|
+
if (audience === "direct") {
|
|
48
|
+
orgShape.org = z
|
|
49
|
+
.string()
|
|
50
|
+
.optional()
|
|
51
|
+
.describe("Organization that owns the datastore. Required on Stigmer Cloud; " +
|
|
52
|
+
"omit against a local backend.");
|
|
53
|
+
}
|
|
54
|
+
server.registerTool("describe_datastore", {
|
|
55
|
+
description: "Describe a datastore: its collections, field declarations and encodings, constraint " +
|
|
56
|
+
"messages, data partitions, and the verbs you are allowed to use per collection " +
|
|
57
|
+
"(empty access means you are not allowed to touch that collection). A read verb may " +
|
|
58
|
+
"carry readable_fields: reads then return only those fields, and only they may appear " +
|
|
59
|
+
"in filter conditions and order_by (empty readable_fields means every field). Call " +
|
|
60
|
+
`this before the first record operation against an unfamiliar datastore. ${ENCODINGS}`,
|
|
61
|
+
inputSchema: {
|
|
62
|
+
datastore: z.string().describe("Datastore slug (e.g. clinic)."),
|
|
63
|
+
...orgShape,
|
|
64
|
+
},
|
|
65
|
+
annotations: { readOnlyHint: true },
|
|
66
|
+
}, (args, extra) => recordResult(`datastore "${args.datastore}"`, () => describeDatastore(target.serverAddress, resolveToken(extra, target.apiKey), args)));
|
|
67
|
+
server.registerTool("find_records", {
|
|
68
|
+
description: "Find records in a datastore collection with a typed filter (conditions are AND-combined). " +
|
|
69
|
+
"Returns records plus total/limit/offset for paging. Results are ordered by created_at " +
|
|
70
|
+
"descending unless order_by is given. Records carry only the fields your grant allows " +
|
|
71
|
+
"(describe_datastore lists them as readable_fields); conditions and order_by on other " +
|
|
72
|
+
`fields are rejected. ${ENCODINGS}`,
|
|
73
|
+
inputSchema: {
|
|
74
|
+
datastore: z.string().describe("Datastore slug (e.g. clinic)."),
|
|
75
|
+
...orgShape,
|
|
76
|
+
collection: z.string().describe("Collection to query (e.g. bookings)."),
|
|
77
|
+
conditions: z
|
|
78
|
+
.array(conditionShape)
|
|
79
|
+
.optional()
|
|
80
|
+
.describe("Filter conditions, AND-combined. Omit to list all readable records."),
|
|
81
|
+
order_by: z
|
|
82
|
+
.object({
|
|
83
|
+
field: z.string().describe("Field to sort by."),
|
|
84
|
+
direction: z.enum(["asc", "desc"]).optional().describe("Sort direction (default asc)."),
|
|
85
|
+
})
|
|
86
|
+
.optional()
|
|
87
|
+
.describe("Sort order. Omit for created_at descending with id tiebreak."),
|
|
88
|
+
limit: z.number().int().optional().describe("Page size (default 25, max 100)."),
|
|
89
|
+
offset: z.number().int().optional().describe("Records to skip for paging."),
|
|
90
|
+
},
|
|
91
|
+
annotations: { readOnlyHint: true },
|
|
92
|
+
}, (args, extra) => recordResult(`records in "${args.datastore}/${args.collection}"`, () => findRecords(target.serverAddress, resolveToken(extra, target.apiKey), {
|
|
93
|
+
...args,
|
|
94
|
+
conditions: args.conditions,
|
|
95
|
+
})));
|
|
96
|
+
server.registerTool("insert_record", {
|
|
97
|
+
description: "Insert one record into a datastore collection. System fields (id, created_at, " +
|
|
98
|
+
"updated_at, created_by) are server-stamped — never include them. Declared constraints " +
|
|
99
|
+
"are enforced by the store; a violation returns the constraint's message verbatim " +
|
|
100
|
+
"(e.g. a taken slot returns ALREADY_EXISTS — pick another, do not retry the same one). " +
|
|
101
|
+
`When uncertain whether a record already exists, find first. ${ENCODINGS}`,
|
|
102
|
+
inputSchema: {
|
|
103
|
+
datastore: z.string().describe("Datastore slug (e.g. clinic)."),
|
|
104
|
+
...orgShape,
|
|
105
|
+
collection: z.string().describe("Collection to insert into (e.g. bookings)."),
|
|
106
|
+
record: z
|
|
107
|
+
.record(z.unknown())
|
|
108
|
+
.describe("Declared fields for the new record, in canonical encodings."),
|
|
109
|
+
},
|
|
110
|
+
}, (args, extra) => recordResult(`record in "${args.datastore}/${args.collection}"`, () => insertRecord(target.serverAddress, resolveToken(extra, target.apiKey), args)));
|
|
111
|
+
server.registerTool("update_record", {
|
|
112
|
+
description: "Update one record by id with a partial merge: only the supplied fields change, and an " +
|
|
113
|
+
"explicit null clears a field. Constraints are re-evaluated on the merged result. " +
|
|
114
|
+
`Returns the full updated record. ${ENCODINGS}`,
|
|
115
|
+
inputSchema: {
|
|
116
|
+
datastore: z.string().describe("Datastore slug (e.g. clinic)."),
|
|
117
|
+
...orgShape,
|
|
118
|
+
collection: z.string().describe("Collection holding the record."),
|
|
119
|
+
id: z.string().describe("Record id (from a previous find or insert)."),
|
|
120
|
+
fields: z
|
|
121
|
+
.record(z.unknown())
|
|
122
|
+
.describe("Fields to merge. Explicit null clears a field; omitted fields keep their values."),
|
|
123
|
+
},
|
|
124
|
+
annotations: { idempotentHint: true },
|
|
125
|
+
}, (args, extra) => recordResult(`record "${args.id}" in "${args.datastore}/${args.collection}"`, () => updateRecord(target.serverAddress, resolveToken(extra, target.apiKey), args)));
|
|
126
|
+
server.registerTool("delete_record", {
|
|
127
|
+
description: "Delete one record by id. Returns the deleted record. Record tools never delete " +
|
|
128
|
+
"collections or datastores.",
|
|
129
|
+
inputSchema: {
|
|
130
|
+
datastore: z.string().describe("Datastore slug (e.g. clinic)."),
|
|
131
|
+
...orgShape,
|
|
132
|
+
collection: z.string().describe("Collection holding the record."),
|
|
133
|
+
id: z.string().describe("Record id (from a previous find or insert)."),
|
|
134
|
+
},
|
|
135
|
+
annotations: { destructiveHint: true, idempotentHint: true },
|
|
136
|
+
}, (args, extra) => recordResult(`record "${args.id}" in "${args.datastore}/${args.collection}"`, () => deleteRecord(target.serverAddress, resolveToken(extra, target.apiKey), args)));
|
|
137
|
+
return ["describe_datastore", "find_records", "insert_record", "update_record", "delete_record"];
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/records/tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resourceuri.d.ts","sourceRoot":"","sources":["../../src/domains/resourceuri.ts"],"names":[],"mappings":"AASA,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAazD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CA6B3E;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,
|
|
1
|
+
{"version":3,"file":"resourceuri.d.ts","sourceRoot":"","sources":["../../src/domains/resourceuri.ts"],"names":[],"mappings":"AASA,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAazD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CA6B3E;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO5D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhF"}
|
package/domains/resourceuri.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resourceuri.js","sourceRoot":"","sources":["../../src/domains/resourceuri.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"resourceuri.js","sourceRoot":"","sources":["../../src/domains/resourceuri.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/search/tools.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/search/tools.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AA8B5E,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA6CtF"}
|
package/domains/search/tools.js
CHANGED
|
@@ -16,12 +16,15 @@ import { buildResourceURI } from "../resourceuri.js";
|
|
|
16
16
|
import { rpcError } from "../rpcerr.js";
|
|
17
17
|
import { textOrError } from "../toolresult.js";
|
|
18
18
|
/**
|
|
19
|
-
* The searchable kinds and their proto enum values.
|
|
20
|
-
*
|
|
21
|
-
*
|
|
19
|
+
* The searchable kinds and their proto enum values. Deliberately a curated
|
|
20
|
+
* subset (not every ApiResourceKind): the kinds an MCP client can also read
|
|
21
|
+
* and manage through tools. The backend's extractor registry supports more
|
|
22
|
+
* (sessions, executions, ...) — add here only alongside a tool surface.
|
|
22
23
|
*/
|
|
23
24
|
const knownKinds = {
|
|
24
25
|
agent: ApiResourceKind.agent,
|
|
26
|
+
datastore: ApiResourceKind.datastore,
|
|
27
|
+
environment: ApiResourceKind.environment,
|
|
25
28
|
skill: ApiResourceKind.skill,
|
|
26
29
|
mcp_server: ApiResourceKind.mcp_server,
|
|
27
30
|
workflow: ApiResourceKind.workflow,
|
|
@@ -29,14 +32,14 @@ const knownKinds = {
|
|
|
29
32
|
/** Register the search tool; returns the registered tool names. */
|
|
30
33
|
export function registerSearchTools(server, target) {
|
|
31
34
|
server.registerTool("search", {
|
|
32
|
-
description: "Search and list Stigmer resources (agents, skills, MCP servers, workflows
|
|
33
|
-
"Set 'kinds' to filter by resource type. Set 'query' for full-text search. " +
|
|
35
|
+
description: "Search and list Stigmer resources (agents, skills, MCP servers, workflows, environments, " +
|
|
36
|
+
"datastores). Set 'kinds' to filter by resource type. Set 'query' for full-text search. " +
|
|
34
37
|
"Set 'org' to scope to an organization. Omit 'query' to list all accessible resources.",
|
|
35
38
|
inputSchema: {
|
|
36
39
|
kinds: z
|
|
37
40
|
.array(z.string())
|
|
38
41
|
.optional()
|
|
39
|
-
.describe("Resource kinds to search. Valid: agent, skill, mcp_server, workflow. Empty searches all."),
|
|
42
|
+
.describe("Resource kinds to search. Valid: agent, skill, mcp_server, workflow, environment, datastore. Empty searches all."),
|
|
40
43
|
query: z
|
|
41
44
|
.string()
|
|
42
45
|
.optional()
|
|
@@ -95,7 +98,7 @@ function parseKinds(raw) {
|
|
|
95
98
|
return raw.map((s) => {
|
|
96
99
|
const kind = knownKinds[s];
|
|
97
100
|
if (kind === undefined) {
|
|
98
|
-
throw new Error(`unknown resource kind "${s}"; valid kinds: agent, skill, mcp_server, workflow`);
|
|
101
|
+
throw new Error(`unknown resource kind "${s}"; valid kinds: agent, skill, mcp_server, workflow, environment, datastore`);
|
|
99
102
|
}
|
|
100
103
|
return kind;
|
|
101
104
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/search/tools.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,0DAA0D;AAC1D,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,0EAA0E;AAC1E,0DAA0D;AAE1D,OAAO,EAAE,MAAM,EAAyB,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AACtH,OAAO,EAGL,oBAAoB,GACrB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/search/tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAMhE,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkFrF"}
|
package/domains/skills/tools.js
CHANGED
|
@@ -9,6 +9,7 @@ import { resolveToken } from "../client.js";
|
|
|
9
9
|
import { textOrError } from "../toolresult.js";
|
|
10
10
|
import { deleteSkill } from "./delete.js";
|
|
11
11
|
import { fetchSkill } from "./fetch.js";
|
|
12
|
+
import { listSkillVersions } from "./versions.js";
|
|
12
13
|
/** Register every Skill-domain tool; returns the registered tool names. */
|
|
13
14
|
export function registerSkillTools(server, target) {
|
|
14
15
|
server.registerTool("get_skill", {
|
|
@@ -34,6 +35,29 @@ export function registerSkillTools(server, target) {
|
|
|
34
35
|
.describe("Skill slug — the unique identifier within the org (e.g. code-review-best-practices). Deletes the skill and all its versions."),
|
|
35
36
|
},
|
|
36
37
|
}, (args, extra) => textOrError(() => deleteSkill(target.serverAddress, resolveToken(extra, target.apiKey), args.org, args.slug)));
|
|
37
|
-
|
|
38
|
+
server.registerTool("list_skill_versions", {
|
|
39
|
+
description: "List a skill's version history (newest first): version hash, tag, who pushed it and " +
|
|
40
|
+
"when, and which version is current. Fetch one version's full content with get_skill and " +
|
|
41
|
+
"its hash or tag.",
|
|
42
|
+
inputSchema: {
|
|
43
|
+
org: z.string().describe("Organization slug that owns the skill."),
|
|
44
|
+
slug: z.string().describe("Skill slug — unique identifier within the org."),
|
|
45
|
+
page_size: z
|
|
46
|
+
.number()
|
|
47
|
+
.int()
|
|
48
|
+
.optional()
|
|
49
|
+
.describe("Maximum versions per page (default 50)."),
|
|
50
|
+
page_token: z
|
|
51
|
+
.string()
|
|
52
|
+
.optional()
|
|
53
|
+
.describe("Pagination token from a previous response's next_page_token."),
|
|
54
|
+
},
|
|
55
|
+
}, (args, extra) => textOrError(() => listSkillVersions(target.serverAddress, resolveToken(extra, target.apiKey), {
|
|
56
|
+
org: args.org,
|
|
57
|
+
slug: args.slug,
|
|
58
|
+
pageSize: args.page_size,
|
|
59
|
+
pageToken: args.page_token,
|
|
60
|
+
})));
|
|
61
|
+
return ["get_skill", "delete_skill", "list_skill_versions"];
|
|
38
62
|
}
|
|
39
63
|
//# sourceMappingURL=tools.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/skills/tools.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,0DAA0D;AAC1D,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,6CAA6C;AAG7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/skills/tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export interface ListSkillVersionsArgs {
|
|
2
|
+
readonly org: string;
|
|
3
|
+
readonly slug: string;
|
|
4
|
+
readonly pageSize?: number;
|
|
5
|
+
readonly pageToken?: string;
|
|
6
|
+
}
|
|
7
|
+
/** List a skill's version history (newest first) as protojson. */
|
|
8
|
+
export declare function listSkillVersions(serverAddress: string, token: string, args: ListSkillVersionsArgs): Promise<string>;
|
|
9
|
+
//# sourceMappingURL=versions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../../src/domains/skills/versions.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,kEAAkE;AAClE,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAkBjB"}
|