agentfootprint 2.8.0 → 2.8.2
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 +157 -394
- package/dist/adapters/observability/agentcore.js +64 -0
- package/dist/adapters/observability/agentcore.js.map +1 -0
- package/dist/adapters/observability/cloudwatch.js +203 -0
- package/dist/adapters/observability/cloudwatch.js.map +1 -0
- package/dist/esm/adapters/observability/agentcore.js +60 -0
- package/dist/esm/adapters/observability/agentcore.js.map +1 -0
- package/dist/esm/adapters/observability/cloudwatch.js +198 -0
- package/dist/esm/adapters/observability/cloudwatch.js.map +1 -0
- package/dist/esm/observability-providers.js +38 -0
- package/dist/esm/observability-providers.js.map +1 -0
- package/dist/esm/strategies/index.js +22 -8
- package/dist/esm/strategies/index.js.map +1 -1
- package/dist/observability-providers.js +43 -0
- package/dist/observability-providers.js.map +1 -0
- package/dist/strategies/index.js +22 -8
- package/dist/strategies/index.js.map +1 -1
- package/dist/types/adapters/observability/agentcore.d.ts +67 -0
- package/dist/types/adapters/observability/agentcore.d.ts.map +1 -0
- package/dist/types/adapters/observability/cloudwatch.d.ts +97 -0
- package/dist/types/adapters/observability/cloudwatch.d.ts.map +1 -0
- package/dist/types/observability-providers.d.ts +38 -0
- package/dist/types/observability-providers.d.ts.map +1 -0
- package/dist/types/strategies/index.d.ts +22 -8
- package/dist/types/strategies/index.d.ts.map +1 -1
- package/package.json +10 -1
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* agentfootprint/observability-providers — vendor observability strategies.
|
|
4
|
+
*
|
|
5
|
+
* Grouped subpath following the parallel-providers pattern v2.5
|
|
6
|
+
* established for `llm-providers` / `tool-providers` /
|
|
7
|
+
* `memory-providers`. Adding a new vendor adds an export here, NOT
|
|
8
|
+
* a new subpath — keeps `package.json#exports` from sprawling.
|
|
9
|
+
*
|
|
10
|
+
* Each adapter lazy-imports its vendor SDK via `lib/lazyRequire.ts`,
|
|
11
|
+
* so consumers who never call a particular factory don't have to
|
|
12
|
+
* install that SDK. Peer-deps are declared in package.json with
|
|
13
|
+
* `peerDependenciesMeta.{name}.optional = true`.
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* ```ts
|
|
17
|
+
* import { agentcoreObservability } from 'agentfootprint/observability-providers';
|
|
18
|
+
* import { microtaskBatchDriver } from 'footprintjs/detach';
|
|
19
|
+
*
|
|
20
|
+
* agent.enable.observability({
|
|
21
|
+
* strategy: agentcoreObservability({
|
|
22
|
+
* region: 'us-east-1',
|
|
23
|
+
* logGroupName: '/agentfootprint/my-agent',
|
|
24
|
+
* }),
|
|
25
|
+
* // Recommended — keeps the agent loop unblocked by network latency.
|
|
26
|
+
* detach: { driver: microtaskBatchDriver, mode: 'forget' },
|
|
27
|
+
* });
|
|
28
|
+
* ```
|
|
29
|
+
*
|
|
30
|
+
* Roadmap:
|
|
31
|
+
* - agentcoreObservability ← v2.8.1
|
|
32
|
+
* - cloudwatchObservability ← v2.8.2 (this release)
|
|
33
|
+
* - xrayObservability ← v2.8.3
|
|
34
|
+
* - otelObservability ← v2.9.x
|
|
35
|
+
* - datadogObservability ← v2.9.x
|
|
36
|
+
*/
|
|
37
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
38
|
+
exports.cloudwatchObservability = exports.agentcoreObservability = void 0;
|
|
39
|
+
var agentcore_js_1 = require("./adapters/observability/agentcore.js");
|
|
40
|
+
Object.defineProperty(exports, "agentcoreObservability", { enumerable: true, get: function () { return agentcore_js_1.agentcoreObservability; } });
|
|
41
|
+
var cloudwatch_js_1 = require("./adapters/observability/cloudwatch.js");
|
|
42
|
+
Object.defineProperty(exports, "cloudwatchObservability", { enumerable: true, get: function () { return cloudwatch_js_1.cloudwatchObservability; } });
|
|
43
|
+
//# sourceMappingURL=observability-providers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../src/observability-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,sEAG+C;AAF7C,sHAAA,sBAAsB,OAAA;AAGxB,wEAGgD;AAF9C,wHAAA,uBAAuB,OAAA"}
|
package/dist/strategies/index.js
CHANGED
|
@@ -8,14 +8,28 @@
|
|
|
8
8
|
* - `types.ts` — typed interfaces (Observability, Cost, LiveStatus, Lens)
|
|
9
9
|
* - `defaults/` — the 4 in-core default strategies
|
|
10
10
|
*
|
|
11
|
-
* Vendor strategies ship
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
* - `agentfootprint/observability-
|
|
17
|
-
*
|
|
18
|
-
*
|
|
11
|
+
* Vendor strategies ship under three GROUPED subpaths (matching the
|
|
12
|
+
* parallel-providers pattern v2.5 established for `llm-providers` /
|
|
13
|
+
* `tool-providers` / `memory-providers`). Each subpath holds N
|
|
14
|
+
* vendor-named factories — adding a vendor never adds a new subpath:
|
|
15
|
+
*
|
|
16
|
+
* - `agentfootprint/observability-providers`
|
|
17
|
+
* agentcoreObservability (v2.8.1)
|
|
18
|
+
* cloudwatchObservability (v2.8.2)
|
|
19
|
+
* xrayObservability (v2.8.3)
|
|
20
|
+
* otelObservability (v2.9.x)
|
|
21
|
+
* datadogObservability (v2.9.x)
|
|
22
|
+
*
|
|
23
|
+
* - `agentfootprint/cost-providers`
|
|
24
|
+
* stripeCost (v2.10.x)
|
|
25
|
+
*
|
|
26
|
+
* - `agentfootprint/lens-providers`
|
|
27
|
+
* browserLens / cliLens (v2.12.x)
|
|
28
|
+
*
|
|
29
|
+
* Each adapter lazy-imports its vendor SDK via `lib/lazyRequire.ts`,
|
|
30
|
+
* so consumers who never call a particular factory don't have to
|
|
31
|
+
* install that SDK. Peer-deps are declared in package.json with
|
|
32
|
+
* `peerDependenciesMeta.{name}.optional = true`.
|
|
19
33
|
*/
|
|
20
34
|
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
21
35
|
if (k2 === undefined) k2 = k;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,sDAAoC;AACpC,2CAAiG;AAAxF,kHAAA,oBAAoB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAC1E,yCAOqB;AANnB,wHAAA,2BAA2B,OAAA;AAC3B,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentcoreObservability — AWS Bedrock AgentCore observability adapter.
|
|
3
|
+
*
|
|
4
|
+
* Ships every `AgentfootprintEvent` to **CloudWatch Logs** in a
|
|
5
|
+
* structured-JSON shape AgentCore's hosted-agent telemetry layer
|
|
6
|
+
* understands. Use when:
|
|
7
|
+
*
|
|
8
|
+
* 1. Your agent runs INSIDE AgentCore — events show up alongside
|
|
9
|
+
* AgentCore's own runtime telemetry in the same log group.
|
|
10
|
+
* 2. Your agent runs OUTSIDE AgentCore but you want to query agent
|
|
11
|
+
* behavior in CloudWatch Insights / X-Ray traces using the same
|
|
12
|
+
* schema AgentCore uses internally.
|
|
13
|
+
*
|
|
14
|
+
* Subpath: `agentfootprint/observability-providers`
|
|
15
|
+
* Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
|
|
16
|
+
* only when this adapter is used; declared via
|
|
17
|
+
* `peerDependenciesMeta.{name}.optional = true`).
|
|
18
|
+
*
|
|
19
|
+
* **Implementation:** thin wrapper over `cloudwatchObservability`'s
|
|
20
|
+
* shared base. The only difference is the strategy `name` (used for
|
|
21
|
+
* registry lookup + diagnostics). All batching, flush, error-routing,
|
|
22
|
+
* and SDK-loading behavior is identical. As we evolve the CloudWatch
|
|
23
|
+
* shipping path (retry, sequence tokens, metrics emission), every
|
|
24
|
+
* CloudWatch-shaped adapter inherits the improvement.
|
|
25
|
+
*
|
|
26
|
+
* @example Basic
|
|
27
|
+
* ```ts
|
|
28
|
+
* import { agentcoreObservability } from 'agentfootprint/observability-providers';
|
|
29
|
+
* import { microtaskBatchDriver } from 'footprintjs/detach';
|
|
30
|
+
*
|
|
31
|
+
* agent.enable.observability({
|
|
32
|
+
* strategy: agentcoreObservability({
|
|
33
|
+
* region: 'us-east-1',
|
|
34
|
+
* logGroupName: '/agentfootprint/my-agent',
|
|
35
|
+
* logStreamName: `${process.env.HOSTNAME}/${Date.now()}`,
|
|
36
|
+
* }),
|
|
37
|
+
* detach: { driver: microtaskBatchDriver, mode: 'forget' },
|
|
38
|
+
* });
|
|
39
|
+
* ```
|
|
40
|
+
*
|
|
41
|
+
* @example Test injection (skip SDK require entirely)
|
|
42
|
+
* ```ts
|
|
43
|
+
* agentcoreObservability({
|
|
44
|
+
* _client: {
|
|
45
|
+
* putLogEvents: async (input) => { capturedBatches.push(input); },
|
|
46
|
+
* },
|
|
47
|
+
* });
|
|
48
|
+
* ```
|
|
49
|
+
*/
|
|
50
|
+
import type { ObservabilityStrategy } from '../../strategies/types.js';
|
|
51
|
+
import { type CloudwatchObservabilityOptions } from './cloudwatch.js';
|
|
52
|
+
/**
|
|
53
|
+
* AgentCore-specific options. Currently identical to the generic
|
|
54
|
+
* `CloudwatchObservabilityOptions` — kept as a separate type for
|
|
55
|
+
* future-proofing (AgentCore-specific knobs like
|
|
56
|
+
* `agentcoreSessionId` propagation could land here without a
|
|
57
|
+
* breaking change).
|
|
58
|
+
*/
|
|
59
|
+
export type AgentcoreObservabilityOptions = CloudwatchObservabilityOptions;
|
|
60
|
+
/**
|
|
61
|
+
* Build an AgentCore-flavored CloudWatch Logs observability strategy.
|
|
62
|
+
* Functionally identical to `cloudwatchObservability` except for the
|
|
63
|
+
* strategy `name`, which lets registry-lookup + diagnostics
|
|
64
|
+
* distinguish AgentCore-targeted shipping from generic CloudWatch.
|
|
65
|
+
*/
|
|
66
|
+
export declare function agentcoreObservability(opts: AgentcoreObservabilityOptions): ObservabilityStrategy;
|
|
67
|
+
//# sourceMappingURL=agentcore.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agentcore.d.ts","sourceRoot":"","sources":["../../../../src/adapters/observability/agentcore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,MAAM,6BAA6B,GAAG,8BAA8B,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,6BAA6B,GAAG,qBAAqB,CAEjG"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* cloudwatchObservability — Generic AWS CloudWatch Logs adapter.
|
|
3
|
+
*
|
|
4
|
+
* Ships every `AgentfootprintEvent` to a CloudWatch Logs stream. Use
|
|
5
|
+
* when you want agent telemetry alongside the rest of your AWS
|
|
6
|
+
* observability stack — CloudWatch Insights queries, alarms,
|
|
7
|
+
* cross-service correlation. Same SDK as `agentcoreObservability`
|
|
8
|
+
* but **without** the AgentCore-specific defaults (log-stream
|
|
9
|
+
* convention, format opinions). Use this when:
|
|
10
|
+
*
|
|
11
|
+
* 1. You're shipping to CloudWatch but NOT running inside Bedrock
|
|
12
|
+
* AgentCore (most common case).
|
|
13
|
+
* 2. You want full control over log group / stream / format and
|
|
14
|
+
* don't need AgentCore's hosted-agent telemetry conventions.
|
|
15
|
+
*
|
|
16
|
+
* Subpath: `agentfootprint/observability-providers`
|
|
17
|
+
* Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
|
|
18
|
+
* only when this adapter is used; declared via
|
|
19
|
+
* `peerDependenciesMeta.{name}.optional = true`).
|
|
20
|
+
*
|
|
21
|
+
* This module also exports the underlying base function used by
|
|
22
|
+
* `agentcoreObservability` — keeps the per-event hot path in one
|
|
23
|
+
* place so improvements (batching, retry, backpressure) flow to
|
|
24
|
+
* every CloudWatch-shaped adapter automatically.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* ```ts
|
|
28
|
+
* import { cloudwatchObservability } from 'agentfootprint/observability-providers';
|
|
29
|
+
* import { microtaskBatchDriver } from 'footprintjs/detach';
|
|
30
|
+
*
|
|
31
|
+
* agent.enable.observability({
|
|
32
|
+
* strategy: cloudwatchObservability({
|
|
33
|
+
* region: 'us-east-1',
|
|
34
|
+
* logGroupName: '/myapp/agent-prod',
|
|
35
|
+
* logStreamName: `${process.env.HOSTNAME}/${Date.now()}`,
|
|
36
|
+
* }),
|
|
37
|
+
* detach: { driver: microtaskBatchDriver, mode: 'forget' },
|
|
38
|
+
* });
|
|
39
|
+
* ```
|
|
40
|
+
*/
|
|
41
|
+
import type { ObservabilityStrategy } from '../../strategies/types.js';
|
|
42
|
+
export interface CloudwatchObservabilityOptions {
|
|
43
|
+
/** AWS region. Falls back to AWS_REGION / AWS_DEFAULT_REGION env. */
|
|
44
|
+
readonly region?: string;
|
|
45
|
+
/** CloudWatch Logs log group. **Required.** Must exist or your IAM
|
|
46
|
+
* role must allow `logs:CreateLogGroup`. */
|
|
47
|
+
readonly logGroupName: string;
|
|
48
|
+
/** CloudWatch Logs log stream within the group. Conventionally
|
|
49
|
+
* `<host>/<startTime>` so multi-instance deployments don't
|
|
50
|
+
* collide. Created on first put if it doesn't exist (or your
|
|
51
|
+
* role must allow `logs:CreateLogStream`). Defaults to
|
|
52
|
+
* `agentfootprint`. */
|
|
53
|
+
readonly logStreamName?: string;
|
|
54
|
+
/** Max events buffered before forced flush. Default 100. */
|
|
55
|
+
readonly maxBatchEvents?: number;
|
|
56
|
+
/** Max payload bytes (UTF-8) buffered before forced flush. Default
|
|
57
|
+
* 10240 (10 KB). CloudWatch hard caps at 1 MB / batch but we keep
|
|
58
|
+
* the default low so latency stays bounded. */
|
|
59
|
+
readonly maxBatchBytes?: number;
|
|
60
|
+
/** Forced-flush interval when traffic is sparse. Default 1000ms.
|
|
61
|
+
* `0` disables time-based flush — only size triggers fire. */
|
|
62
|
+
readonly flushIntervalMs?: number;
|
|
63
|
+
/** Test injection — bypasses SDK lazy-require entirely. When set,
|
|
64
|
+
* `region` / IAM are ignored. */
|
|
65
|
+
readonly _client?: CloudWatchLikeClient;
|
|
66
|
+
}
|
|
67
|
+
export interface CloudWatchLikeClient {
|
|
68
|
+
putLogEvents(input: {
|
|
69
|
+
logGroupName: string;
|
|
70
|
+
logStreamName: string;
|
|
71
|
+
logEvents: ReadonlyArray<{
|
|
72
|
+
timestamp: number;
|
|
73
|
+
message: string;
|
|
74
|
+
}>;
|
|
75
|
+
}): Promise<unknown>;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Internal: shared CloudWatch Logs base used by every adapter that
|
|
79
|
+
* ships to CWL. `cloudwatchObservability` is the public generic
|
|
80
|
+
* factory; `agentcoreObservability` calls this with AgentCore-flavored
|
|
81
|
+
* defaults.
|
|
82
|
+
*
|
|
83
|
+
* Exported for adapter authors only — consumers should call
|
|
84
|
+
* `cloudwatchObservability` or `agentcoreObservability` directly.
|
|
85
|
+
*
|
|
86
|
+
* @internal
|
|
87
|
+
*/
|
|
88
|
+
export declare function _buildCloudWatchObservability(opts: CloudwatchObservabilityOptions, strategyName: string): ObservabilityStrategy;
|
|
89
|
+
/**
|
|
90
|
+
* Generic CloudWatch Logs observability adapter. See
|
|
91
|
+
* `CloudwatchObservabilityOptions` for the per-option contract.
|
|
92
|
+
*
|
|
93
|
+
* For AgentCore-specific conventions, use `agentcoreObservability`
|
|
94
|
+
* which thin-wraps this with AgentCore-flavored defaults.
|
|
95
|
+
*/
|
|
96
|
+
export declare function cloudwatchObservability(opts: CloudwatchObservabilityOptions): ObservabilityStrategy;
|
|
97
|
+
//# sourceMappingURL=cloudwatch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cloudwatch.d.ts","sourceRoot":"","sources":["../../../../src/adapters/observability/cloudwatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,MAAM,WAAW,8BAA8B;IAC7C,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;iDAC6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;4BAIwB;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;oDAEgD;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;mEAC+D;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;sCACkC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAID,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,KAAK,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,aAAa,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,8BAA8B,EACpC,YAAY,EAAE,MAAM,GACnB,qBAAqB,CA8GvB;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,8BAA8B,GACnC,qBAAqB,CAEvB"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/observability-providers — vendor observability strategies.
|
|
3
|
+
*
|
|
4
|
+
* Grouped subpath following the parallel-providers pattern v2.5
|
|
5
|
+
* established for `llm-providers` / `tool-providers` /
|
|
6
|
+
* `memory-providers`. Adding a new vendor adds an export here, NOT
|
|
7
|
+
* a new subpath — keeps `package.json#exports` from sprawling.
|
|
8
|
+
*
|
|
9
|
+
* Each adapter lazy-imports its vendor SDK via `lib/lazyRequire.ts`,
|
|
10
|
+
* so consumers who never call a particular factory don't have to
|
|
11
|
+
* install that SDK. Peer-deps are declared in package.json with
|
|
12
|
+
* `peerDependenciesMeta.{name}.optional = true`.
|
|
13
|
+
*
|
|
14
|
+
* @example
|
|
15
|
+
* ```ts
|
|
16
|
+
* import { agentcoreObservability } from 'agentfootprint/observability-providers';
|
|
17
|
+
* import { microtaskBatchDriver } from 'footprintjs/detach';
|
|
18
|
+
*
|
|
19
|
+
* agent.enable.observability({
|
|
20
|
+
* strategy: agentcoreObservability({
|
|
21
|
+
* region: 'us-east-1',
|
|
22
|
+
* logGroupName: '/agentfootprint/my-agent',
|
|
23
|
+
* }),
|
|
24
|
+
* // Recommended — keeps the agent loop unblocked by network latency.
|
|
25
|
+
* detach: { driver: microtaskBatchDriver, mode: 'forget' },
|
|
26
|
+
* });
|
|
27
|
+
* ```
|
|
28
|
+
*
|
|
29
|
+
* Roadmap:
|
|
30
|
+
* - agentcoreObservability ← v2.8.1
|
|
31
|
+
* - cloudwatchObservability ← v2.8.2 (this release)
|
|
32
|
+
* - xrayObservability ← v2.8.3
|
|
33
|
+
* - otelObservability ← v2.9.x
|
|
34
|
+
* - datadogObservability ← v2.9.x
|
|
35
|
+
*/
|
|
36
|
+
export { agentcoreObservability, type AgentcoreObservabilityOptions, } from './adapters/observability/agentcore.js';
|
|
37
|
+
export { cloudwatchObservability, type CloudwatchObservabilityOptions, } from './adapters/observability/cloudwatch.js';
|
|
38
|
+
//# sourceMappingURL=observability-providers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observability-providers.d.ts","sourceRoot":"","sources":["../../src/observability-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,GACpC,MAAM,wCAAwC,CAAC"}
|
|
@@ -7,14 +7,28 @@
|
|
|
7
7
|
* - `types.ts` — typed interfaces (Observability, Cost, LiveStatus, Lens)
|
|
8
8
|
* - `defaults/` — the 4 in-core default strategies
|
|
9
9
|
*
|
|
10
|
-
* Vendor strategies ship
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
* - `agentfootprint/observability-
|
|
16
|
-
*
|
|
17
|
-
*
|
|
10
|
+
* Vendor strategies ship under three GROUPED subpaths (matching the
|
|
11
|
+
* parallel-providers pattern v2.5 established for `llm-providers` /
|
|
12
|
+
* `tool-providers` / `memory-providers`). Each subpath holds N
|
|
13
|
+
* vendor-named factories — adding a vendor never adds a new subpath:
|
|
14
|
+
*
|
|
15
|
+
* - `agentfootprint/observability-providers`
|
|
16
|
+
* agentcoreObservability (v2.8.1)
|
|
17
|
+
* cloudwatchObservability (v2.8.2)
|
|
18
|
+
* xrayObservability (v2.8.3)
|
|
19
|
+
* otelObservability (v2.9.x)
|
|
20
|
+
* datadogObservability (v2.9.x)
|
|
21
|
+
*
|
|
22
|
+
* - `agentfootprint/cost-providers`
|
|
23
|
+
* stripeCost (v2.10.x)
|
|
24
|
+
*
|
|
25
|
+
* - `agentfootprint/lens-providers`
|
|
26
|
+
* browserLens / cliLens (v2.12.x)
|
|
27
|
+
*
|
|
28
|
+
* Each adapter lazy-imports its vendor SDK via `lib/lazyRequire.ts`,
|
|
29
|
+
* so consumers who never call a particular factory don't have to
|
|
30
|
+
* install that SDK. Peer-deps are declared in package.json with
|
|
31
|
+
* `peerDependenciesMeta.{name}.optional = true`.
|
|
18
32
|
*/
|
|
19
33
|
export * from './types.js';
|
|
20
34
|
export * from './defaults/index.js';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentfootprint",
|
|
3
|
-
"version": "2.8.
|
|
3
|
+
"version": "2.8.2",
|
|
4
4
|
"description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Sanjay Krishna Anbalagan",
|
|
@@ -109,6 +109,11 @@
|
|
|
109
109
|
"import": "./dist/esm/memory-providers.js",
|
|
110
110
|
"require": "./dist/memory-providers.js"
|
|
111
111
|
},
|
|
112
|
+
"./observability-providers": {
|
|
113
|
+
"types": "./dist/types/observability-providers.d.ts",
|
|
114
|
+
"import": "./dist/esm/observability-providers.js",
|
|
115
|
+
"require": "./dist/observability-providers.js"
|
|
116
|
+
},
|
|
112
117
|
"./observe": {
|
|
113
118
|
"types": "./dist/types/observe.d.ts",
|
|
114
119
|
"import": "./dist/esm/observe.js",
|
|
@@ -165,6 +170,7 @@
|
|
|
165
170
|
"@anthropic-ai/sdk": "*",
|
|
166
171
|
"@aws-sdk/client-bedrock-agent-runtime": "*",
|
|
167
172
|
"@aws-sdk/client-bedrock-runtime": "*",
|
|
173
|
+
"@aws-sdk/client-cloudwatch-logs": "*",
|
|
168
174
|
"@modelcontextprotocol/sdk": "*",
|
|
169
175
|
"footprintjs": ">=4.17.1",
|
|
170
176
|
"ioredis": "*",
|
|
@@ -184,6 +190,9 @@
|
|
|
184
190
|
"@aws-sdk/client-bedrock-agent-runtime": {
|
|
185
191
|
"optional": true
|
|
186
192
|
},
|
|
193
|
+
"@aws-sdk/client-cloudwatch-logs": {
|
|
194
|
+
"optional": true
|
|
195
|
+
},
|
|
187
196
|
"@modelcontextprotocol/sdk": {
|
|
188
197
|
"optional": true
|
|
189
198
|
},
|