@coalex-ai/sdk 1.15.0-beta.262 → 1.17.0-beta.392
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/agents.d.ts.map +1 -1
- package/dist/agents.js +3 -2
- package/dist/agents.js.map +1 -1
- package/dist/auto-instrument.d.ts.map +1 -1
- package/dist/auto-instrument.js +3 -2
- package/dist/auto-instrument.js.map +1 -1
- package/dist/decision-request.d.ts +37 -2
- package/dist/decision-request.d.ts.map +1 -1
- package/dist/decision-request.js +74 -4
- package/dist/decision-request.js.map +1 -1
- package/dist/evaluate.d.ts +5 -0
- package/dist/evaluate.d.ts.map +1 -1
- package/dist/evaluate.js +29 -4
- package/dist/evaluate.js.map +1 -1
- package/dist/ext/tool.d.ts.map +1 -1
- package/dist/ext/tool.js +13 -0
- package/dist/ext/tool.js.map +1 -1
- package/dist/http.d.ts +29 -0
- package/dist/http.d.ts.map +1 -0
- package/dist/http.js +43 -0
- package/dist/http.js.map +1 -0
- package/dist/index.d.ts +19 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -1
- package/dist/inventory.d.ts +30 -0
- package/dist/inventory.d.ts.map +1 -0
- package/dist/inventory.js +54 -0
- package/dist/inventory.js.map +1 -0
- package/dist/logger.d.ts +31 -0
- package/dist/logger.d.ts.map +1 -0
- package/dist/logger.js +28 -0
- package/dist/logger.js.map +1 -0
- package/dist/prompts.d.ts.map +1 -1
- package/dist/prompts.js +3 -2
- package/dist/prompts.js.map +1 -1
- package/dist/resolve.d.ts +16 -1
- package/dist/resolve.d.ts.map +1 -1
- package/dist/resolve.js +24 -6
- package/dist/resolve.js.map +1 -1
- package/dist/safe-exporter.d.ts +24 -0
- package/dist/safe-exporter.d.ts.map +1 -1
- package/dist/safe-exporter.js +51 -25
- package/dist/safe-exporter.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/dist/agents.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiC1F"}
|
package/dist/agents.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { getConfig, getApiKey } from "./index.js";
|
|
2
|
+
import { coalexFetch, httpError } from "./http.js";
|
|
2
3
|
export async function declareAgent(options) {
|
|
3
4
|
const config = getConfig();
|
|
4
5
|
const apiKey = getApiKey();
|
|
@@ -11,7 +12,7 @@ export async function declareAgent(options) {
|
|
|
11
12
|
if (options.metadata !== undefined) {
|
|
12
13
|
payload.metadata = options.metadata;
|
|
13
14
|
}
|
|
14
|
-
const resp = await
|
|
15
|
+
const resp = await coalexFetch("declareAgent()", `${config.endpoint}/api/v1/agents`, {
|
|
15
16
|
method: "POST",
|
|
16
17
|
headers: {
|
|
17
18
|
"Content-Type": "application/json",
|
|
@@ -20,7 +21,7 @@ export async function declareAgent(options) {
|
|
|
20
21
|
body: JSON.stringify(payload),
|
|
21
22
|
});
|
|
22
23
|
if (!resp.ok) {
|
|
23
|
-
throw
|
|
24
|
+
throw await httpError("declareAgent()", resp);
|
|
24
25
|
}
|
|
25
26
|
const data = await resp.json();
|
|
26
27
|
return {
|
package/dist/agents.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAcnD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,OAAO,GAA4B;QACvC,QAAQ,EAAE,OAAO,CAAC,OAAO;KAC1B,CAAC;IACF,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,QAAQ,gBAAgB,EAAE;QACnF,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,MAAM,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,QAAQ;QACtB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auto-instrument.d.ts","sourceRoot":"","sources":["../src/auto-instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"auto-instrument.d.ts","sourceRoot":"","sources":["../src/auto-instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,eAAe,GACf,sBAAsB,GACtB,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAwED,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAuCvC;AAED,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAoBhD;AAED,wBAAgB,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAMzE;AAED,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAM5E;AAED,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAM5E"}
|
package/dist/auto-instrument.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { log } from "./logger.js";
|
|
1
2
|
const INSTRUMENTORS = [
|
|
2
3
|
{
|
|
3
4
|
name: "openai",
|
|
@@ -29,7 +30,7 @@ async function instrumentLibrary(config, tracerProvider, suppressErrors = true)
|
|
|
29
30
|
}
|
|
30
31
|
const InstrumentorClass = mod[config.class];
|
|
31
32
|
if (!InstrumentorClass) {
|
|
32
|
-
|
|
33
|
+
log.warn(`Found ${config.package} but missing ${config.class} export`);
|
|
33
34
|
return "error";
|
|
34
35
|
}
|
|
35
36
|
const instrumentor = new InstrumentorClass();
|
|
@@ -46,7 +47,7 @@ async function instrumentLibrary(config, tracerProvider, suppressErrors = true)
|
|
|
46
47
|
catch (e) {
|
|
47
48
|
const msg = e instanceof Error ? e.message : String(e);
|
|
48
49
|
if (suppressErrors) {
|
|
49
|
-
|
|
50
|
+
log.warn(`Failed to instrument ${config.name}: ${msg}`);
|
|
50
51
|
return "error";
|
|
51
52
|
}
|
|
52
53
|
throw e;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auto-instrument.js","sourceRoot":"","sources":["../src/auto-instrument.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"auto-instrument.js","sourceRoot":"","sources":["../src/auto-instrument.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAuBlC,MAAM,aAAa,GAAyB;IAC1C;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,+CAA+C;QACxD,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,YAAY;KAC1B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,kDAAkD;QAC3D,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,WAAW;KACzB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,kDAAkD;QAC3D,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,kBAAkB;KAChC;CACF,CAAC;AAEF,KAAK,UAAU,iBAAiB,CAC9B,MAA0B,EAC1B,cAA+B,EAC/B,cAAc,GAAG,IAAI;IAErB,IAAI,CAAC;QACH,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC;YACvE,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAE7C,IAAI,YAAY,CAAC,8BAA8B,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC;YAC9E,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,YAAY,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC;QACD,YAAY,CAAC,MAAM,EAAE,CAAC;QAEtB,OAAO,CAAC,IAAI,CAAC,sCAAsC,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1F,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,cAAc,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;YACxD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAA+B;IAE/B,MAAM,OAAO,GAA0C,EAAE,CAAC;IAE1D,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,gBAAgB,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,SAAS;QACX,CAAC;QACD,IAAI,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;YAClC,SAAS;QACX,CAAC;QAED,kEAAkE;QAClE,0EAA0E;QAC1E,oEAAoE;QACpE,IAAI,CAAC;YACH,iEAAiE;YACjE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC7C,IAAI,YAAY,CAAC,8BAA8B,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC;gBAC9E,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC;gBAC9C,SAAS;YACX,CAAC;YACD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;gBAC5B,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACzD,CAAC;YACD,YAAY,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA+B;IAE/B,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC;IACvD,MAAM,OAAO,GAA0C,EAAE,CAAC;IAE1D,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,gBAAgB,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,SAAS;QACX,CAAC;QACD,IAAI,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;YAClC,SAAS;QACX,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,iBAAiB,CAC5C,MAAM,EACN,OAAO,EAAE,cAAc,EACvB,cAAc,CACf,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,cAA+B;IAC9D,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,cAAc;QACd,gBAAgB,EAAE,CAAC,QAAQ,CAAC;KAC7B,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,cAA+B;IACjE,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,cAAc;QACd,gBAAgB,EAAE,CAAC,WAAW,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,cAA+B;IACjE,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,cAAc;QACd,gBAAgB,EAAE,CAAC,WAAW,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC;AACxC,CAAC"}
|
|
@@ -77,8 +77,41 @@ export interface QuestionSchema {
|
|
|
77
77
|
required: string[];
|
|
78
78
|
}
|
|
79
79
|
/**
|
|
80
|
-
*
|
|
81
|
-
*
|
|
80
|
+
* Fields a Decision Request must never carry to an approver (spec §6, COA-2187).
|
|
81
|
+
*
|
|
82
|
+
* Anchoring: a reviewer told the agent was 94% confident does not review, they ratify. The Python
|
|
83
|
+
* SDK has filtered these since the composer existed and the Console has filtered them at render
|
|
84
|
+
* since COA-1739 — **this SDK filtered nothing**, and the JSDoc below claimed otherwise. So a
|
|
85
|
+
* TypeScript producer whose agent put `{answer, confidence: 0.94}` in the output had that
|
|
86
|
+
* confidence served to every other client of the Decision Requests API, and the anchoring the whole
|
|
87
|
+
* of §6 exists to prevent was live in that organisation.
|
|
88
|
+
*
|
|
89
|
+
* Kept in step with `FORBIDDEN_FIELD_KEYS` in `packages/sdk-python/src/coalex/decision_request.py`
|
|
90
|
+
* and in `apps/console/src/data/decision.ts`. Three copies is one too many; diverging is worse.
|
|
91
|
+
*/
|
|
92
|
+
export declare const FORBIDDEN_FIELD_KEYS: ReadonlySet<string>;
|
|
93
|
+
/** What a Question Composer decides the card shows (spec §6). */
|
|
94
|
+
export interface ComposedQuestion {
|
|
95
|
+
question: string;
|
|
96
|
+
summary?: string;
|
|
97
|
+
output: Record<string, unknown>;
|
|
98
|
+
schema: QuestionSchema;
|
|
99
|
+
}
|
|
100
|
+
/** Decides what an approver sees. A seam, so a better composer changes the card, not the card's code. */
|
|
101
|
+
export interface QuestionComposer {
|
|
102
|
+
compose(escalation: EscalationLike): ComposedQuestion;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* v1 (spec §6): the card shows what the producer sent, minus what §6 keeps out.
|
|
106
|
+
*
|
|
107
|
+
* Deliberately does nothing interesting. Its whole value is that it is a seam — the Python SDK's
|
|
108
|
+
* `IdentityComposer`, in TypeScript.
|
|
109
|
+
*/
|
|
110
|
+
export declare const identityComposer: QuestionComposer;
|
|
111
|
+
/**
|
|
112
|
+
* What the human needs to judge (spec §4.1, §6 de-biasing). `output` is shown as an editable
|
|
113
|
+
* answer, with the agent's reasoning, confidence and risk score removed by the composer — see
|
|
114
|
+
* `FORBIDDEN_FIELD_KEYS`. Until COA-2187 this comment was a claim this SDK did not honour.
|
|
82
115
|
*/
|
|
83
116
|
export interface ContextPayload {
|
|
84
117
|
question: string;
|
|
@@ -153,6 +186,8 @@ export interface FromEscalationOptions {
|
|
|
153
186
|
resumeHook?: ResumeHook;
|
|
154
187
|
/** The composed question shown on the card. Default: identity composer (§6). */
|
|
155
188
|
question?: string;
|
|
189
|
+
/** Decides what the card shows (spec §6). Default: `identityComposer`. */
|
|
190
|
+
composer?: QuestionComposer;
|
|
156
191
|
}
|
|
157
192
|
/**
|
|
158
193
|
* Materialize an escalation as a Decision Request (spec §4, COA-1278). The task state
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"decision-request.d.ts","sourceRoot":"","sources":["../src/decision-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5F,yDAAyD;AACzD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,SAAS,CAM7C,CAAC;AAEH,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhE,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAQ1D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAQ5E;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED
|
|
1
|
+
{"version":3,"file":"decision-request.d.ts","sourceRoot":"","sources":["../src/decision-request.ts"],"names":[],"mappings":"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"}
|
package/dist/decision-request.js
CHANGED
|
@@ -64,6 +64,72 @@ export function resumeHookFromDict(data) {
|
|
|
64
64
|
...(typeof data.task_id === "string" ? { taskId: data.task_id } : {}),
|
|
65
65
|
};
|
|
66
66
|
}
|
|
67
|
+
/**
|
|
68
|
+
* Fields a Decision Request must never carry to an approver (spec §6, COA-2187).
|
|
69
|
+
*
|
|
70
|
+
* Anchoring: a reviewer told the agent was 94% confident does not review, they ratify. The Python
|
|
71
|
+
* SDK has filtered these since the composer existed and the Console has filtered them at render
|
|
72
|
+
* since COA-1739 — **this SDK filtered nothing**, and the JSDoc below claimed otherwise. So a
|
|
73
|
+
* TypeScript producer whose agent put `{answer, confidence: 0.94}` in the output had that
|
|
74
|
+
* confidence served to every other client of the Decision Requests API, and the anchoring the whole
|
|
75
|
+
* of §6 exists to prevent was live in that organisation.
|
|
76
|
+
*
|
|
77
|
+
* Kept in step with `FORBIDDEN_FIELD_KEYS` in `packages/sdk-python/src/coalex/decision_request.py`
|
|
78
|
+
* and in `apps/console/src/data/decision.ts`. Three copies is one too many; diverging is worse.
|
|
79
|
+
*/
|
|
80
|
+
export const FORBIDDEN_FIELD_KEYS = new Set([
|
|
81
|
+
"reasoning",
|
|
82
|
+
"reason", // the agent's rationale — distinct from the operator's decline reason
|
|
83
|
+
"rationale",
|
|
84
|
+
"chain_of_thought",
|
|
85
|
+
"cot",
|
|
86
|
+
"thoughts",
|
|
87
|
+
"confidence",
|
|
88
|
+
"confidence_score",
|
|
89
|
+
"certainty",
|
|
90
|
+
"risk",
|
|
91
|
+
"risk_score",
|
|
92
|
+
"risk_tier",
|
|
93
|
+
"score",
|
|
94
|
+
]);
|
|
95
|
+
/**
|
|
96
|
+
* The curated human-readable `reason` from an escalation's metadata, for the card summary
|
|
97
|
+
* (COA-1758).
|
|
98
|
+
*
|
|
99
|
+
* ONLY this field is surfaced from metadata — never the risk tier, the governed flag or the risk
|
|
100
|
+
* score, which is the same rule the denylist enforces one level up.
|
|
101
|
+
*/
|
|
102
|
+
function reasonFromMetadata(metadata) {
|
|
103
|
+
if (metadata && typeof metadata === "object") {
|
|
104
|
+
const reason = metadata.reason;
|
|
105
|
+
if (typeof reason === "string" && reason.trim())
|
|
106
|
+
return reason;
|
|
107
|
+
}
|
|
108
|
+
return undefined;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* v1 (spec §6): the card shows what the producer sent, minus what §6 keeps out.
|
|
112
|
+
*
|
|
113
|
+
* Deliberately does nothing interesting. Its whole value is that it is a seam — the Python SDK's
|
|
114
|
+
* `IdentityComposer`, in TypeScript.
|
|
115
|
+
*/
|
|
116
|
+
export const identityComposer = {
|
|
117
|
+
compose(escalation) {
|
|
118
|
+
const raw = escalation.output ?? {};
|
|
119
|
+
const output = {};
|
|
120
|
+
for (const [key, value] of Object.entries(raw)) {
|
|
121
|
+
if (!FORBIDDEN_FIELD_KEYS.has(key.toLowerCase()))
|
|
122
|
+
output[key] = value;
|
|
123
|
+
}
|
|
124
|
+
return {
|
|
125
|
+
question: DEFAULT_QUESTION,
|
|
126
|
+
summary: reasonFromMetadata(escalation.metadata),
|
|
127
|
+
output,
|
|
128
|
+
// Derived from the FILTERED output, so a forbidden key cannot come back as a field.
|
|
129
|
+
schema: questionSchemaFromOutput(output, escalation.metrics),
|
|
130
|
+
};
|
|
131
|
+
},
|
|
132
|
+
};
|
|
67
133
|
/**
|
|
68
134
|
* Escalation status -> MCP task state (spec §5). See `fromEscalation` for the full
|
|
69
135
|
* status -> (state, action) reconciliation.
|
|
@@ -136,12 +202,16 @@ export function fromEscalation(escalation, options = {}) {
|
|
|
136
202
|
throw new Error(`unknown escalation status '${status}'; expected one of ${known}`);
|
|
137
203
|
}
|
|
138
204
|
const action = ACTION_BY_STATUS[status];
|
|
139
|
-
|
|
140
|
-
|
|
205
|
+
// Through the composer, not straight from the escalation (COA-2187): this is where §6's
|
|
206
|
+
// forbidden keys are dropped, and where a better composer would change the card.
|
|
207
|
+
const composed = (options.composer ?? identityComposer).compose(escalation);
|
|
208
|
+
const questionSchema = composed.schema;
|
|
141
209
|
const context = {
|
|
142
|
-
question: options.question ??
|
|
143
|
-
output,
|
|
210
|
+
question: options.question ?? composed.question,
|
|
211
|
+
output: composed.output,
|
|
144
212
|
};
|
|
213
|
+
if (composed.summary)
|
|
214
|
+
context.summary = composed.summary;
|
|
145
215
|
if (escalation.input)
|
|
146
216
|
context.input = escalation.input;
|
|
147
217
|
let resolver;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"decision-request.js","sourceRoot":"","sources":["../src/decision-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAA2B,IAAI,GAAG,CAAC;IACzD,SAAS;IACT,gBAAgB;IAChB,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC,CAAC;AAKH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAQrD,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,GAAG,CAAC,CAAC;AAC7E,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,IAAI,GAAuB,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;IACtF,OAAO;QACL,IAAI;QACJ,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;AACJ,CAAC;
|
|
1
|
+
{"version":3,"file":"decision-request.js","sourceRoot":"","sources":["../src/decision-request.ts"],"names":[],"mappings":"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"}
|
package/dist/evaluate.d.ts
CHANGED
|
@@ -2,6 +2,11 @@ import { type ResumeHook } from "./decision-request.js";
|
|
|
2
2
|
export declare const KNOWN_METRICS: Set<string>;
|
|
3
3
|
export interface EvaluationDecision {
|
|
4
4
|
readonly status: "auto_approved" | "escalated" | "rejected";
|
|
5
|
+
/**
|
|
6
|
+
* The same outcome in MCP vocabulary (COA-1790): "escalated" is "input_required". Undefined
|
|
7
|
+
* against an older platform that does not send it yet.
|
|
8
|
+
*/
|
|
9
|
+
readonly taskState?: string;
|
|
5
10
|
readonly riskScore: number;
|
|
6
11
|
readonly escalationId?: string;
|
|
7
12
|
}
|
package/dist/evaluate.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAK7E,eAAO,MAAM,aAAa,aASxB,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AA2BD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsEpF"}
|
package/dist/evaluate.js
CHANGED
|
@@ -2,6 +2,8 @@ import { getConfig, getApiKey } from "./index.js";
|
|
|
2
2
|
import { currentAgentId } from "./context.js";
|
|
3
3
|
import { serializeResumeHook } from "./decision-request.js";
|
|
4
4
|
import { VERSION } from "./version.js";
|
|
5
|
+
import { coalexFetch, httpError } from "./http.js";
|
|
6
|
+
import { log } from "./logger.js";
|
|
5
7
|
export const KNOWN_METRICS = new Set([
|
|
6
8
|
"f1",
|
|
7
9
|
"word_overlap",
|
|
@@ -12,9 +14,31 @@ export const KNOWN_METRICS = new Set([
|
|
|
12
14
|
"levenshtein",
|
|
13
15
|
"contains",
|
|
14
16
|
]);
|
|
17
|
+
/**
|
|
18
|
+
* Options the Python SDK accepts and this one does not (COA-2192).
|
|
19
|
+
*
|
|
20
|
+
* From TypeScript, passing one is a compile error — the earlier and better failure. From plain
|
|
21
|
+
* JavaScript it was silently dropped, and the escalation quietly took the platform's default
|
|
22
|
+
* resolver or TTL with nothing in the caller's code saying so. A `resolver` of `role:manager` that
|
|
23
|
+
* vanishes is the difference between "a manager approved this" and "anyone did".
|
|
24
|
+
*/
|
|
25
|
+
const NOT_IN_THIS_SDK = {
|
|
26
|
+
resolver: "who may resolve the escalation",
|
|
27
|
+
ttlBusinessHours: "how long the approval may wait before it expires",
|
|
28
|
+
ttl_business_hours: "how long the approval may wait before it expires",
|
|
29
|
+
};
|
|
30
|
+
function warnAboutUnsupportedOptions(options) {
|
|
31
|
+
for (const [key, meaning] of Object.entries(NOT_IN_THIS_SDK)) {
|
|
32
|
+
if (key in options) {
|
|
33
|
+
log.warn(`evaluate() ignored '${key}' (${meaning}): it exists in the Python SDK and not in this one, ` +
|
|
34
|
+
"so the platform default applies. See https://docs.coalex.ai/sdk/parity/");
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
15
38
|
export async function evaluate(options) {
|
|
16
39
|
const config = getConfig();
|
|
17
40
|
const apiKey = getApiKey();
|
|
41
|
+
warnAboutUnsupportedOptions(options);
|
|
18
42
|
if (options.metrics) {
|
|
19
43
|
for (const [field, metricList] of Object.entries(options.metrics)) {
|
|
20
44
|
const unknown = metricList.filter((m) => !KNOWN_METRICS.has(m));
|
|
@@ -28,7 +52,7 @@ export async function evaluate(options) {
|
|
|
28
52
|
throw new Error("evaluate() requires 'requestId' (or deprecated 'traceId')");
|
|
29
53
|
}
|
|
30
54
|
if (options.traceId) {
|
|
31
|
-
|
|
55
|
+
log.warn("traceId is deprecated, use requestId instead");
|
|
32
56
|
}
|
|
33
57
|
const agentId = options.agentId ?? currentAgentId();
|
|
34
58
|
const payload = {
|
|
@@ -48,7 +72,7 @@ export async function evaluate(options) {
|
|
|
48
72
|
if (options.resumeHook) {
|
|
49
73
|
payload.resume_hook = serializeResumeHook(options.resumeHook);
|
|
50
74
|
}
|
|
51
|
-
const resp = await
|
|
75
|
+
const resp = await coalexFetch("evaluate()", `${config.endpoint}/api/v1/evaluate`, {
|
|
52
76
|
method: "POST",
|
|
53
77
|
headers: {
|
|
54
78
|
"Content-Type": "application/json",
|
|
@@ -58,16 +82,17 @@ export async function evaluate(options) {
|
|
|
58
82
|
body: JSON.stringify(payload),
|
|
59
83
|
});
|
|
60
84
|
if (!resp.ok) {
|
|
61
|
-
throw
|
|
85
|
+
throw await httpError("evaluate()", resp);
|
|
62
86
|
}
|
|
63
87
|
// COA-261: surface server-side deprecation notices to the caller.
|
|
64
88
|
const deprecation = resp.headers?.get?.("X-Deprecation");
|
|
65
89
|
if (deprecation) {
|
|
66
|
-
|
|
90
|
+
log.warn(`API deprecation: ${deprecation}`);
|
|
67
91
|
}
|
|
68
92
|
const data = await resp.json();
|
|
69
93
|
return {
|
|
70
94
|
status: data.status,
|
|
95
|
+
taskState: data.task_state,
|
|
71
96
|
riskScore: data.risk_score,
|
|
72
97
|
escalationId: data.escalation_id ?? undefined,
|
|
73
98
|
};
|
package/dist/evaluate.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAmB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"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"}
|
package/dist/ext/tool.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/ext/tool.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/ext/tool.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqBD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC7C,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACjC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CA2C5B"}
|
package/dist/ext/tool.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { getParentContext, getTracer } from "./base.js";
|
|
2
|
+
import { SpanStatusCode } from "@opentelemetry/api";
|
|
2
3
|
const MAX_OUTPUT_LEN = 10_000;
|
|
3
4
|
/**
|
|
4
5
|
* Serialize a tool's return value for the `output.value` span attribute.
|
|
@@ -45,8 +46,20 @@ export function toolSpan(options, fn) {
|
|
|
45
46
|
catch {
|
|
46
47
|
// ignore serialization errors
|
|
47
48
|
}
|
|
49
|
+
span.setStatus({ code: SpanStatusCode.OK });
|
|
48
50
|
return result;
|
|
49
51
|
}
|
|
52
|
+
catch (e) {
|
|
53
|
+
// Its two siblings — `guardrail.ts` and `retrieval.ts` — already do this, and only
|
|
54
|
+
// `toolSpan` was left out (COA-2187). `startActiveSpan` does NOT record exceptions the way
|
|
55
|
+
// Python's `start_as_current_span(record_exception=True)` does, so a tool that threw on
|
|
56
|
+
// every call showed up in the trace viewer with status UNSET and no exception event —
|
|
57
|
+
// indistinguishable from success. The developer concluded the tool was fine and looked
|
|
58
|
+
// somewhere else.
|
|
59
|
+
span.setStatus({ code: SpanStatusCode.ERROR, message: String(e) });
|
|
60
|
+
span.recordException(e instanceof Error ? e : new Error(String(e)));
|
|
61
|
+
throw e;
|
|
62
|
+
}
|
|
50
63
|
finally {
|
|
51
64
|
span.end();
|
|
52
65
|
}
|
package/dist/ext/tool.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/ext/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/ext/tool.ts"],"names":[],"mappings":"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"}
|
package/dist/http.d.ts
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The two things every governance call to Coalex has to get right (COA-2187).
|
|
3
|
+
*
|
|
4
|
+
* **A timeout.** Node's `fetch` has none. A swallowed connection — the shape a firewall that drops
|
|
5
|
+
* rather than refuses produces — leaves the promise pending *for ever*. A customer's network policy
|
|
6
|
+
* changes, the agent's `evaluate()` never resolves, the handler is stuck, the pool drains, and the
|
|
7
|
+
* service stops answering, with nothing logged. From outside it looks like THEIR agent hung.
|
|
8
|
+
* `inventory.ts` already passed `AbortSignal.timeout`; the governance paths did not.
|
|
9
|
+
*
|
|
10
|
+
* **The server's reason.** `throw new Error(\`… failed: ${resp.status}\`)` discards the response
|
|
11
|
+
* body, so a 422 says the status and nothing about which field was wrong.
|
|
12
|
+
*/
|
|
13
|
+
/** Long enough for a cold start, short enough that a stuck call fails rather than hangs. */
|
|
14
|
+
export declare const REQUEST_TIMEOUT_MS = 30000;
|
|
15
|
+
/**
|
|
16
|
+
* `fetch` that cannot hang. Everything else is the caller's.
|
|
17
|
+
*
|
|
18
|
+
* A timeout surfaces as an error naming the operation and the limit rather than a bare
|
|
19
|
+
* `TimeoutError`, which is indistinguishable from a dozen other things in a customer's log.
|
|
20
|
+
*/
|
|
21
|
+
export declare function coalexFetch(operation: string, url: string, init?: RequestInit, timeoutMs?: number): Promise<Response>;
|
|
22
|
+
/**
|
|
23
|
+
* The error a non-2xx deserves: the status AND what the server said was wrong.
|
|
24
|
+
*
|
|
25
|
+
* Truncated, because a server can return an HTML error page; 500 characters is enough to name the
|
|
26
|
+
* offending field and short enough not to bury a log.
|
|
27
|
+
*/
|
|
28
|
+
export declare function httpError(operation: string, resp: Response): Promise<Error>;
|
|
29
|
+
//# sourceMappingURL=http.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,WAAgB,EACtB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAIjF"}
|
package/dist/http.js
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The two things every governance call to Coalex has to get right (COA-2187).
|
|
3
|
+
*
|
|
4
|
+
* **A timeout.** Node's `fetch` has none. A swallowed connection — the shape a firewall that drops
|
|
5
|
+
* rather than refuses produces — leaves the promise pending *for ever*. A customer's network policy
|
|
6
|
+
* changes, the agent's `evaluate()` never resolves, the handler is stuck, the pool drains, and the
|
|
7
|
+
* service stops answering, with nothing logged. From outside it looks like THEIR agent hung.
|
|
8
|
+
* `inventory.ts` already passed `AbortSignal.timeout`; the governance paths did not.
|
|
9
|
+
*
|
|
10
|
+
* **The server's reason.** `throw new Error(\`… failed: ${resp.status}\`)` discards the response
|
|
11
|
+
* body, so a 422 says the status and nothing about which field was wrong.
|
|
12
|
+
*/
|
|
13
|
+
/** Long enough for a cold start, short enough that a stuck call fails rather than hangs. */
|
|
14
|
+
export const REQUEST_TIMEOUT_MS = 30_000;
|
|
15
|
+
/**
|
|
16
|
+
* `fetch` that cannot hang. Everything else is the caller's.
|
|
17
|
+
*
|
|
18
|
+
* A timeout surfaces as an error naming the operation and the limit rather than a bare
|
|
19
|
+
* `TimeoutError`, which is indistinguishable from a dozen other things in a customer's log.
|
|
20
|
+
*/
|
|
21
|
+
export async function coalexFetch(operation, url, init = {}, timeoutMs = REQUEST_TIMEOUT_MS) {
|
|
22
|
+
try {
|
|
23
|
+
return await fetch(url, { ...init, signal: init.signal ?? AbortSignal.timeout(timeoutMs) });
|
|
24
|
+
}
|
|
25
|
+
catch (err) {
|
|
26
|
+
if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError")) {
|
|
27
|
+
throw new Error(`${operation} timed out after ${timeoutMs}ms`);
|
|
28
|
+
}
|
|
29
|
+
throw new Error(`${operation} could not reach Coalex: ${String(err)}`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* The error a non-2xx deserves: the status AND what the server said was wrong.
|
|
34
|
+
*
|
|
35
|
+
* Truncated, because a server can return an HTML error page; 500 characters is enough to name the
|
|
36
|
+
* offending field and short enough not to bury a log.
|
|
37
|
+
*/
|
|
38
|
+
export async function httpError(operation, resp) {
|
|
39
|
+
const detail = await resp.text().catch(() => "");
|
|
40
|
+
const suffix = detail.trim() ? `: ${detail.trim().slice(0, 500)}` : "";
|
|
41
|
+
return new Error(`${operation} failed: ${resp.status} ${resp.statusText}${suffix}`);
|
|
42
|
+
}
|
|
43
|
+
//# sourceMappingURL=http.js.map
|
package/dist/http.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,GAAW,EACX,OAAoB,EAAE,EACtB,YAAoB,kBAAkB;IAEtC,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,CAAC;YACvF,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,oBAAoB,SAAS,IAAI,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,4BAA4B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,IAAc;IAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,IAAI,KAAK,CAAC,GAAG,SAAS,YAAY,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;AACtF,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import type { CoalexConfig } from "./config.js";
|
|
2
|
+
import type { AgentInventory } from "./inventory.js";
|
|
3
|
+
import { type CoalexLogger } from "./logger.js";
|
|
2
4
|
export type { CoalexConfig } from "./config.js";
|
|
3
5
|
export { coalexContext, coalexContextSync, currentAgentId } from "./context.js";
|
|
4
6
|
export type { CoalexContextOptions } from "./context.js";
|
|
@@ -11,9 +13,12 @@ export type { DecisionRequest, TaskState, ElicitationAction, ElicitationResult,
|
|
|
11
13
|
export { getPrompt } from "./prompts.js";
|
|
12
14
|
export type { GetPromptOptions, PromptVersion } from "./prompts.js";
|
|
13
15
|
export { declareAgent } from "./agents.js";
|
|
16
|
+
export { declareInventory } from "./inventory.js";
|
|
17
|
+
export type { AgentInventory } from "./inventory.js";
|
|
14
18
|
export type { AgentDeclaration, DeclareAgentOptions } from "./agents.js";
|
|
15
19
|
export { autoInstrument, autoInstrumentAsync, instrumentOpenAI, instrumentLangChain, instrumentAnthropic } from "./auto-instrument.js";
|
|
16
20
|
export type { AutoInstrumentOptions, InstrumentationStatus } from "./auto-instrument.js";
|
|
21
|
+
export type { CoalexLogger } from "./logger.js";
|
|
17
22
|
export declare function getConfig(): CoalexConfig;
|
|
18
23
|
export declare function getApiKey(): string;
|
|
19
24
|
export interface RegisterOptions {
|
|
@@ -22,6 +27,20 @@ export interface RegisterOptions {
|
|
|
22
27
|
serviceName?: string;
|
|
23
28
|
filterNonAiSpans?: boolean;
|
|
24
29
|
suppressExportErrors?: boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Where this SDK's diagnostics go (COA-2192). Defaults to `console`; pass your own logger to
|
|
32
|
+
* route them into your structured logging, or `null` to silence them.
|
|
33
|
+
*
|
|
34
|
+
* Every diagnostic used to be an unconditional `console.warn` into your service's stderr, which
|
|
35
|
+
* is a defect on its own and a peculiar one in a product that sells observability.
|
|
36
|
+
*/
|
|
37
|
+
logger?: CoalexLogger | null;
|
|
38
|
+
/**
|
|
39
|
+
* Optionally tell the platform where this agent lives and what tools it has (COA-1969), so it
|
|
40
|
+
* appears in the Console without anyone registering it by hand. Best-effort: a failure is
|
|
41
|
+
* logged and startup continues. Omit it and `register()` makes no network call at all.
|
|
42
|
+
*/
|
|
43
|
+
declare?: AgentInventory;
|
|
25
44
|
}
|
|
26
45
|
export declare function register(options?: RegisterOptions): void;
|
|
27
46
|
/** Reset SDK state — for testing only. */
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvI,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvI,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAmCxD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}
|