@once-agent/sdk 0.1.11 → 0.1.12
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 +76 -1
- package/dist/cli.js +50 -1
- package/dist/cli.js.map +1 -1
- package/dist/connect/identity.d.ts +22 -0
- package/dist/connect/identity.d.ts.map +1 -0
- package/dist/connect/identity.js +159 -0
- package/dist/connect/identity.js.map +1 -0
- package/dist/connect/index.d.ts +17 -0
- package/dist/connect/index.d.ts.map +1 -0
- package/dist/connect/index.js +9 -0
- package/dist/connect/index.js.map +1 -0
- package/dist/connect/local-agent-tool.d.ts +30 -7
- package/dist/connect/local-agent-tool.d.ts.map +1 -1
- package/dist/connect/local-agent-tool.js +81 -9
- package/dist/connect/local-agent-tool.js.map +1 -1
- package/dist/connect/manifest.d.ts +55 -0
- package/dist/connect/manifest.d.ts.map +1 -0
- package/dist/connect/manifest.js +166 -0
- package/dist/connect/manifest.js.map +1 -0
- package/dist/connect/openai-function-tools.d.ts +66 -0
- package/dist/connect/openai-function-tools.d.ts.map +1 -0
- package/dist/connect/openai-function-tools.js +182 -0
- package/dist/connect/openai-function-tools.js.map +1 -0
- package/dist/connect/payload.d.ts +30 -0
- package/dist/connect/payload.d.ts.map +1 -0
- package/dist/connect/payload.js +122 -0
- package/dist/connect/payload.js.map +1 -0
- package/dist/connect/tool-classifier.d.ts +40 -0
- package/dist/connect/tool-classifier.d.ts.map +1 -0
- package/dist/connect/tool-classifier.js +271 -0
- package/dist/connect/tool-classifier.js.map +1 -0
- package/dist/connect/toolset.d.ts +42 -0
- package/dist/connect/toolset.d.ts.map +1 -0
- package/dist/connect/toolset.js +123 -0
- package/dist/connect/toolset.js.map +1 -0
- package/dist/discovery/index.d.ts +13 -0
- package/dist/discovery/index.d.ts.map +1 -0
- package/dist/discovery/index.js +8 -0
- package/dist/discovery/index.js.map +1 -0
- package/dist/execution-observation.d.ts +122 -0
- package/dist/execution-observation.d.ts.map +1 -0
- package/dist/execution-observation.js +324 -0
- package/dist/execution-observation.js.map +1 -0
- package/dist/gateway/index.d.ts +9 -0
- package/dist/gateway/index.d.ts.map +1 -0
- package/dist/gateway/index.js +5 -0
- package/dist/gateway/index.js.map +1 -0
- package/dist/gateway/local-toolset.d.ts +32 -0
- package/dist/gateway/local-toolset.d.ts.map +1 -0
- package/dist/gateway/local-toolset.js +79 -0
- package/dist/gateway/local-toolset.js.map +1 -0
- package/dist/gateway/openai-function-tools.d.ts +28 -0
- package/dist/gateway/openai-function-tools.d.ts.map +1 -0
- package/dist/gateway/openai-function-tools.js +117 -0
- package/dist/gateway/openai-function-tools.js.map +1 -0
- package/dist/gateway/planner.d.ts +53 -0
- package/dist/gateway/planner.d.ts.map +1 -0
- package/dist/gateway/planner.js +155 -0
- package/dist/gateway/planner.js.map +1 -0
- package/dist/gateway/tool-graph-binding.d.ts +51 -0
- package/dist/gateway/tool-graph-binding.d.ts.map +1 -0
- package/dist/gateway/tool-graph-binding.js +123 -0
- package/dist/gateway/tool-graph-binding.js.map +1 -0
- package/dist/langchain-execution-observer.d.ts +22 -0
- package/dist/langchain-execution-observer.d.ts.map +1 -0
- package/dist/langchain-execution-observer.js +128 -0
- package/dist/langchain-execution-observer.js.map +1 -0
- package/dist/langchain-runtime-discovery.d.ts +33 -0
- package/dist/langchain-runtime-discovery.d.ts.map +1 -0
- package/dist/langchain-runtime-discovery.js +214 -0
- package/dist/langchain-runtime-discovery.js.map +1 -0
- package/dist/mcp-live-discovery.d.ts +71 -0
- package/dist/mcp-live-discovery.d.ts.map +1 -0
- package/dist/mcp-live-discovery.js +710 -0
- package/dist/mcp-live-discovery.js.map +1 -0
- package/dist/mcp-live-report.d.ts +3 -0
- package/dist/mcp-live-report.d.ts.map +1 -0
- package/dist/mcp-live-report.js +50 -0
- package/dist/mcp-live-report.js.map +1 -0
- package/dist/mcp-tool-refresh-report.d.ts +3 -0
- package/dist/mcp-tool-refresh-report.d.ts.map +1 -0
- package/dist/mcp-tool-refresh-report.js +44 -0
- package/dist/mcp-tool-refresh-report.js.map +1 -0
- package/dist/mcp-tool-refresh.d.ts +33 -0
- package/dist/mcp-tool-refresh.d.ts.map +1 -0
- package/dist/mcp-tool-refresh.js +489 -0
- package/dist/mcp-tool-refresh.js.map +1 -0
- package/dist/openai-agents-execution-observer.d.ts +24 -0
- package/dist/openai-agents-execution-observer.d.ts.map +1 -0
- package/dist/openai-agents-execution-observer.js +163 -0
- package/dist/openai-agents-execution-observer.js.map +1 -0
- package/dist/otel-execution-observer.d.ts +16 -0
- package/dist/otel-execution-observer.d.ts.map +1 -0
- package/dist/otel-execution-observer.js +129 -0
- package/dist/otel-execution-observer.js.map +1 -0
- package/dist/runtime-tool-discovery.d.ts +86 -0
- package/dist/runtime-tool-discovery.d.ts.map +1 -0
- package/dist/runtime-tool-discovery.js +429 -0
- package/dist/runtime-tool-discovery.js.map +1 -0
- package/dist/tool-discovery.d.ts +51 -0
- package/dist/tool-discovery.d.ts.map +1 -0
- package/dist/tool-discovery.js +487 -0
- package/dist/tool-discovery.js.map +1 -0
- package/dist/tool-importance.d.ts +34 -0
- package/dist/tool-importance.d.ts.map +1 -0
- package/dist/tool-importance.js +269 -0
- package/dist/tool-importance.js.map +1 -0
- package/dist/tool-report.d.ts +3 -0
- package/dist/tool-report.d.ts.map +1 -0
- package/dist/tool-report.js +75 -0
- package/dist/tool-report.js.map +1 -0
- package/dist/vercel-execution-observer.d.ts +12 -0
- package/dist/vercel-execution-observer.d.ts.map +1 -0
- package/dist/vercel-execution-observer.js +97 -0
- package/dist/vercel-execution-observer.js.map +1 -0
- package/dist-cjs/connect/identity.js +162 -0
- package/dist-cjs/connect/identity.js.map +1 -0
- package/dist-cjs/connect/index.js +26 -0
- package/dist-cjs/connect/index.js.map +1 -0
- package/dist-cjs/connect/local-agent-tool.js +82 -9
- package/dist-cjs/connect/local-agent-tool.js.map +1 -1
- package/dist-cjs/connect/manifest.js +171 -0
- package/dist-cjs/connect/manifest.js.map +1 -0
- package/dist-cjs/connect/openai-function-tools.js +187 -0
- package/dist-cjs/connect/openai-function-tools.js.map +1 -0
- package/dist-cjs/connect/payload.js +125 -0
- package/dist-cjs/connect/payload.js.map +1 -0
- package/dist-cjs/connect/tool-classifier.js +276 -0
- package/dist-cjs/connect/tool-classifier.js.map +1 -0
- package/dist-cjs/connect/toolset.js +126 -0
- package/dist-cjs/connect/toolset.js.map +1 -0
- package/dist-cjs/discovery/index.js +26 -0
- package/dist-cjs/discovery/index.js.map +1 -0
- package/dist-cjs/execution-observation.js +330 -0
- package/dist-cjs/execution-observation.js.map +1 -0
- package/dist-cjs/gateway/index.js +16 -0
- package/dist-cjs/gateway/index.js.map +1 -0
- package/dist-cjs/gateway/local-toolset.js +84 -0
- package/dist-cjs/gateway/local-toolset.js.map +1 -0
- package/dist-cjs/gateway/openai-function-tools.js +120 -0
- package/dist-cjs/gateway/openai-function-tools.js.map +1 -0
- package/dist-cjs/gateway/planner.js +160 -0
- package/dist-cjs/gateway/planner.js.map +1 -0
- package/dist-cjs/gateway/tool-graph-binding.js +126 -0
- package/dist-cjs/gateway/tool-graph-binding.js.map +1 -0
- package/dist-cjs/langchain-execution-observer.js +131 -0
- package/dist-cjs/langchain-execution-observer.js.map +1 -0
- package/dist-cjs/langchain-runtime-discovery.js +218 -0
- package/dist-cjs/langchain-runtime-discovery.js.map +1 -0
- package/dist-cjs/openai-agents-execution-observer.js +166 -0
- package/dist-cjs/openai-agents-execution-observer.js.map +1 -0
- package/dist-cjs/otel-execution-observer.js +132 -0
- package/dist-cjs/otel-execution-observer.js.map +1 -0
- package/dist-cjs/runtime-tool-discovery.js +436 -0
- package/dist-cjs/runtime-tool-discovery.js.map +1 -0
- package/dist-cjs/tool-importance.js +272 -0
- package/dist-cjs/tool-importance.js.map +1 -0
- package/dist-cjs/vercel-execution-observer.js +100 -0
- package/dist-cjs/vercel-execution-observer.js.map +1 -0
- package/package.json +25 -3
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { executionToolFingerprint, observeToolExecution, } from "./execution-observation.js";
|
|
2
|
+
function asRecord(value) {
|
|
3
|
+
return value && typeof value === "object" && !Array.isArray(value)
|
|
4
|
+
? value
|
|
5
|
+
: undefined;
|
|
6
|
+
}
|
|
7
|
+
function ownDataValue(value, key) {
|
|
8
|
+
const record = asRecord(value);
|
|
9
|
+
if (!record)
|
|
10
|
+
return undefined;
|
|
11
|
+
const descriptor = Object.getOwnPropertyDescriptor(record, key);
|
|
12
|
+
return descriptor && "value" in descriptor
|
|
13
|
+
? descriptor.value
|
|
14
|
+
: undefined;
|
|
15
|
+
}
|
|
16
|
+
function ownString(value, key) {
|
|
17
|
+
const raw = ownDataValue(value, key);
|
|
18
|
+
return typeof raw === "string" && raw.trim() !== ""
|
|
19
|
+
? raw
|
|
20
|
+
: undefined;
|
|
21
|
+
}
|
|
22
|
+
function optionalArgString(args, index) {
|
|
23
|
+
const value = args[index];
|
|
24
|
+
return typeof value === "string" && value.trim() !== ""
|
|
25
|
+
? value
|
|
26
|
+
: undefined;
|
|
27
|
+
}
|
|
28
|
+
function toolByName(snapshot) {
|
|
29
|
+
const map = new Map();
|
|
30
|
+
for (const tool of snapshot.tools) {
|
|
31
|
+
if (!map.has(tool.canonicalName)) {
|
|
32
|
+
map.set(tool.canonicalName, tool);
|
|
33
|
+
}
|
|
34
|
+
else {
|
|
35
|
+
map.set(tool.canonicalName, null);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
return map;
|
|
39
|
+
}
|
|
40
|
+
function serializedToolName(serialized) {
|
|
41
|
+
const direct = ownString(serialized, "name");
|
|
42
|
+
if (direct)
|
|
43
|
+
return direct;
|
|
44
|
+
const id = ownDataValue(serialized, "id");
|
|
45
|
+
if (!Array.isArray(id) || id.length === 0)
|
|
46
|
+
return undefined;
|
|
47
|
+
const last = id[id.length - 1];
|
|
48
|
+
return typeof last === "string" && last.trim() !== ""
|
|
49
|
+
? last
|
|
50
|
+
: undefined;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Create a dependency-free object compatible with LangChain callback handler
|
|
54
|
+
* methods for tool execution observation.
|
|
55
|
+
*
|
|
56
|
+
* The observer never invokes a tool and never retains input, output, errors,
|
|
57
|
+
* tags, metadata or parent run state. A matching handleToolStart establishes
|
|
58
|
+
* exact tool identity; handleToolEnd/handleToolError close that run as
|
|
59
|
+
* SUCCEEDED/FAILED respectively.
|
|
60
|
+
*/
|
|
61
|
+
export function createLangChainExecutionObserver(visibleSnapshot) {
|
|
62
|
+
const byName = toolByName(visibleSnapshot);
|
|
63
|
+
const pending = new Map();
|
|
64
|
+
const collected = [];
|
|
65
|
+
const handleToolStart = (...args) => {
|
|
66
|
+
// Current CallbackHandlerMethods shape:
|
|
67
|
+
// (serializedTool, input, runId, parentRunId?, tags?, metadata?, runName?, toolCallId?)
|
|
68
|
+
const runId = optionalArgString(args, 2);
|
|
69
|
+
if (!runId)
|
|
70
|
+
return;
|
|
71
|
+
const serialized = args[0];
|
|
72
|
+
const runName = optionalArgString(args, 6);
|
|
73
|
+
const name = runName ?? serializedToolName(serialized);
|
|
74
|
+
if (!name)
|
|
75
|
+
return;
|
|
76
|
+
const tool = byName.get(name);
|
|
77
|
+
if (!tool)
|
|
78
|
+
return;
|
|
79
|
+
const toolCallId = optionalArgString(args, 7);
|
|
80
|
+
pending.set(runId, {
|
|
81
|
+
tool,
|
|
82
|
+
startedAtMs: Date.now(),
|
|
83
|
+
...(toolCallId ? { toolCallId } : {}),
|
|
84
|
+
});
|
|
85
|
+
};
|
|
86
|
+
const finish = (status, args) => {
|
|
87
|
+
// handleToolEnd(output, runId, ...)
|
|
88
|
+
// handleToolError(error, runId, ...)
|
|
89
|
+
const runId = optionalArgString(args, 1);
|
|
90
|
+
if (!runId)
|
|
91
|
+
return;
|
|
92
|
+
const started = pending.get(runId);
|
|
93
|
+
if (!started)
|
|
94
|
+
return;
|
|
95
|
+
pending.delete(runId);
|
|
96
|
+
const now = Date.now();
|
|
97
|
+
const observed = observeToolExecution({
|
|
98
|
+
eventId: `langchain-tool-run:${runId}`,
|
|
99
|
+
toolId: started.tool.toolId,
|
|
100
|
+
namespacedName: started.tool.namespacedName,
|
|
101
|
+
descriptorFingerprint: executionToolFingerprint(started.tool),
|
|
102
|
+
canonicalName: started.tool.canonicalName,
|
|
103
|
+
framework: "langchain",
|
|
104
|
+
runtimeName: visibleSnapshot.runtimeName,
|
|
105
|
+
source: "framework_callback",
|
|
106
|
+
status,
|
|
107
|
+
observedAt: new Date(now).toISOString(),
|
|
108
|
+
durationMs: Math.max(0, now - started.startedAtMs),
|
|
109
|
+
});
|
|
110
|
+
if (observed.accepted) {
|
|
111
|
+
collected.push(observed.event);
|
|
112
|
+
}
|
|
113
|
+
};
|
|
114
|
+
return Object.freeze({
|
|
115
|
+
name: "once-execution-observer",
|
|
116
|
+
handleToolStart,
|
|
117
|
+
handleToolEnd: (...args) => finish("SUCCEEDED", args),
|
|
118
|
+
handleToolError: (...args) => finish("FAILED", args),
|
|
119
|
+
events: () => Object.freeze([...collected]),
|
|
120
|
+
drain: () => {
|
|
121
|
+
const drained = Object.freeze([...collected]);
|
|
122
|
+
collected.length = 0;
|
|
123
|
+
return drained;
|
|
124
|
+
},
|
|
125
|
+
pendingCount: () => pending.size,
|
|
126
|
+
});
|
|
127
|
+
}
|
|
128
|
+
//# sourceMappingURL=langchain-execution-observer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"langchain-execution-observer.js","sourceRoot":"","sources":["../src/langchain-execution-observer.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { RuntimeToolObservation } from "./runtime-tool-discovery.js";
|
|
2
|
+
type BaseRuntimeObservation = Omit<RuntimeToolObservation, "framework" | "origin" | "safeMetadata">;
|
|
3
|
+
export type LangChainRuntimeToolObservation = BaseRuntimeObservation & {
|
|
4
|
+
framework: "langchain";
|
|
5
|
+
origin: Omit<RuntimeToolObservation["origin"], "source"> & {
|
|
6
|
+
source: "langchain.tools" | "langchain.bindTools";
|
|
7
|
+
};
|
|
8
|
+
safeMetadata?: NonNullable<RuntimeToolObservation["safeMetadata"]> & {
|
|
9
|
+
returnDirect?: boolean;
|
|
10
|
+
};
|
|
11
|
+
};
|
|
12
|
+
export type LangChainRegisteredToolSnapshot = {
|
|
13
|
+
framework: "langchain";
|
|
14
|
+
runtimeName?: string;
|
|
15
|
+
registeredToolCount: number;
|
|
16
|
+
tools: LangChainRuntimeToolObservation[];
|
|
17
|
+
externalCallsMade: false;
|
|
18
|
+
toolInvocationsMade: false;
|
|
19
|
+
secretValuesRetained: false;
|
|
20
|
+
};
|
|
21
|
+
export type LangChainModelVisibleToolSnapshot = {
|
|
22
|
+
framework: "langchain";
|
|
23
|
+
runtimeName?: string;
|
|
24
|
+
modelVisibleToolCount: number;
|
|
25
|
+
tools: LangChainRuntimeToolObservation[];
|
|
26
|
+
externalCallsMade: false;
|
|
27
|
+
toolInvocationsMade: false;
|
|
28
|
+
secretValuesRetained: false;
|
|
29
|
+
};
|
|
30
|
+
export declare function discoverLangChainRegisteredTools(toolsOrAgentConfig: unknown, runtimeName?: string): LangChainRegisteredToolSnapshot;
|
|
31
|
+
export declare function discoverLangChainModelVisibleTools(toolsPassedToBindTools: unknown, runtimeName?: string): LangChainModelVisibleToolSnapshot;
|
|
32
|
+
export {};
|
|
33
|
+
//# sourceMappingURL=langchain-runtime-discovery.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"langchain-runtime-discovery.d.ts","sourceRoot":"","sources":["../src/langchain-runtime-discovery.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAIrC,KAAK,sBAAsB,GAAG,IAAI,CAChC,sBAAsB,EACtB,WAAW,GAAG,QAAQ,GAAG,cAAc,CACxC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACzC,sBAAsB,GAAG;IACvB,SAAS,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG;QACzD,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAAC;KACnD,CAAC;IACF,YAAY,CAAC,EAAE,WAAW,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,GAAG;QACnE,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEJ,MAAM,MAAM,+BAA+B,GAAG;IAC5C,SAAS,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,+BAA+B,EAAE,CAAC;IACzC,iBAAiB,EAAE,KAAK,CAAC;IACzB,mBAAmB,EAAE,KAAK,CAAC;IAC3B,oBAAoB,EAAE,KAAK,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,SAAS,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,+BAA+B,EAAE,CAAC;IACzC,iBAAiB,EAAE,KAAK,CAAC;IACzB,mBAAmB,EAAE,KAAK,CAAC;IAC3B,oBAAoB,EAAE,KAAK,CAAC;CAC7B,CAAC;AAuRF,wBAAgB,gCAAgC,CAC9C,kBAAkB,EAAE,OAAO,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,+BAA+B,CAiBjC;AAED,wBAAgB,kCAAkC,CAChD,sBAAsB,EAAE,OAAO,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,iCAAiC,CAiBnC"}
|
|
@@ -0,0 +1,214 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { assessToolImportance, } from "./tool-importance.js";
|
|
3
|
+
function asRecord(value) {
|
|
4
|
+
if (value &&
|
|
5
|
+
typeof value === "object" &&
|
|
6
|
+
!Array.isArray(value)) {
|
|
7
|
+
return value;
|
|
8
|
+
}
|
|
9
|
+
return undefined;
|
|
10
|
+
}
|
|
11
|
+
function ownDataValue(record, key) {
|
|
12
|
+
if (!record)
|
|
13
|
+
return undefined;
|
|
14
|
+
const descriptor = Object.getOwnPropertyDescriptor(record, key);
|
|
15
|
+
return descriptor && "value" in descriptor
|
|
16
|
+
? descriptor.value
|
|
17
|
+
: undefined;
|
|
18
|
+
}
|
|
19
|
+
function stableId(value) {
|
|
20
|
+
return `tool:${createHash("sha256")
|
|
21
|
+
.update(JSON.stringify(value))
|
|
22
|
+
.digest("hex")}`;
|
|
23
|
+
}
|
|
24
|
+
function stringValue(value) {
|
|
25
|
+
return typeof value === "string" && value.trim() !== ""
|
|
26
|
+
? value
|
|
27
|
+
: undefined;
|
|
28
|
+
}
|
|
29
|
+
const secretNamePattern = /(?:^|[_-])(authorization|api[_-]?key|token|password|passwd|secret|credential|cookie)(?:$|[_-])/i;
|
|
30
|
+
function safeJsonData(value, depth = 0, seen = new Set(), secretContext = false) {
|
|
31
|
+
if (value === null)
|
|
32
|
+
return null;
|
|
33
|
+
if (typeof value === "string" ||
|
|
34
|
+
typeof value === "boolean") {
|
|
35
|
+
return secretContext ? "<redacted>" : value;
|
|
36
|
+
}
|
|
37
|
+
if (typeof value === "number") {
|
|
38
|
+
return Number.isFinite(value)
|
|
39
|
+
? (secretContext ? "<redacted>" : value)
|
|
40
|
+
: undefined;
|
|
41
|
+
}
|
|
42
|
+
if (typeof value !== "object" || depth > 12) {
|
|
43
|
+
return undefined;
|
|
44
|
+
}
|
|
45
|
+
const objectValue = value;
|
|
46
|
+
if (seen.has(objectValue))
|
|
47
|
+
return undefined;
|
|
48
|
+
const prototype = Object.getPrototypeOf(value);
|
|
49
|
+
if (!Array.isArray(value) &&
|
|
50
|
+
prototype !== Object.prototype &&
|
|
51
|
+
prototype !== null) {
|
|
52
|
+
return undefined;
|
|
53
|
+
}
|
|
54
|
+
seen.add(objectValue);
|
|
55
|
+
try {
|
|
56
|
+
if (Array.isArray(value)) {
|
|
57
|
+
const output = [];
|
|
58
|
+
for (let index = 0; index < value.length; index++) {
|
|
59
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
|
|
60
|
+
if (!descriptor || !("value" in descriptor)) {
|
|
61
|
+
return undefined;
|
|
62
|
+
}
|
|
63
|
+
const item = safeJsonData(descriptor.value, depth + 1, seen, secretContext);
|
|
64
|
+
if (item === undefined)
|
|
65
|
+
return undefined;
|
|
66
|
+
output.push(item);
|
|
67
|
+
}
|
|
68
|
+
return output;
|
|
69
|
+
}
|
|
70
|
+
const output = {};
|
|
71
|
+
const descriptors = Object.getOwnPropertyDescriptors(value);
|
|
72
|
+
for (const [key, descriptor] of Object.entries(descriptors)) {
|
|
73
|
+
if (!("value" in descriptor))
|
|
74
|
+
continue;
|
|
75
|
+
if (descriptor.value === undefined)
|
|
76
|
+
continue;
|
|
77
|
+
const child = safeJsonData(descriptor.value, depth + 1, seen, secretContext || secretNamePattern.test(key));
|
|
78
|
+
if (child !== undefined) {
|
|
79
|
+
output[key] = child;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
return output;
|
|
83
|
+
}
|
|
84
|
+
finally {
|
|
85
|
+
seen.delete(objectValue);
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
function langChainTools(input) {
|
|
89
|
+
if (Array.isArray(input))
|
|
90
|
+
return input;
|
|
91
|
+
const record = asRecord(input);
|
|
92
|
+
if (!record)
|
|
93
|
+
return [];
|
|
94
|
+
const tools = ownDataValue(record, "tools");
|
|
95
|
+
return Array.isArray(tools) ? tools : [];
|
|
96
|
+
}
|
|
97
|
+
function openAiFormattedFunction(tool) {
|
|
98
|
+
const type = stringValue(ownDataValue(tool, "type"));
|
|
99
|
+
if (type !== "function")
|
|
100
|
+
return undefined;
|
|
101
|
+
return asRecord(ownDataValue(tool, "function"));
|
|
102
|
+
}
|
|
103
|
+
function observeLangChainTool(rawTool, evidence, source, index, runtimeName) {
|
|
104
|
+
const tool = asRecord(rawTool);
|
|
105
|
+
if (!tool)
|
|
106
|
+
return undefined;
|
|
107
|
+
const formatted = openAiFormattedFunction(tool);
|
|
108
|
+
const name = stringValue(ownDataValue(tool, "name")) ??
|
|
109
|
+
stringValue(ownDataValue(formatted, "name"));
|
|
110
|
+
if (!name)
|
|
111
|
+
return undefined;
|
|
112
|
+
const description = stringValue(ownDataValue(tool, "description")) ??
|
|
113
|
+
stringValue(ownDataValue(formatted, "description")) ??
|
|
114
|
+
"";
|
|
115
|
+
const rawSchema = ownDataValue(tool, "schema") ??
|
|
116
|
+
ownDataValue(tool, "inputSchema") ??
|
|
117
|
+
ownDataValue(tool, "parameters") ??
|
|
118
|
+
ownDataValue(formatted, "parameters");
|
|
119
|
+
const schema = safeJsonData(rawSchema);
|
|
120
|
+
const schemaOpaque = rawSchema !== undefined &&
|
|
121
|
+
schema === undefined;
|
|
122
|
+
const autoExecutable = [
|
|
123
|
+
ownDataValue(tool, "invoke"),
|
|
124
|
+
ownDataValue(tool, "call"),
|
|
125
|
+
ownDataValue(tool, "func"),
|
|
126
|
+
].some(value => typeof value === "function");
|
|
127
|
+
const rawReturnDirect = ownDataValue(tool, "returnDirect");
|
|
128
|
+
const returnDirect = typeof rawReturnDirect === "boolean"
|
|
129
|
+
? rawReturnDirect
|
|
130
|
+
: undefined;
|
|
131
|
+
const namespace = `langchain/${runtimeName ?? "runtime"}`;
|
|
132
|
+
const toolType = formatted
|
|
133
|
+
? "function"
|
|
134
|
+
: "structured_tool";
|
|
135
|
+
const safeMetadata = {
|
|
136
|
+
autoExecutable,
|
|
137
|
+
...(schemaOpaque ? { schemaOpaque: true } : {}),
|
|
138
|
+
...(returnDirect !== undefined ? { returnDirect } : {}),
|
|
139
|
+
};
|
|
140
|
+
const once = assessToolImportance({
|
|
141
|
+
name,
|
|
142
|
+
description,
|
|
143
|
+
sourceCategory: toolType,
|
|
144
|
+
evidence,
|
|
145
|
+
readOnlyHint: /(?:^|[_-])(?:search|lookup|retrieve|fetch|get|list|read|find)(?:$|[_-])/i.test(name)
|
|
146
|
+
? true
|
|
147
|
+
: undefined,
|
|
148
|
+
});
|
|
149
|
+
return {
|
|
150
|
+
toolId: stableId({
|
|
151
|
+
framework: "langchain",
|
|
152
|
+
namespace,
|
|
153
|
+
name,
|
|
154
|
+
toolType,
|
|
155
|
+
description,
|
|
156
|
+
schema,
|
|
157
|
+
}),
|
|
158
|
+
namespacedName: `${namespace}/${name}`,
|
|
159
|
+
canonicalName: name,
|
|
160
|
+
displayName: name,
|
|
161
|
+
description,
|
|
162
|
+
toolType,
|
|
163
|
+
framework: "langchain",
|
|
164
|
+
origin: {
|
|
165
|
+
kind: "runtime",
|
|
166
|
+
source,
|
|
167
|
+
...(runtimeName ? { runtimeName } : {}),
|
|
168
|
+
index,
|
|
169
|
+
},
|
|
170
|
+
evidence: {
|
|
171
|
+
level: evidence,
|
|
172
|
+
source: `${namespace}:${source}`,
|
|
173
|
+
},
|
|
174
|
+
visibility: {
|
|
175
|
+
configured: true,
|
|
176
|
+
runtimeRegistered: true,
|
|
177
|
+
modelVisible: evidence === "MODEL_VISIBLE",
|
|
178
|
+
executed: false,
|
|
179
|
+
},
|
|
180
|
+
...(schema !== undefined ? { inputSchema: schema } : {}),
|
|
181
|
+
safeMetadata,
|
|
182
|
+
once,
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
function discover(input, evidence, source, runtimeName) {
|
|
186
|
+
return langChainTools(input)
|
|
187
|
+
.map((tool, index) => observeLangChainTool(tool, evidence, source, index, runtimeName))
|
|
188
|
+
.filter((tool) => Boolean(tool));
|
|
189
|
+
}
|
|
190
|
+
export function discoverLangChainRegisteredTools(toolsOrAgentConfig, runtimeName) {
|
|
191
|
+
const tools = discover(toolsOrAgentConfig, "RUNTIME_REGISTERED", "langchain.tools", runtimeName);
|
|
192
|
+
return {
|
|
193
|
+
framework: "langchain",
|
|
194
|
+
...(runtimeName ? { runtimeName } : {}),
|
|
195
|
+
registeredToolCount: tools.length,
|
|
196
|
+
tools,
|
|
197
|
+
externalCallsMade: false,
|
|
198
|
+
toolInvocationsMade: false,
|
|
199
|
+
secretValuesRetained: false,
|
|
200
|
+
};
|
|
201
|
+
}
|
|
202
|
+
export function discoverLangChainModelVisibleTools(toolsPassedToBindTools, runtimeName) {
|
|
203
|
+
const tools = discover(toolsPassedToBindTools, "MODEL_VISIBLE", "langchain.bindTools", runtimeName);
|
|
204
|
+
return {
|
|
205
|
+
framework: "langchain",
|
|
206
|
+
...(runtimeName ? { runtimeName } : {}),
|
|
207
|
+
modelVisibleToolCount: tools.length,
|
|
208
|
+
tools,
|
|
209
|
+
externalCallsMade: false,
|
|
210
|
+
toolInvocationsMade: false,
|
|
211
|
+
secretValuesRetained: false,
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
//# sourceMappingURL=langchain-runtime-discovery.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"langchain-runtime-discovery.js","sourceRoot":"","sources":["../src/langchain-runtime-discovery.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { type ToolImportanceAssessment } from "./tool-importance.js";
|
|
2
|
+
import type { ConfiguredToolSource } from "./tool-discovery.js";
|
|
3
|
+
export type McpProtocolEra = "MODERN_2026" | "LEGACY_2025";
|
|
4
|
+
export type McpLiveProbeStatus = "ENUMERATED" | "SKIPPED_STDIO" | "SKIPPED_UNSUPPORTED_TRANSPORT" | "FAILED";
|
|
5
|
+
export type McpLiveProbe = {
|
|
6
|
+
sourceId: string;
|
|
7
|
+
source: string;
|
|
8
|
+
status: McpLiveProbeStatus;
|
|
9
|
+
endpoint?: string;
|
|
10
|
+
protocolEra?: McpProtocolEra;
|
|
11
|
+
protocolVersion?: string;
|
|
12
|
+
pages: number;
|
|
13
|
+
toolCount: number;
|
|
14
|
+
errorCode?: string;
|
|
15
|
+
};
|
|
16
|
+
export type McpAuthoritativeToolRecord = {
|
|
17
|
+
toolId: string;
|
|
18
|
+
canonicalName: string;
|
|
19
|
+
displayName: string;
|
|
20
|
+
description: string;
|
|
21
|
+
origin: {
|
|
22
|
+
kind: "mcp";
|
|
23
|
+
host: string;
|
|
24
|
+
server: string;
|
|
25
|
+
scope: "PROJECT" | "USER";
|
|
26
|
+
};
|
|
27
|
+
source: {
|
|
28
|
+
sourceId: string;
|
|
29
|
+
endpoint: string;
|
|
30
|
+
};
|
|
31
|
+
evidence: {
|
|
32
|
+
level: "SERVER_AUTHORITATIVE";
|
|
33
|
+
source: string;
|
|
34
|
+
};
|
|
35
|
+
visibility: {
|
|
36
|
+
configured: true;
|
|
37
|
+
runtimeRegistered: false;
|
|
38
|
+
modelVisible: false;
|
|
39
|
+
executed: false;
|
|
40
|
+
};
|
|
41
|
+
inputSchema?: unknown;
|
|
42
|
+
annotations?: {
|
|
43
|
+
title?: string;
|
|
44
|
+
readOnlyHint?: boolean;
|
|
45
|
+
destructiveHint?: boolean;
|
|
46
|
+
idempotentHint?: boolean;
|
|
47
|
+
openWorldHint?: boolean;
|
|
48
|
+
};
|
|
49
|
+
once: ToolImportanceAssessment;
|
|
50
|
+
};
|
|
51
|
+
export type McpLiveDiscoveryResult = {
|
|
52
|
+
mode: "EXPLICIT_REMOTE_HTTP";
|
|
53
|
+
externalServersContacted: number;
|
|
54
|
+
stdioServersLaunched: false;
|
|
55
|
+
redirectsFollowed: false;
|
|
56
|
+
secretValuesRetained: false;
|
|
57
|
+
probes: McpLiveProbe[];
|
|
58
|
+
tools: McpAuthoritativeToolRecord[];
|
|
59
|
+
};
|
|
60
|
+
export type McpLiveDiscoveryOptions = {
|
|
61
|
+
timeoutMs?: number;
|
|
62
|
+
maxPages?: number;
|
|
63
|
+
maxTools?: number;
|
|
64
|
+
maxResponseBytes?: number;
|
|
65
|
+
};
|
|
66
|
+
export declare class McpLiveDiscoveryError extends Error {
|
|
67
|
+
readonly code: string;
|
|
68
|
+
constructor(code: string, message: string);
|
|
69
|
+
}
|
|
70
|
+
export declare function discoverLiveMcpTools(root: string, configuredSources: readonly ConfiguredToolSource[], selectors: readonly string[], options?: McpLiveDiscoveryOptions): Promise<McpLiveDiscoveryResult>;
|
|
71
|
+
//# sourceMappingURL=mcp-live-discovery.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-live-discovery.d.ts","sourceRoot":"","sources":["../src/mcp-live-discovery.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAS7B,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,eAAe,GACf,+BAA+B,GAC/B,QAAQ,CAAC;AAEb,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;KAC3B,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,sBAAsB,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,IAAI,CAAC;QACjB,iBAAiB,EAAE,KAAK,CAAC;QACzB,YAAY,EAAE,KAAK,CAAC;QACpB,QAAQ,EAAE,KAAK,CAAC;KACjB,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,IAAI,EAAE,wBAAwB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,KAAK,CAAC;IAC5B,iBAAiB,EAAE,KAAK,CAAC;IACzB,oBAAoB,EAAE,KAAK,CAAC;IAC5B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAeF,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAq5BD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,SAAS,oBAAoB,EAAE,EAClD,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA2EjC"}
|