agentblueprint 0.6.19 → 0.6.22
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/__tests__/renderers.test.js +520 -2
- package/dist/__tests__/renderers.test.js.map +1 -1
- package/dist/__tests__/tools.test.js +200 -2
- package/dist/__tests__/tools.test.js.map +1 -1
- package/dist/client.d.ts +75 -0
- package/dist/client.js +6 -0
- package/dist/client.js.map +1 -1
- package/dist/download.js +17 -1
- package/dist/download.js.map +1 -1
- package/dist/renderers.d.ts +4 -0
- package/dist/renderers.js +724 -28
- package/dist/renderers.js.map +1 -1
- package/dist/server.js +26 -0
- package/dist/server.js.map +1 -1
- package/dist/tools/download-blueprint.js +17 -3
- package/dist/tools/download-blueprint.js.map +1 -1
- package/dist/tools/get-progress.d.ts +17 -0
- package/dist/tools/get-progress.js +73 -0
- package/dist/tools/get-progress.js.map +1 -0
- package/dist/tools/report-metric.d.ts +26 -0
- package/dist/tools/report-metric.js +45 -0
- package/dist/tools/report-metric.js.map +1 -0
- package/package.json +1 -1
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { formatError } from '../errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* Format a human-readable progress summary for the agent.
|
|
4
|
+
*/
|
|
5
|
+
function formatProgress(result) {
|
|
6
|
+
const lines = [];
|
|
7
|
+
lines.push(`Progress: ${result.blueprintTitle}`);
|
|
8
|
+
lines.push(`Blueprint: ${result.blueprintId}`);
|
|
9
|
+
lines.push('');
|
|
10
|
+
// Implementation state (Phase 2A)
|
|
11
|
+
if (result.implementationState) {
|
|
12
|
+
const is = result.implementationState;
|
|
13
|
+
lines.push(`Implementation: ${is.implementedCount}/${is.agentCount} agents (${is.overallStatus})`);
|
|
14
|
+
lines.push(`Last synced: ${is.lastSyncedAt}`);
|
|
15
|
+
lines.push('');
|
|
16
|
+
}
|
|
17
|
+
// Summary
|
|
18
|
+
const { summary } = result;
|
|
19
|
+
lines.push(`Metrics: ${summary.metricsRecorded}/${summary.totalTargets} targets measured`);
|
|
20
|
+
if (summary.metricsRecorded > 0) {
|
|
21
|
+
lines.push(` On track: ${summary.onTrack}`);
|
|
22
|
+
if (summary.minorDeviation > 0)
|
|
23
|
+
lines.push(` Minor deviation: ${summary.minorDeviation}`);
|
|
24
|
+
if (summary.majorDeviation > 0)
|
|
25
|
+
lines.push(` Major deviation: ${summary.majorDeviation}`);
|
|
26
|
+
}
|
|
27
|
+
// Per-metric detail
|
|
28
|
+
if (result.actuals.length > 0) {
|
|
29
|
+
lines.push('');
|
|
30
|
+
lines.push('Latest measurements:');
|
|
31
|
+
for (const actual of result.actuals) {
|
|
32
|
+
const statusIcon = actual.status === 'on_track' ? '[OK]'
|
|
33
|
+
: actual.status === 'minor_deviation' ? '[MINOR]'
|
|
34
|
+
: '[MAJOR]';
|
|
35
|
+
const target = actual.predictedValue && actual.predictedValue !== 'N/A'
|
|
36
|
+
? ` (target: ${actual.predictedValue}, deviation: ${actual.deviationPercent}%)`
|
|
37
|
+
: '';
|
|
38
|
+
const count = actual.recordingCount > 1 ? ` [${actual.recordingCount} recordings]` : '';
|
|
39
|
+
lines.push(` ${statusIcon} ${actual.metricName}: ${actual.actualValue}${target}${count}`);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
// Unmeasured targets
|
|
43
|
+
const allTargetNames = [
|
|
44
|
+
...result.targets.operational.map((t) => t.name),
|
|
45
|
+
...result.targets.financial.map((t) => t.name),
|
|
46
|
+
];
|
|
47
|
+
const measuredNames = new Set(result.actuals.map((a) => a.metricName.toLowerCase()));
|
|
48
|
+
const unmeasured = allTargetNames.filter((n) => !measuredNames.has(n.toLowerCase()));
|
|
49
|
+
if (unmeasured.length > 0) {
|
|
50
|
+
lines.push('');
|
|
51
|
+
lines.push('Not yet measured:');
|
|
52
|
+
for (const name of unmeasured) {
|
|
53
|
+
lines.push(` - ${name}`);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return lines.join('\n');
|
|
57
|
+
}
|
|
58
|
+
export async function handleGetProgress(client, args) {
|
|
59
|
+
try {
|
|
60
|
+
const result = await client.getProgress(args.blueprintId, args.customerOrgId);
|
|
61
|
+
const text = formatProgress(result);
|
|
62
|
+
return {
|
|
63
|
+
content: [{ type: 'text', text }],
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
catch (err) {
|
|
67
|
+
return {
|
|
68
|
+
content: [{ type: 'text', text: formatError(err) }],
|
|
69
|
+
isError: true,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=get-progress.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-progress.js","sourceRoot":"","sources":["../../src/tools/get-progress.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { AgentBlueprintClient } from '../client.js';
|
|
2
|
+
export declare function handleReportMetric(client: AgentBlueprintClient, args: {
|
|
3
|
+
blueprintId: string;
|
|
4
|
+
metrics: Array<{
|
|
5
|
+
metricName: string;
|
|
6
|
+
actualValue: string;
|
|
7
|
+
metricType?: 'operational' | 'financial';
|
|
8
|
+
metricUnit?: string;
|
|
9
|
+
baselineValue?: string;
|
|
10
|
+
notes?: string;
|
|
11
|
+
measuredAt?: string;
|
|
12
|
+
}>;
|
|
13
|
+
customerOrgId?: string;
|
|
14
|
+
}): Promise<{
|
|
15
|
+
content: {
|
|
16
|
+
type: "text";
|
|
17
|
+
text: string;
|
|
18
|
+
}[];
|
|
19
|
+
isError?: undefined;
|
|
20
|
+
} | {
|
|
21
|
+
content: {
|
|
22
|
+
type: "text";
|
|
23
|
+
text: string;
|
|
24
|
+
}[];
|
|
25
|
+
isError: boolean;
|
|
26
|
+
}>;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { formatError } from '../errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* Format a human-readable summary of the metric report for the agent.
|
|
4
|
+
*/
|
|
5
|
+
function formatReportSummary(result) {
|
|
6
|
+
const lines = [];
|
|
7
|
+
lines.push(`Reported ${result.summary.succeeded}/${result.summary.total} metrics.`);
|
|
8
|
+
if (result.summary.failed > 0) {
|
|
9
|
+
lines.push(`${result.summary.failed} failed.`);
|
|
10
|
+
}
|
|
11
|
+
lines.push('');
|
|
12
|
+
for (const r of result.results) {
|
|
13
|
+
if (r.error) {
|
|
14
|
+
lines.push(`[FAIL] ${r.metricName}: ${r.error}`);
|
|
15
|
+
continue;
|
|
16
|
+
}
|
|
17
|
+
const statusIcon = r.status === 'on_track' ? '[OK]'
|
|
18
|
+
: r.status === 'minor_deviation' ? '[MINOR]'
|
|
19
|
+
: '[MAJOR]';
|
|
20
|
+
const target = r.predictedValue && r.predictedValue !== 'N/A'
|
|
21
|
+
? ` (target: ${r.predictedValue}, deviation: ${r.deviationPercent}%)`
|
|
22
|
+
: ' (no target in blueprint)';
|
|
23
|
+
lines.push(`${statusIcon} ${r.metricName}: ${r.actualValue}${target}`);
|
|
24
|
+
for (const w of r.warnings) {
|
|
25
|
+
lines.push(` ! ${w}`);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
return lines.join('\n');
|
|
29
|
+
}
|
|
30
|
+
export async function handleReportMetric(client, args) {
|
|
31
|
+
try {
|
|
32
|
+
const result = await client.reportMetrics(args.blueprintId, args.metrics, 'mcp', args.customerOrgId);
|
|
33
|
+
const summary = formatReportSummary(result);
|
|
34
|
+
return {
|
|
35
|
+
content: [{ type: 'text', text: summary }],
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
catch (err) {
|
|
39
|
+
return {
|
|
40
|
+
content: [{ type: 'text', text: formatError(err) }],
|
|
41
|
+
isError: true,
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=report-metric.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"report-metric.js","sourceRoot":"","sources":["../../src/tools/report-metric.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAA6B;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,CAAC,CAAC;IAEpF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GACd,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM;YAChC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC,CAAC,SAAS;gBAC5C,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,MAAM,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,cAAc,KAAK,KAAK;YAC3D,CAAC,CAAC,aAAa,CAAC,CAAC,cAAc,gBAAgB,CAAC,CAAC,gBAAgB,IAAI;YACrE,CAAC,CAAC,2BAA2B,CAAC;QAEhC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,EAAE,CAAC,CAAC;QAEvE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA4B,EAC5B,IAYC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CACvC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,EACZ,KAAK,EACL,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}
|
package/package.json
CHANGED